Anthem.ImageButton Class Reference

Creates an updatable control that displays an image and responds to mouse clicks on the image using callbacks. More...

Inheritance diagram for Anthem.ImageButton:

Anthem.IUpdatableControl Anthem.ICallBackControl List of all members.

Public Member Functions

override void RenderControl (HtmlTextWriter writer)
 Forces the server control to output content and trace information.

Protected Member Functions

override void AddAttributesToRender (HtmlTextWriter writer)
 Adds the onclick attribute to invoke a callback from the client, then renders the attributes of the control to the output stream.
override void Render (HtmlTextWriter writer)
 Renders the server control wrapped in an additional element so that the element.innerHTML can be updated after a callback.
override void OnLoad (EventArgs e)
 Raises the System.Web.UI.Control.Load event and registers the control with Anthem.Manager.

Properties

[Category("Anthem")][DefaultValue("")][Description("The text
to display during the callback.")]
string 
ImageUrlDuringCallBack [get, set]
 Gets or sets the url of the image to display on the client during the callback.
[Category("Anthem")][DefaultValue("")][Description("The javascript
function to call on the client
if the callback is cancelled.")]
virtual string 
CallBackCancelledFunction [get, set]
 Gets or sets the javascript function to execute on the client if the callback is cancelled. See PreCallBackFunction.
[Category("Anthem")][DefaultValue(true)][Description("True
if this control uses callbacks
instead of postbacks to post
data to the server.")] virtual
bool 
EnableCallBack [get, set]
 Gets or sets a value indicating whether the control uses callbacks instead of postbacks to post data to the server.
[Category("Anthem")][DefaultValue(true)][Description("True
if this control is enabled
on the client during callbacks.")]
virtual bool 
EnabledDuringCallBack [get, set]
 Gets or sets a value indicating whether the control is enabled on the client during callbacks.
[Category("Anthem")][DefaultValue("")][Description("The javascript
function to call on the client
after the callback response
is received.")] virtual string 
PostCallBackFunction [get, set]
 Gets or sets the javascript function to execute on the client after the callback response is received.
[Category("Anthem")][DefaultValue("")][Description("The javascript
function to call on the client
before the callback is made.")]
virtual string 
PreCallBackFunction [get, set]
 Gets or sets the javascript function to execute on the client before the callback is made.
[Category("Anthem")][DefaultValue("")][Description("The text
to display during the callback.")]
virtual string 
TextDuringCallBack [get, set]
 Gets or sets the text to display on the client during the callback.
[Category("Anthem")][DefaultValue(false)][Description("True
if this control should be
updated after each callback.")]
virtual bool 
AutoUpdateAfterCallBack [get, set]
 Gets or sets a value indicating whether the control should be updated after each callback. Also see UpdateAfterCallBack.
[Browsable(false)][DefaultValue(false)] virtual bool UpdateAfterCallBack [get, set]
 Gets or sets a value which indicates whether the control should be updated after the current callback. Also see AutoUpdateAfterCallBack.
override bool Visible [get, set]
 Overrides the Visible property so that Anthem.Manager can track the visibility.

Detailed Description

Creates an updatable control that displays an image and responds to mouse clicks on the image using callbacks.

Definition at line 13 of file ImageButton.cs.


Member Function Documentation

override void Anthem.ImageButton.AddAttributesToRender ( HtmlTextWriter  writer  )  [protected]

Adds the onclick attribute to invoke a callback from the client, then renders the attributes of the control to the output stream.

Definition at line 44 of file ImageButton.cs.

override void Anthem.ImageButton.Render ( HtmlTextWriter  writer  )  [protected]

Renders the server control wrapped in an additional element so that the element.innerHTML can be updated after a callback.

Definition at line 68 of file ImageButton.cs.

override void Anthem.ImageButton.OnLoad ( EventArgs  e  )  [protected]

Raises the System.Web.UI.Control.Load event and registers the control with Anthem.Manager.

Parameters:
e A System.EventArgs.

Definition at line 329 of file ImageButton.cs.

override void Anthem.ImageButton.RenderControl ( HtmlTextWriter  writer  ) 

Forces the server control to output content and trace information.

Definition at line 339 of file ImageButton.cs.


Property Documentation

[Category("Anthem")][DefaultValue("")][Description("The text to display during the callback.")] string Anthem.ImageButton.ImageUrlDuringCallBack [get, set]

Gets or sets the url of the image to display on the client during the callback.

If the HTML element that invoked the callback is an <image> then the src property of the element is updated during the callback to the value of ImageUrlDuringCallBack, otherwise the associated <label> text is updated during the callback. If the element is not an <image>, and if there is no associated <label>, then this property is ignored.

Definition at line 29 of file ImageButton.cs.

[Category("Anthem")][DefaultValue("")][Description("The javascript function to call on the client if the callback is cancelled.")] virtual string Anthem.ImageButton.CallBackCancelledFunction [get, set]

Gets or sets the javascript function to execute on the client if the callback is cancelled. See PreCallBackFunction.

Implements Anthem.ICallBackControl.

Definition at line 100 of file ImageButton.cs.

[Category("Anthem")][DefaultValue(true)][Description("True if this control uses callbacks instead of postbacks to post data to the server.")] virtual bool Anthem.ImageButton.EnableCallBack [get, set]

Gets or sets a value indicating whether the control uses callbacks instead of postbacks to post data to the server.

true if the the control uses callbacks; otherwise, false. The default is true.

Implements Anthem.ICallBackControl.

Definition at line 126 of file ImageButton.cs.

[Category("Anthem")][DefaultValue(true)][Description("True if this control is enabled on the client during callbacks.")] virtual bool Anthem.ImageButton.EnabledDuringCallBack [get, set]

Gets or sets a value indicating whether the control is enabled on the client during callbacks.

true if the the control is enabled; otherwise, false. The default is true.

Not all HTML elements support this property.

Implements Anthem.ICallBackControl.

Definition at line 153 of file ImageButton.cs.

[Category("Anthem")][DefaultValue("")][Description("The javascript function to call on the client after the callback response is received.")] virtual string Anthem.ImageButton.PostCallBackFunction [get, set]

Gets or sets the javascript function to execute on the client after the callback response is received.

The callback response is passed into the PostCallBackFunction as the one and only parameter.

            function AfterCallBack(result) {
              if (result.error != null &amp;&amp; result.error.length &gt; 0) {
                alert(result.error);
              }
            }

Implements Anthem.ICallBackControl.

Definition at line 190 of file ImageButton.cs.

[Category("Anthem")][DefaultValue("")][Description("The javascript function to call on the client before the callback is made.")] virtual string Anthem.ImageButton.PreCallBackFunction [get, set]

Gets or sets the javascript function to execute on the client before the callback is made.

The function should return false on the client to cancel the callback.

Implements Anthem.ICallBackControl.

Definition at line 215 of file ImageButton.cs.

[Category("Anthem")][DefaultValue("")][Description("The text to display during the callback.")] virtual string Anthem.ImageButton.TextDuringCallBack [get, set]

Gets or sets the text to display on the client during the callback.

If the HTML element that invoked the callback has a text value (such as <input type="button" value="Run">) then the text of the element is updated during the callback, otherwise the associated <label> text is updated during the callback. If the element does not have a text value, and if there is no associated <label>, then this property is ignored.

Implements Anthem.ICallBackControl.

Definition at line 243 of file ImageButton.cs.

[Category("Anthem")][DefaultValue(false)][Description("True if this control should be updated after each callback.")] virtual bool Anthem.ImageButton.AutoUpdateAfterCallBack [get, set]

Gets or sets a value indicating whether the control should be updated after each callback. Also see UpdateAfterCallBack.

true if the the control should be updated; otherwise, false. The default is false.

            &lt;anthem:Label id="label" runat="server" AutoUpdateAfterCallBack="true" /&gt;

Implements Anthem.IUpdatableControl.

Definition at line 280 of file ImageButton.cs.

[Browsable(false)][DefaultValue(false)] virtual bool Anthem.ImageButton.UpdateAfterCallBack [get, set]

Gets or sets a value which indicates whether the control should be updated after the current callback. Also see AutoUpdateAfterCallBack.

true if the the control should be updated; otherwise, false. The default is false.

            this.Label = "Count = " + count;
            this.Label.UpdateAfterCallBack = true;

Implements Anthem.IUpdatableControl.

Definition at line 315 of file ImageButton.cs.

override bool Anthem.ImageButton.Visible [get, set]

Overrides the Visible property so that Anthem.Manager can track the visibility.

true if the control is rendered on the client; otherwise false. The default is true.

Definition at line 354 of file ImageButton.cs.

Referenced by Anthem.ImageButton.Render().


The documentation for this class was generated from the following file:
Generated on Wed Mar 14 23:50:40 2007 for Anthem by  doxygen 1.5.1-p1