From cd0f12a763203e2ea20df5c806c0f93d89c1f0cd Mon Sep 17 00:00:00 2001 From: Rick Falkvinge Date: Tue, 9 Sep 2014 13:25:01 +0200 Subject: [PATCH] Delete Telerik.Web.UI.xml --- External Libraries/Telerik.Web.UI.xml | 59871 ------------------------ 1 file changed, 59871 deletions(-) delete mode 100644 External Libraries/Telerik.Web.UI.xml diff --git a/External Libraries/Telerik.Web.UI.xml b/External Libraries/Telerik.Web.UI.xml deleted file mode 100644 index 4f25411f..00000000 --- a/External Libraries/Telerik.Web.UI.xml +++ /dev/null @@ -1,59871 +0,0 @@ - - - - Telerik.Web.UI - - - - - - - - - Describes an object that can be used to resolve references to a control by its ID - - - - - Resolves a reference to a control by its ID - - - - - - - - - - - - - - - Registers the control with the ScriptManager - - - - - Registers the CSS references - - - - - Loads the client state data - - - - - - Saves the client state data - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Returns the names of all embedded skins. Used by Telerik.Web.Examples. - - - - - Executed when post data is loaded from the request - - - - - - - - Executed when post data changes should invoke a chagned event - - - - Gets or sets the skin name for the control user interface. - A string containing the skin name for the control user interface. The default is string.Empty. - - - If this property is not set, the control will render using the skin named "Default". - If EnableEmbeddedSkins is set to false, the control will not render skin. - - - - - - - For internal use. - - - - - Gets or sets the value, indicating whether to render script references to the embedded scripts or not. - - - - If EnableEmbeddedScripts is set to false you will have to register the needed Scripts files by hand. - - - - - Gets or sets the value, indicating whether to render links to the embedded skins or not. - - - If EnableEmbeddedSkins is set to false you will have to register the needed CSS files by hand. - - - - - - Gets or sets the value, indicating whether to render the link to the embedded base stylesheet of the control or not. - - - If EnableEmbeddedBaseStylesheet is set to false you will have to register the needed control base CSS file by hand. - - - - - - Gets the real skin name for the control user interface. If Skin is not set, returns - "Default", otherwise returns Skin. - - - - Gets or sets the value, indicating whether to render the skin CSS files during Ajax requests - - - If EnableAjaxSkinRendering is set to false you will have to register the needed control base CSS file by hand when adding/showing the control with Ajax. - - - - - - - - - - The CssClass property will now be used instead of the former Skin - and will be modified in AddAttributesToRender() - - - protected override string CssClassFormatString - { - get - { - return "RadDock RadDock_{0} rdWTitle rdWFooter"; - } - } - - - - - - - - - - - - - Base control used to contain a template. Ensures that if the template - has been instantiated or the Controls collection has been accessed - the template cannot be set again. - - - 1) Into an existing WebControl add a readonly property and - a member for the template container - - private SingleTemplateContainer _contentContainer; - - [Browsable(false)] - public SingleTemplateContainer ContentContainer - { - get - { - EnsureChildControls(); - return _contentContainer; - } - } - - 2) Override CreateChildControls() and instantiate the SingleTemplateContainer. - The parameter is a reference to the instantiating control (used when throwing exceptions). - - protected override void CreateChildControls() - { - base.CreateChildControls(); - - _contentContainer = new SingleTemplateContainer(this); - _contentContainer.ID = "Content"; - Controls.Add(_contentContainer); - } - - 3) Add read/write property for the template. You will need the TemplateContainer - attribute in case if you override SingleTemplateContainer in order to add - properties, accessible during the databinding. - - //[TemplateContainer(typeof(SingleTemplateContainer))] - [PersistenceMode(PersistenceMode.InnerProperty)] - [TemplateInstance(TemplateInstance.Single)] - [Browsable(false)] - public ITemplate ContentTemplate - { - get - { - EnsureChildControls(); - return ContentContainer.Template; - } - set - { - EnsureChildControls(); - ContentContainer.Template = value; - } - } - - - - - - Instantiates a new instance of SingleTemplateContainer. - - - The control which contains the template. This parameter is used when - SingleTemplateContainer throws exceptions. - - - - - cssLinkFormat is used when registering css during ajax requests or when the page header is not runat="server". - - - - - this script is optimized in order to decrease the response size. If you change it, - please change the full commented version below as well. - - - - - Returns the skin that should be applied to the control. - - - - - Returns the web.config value which specifies the application-wide Skin setting. - - - Telerik.[ShortControlName].Skin or Telerik.Skin, depending on which value was set. - - - - - Registers the common skin CSS file and the CSS files, associated with the selected skin. - - - - - Registers a Css file reference on the page - - reference to the page - reference to the control - the css file url - - - - Returns the attributes for the common skin CSS file and the CSS files, associated with the selected skin. - - - - - Returns the attributes for all embedded skins. - - - - - Returns the names of all embedded skins. The common skin attribute is not included! - - - - - Allows the mapping of a property declared in managed code to a property - declared in client script. For example, if the client script property is named "handle" and you - prefer the name on the TargetProperties object to be "Handle", you would apply this attribute with the value "handle." - - - - - Creates an instance of the ClientPropertyNameAttribute and initializes - the PropertyName value. - - The name of the property in client script that you wish to map to. - - - - The name of the property in client script code that you wish to map to. - - - - - Associates a client script resource with an extender class. - This allows the extender to find it's associated script and what - names and prefixes with which to reference it. - - - - - Called from other constructors to set the prefix and the name. - - The name given to the class in the Web.TypeDescriptor.addType call - - - - Associates a client script resource with the class. - - The name given to the class in the Web.TypeDescriptor.addType call - A Type that lives in the same folder as the script file - The name of the script file itself (e.g. 'foo.cs') - - - - Associates a client script resource with the class. - - The name given to the class in the Web.TypeDescriptor.addType call - The name of the script resource, e.g. 'ControlLibrary1.FooExtender.Foo.js' - - - - The component type name to use when referencing the component class in XML. If - the XML reference is "<myns:Foo/>", the component type is "Foo". - - - - - This is the path to the resource in the assembly. This is usually defined as - [default namespace].[Folder name].FileName. In a project called "ControlLibrary1", a - JScript file called Foo.js in the "Script" subdirectory would be named "ControlLibrary1.Script.Foo.js" by default. - - - - - Signifies that this property references a ScriptComponent - - - - - The AnimationScripts class is used to load all of the animation support for the AJAX - Control Toolkit. To use any of the animations you find in Animations.js, simply include - the attribute [RequiredScript(typeof(AnimationScripts))] on your extender. - - - - - Repository of old "Atlas" code that we're waiting to have integrated into the new Microsoft Ajax Library - - - - - Specifies this property is an element reference and should be converted during serialization. - The default (e.g. cases without this attribute) will generate the element's ID - - - - - Constructs a new ElementReferenceAttribute - - - - - Signifies that this Property should be exposed as a client-side event reference - - - - - Initializes a new ClientControlEventAttribute - - - - - Initializes a new ClientControlEventAttribute - - - - - - Tests for object equality - - - - - - - Gets a hash code for this object - - - - - - Gets whether this is the default value for this attribute - - - - - - Whether this is a valid ScriptEvent - - - - - Signifies that this method should be exposed as a client callback - - - - - Initializes a new ClientControlMethodAttribute - - - - - Initializes a new ClientControlMethodAttribute - - - - - - Tests for object equality - - - - - - - Gets a hash code for this object - - - - - - Gets whether this is the default value for this attribute - - - - - - Whether this is a valid ScriptMethod - - - - - Signifies that this property is to be emitted as a client script property - - - - - Initializes a new ClientControlPropertyAttribute - - - - - Initializes a new ClientControlPropertyAttribute - - - - - - Tests for object equality - - - - - - - Gets a hash code for this object - - - - - - Gets whether this is the default value for this attribute - - - - - - Whether this property should be exposed to the client - - - - - Describes an object which supports ClientState - - - - - Loads the client state for the object - - - - - - Saves the client state for the object - - - - - - Whether ClientState is supported by the object instance - - - - - Defines the common property categories' names - - - - - - - - - - - - - - - - - Registers the control with the ScriptManager - - - - - Registers the CSS references - - - - - Loads the client state data - - - - - - Saves the client state data - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Returns the names of all embedded skins. Used by Telerik.Web.Examples. - - - - - Executed when post data is loaded from the request - - - - - - - - Executed when post data changes should invoke a chagned event - - - - Gets or sets the skin name for the control user interface. - A string containing the skin name for the control user interface. The default is string.Empty. - - - If this property is not set, the control will render using the skin named "Default". - If EnableEmbeddedSkins is set to false, the control will not render skin. - - - - - - For internal use. - - - - - Gets or sets the value, indicating whether to render script references to the embedded scripts or not. - - - - If EnableEmbeddedScripts is set to false you will have to register the needed Scripts files by hand. - - - - - Gets or sets the value, indicating whether to render links to the embedded skins or not. - - - If EnableEmbeddedSkins is set to false you will have to register the needed CSS files by hand. - - - - - Gets or sets the value, indicating whether to render the link to the embedded base stylesheet of the control or not. - - - If EnableEmbeddedBaseStylesheet is set to false you will have to register the needed control base CSS file by hand. - - - - - - Gets the real skin name for the control user interface. If Skin is not set, returns - "Default", otherwise returns Skin. - - - - Gets or sets the value, indicating whether to render the skin CSS files during Ajax requests - - - If EnableAjaxSkinRendering is set to false you will have to register the needed control base CSS file by hand when adding/showing the control with Ajax. - - - - - - - - - - The CssClass property will now be used instead of the former Skin - and will be modified in AddAttributesToRender() - - - protected override string CssClassFormatString - { - get - { - return "RadDock RadDock_{0} rdWTitle rdWFooter"; - } - } - - - - - - - - - The presence of this attribute on a property of a subclass of - TargetControlPropertiesBase indicates that the property value is - required and the control can not be used without it. Absence of a - required property value causes an exception to be thrown during - creation of the control. - - - - - Constructs a new RequiredPropertyAttribute - - - - - Gets the script references for a type - - - - - Describes an object to a ScriptComponentDescriptor based on its reflected properties and methods - - The object to be described - The script descriptor to fill - The object used to resolve urls - The object used to resolve control references - - - - Gets the script references for a type - - - - - - - Gets the script references for a type - - - - - - - - Gets the embedded css file references for a type - - - - - - - Register's the Css references for this control - - - - - - Executes a callback capable method on a control - - - - - - - - ScriptReference objects aren't immutable. The AJAX core adds context to them, so we cant' reuse them. - Therefore, we track only ReferenceEntries internally and then convert them to NEW ScriptReference objects on-demand. - - - - - - - Gets the script references for a type and walks the type's dependencies with circular-reference checking - - - - - - - - Gets the css references for a type and walks the type's dependencies with circular-reference checking - - - - - - - - - Represents the Close command item in a RadDock control. - - - - - Represents a custom command item in a RadDock control. - - - - - Initializes a new instance of the DockCommand class - - - - - Initializes a new instance of the DockCommand class with the specified - clientTypeName, cssClass, name, text and autoPostBack - - - - - Creates an HtmlAnchor control with applied CssClass and Title - - An HtmlAnchor control - - - - Returns the value of the CssClass property. This method should be overriden - in multistate commands, such as DockToggleCommand, to return one of the - CssClass and AlternateCssClass properties, depending on the command state. - - - - - Returns the value of the Text property. This method should be overriden - in multistate commands, such as DockToggleCommand, to return one of the - Text and AlternateText properties, depending on the command state. - - - - - Specifies the name of the type of the client object, which - will be instantiated when the command is initialized for the first time. - - - - - Specifies the name of the command. The value of this property is used - to determine on the server which command was clicked on the client. - - - - - Specifies the text, which will be displayed as tooltip when the user - hovers the mouse cursor over the command button. - - - - - Gets or sets a value indicating whether a postback to the server - automatically occurs when the user drags the RadDock control. - - - - - Gets or sets the client-side script that executes when the Command event is raised - on the client. - - - - - Gets or sets the Cascading Style Sheet (CSS) class rendered by the Command item - on the client. - - - - - Initializes a new instance of the DockCloseCommand class - - - - - - - - - - - - - - - - - A collection of DockCommand objects in a RadDock control. - - - - - Appends a DockCommand to the end of the collection - - - - - Inserts a DockCommand to a given index in the collection - - - - - Provides data for the DockCommand event. - - - - - Gets the DockCommand item which initiated the event. - - - - - Represents the method that handles a DockCommand event - - The source of the event - A DockCommandEventArgs that contains the event data - - - - Represents the ExpandCollapse command item in a RadDock control. - - - - - Represents a two state command item in a RadDock control. - - - - - Initializes a new instance of the DockToggleCommand class - - - - - Initializes a new instance of the DockToggleCommand class with the specified - clientTypeName, cssClass, alternateCssClass, name, text, alternateText and autoPostBack - - - - - Returns the value of the CssClass property if the value of the State - property is Primary, otherwise AlternateCssClass. - - - - - Returns the value of the Text property if the value of the State property is - Primary, otherwise AlternateText. - - - - - Gets or sets the initial state of the command item. If the value of this property - is Primary, the values of the Text and CssClass properties will be used initially, - otherwise the command will use AlternateText and AlternateCssClass. - - - - - Gets or sets the Cascading Style Sheet (CSS) class rendered by the Command item - on the client when State is Alternate. - - - - - Specifies the text, which will be displayed as tooltip when the user - hovers the mouse cursor over the command button when State is Alternate. - - - - - Initializes a new instance of the DockExpandCollapseCommand class - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Implements methods, needed by RadDock or RadDockZone to register with - a control which will take care of the dock positions. - - - - - Each dock will use this method in its OnInit event to register - with the IDockLayout. This is needed in order the layout to - be able to manage the dock position, set on the client. - - - - - Each dock will use this method in its OnUnload event to unregister - with the IDockLayout. This is needed in order the layout to - be able to manage the dock state properly. - - - - - Each zone will use this method in its OnInit event to register - with the IDockLayout. This is needed in order the layout to - be able to manage the dock positions, set on the client. - - - - - Each zone will use this method in its OnUnload event to unregister - with the IDockLayout. - - - - - Docks the RadDock control inside a child zone with ID=newParentClientID - - - - - RadDock is a control, which enables the developers to move, dock, - expand/collapse any DHTML/ASP.NET content - - - - - Raises the DockPositionChanged event. - - - This method notifies the server control that it should perform actions to - ensure that it should be docked in the specified RadDockZone on the client. - - - - - Raises the Command event and allows you to handle the Command event directly. - - - - - Docks the RadDock control in the zone with ClientID equal to dockZoneID. - - - The RadDock control should be placed into a RadDockLayout in order this - method to work. It is not necessary the layout to be direct parent of the - RadDock control. - - The ClientID of the RadDockZone control, where - the control should be docked. - - - - Docks the RadDock control in the specified RadDockZone. - - The RadDockZone control where the control should be docked. - - - - Removes the RadDock control from its parent RadDockZone. - - - - - Returns the unique name for the dock, based on the UniqueName and - the ID properties. - - - A string, containing the UniqueName property of the dock, or its - ID, if the UniqueName property is not set. - - - - - Returns a DockState object, containing data about the current state - of the RadDock control. - - A DockState object, containing data about the current state - of the RadDock control. This object could be passed to ApplyState() - method. - - - - - Applies the data from the supplied DockState object. - - - A DockState object, containing data about the state, which should - be applied on the RadDock control. - - - - - Overriden. Handles the Init event. Inherited from WebControl. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Gets or sets a value, indicating whether the control will initiate postback - when it is docked/undocked or its position changes. - - - - - Gets or sets a value, indicating whether the control is closed (style="display:none;"). - - - When the value of this property is true, the control will be hidden, but its HTML will - be rendered on the page - - - - - Gets or sets the tooltip of the CloseCommand when the corresponding - property was not explicitly set on the command object. - - - - - Gets or sets a value, indicating whether the control is collapsed. - - - When the value of this property is true, the content area of the control - will not be visible. - - - - - Gets or sets the tooltip of the ExpandCollapseCommand when the dock - is not collapsed and the corresponding property was not explicitly set - on the command object. - - - - - Gets a collection of DockCommand objects representing the individual commands within the control titlebar. - - - A DockCommandCollection that contains a collection of DockCommand objects representing the individual commands within the control titlebar. - - - Use the Commands collection to programmatically control the commands buttons within the control titlebar. - - - - - Gets or sets a value, indicating whether the control will initiate postback - when its command items are clicked. - - - - - Gets the control, where the ContentTemplate will be instantiated in. - - - You can use this property to programmatically add controls to the content area. If you add controls - to the ContentContainer the Text property will be ignored. - - - - - Gets or sets the System.Web.UI.ITemplate that contains the controls which will be - placed in the control content area. - - - You cannot set this property twice, or when you added controls to the ContentContainer. If you set - ContentTemplate the Text property will be ignored. - - - - - Gets or sets the value, defining the commands which will appear - in the RadDock titlebar when the commands collection is not modified. - - - - - Gets or sets the value, defining the behavior of the control titlebar and grips. - - - - - Gets or sets a value, indicating whether the control could be left undocked. - - - - - Gets the ClientID of the RadDockZone, where the control is docked. When the control is undocked, - this property returns string.Empty. - - - - - Gets or sets a value, indicating whether the control could be dragged. - - - When the value of this property is true, the control could be dragged with the mouse - - - - - Gets or sets the tooltip of the ExpandCollapseCommand when the dock - is collapsed and the corresponding property was not explicitly set - on the command object. - - - - - Specifies the UniqueNames of the RadDockZone controls, where - the RadDock control will not be allowed to dock. - - - - - Gets or sets the height of the RadDock control - - - - - Gets or sets the expanded height of the RadDock control - - - - - Gets the position of the RadDock control in its parent zone. If undocked returns -1. - - - - - - - - - Gets or sets the horizontal position of the RadDock control in pixels. This - property is ignored when the RadDock control is docked into a RadDockZone. - - - - - Gets or sets the client-side script that executes when a RadDock Command event is raised - - - - - Gets or sets the client-side script that executes when a RadDock DragStart event is raised - - - - - Gets or sets the client-side script that executes when a RadDock DragEnd event is raised - - - - - Gets or sets the client-side script that executes when a RadDock Drag event is raised - - - - - Gets or sets the client-side script that executes when the RadDock control changes its position - - - - - Gets or sets the client-side script that executes when the RadDock control is dropped on to a zone - before it changes its position - - - - - Gets or sets the client-side script that executes after the RadDock client-side obect initializes - - - - - Gets or sets the client-side script that executes when a RadDock ResizeStart event is raised - - - - - Gets or sets the client-side script that executes when a RadDock ResizeEnd event is raised - - - - - Gets or sets a value, indicating whether the control is resizable. - - - When the value of this property is true, the control will be resizable - - - - - Gets or sets a value, indicating whether the control is pinned. - - - When the value of this property is true, the control will retain its position - if the page scrolled. - - - - - Gets or sets the tooltip of the PinUnpinCommand when the dock - is not pinned and the corresponding property was not explicitly set - on the command object. - - - - - Gets or sets the additional data, which could be saved in the DockState. - - - - - Gets or sets the text which will appear in the control content area. If the ContentTemplate - or the ContentContainer contain any controls, the value of this property is ignored. - - - - - Gets or sets the text which will appear in the control titlebar area. If the TitlebarTemplate - or the TitlebarContainer contain any controls, the value of this property is ignored. - - - - - Gets the control, where the TitlebarTemplate will be instantiated in. - - - You can use this property to programmatically add controls to the titlebar. If you add controls - to the TitlebarContainer the Title property will be ignored. - - - - - Gets or sets the System.Web.UI.ITemplate that contains the controls which will be - placed in the control titlebar. - - - You cannot set this property twice, or when you added controls to the TitlebarContainer. If you set - TitlebarTemplate the Title property will be ignored. - - - - - Gets or sets the vertical position of the RadDock control in pixels. This - property is ignored when the RadDock control is docked into a RadDockZone. - - - - - Gets or sets the unique name of the control, which allows the parent RadDockLayout to - automatically manage its position. If this property is not set, the control ID will be - used instead. RadDockLayout will throw an exception if it finds two RadDock controls with - the same UniqueName. - - - - - Gets or sets the tooltip of the PinUnpinCommand when the dock - is pinned and the corresponding property was not explicitly set - on the command object. - - - - - Gets or sets the width of the RadDock control - - - - - Occurs when the control is docked in another RadDockZone, or its - in its current zone position was changed. - - - Notifies the server control to perform the needed actions to ensure that - it should be docked in the specified RadDockZone on the client. - - - - - Occurs when a command is clicked. - - - The event handler receives an argument of type DockCommandEventArgs containing - data related to this event. - - - - - - - - - - - - - Workflow: - 1). OnInit - ensure that the framework will call TrackViewState, LoadViewState and SaveViewState. - We expect that all child docks will be created here. - 2). TrackViewState - raise LoadDockLayout event in order to let the developer to supply - the initial parents of the registered docks, because the docks could be created with - different parents than needed. - 2a). LoadViewState - loads and applies the dock parents from the ViewState in order to persist - the dock positions between the page postbacks. - 3). LoadPostData - returns true to ensure that RaisePostDataChangedEvent() - 3a). Dock_DockZoneChanged - this event is raised by each dock in its LoadPostData method. - We handle this event and store the pair UniqueName/NewDockZoneID in the _clientPositions - Dictionary. This Dictionary will be used in #4. - 4). RaisePostDataChangedEvent - sets the parents of the registered docks according their - positions, set on the client. These positions are stored in the _clientPositions Dictionary. - 5). OnLoad, other events, such as Click, Command, etc. If you create a dock here it will be - rendered on the page, but if it is not recreated in the next OnInit, it will not persist - its position, set on the client! - 6). SaveViewState - stores the dock parents in the ViewState in order to persist their positions - between the page postbacks. - 7). Page_SaveStateComplete - raises the SaveDockLayout event to let the developer to save - the state in a database or other storage medium. - Note: The dock parents will be stored in the ViewState if StoreLayoutInViewState is set - to true (default). Otherwise the developer should take care of the dock positions when the page - is posted back. - - - - - Overriden. Handles the Init event. Inherited from Control. - - - - - The docks must be already created. We will apply their order - and if there is a state information, we will apply it. - - - - - We will apply the dock positions saved in the ViewState here. - - - - - Overridden. Raises the PreRender event - - - - - - - - - We will loop through all registered docks and will retrieve their - positions and state. Those positions will be saved in the ViewState - if StoreLayoutInViewState is true. - - base.SaveViewState() - - - - Reorders the docks in the control tree, according the supplied parameters. - - - This method will check for uniqueness of the UniqueNames of the registered docks. If - there are two docks with equal unique names an exception will be thrown. - - A Dictionary, containing UniqueName/DockZoneID pairs. - A Dictionary, containing UniqueName/Index pairs. - - - - Docks the dock to a zone with ClientID = newParentClientID. - - The dock which should be docked. - The ClientID of the new parent. - - - - Cycles through all registered docks and retrieves their parents. The Dictionary - returned by this method could be passed to SetRegisteredDockParents(). - - - A dictionary, containing UniqueName/DockZoneID pairs. - - - - - Cycles through all registered docks and retrieves their indices. The Dictionary - returned by this method could be passed to SetRegisteredDockParents(). - - - A dictionary, containing UniqueName/Index pairs. - - - - - Cycles through all registered docks and retrieves their state, depending - on the omitClosedDocks parameter and the value of the Closed property of - each RadDock control. The List returned by this method could be used to - recreate the docks when the user visits the page again. - - - A List, containing UniqueName/DockState pairs. - - - - - Cycles through all registered docks and retrieves their state. The List - returned by this method could be used to recreate the docks when the user - visits the page again. - - - A List, containing UniqueName/DockState pairs. - - - - - Raises the LoadDockLayout event - - A DockLayoutEventArgs that contains the event data - - - - Raises the SaveDockLayout event - - A DockLayoutEventArgs that contains the event data - - - - Ensures that the dock has unique UniqueName or ID properties to its - RadDockLayout. If the UniqueName or the ID are not unique, throws an - exception. - - - A string, containing the UniqueName property of the dock, or its - ID if the UniqueName property is not set. Got from the RadDock.GetUniqueName(). - - - - - Each dock will use this method in its OnInit event to register - with the RadDockLayout. This is needed in order the layout to - be able to manage the dock position, set on the client. - - - - - Each zone will use this method in its OnInit event to register - with the RadDockLayout. This is needed in order the layout to - be able to manage the dock positions, set on the client. - - - - - Docks the dock to a zone with ClientID = newParentClientID. - - The dock which should be docked. - The ClientID of the new parent. - - - - Each dock will use this method in its OnUnload event to unregister - with the IDockLayout. This is needed in order the layout to - be able to manage the dock state properly. - - - - - Each zone will use this method in its OnUnload event to unregister - with the IDockLayout. - - - - - Each dock will store its position on the client in the DockZoneChanged event. - In RaisePostDataChangedEvent() RadDockLayout will reorganize the docks according - this information. - - - - - All docks, which are direct or indirect children of the RadDockLayout - - - - - All zones, which are direct or indirect children of the RadDockLayout - - - - - Returns the names of all embedded skins. Used by Telerik.Web.Examples. - - - - - Returns all registered docks with this RadDockLayout control. - - - Returns a read only collection containing all registered docks. - - - - - Returns all registered zones with this RadDockLayout control. - - - Returns a read only collection containing all registered zones. - - - - - RadDockLayout will raise the LoadDockLayout event in order to retrieve the parents - which will be automatically applied on the registered docks. The client - positions will be applied in a later stage of the lifecycle. - - - - - RadDockLayout will raise this event to let the developer to save - the parents of the registered docks in a database or other storage - medium. These parents can be later supplied to the LoadDockLayout event. - - - - - This is the container where we will store the dock positions, set on the client. - - - - - This is the container where we will store the dock positions, set on the client. - - - - - By default RadDockLayout will store the positions of its inner docks in - the ViewState. If you want to store the positions in other storage medium - such as a database, or the Session, set this property to false. Setting this - property to false will also minimize the ViewState usage. - - - - Gets or sets the skin name for the child controls' user interface. - A string containing the skin name for the control user interface. The - default is string.Empty. - - - If this property is set, RadDockLayout will set the Skin and EnableEmbeddedSkins properties - of each child RadDock and RadDockZone, unless their Skin property is not explicitly set. - - - - - - For internal use. - - - - Gets or sets the value, indicating whether to render links to the embedded skins or not. - - - If EnableEmbeddedSkins is set to false you will have to register the needed CSS files by hand. - - - If the Skin property is set, RadDockLayout will set the Skin and EnableEmbeddedSkins properties - of each child RadDock and RadDockZone, unless their Skin property is not explicitly set. - - - - - Gets or sets the value, indicating whether to render the link to the embedded base stylesheet of the control or not. - - - If EnableEmbeddedBaseStylesheet is set to false you will have to register the needed control base CSS file by hand. - - - - - Gets or sets the value, indicating whether to render the skin CSS files during Ajax requests - - - If EnableAjaxSkinRendering is set to false you will have to register the needed control base CSS file by hand when adding/showing the control with Ajax. - - - - - - RadDockZone is a control which represents a virtual placeholder, where - RadDock controls could be docked. - - - - - Returns the unique name for the dock, based on the UniqueName and - the ID properties. - - - A string, containing the UniqueName property of the dock, or its - ID, if the UniqueName property is not set. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Gets or sets a value, indicating whether the control will set the size - of the docked RadDock controls to 100% depending the control Orientation. - - - When Orientation is Horizontal, the Height of the docked RadDock controls - will become 100%, otherwise the Width will become 100%. - - - - - Gets or sets a css class name, which will be applied when the RadDockZone is highlighted. - If this property is not set, the control will not have a highlighted style. - - - - - Gets or sets the unique name of the control. If this property is not set, the control ID will be - used instead. RadDockLayout will throw an exception if it finds two RadDockZone controls with - the same UniqueName. - - - - - Gets or sets a value that specifies the dimension in which docked RadDock controls are arranged - - - - - Gets or sets the minimum width of the RadDockZone control. - - - - - Gets or sets the minimum height of the RadDockZone control. - - - - - - - - - Telerik RadSlider is a flexible UI component that allows users to select a value from a defined range using a smooth or step-based slider. - - - - - Adds the property to the ScriptComponentDescriptor, if it's value is different from the given default. - - The descriptor to add the property to. - The property name. - The current value of the property. - The default value. - - - - Gets an XML string representing the state of the control. All child items and their properties are serialized in this - string. - - - A String representing the state of the control - child items, properties etc. - - - Use the GetXml method to get the XML state of the control. You can cache it and then restore it using - the LoadXml method. - - - - - Loads the control from an XML string. - - - The string representing the XML from which the control will be populated. - - - Use the LoadXml method to populate the control from an XML string. You can use it along the GetXml - method to implement caching. - - - - - Gets or sets the name of the validation group to which this validation - control belongs. - - - The name of the validation group to which this validation control belongs. The - default is an empty string (""), which indicates that this property is not set. - - - This property works only when CausesValidation - is set to true. - - - - - Gets or sets the URL of the page to post to from the current page when a tab - from the tabstrip is clicked. - - - The URL of the Web page to post to from the current page when a tab from the - tabstrip control is clicked. The default value is an empty string (""), which causes - the page to post back to itself. - - - - - Gets or sets a value indicating whether validation is performed when an item within - the control is selected. - - - true if validation is performed when an item is selected; - otherwise, false. The default value is true. - - - By default, page validation is performed when an item is selected. Page - validation determines whether the input controls associated with a validation - control on the page all pass the validation rules specified by the validation - control. You can specify or determine whether validation is performed on both the - client and the server when an item is clicked by using the CausesValidation - property. To prevent validation from being performed, set the - CausesValidation property to false. - - - - - Gets or sets a value indicating the server-side event handler that is called - when the value of the slider has been changed. - - - A string specifying the name of the server-side event handler that will handle the - event. The default value is empty string. - - - If specified, the OnValueChanged - event handler that is called - when the value of the slider has been changed. Two parameters are passed to the handler: - - sender, the RadSlider object. - args. - - This event cannot be cancelled. - - - The following example demonstrates how to use the - OnValueChanged property. - -
- <telerik:RadSlider ID="RadSlider1"
- runat= "server"
- OnValueChanged="OnValueChanged">
- ....
- </telerik:RadSlider> -
-
-
-
- - - Clears out the list selection and sets the Selected property - of all items to false. - - Use this method to reset the control so that no items are selected. - - - RadComboBox1.ClearSelection() - - - RadComboBox1.ClearSelection(); - - - - - - Adds HTML attributes and styles that need to be rendered to the specified . This method is used primarily by control developers. - - A that represents the output stream to render HTML content on the client. - - - - The Enabled property is reset in AddAttributesToRender in order - to avoid setting disabled attribute in the control tag (this is - the default behavior). This property has the real value of the - Enabled property in that moment. - - - - - Get/Set the value of the slider - - - - - Get/Set the SelectionStart of the slider - - - - - Get/Set the SelectionEnd of the slider - - - - - Get/Set the IsSelectionRangeEnabled of the slider - - - - - Get/Set the IsDirectionReversed of the slider - - - - - Get/Set the LiveDrag of the slider - - - - - Get/Set the ItemType of the slider items - - - - - Get/Set the TrackPosition of the slider track - - - - - Get/Set orientation of the slider - - - - - Get/Set the step with which the slider value will change - - - - - Get/Set the step with which the slider value will change - - - - - Get/Set the delta with which the value will change - when user click on the track - - - - - Get/Set the delta with which the value will change - when user click on the track - - - - - Get/Set the length of the animation - - - - - Get/Set the length of the slider including the decrease and increase handles. - - - If the slider is horizontal the width will be set, otherwise the height will be set. - - - - - Get/Set the Width of the slider including the decrease and increase handles. - - - - - Get/Set the Height of the slider including the decrease and increase handles. - - - - - True to cause a postback on value change. - - - - - Get/Set the min value of the slider - - - - - Get/Set the max value of the slider - - - - - Enable/Disable whether the mouse wheel should be handled - - - - - Show/Hide the drag handle - - - - - Show/Hide the decrease handle - - - - - Show/Hide the increase handle - - - - - Gets or sets the text for the decrease handle - - - - - Gets or sets the text for the increase handle - - - - - Gets or sets the text for the increase handle - - - - - Gets or sets a value indicating the client-side event handler that is called when - the RadSlider control is initialized. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - If specified, the OnClientLoaded - client-side event handler is called when the RadSlider - is initialized. Two parameters are passed to the handler: - - sender, the RadSlider object. - args. - - This event cannot be cancelled. - - - The following example demonstrates how to use the - OnClientLoaded property. - -
- <script type="text/javascript">
- function OnSliderLoadHandler(sender, args)
- {
- var slider = sender;
- }
- </script> -
-
- <telerik:RadSlider ID="RadSlider1"
- runat= "server"
- OnClientLoaded="OnSliderLoadHandler">
- ....
- </telerik:RadSlider> -
-
-
-
- - - Gets or sets a value indicating the client-side event handler that is called before - the sliding is started. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - If specified, the OnClientSlideStart - client-side event handler is called before - the sliding is started. Two parameters are passed to the handler: - - sender, the RadSlider object. - args. - - This event cannot be cancelled. - - - The following example demonstrates how to use the - OnClientSlideStart property. - -
- <script type="text/javascript">
- function OnSlideBeginHandler(sender, args)
- {
- var slider = sender;
- }
- </script> -
-
- <telerik:RadSlider ID="RadSlider1"
- runat= "server"
- OnClientSlideStart="OnSlideBeginHandler">
- ....
- </telerik:RadSlider> -
-
-
-
- - - Gets or sets a value indicating the client-side event handler that is called - while the handle is being slided. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - If specified, the OnClientSlide - client-side event handler that is called - while the handle is being slided. Two parameters are passed to the handler: - - sender, the RadSlider object. - args. - - This event cannot be cancelled. - - - The following example demonstrates how to use the - OnClientSlide property. - -
- <script type="text/javascript">
- function OnSlidingHandler(sender, args)
- {
- var slider = sender;
- }
- </script> -
-
- <telerik:RadSlider ID="RadSlider1"
- runat= "server"
- OnClientSlide="OnSlidingHandler">
- ....
- </telerik:RadSlider> -
-
-
-
- - - Gets or sets a value indicating the client-side event handler that is called - when slide has ended. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - If specified, the OnClientSlideEnd - client-side event handler that is called - when slide has ended. Two parameters are passed to the handler: - - sender, the RadSlider object. - args. - - This event cannot be cancelled. - - - The following example demonstrates how to use the - OnClientSlideEnd property. - -
- <script type="text/javascript">
- function OnSlideHandler(sender, args)
- {
- var slider = sender;
- }
- </script> -
-
- <telerik:RadSlider ID="RadSlider1"
- runat= "server"
- OnClientSlideEnd="OnSlideHandler">
- ....
- </telerik:RadSlider> -
-
-
-
- - - Gets or sets a value indicating the client-side event handler that is called - when the value of the slider has been changed. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - If specified, the OnClientValueChange - client-side event handler that is called - when the value of the slider has been changed. Two parameters are passed to the handler: - - sender, the RadSlider object. - args. - - This event cannot be cancelled. - - - The following example demonstrates how to use the - OnClientValueChange property. - -
- <script type="text/javascript">
- function OnValueChangeHandler(sender, args)
- {
- var slider = sender;
- }
- </script> -
-
- <telerik:RadSlider ID="RadSlider1"
- runat= "server"
- OnClientValueChange="OnValueChangeHandler">
- ....
- </telerik:RadSlider> -
-
-
-
- - - Gets or sets a value indicating the client-side event handler that is called - just before the value of the slider changes. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - If specified, the OnClientBeforeValueChange - client-side event handler that is called - just before the value of the slider changes. Two parameters are passed to the handler: - - sender, the RadSlider object. - args. - - This event can be cancelled. - - - The following example demonstrates how to use the - OnClientBeforeValueChange property. - -
- <script type="text/javascript">
- function OnClientBeforeValueChange(sender, args)
- {
- var slider = sender;
- }
- </script> -
-
- <telerik:RadSlider ID="RadSlider1"
- runat= "server"
- OnClientBeforeValueChange="OnClientBeforeValueChange">
- ....
- </telerik:RadSlider> -
-
-
-
- - - Gets a RadSliderItemCollection object that contains the items of the current RadSlider control. - - - A RadSliderItemCollection that contains the items of the current RadSlider control. By default - the collection is empty (RadSlider is a numeric slider). - - - Use the Items property to access the child items of RadSlider - You can add, remove or modify items from the Items collection. - - - - - This property is being used internally by the RadSplitter control. - Setting it may lead to unpredictable results. - - - The Index property is used internally. - - - - - Sets/gets the min width to which the pane can be resized - - - - - Sets/gets the max width to which the pane can be resized - - - - - Sets/gets the min height to which the pane can be resized - - - - - Sets/gets the max height to which the pane can be resized - - - - - Sets/gets whether the content of the pane will get a scrollbars when it exceeds the pane area size - - - - - Gets or sets a value indicating the client-side event handler that is called when - the RadPane is collapsed. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - If specified, the OnClientCollapsed - client-side event handler is called when the RadPane - is collapsed. Two parameters are passed to the handler: - - event, the event object; - eventArgs with one property, paneObj (the - instance of the RadPane). - - This event cannot be cancelled. - - - The following example demonstrates how to use the - OnClientCollapsed property. - -
- <script type="text/javascript">
- function OnClientCollapsedHandler(sender, eventArgs)
- {
- alert(eventArgs.paneObj.ID);
- }
- </script> -
-
- <radspl:RadPane ID="RadPane1"
- runat= "server"
- OnClientCollapsed="OnClientCollapsedHandler">
- ....
- </radspl:RadPane> -
-
-
-
- - - Gets or sets a value indicating the client-side event handler that is called before - the RadPane is collapsed. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - If specified, the OnClientBeforeCollapse - client-side event handler is called before the RadPane - is collapsed. Two parameters are passed to the handler: - - event, the event object; - eventArgs with one property, paneObj (the - instance of the RadPane). - - This event can be cancelled. - - - The following example demonstrates how to use the - OnClientBeforeCollapse property. - -
- <script type="text/javascript">
- function OnClientBeforeCollapseHandler(sender, eventArgs)
- {
- alert(eventArgs.paneObj.ID);
- return true;//false to cancel the event
- }
- </script> -
-
- <radspl:RadPane ID="RadPane1"
- runat= "server"
- OnClientBeforeCollapse="OnClientBeforeCollapseHandler">
- ....
- </radspl:RadPane> -
-
-
-
- - - Gets or sets a value indicating the client-side event handler that is called when - the RadPane is expanded. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - If specified, the OnClientExpanded - client-side event handler is called when the RadPane - is expanded. Two parameters are passed to the handler: - - event, the event object; - eventArgs with one property, paneObj (the - instance of the RadPane). - - This event cannot be cancelled. - - - The following example demonstrates how to use the - OnClientExpanded property. - -
- <script type="text/javascript">
- function OnClientExpandedHandler(sender, eventArgs)
- {
- alert(eventArgs.paneObj.ID);
- }
- </script> -
-
- <radspl:RadPane ID="RadPane1"
- runat= "server"
- OnClientExpanded="OnClientExpandedHandler">
- ....
- </radspl:RadPane> -
-
-
-
- - - Gets or sets a value indicating the client-side event handler that is called before - the RadPane is expanded. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - If specified, the OnClientBeforeExpand - client-side event handler is called before the RadPane - is expanded. Two parameters are passed to the handler: - - event, the event object; - eventArgs with one property, paneObj (the - instance of the RadPane). - - This event can be cancelled. - - - The following example demonstrates how to use the - OnClientBeforeExpand property. - -
- <script type="text/javascript">
- function OnClientBeforeExpandHandler(sender, eventArgs)
- {
- alert(eventArgs.paneObj.ID);
- return true;//false to cancel the event
- }
- </script> -
-
- <radspl:RadPane ID="RadPane1"
- runat= "server"
- OnClientBeforeExpand="OnClientBeforeExpandHandler">
- ....
- </radspl:RadPane> -
-
-
-
- - - Gets or sets a value indicating the client-side event handler that is called when - the RadPane is resized. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - If specified, the OnClientResized - client-side event handler is called when the RadPane - is resized. Two parameters are passed to the handler: - - event, the event object; - eventArgs with the following properties: - - paneObj - the pane object that has been resized - oldWidth - the width of the pane before the resize - oldHeight - the height of the pane before the resize - newWidth - the current pane width - newHeight - the current pane height - - - - This event cannot be cancelled. - - - The following example demonstrates how to use the - OnClientResized property. - -
- <script type="text/javascript">
- function OnClientResizedHandler(sender, eventArgs)
- {
- alert(eventArgs.paneObj.ID);
- }
- </script> -
-
- <radspl:RadPane ID="RadPane1"
- runat= "server"
- OnClientResized="OnClientResizedHandler">
- ....
- </radspl:RadPane> -
-
-
-
- - - Gets or sets a value indicating the client-side event handler that is called before - the RadPane is resized. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - If specified, the OnClientBeforeResize - client-side event handler is called before the RadPane - is resized. Two parameters are passed to the handler: - - event, the event object; - eventArgs with the following properties: - - paneObj - the pane object that will be resized - delta - the delta with which the pane will be resized - direction - the direction in which the pane will be resized. You can use the Telerik.Web.UI.SplitterDirection hash to check the direction. The 2 possible values are : Forward and Backward - - - - This event can be cancelled. - - - The following example demonstrates how to use the - OnClientBeforeResize property. - -
- <script type="text/javascript">
- function OnClientBeforeResizeHandler(sender, eventArgs)
- {
- alert(eventArgs.paneObj.ID);
- return true;//false to cancel the event
- }
- </script> -
-
- <radspl:RadPane ID="RadPane1"
- runat= "server"
- OnClientBeforeResize="OnClientBeforeResizeHandler">
- ....
- </radspl:RadPane> -
-
-
-
- - - Sets/gets whether the scrolls position will be persisted acrosss postbacks - - - - - Get the expanded Size of the pane, when the pane is collapsed. - In case the Orientation of the splitter is Vertical, returns the expanded Height, otherwise, the expanded Width. - - - - - Set the expanded Size of the pane, when the pane is collapsed. - In case the Orientation of the splitter is Vertical, sets the expanded Height, otherwise, the expanded Width. - - - - - - - - - - - - - - - - - Sets/gets whether the pane is collapsed - - - - - Sets/gets whether the pane is locked - - - - - The URL of the page to load inside the pane. - - - Use the ContentUrl property if you want to load external page - into the pane content area. - - - - - Get/Set the Width of the pane. - - - - - Get/Set the Height of the pane. - - - - - Reference to the parent Splitter object - - - - - - - - - - - - - - - - - Sets/gets the min height to which the pane can be resized - - - - - Sets/gets the height of the sliding pane - - - - - Sets/gets the min width to which the pane can be resized - - - - - Sets/gets the width of the sliding pane - - - - - Sets/gets whether the resize bar will be active - - - - - Gets or sets the path to an image to display for the item. - - - - - Sets/gets way the tab of the pane is rendered - - - - - Sets/gets whether the pane can be docked - - - - - The title that will be displayed when the pane is docked/docked - - - - - Gets or sets the text for resize bar - - - - - Gets or sets the text for undock image - - - - - Gets or sets the text for dock image - - - - - Gets or sets the text for collapse image - - - - - Gets or sets a value indicating the client-side event handler that is called when - the RadSlidingPane is docked. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - If specified, the OnClientDocked - client-side event handler is called when the RadSlidingPane - is docked. Two parameters are passed to the handler: - - event, the event object; - eventArgs with one property, paneObj (the - instance of the RadSlidingPane). - - This event cannot be cancelled. - - - The following example demonstrates how to use the - OnClientDocked property. - -
- <script type="text/javascript">
- function OnClientDockedHandler(sender, eventArgs)
- {
- alert(eventArgs.paneObj.ID);
- }
- </script> -
-
- <radspl:RadSlidingPane ID="RadSlidingPane1"
- runat= "server"
- OnClientDocked="OnClientDockedHandler">
- ....
- </radspl:RadSlidingPane> -
-
-
-
- - - Gets or sets a value indicating the client-side event handler that is called when - the RadSlidingPane is undocked. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - If specified, the OnClientUndocked - client-side event handler is called when the RadSlidingPane - is docked. Two parameters are passed to the handler: - - event, the event object; - eventArgs with one property, paneObj (the - instance of the RadSlidingPane). - - This event cannot be cancelled. - - - The following example demonstrates how to use the - OnClientUndocked property. - -
- <script type="text/javascript">
- function OnClientUndockedHandler(sender, eventArgs)
- {
- alert(eventArgs.paneObj.ID);
- }
- </script> -
-
- <radspl:RadSlidingPane ID="RadSlidingPane1"
- runat= "server"
- OnClientUndocked="OnClientUndockedHandler">
- ....
- </radspl:RadSlidingPane> -
-
-
-
- - - Gets or sets a value indicating the client-side event handler that is called before - the RadSlidingPane is docked. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - If specified, the OnClientBeforeDock - client-side event handler is called before the RadSlidingPane - is docked. Two parameters are passed to the handler: - - event, the event object; - eventArgs with the following properties: - - paneObj - the pane object that will be docked - - - - This event can be cancelled. - - - The following example demonstrates how to use the - OnClientBeforeDock property. - -
- <script type="text/javascript">
- function OnClientBeforeDockHandler(sender, eventArgs)
- {
- alert(eventArgs.paneObj.ID);
- return true;//false to cancel the event
- }
- </script> -
-
- <radspl:RadSlidingPane ID="RadSlidingPane1"
- runat= "server"
- OnClientBeforeDock="OnClientBeforeDockHandler">
- ....
- </radspl:RadSlidingPane> -
-
-
-
- - - Gets or sets a value indicating the client-side event handler that is called before - the RadSlidingPane is undocked. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - If specified, the OnClientBeforeUndock - client-side event handler is called before the RadSlidingPane - is undocked. Two parameters are passed to the handler: - - event, the event object; - eventArgs with the following properties: - - paneObj - the pane object that will be undocked - - - - This event can be cancelled. - - - The following example demonstrates how to use the - OnClientBeforeUndock property. - -
- <script type="text/javascript">
- function OnClientBeforeUndockHandler(sender, eventArgs)
- {
- alert(eventArgs.paneObj.ID);
- return true;//false to cancel the event
- }
- </script> -
-
- <radspl:RadSlidingPane ID="RadSlidingPane1"
- runat= "server"
- OnClientBeforeUndock="OnClientBeforeUndockHandler">
- ....
- </radspl:RadSlidingPane> -
-
-
-
- - - Reference to the parent SlidingZone object - - - - - Gets the collection of child items in the RadSplitter - control. - - - A SplitterItemsCollection that represents the children within - the RadSplitter control. The default is empty collection. - - - Use this property to retrieve the child items of the RadSplitter - control. You can also use it to programmatically add or remove items. - - - The following example demonstrates how to programmatically add items. - - void Page_Load(object sender, EventArgs e) - { - if (!Page.IsPostBack) - { - RadPane pane1 = new RadPane(); - RadSplitter1.Items.Add(pane1); - - RadSplitbar splitBar1 = new RadSplitBar(); - RadSplitter1.Items.Add(splitBar1); - - RadPane pane2 = new RadPane(); - RadSplitter1.Items.Add(pane2); - } - } - - - Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Load - If Not Page.IsPostBack Then - Dim pane1 As RadPane = New RadPane() - RadSplitter1.Items.Add(pane1) - - Dim splitBar1 As RadSplitbar = New RadSplitBar() - RadSplitter1.Items.Add(splitBar1) - - Dim pane2 As RadPane = New RadPane() - RadSplitter1.Items.Add(pane2) - - End If - End Sub - - - - - - - - - - - - - - - - - - - - - - Sets/gets the height of the sliding zone - - - - - Sets/gets the width of the sliding zone - - - - - Sets/gets whether the pane should be clicked in order to open - - - - - Sets/gets the id of the pane that is will be displayed docked - - - - - Sets/gets the id of the pane that is will be expanded - - - - - Sets/gets the direction in which the panes will slide - - - - - Sets/gets the step in px in which the resize bar will be moved when dragged. - - - - - Sets/gets the duration of the slide animation in milliseconds. - - - - - Gets or sets a value indicating the client-side event handler that is called when - the RadSlidingZone control is initialized. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - If specified, the OnClientLoaded - client-side event handler is called when the RadSlidingZone - is initialized. Two parameters are passed to the handler: - - event, the event object; - eventArgs with one property, slidingZoneObj (the - instance of the RadSlidingZone object). - - This event cannot be cancelled. - - - The following example demonstrates how to use the - OnClientLoaded property. - -
- <script type="text/javascript">
- function OnSlidingZoneLoadHandler(sender, eventArgs)
- {
- alert(eventArgs.slidingZoneObj.ID);
- }
- </script> -
-
- <radspl:RadSlidingZone ID="RadSlidingZone1"
- runat= "server"
- OnClientLoaded="OnSlidingZoneLoadHandler">
- ....
- </radspl:RadSlidingZone> -
-
-
-
- - - Reference to the parent Splitter object - - - - - - - - - - - - - - - - - - - - - Sets/gets the collapse mode of the splitbar - - - - - Sets/gets whether the resize bar will be active - - - - - Sets/gets the step in px in which the resize bar will be moved when dragged. - - - - - Reference to the parent Splitter object - - - - - Gets or sets the text for collapse bar images - - - - - Specifies the collapse mode of a splitbar - - - - - No collapse is available - - 1 - - - - Forward collapse availalbe only - - 2 - - - - Backward collapse availalbe only - - 3 - - - - Both - forward and backward collapse available - - 4 - - - - telerik RadSplitter is a flexible UI component for ASP.NET applications which allows users to manage effectively the content size and layout. - - - - - - - - - - - - - - - - - - - - - Sets/gets the pixels that should be substracted from the splitter height when its height is defined in percent - - - - - Resize the splitter in 100% of the page - - - - - Whether the Splitter should be visible during its initialization or not - - - - - Sets/gets the height of the splitter - - - - - Sets/gets the width of the splitter - - - - - Sets/gets whether the rendering of the splitter panes is previewed during the resize - - - - - Sets/gets whether the splitter will be resized when the browser window is resized. The Width or Height properties should be defined in percent. - - - - - Sets/gets whether the splitter will resize when the parent pane is resized - - - - - Specify the orientation of the panes inside the splitter - - - - - Set/Get the way the panes are resized - - - - - Set/Get size of the splitter border - - - - - Set/Get size of the splitter panes border - - - - - Set/Get size of the split bars - in pixels - - - - - Gets or sets a value indicating the client-side event handler that is called when - the RadSplitter control is initialized. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - If specified, the OnClientLoaded - client-side event handler is called when the RadSplitter - is initialized. Two parameters are passed to the handler: - - event, the event object; - eventArgs with one property, splitterObj (the - instance of the RadSplitter object). - - This event cannot be cancelled. - - - The following example demonstrates how to use the - OnClientLoaded property. - -
- <script type="text/javascript">
- function OnSplitterLoadHandler(sender, eventArgs)
- {
- alert(eventArgs.splitterObj.ID);
- }
- </script> -
-
- <radspl:RadSplitter ID="RadSplitter1"
- runat= "server"
- OnClientLoaded="OnSplitterLoadHandler">
- ....
- </radspl:RadSplitter> -
-
-
-
- - - Gets or sets a value indicating the client-side event handler that is called when - the RadSplitter is resized. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - If specified, the OnClientResized - client-side event handler is called when the RadSplitter - is resized. Two parameters are passed to the handler: - - event, the event object; - eventArgs with the following properties: - - splitterObj - the splitter object that has been resized - oldWidth - the width of the splitter before the resize - oldHeight - the height of the splitter before the resize - newWidth - the current splitter width - newHeight - the current splitter height - - - - This event cannot be cancelled. - - - The following example demonstrates how to use the - OnClientResized property. - -
- <script type="text/javascript">
- function OnClientResizedHandler(sender, eventArgs)
- {
- alert(eventArgs.splitterObj.ID);
- }
- </script> -
-
- <radspl:RadSplitter ID="RadSplitter1"
- runat= "server"
- OnClientResized="OnClientResizedHandler">
- ....
- </radspl:RadSplitter> -
-
-
-
- - - Gets or sets a value indicating the client-side event handler that is called before - the RadSplitter is resized. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - If specified, the OnClientBeforeResize - client-side event handler is called before the RadSplitter - is resized. Two parameters are passed to the handler: - - event, the event object; - eventArgs with the following properties: - - splitterObj - the splitter object that will be resized - newWidth - the new width that will be applied to the RadSplitter object - newHeight - the new height that will be applied to the RadSplitter object - - - - This event can be cancelled. - - - The following example demonstrates how to use the - OnClientBeforeResize property. - -
- <script type="text/javascript">
- function OnClientBeforeResizeHandler(sender, eventArgs)
- {
- alert(eventArgs.splitterObj.ID);
- return true;//false to cancel the event
- }
- </script> -
-
- <radspl:RadSplitter ID="RadSplitter1"
- runat= "server"
- OnClientBeforeResize="OnClientBeforeResizeHandler">
- ....
- </radspl:RadSplitter> -
-
-
-
- - - Specifies the collapse direction options of the splitter bar - - - - - On collapse the current pane is collapsed - - 1 - - - - On collapse the next pane is resized - - 2 - - - - A collection of SplitterItem objects in a - RadSplitter control. - - - The SplitterItemsCollection class represents a collection of - SplitterItem objects. The SplitterItem objects in turn represent - panes items within a RadSplitter control. - - - Use the indexer to programmatically retrieve a - single SplitterItem from the collection, using array notation. - - - Use the Count property to determine the total - number of panes in the collection. - - - Use the Add method to add panes in the collection. - - - Use the Remove method to remove panes from the - collection. - - - - - - - Initializes a new instance of the SplitterItemsCollection class. - Use the constructor to create a new SplitterItemsCollection class. - The container of the collection. - - - Appends a SplitterItem to the end of the collection. - - The following example demonstrates how to programmatically add items in a - RadSplitter control. - - RadPane pane = new RadPane(); - - RadMenu1.Panes.Add(pane); - - - Dim pane As RadPane = New RadPane() - - RadMenu1.Panes.Add(pane) - - - - - - - - - - Inserts the specified SplitterItem in the collection at the specified - index location. - - - Use the Insert method to add a SplitterItem to the collection at - the index specified by the index parameter. - - The location in the collection to insert the SplitterItem. - The SplitterItem to add to the collection. - - - - - - - - Determines the index value that represents the position of the specified - SplitterItem in the collection. - - - The zero-based index position of the specified SplitterItem in the - collection. - - - Use the IndexOf method to determine the index value of the - SplitterItem specified by the item parameter in the collection. If an item - with this criteria is not found in the collection, -1 is returned. - - A SplitterItem to search for in the collection. - - - - - - - - Determines whether the collection contains the specified - SplitterItem. - - - true if the collection contains the specified item; otherwise, - false. - - - Use the Contains method to determine whether the SplitterItem - specified by the item parameter is in the collection. - - A SplitterItem to search for in the collection. - - - - - - - Removes the specified SplitterItem from the collection. - - Use the Remove method to remove a SplitterItem from the - collection. - - - The following example demonstrates how to programmatically remove a SplitterItem from a - RadSplitter control. - - RadPane pane = RadSplitter1.GetPaneById("pane1"); - if (pane != null) - { - RadSplitter1.Panes.Remove(pane); - } - - - Dim pane As RadPane = RadSplitter1.GetPaneById("pane1") - If Not pane Is Nothing Then - RadSplitter1.Panes.Remove(pane) - End If - - - - - - - - - Removes the SplitterItem at the specified index from the collection. - - Use the RemoveAt method to remove the SplitterItem at the - specified index from the collection. - - The index of the SplitterItem to remove. - - - Removes all items from the collection. - - Use the Clear method to remove all items from the collection. The - Count property is set to 0. - - - - - - Gets a SplitterItem at the specified index in the collection. - - - - Use this indexer to get a SplitterItem from the collection at the - specified index, using array notation. - - - The zero-based index of the SplitterItem to retrieve from the - collection. - - - - - Specifies the scrolling options for the RadPane object - - - - - Both X and Y scrolls are displayed - - 1 - - - - Only the scroll on X dimension is displayed - - 2 - - - - Only the scroll on Y dimension is displayed - - 3 - - - - No scrolls are displayed - - 1 - - - - Specifies resize mode options for the RadSplitter object - - - - - On resize of a pane the adjacent pane is resized also - - 1 - - - - On resize of a pane the other panes are resize proportionaly - - 2 - - - - On resize of a pane the end pane in the splitter is resized also - - 3 - - - - Specifies the available directions for the slide panes - - - - - Slide panes are sliding from left to right - - 1 - - - - Slide panes are sliding from right to left - - 2 - - - - Slide panes are sliding from top to bottom - - 3 - - - - Slide panes are sliding from bottom to top - - 4 - - - - Specifies views of the pane tab - - - - - Pane tab is displayed using its Title and Icon - - 1 - - - - Pane tab is displayed using only its Title - - 2 - - - - Pane tab is displayed using only its Icon - - 3 - - - - - - - - This class holds a reference to a single updated control and the loading panel to - display. - - - - - A constructor of AjaxUpdatedControl which takes the control to be updated and the - id of the loading panel to display as parameters. - - - - The default constructor of the AjaxUpdatedControl class. - - - The ID of the web control that is to be updated. - - - - The ID of the RadAjaxLoadingPanel to be displayed during the update of the - control. - - - - A collection of the controls that are updated by the AjaxManager. - - - Adds an item to the collection - - - Removes the specified item from the collection - - - Checks wether the collection contains the specified item. - - - Gets the index of the specified item in the collection. - - - Inserts an item at the specified index in the collection. - - - The default indexer of the collection. - - - - Represents a single AjaxManager setting - a mapping between a control that - initiates an AJAX request and a collection of controls to be updated by the - operation. - - - - Default constructor for the AjaxSetting class. - - - - A constructor for AjaxSetting taking the ClientID of the control initiating the - AJAX request. - - - - - This field holds the control id of the control that can initiate an - AJAX request. - - - - Corresponds to the EventName property of the internally created AsyncPostBackTrigger. - - - A collection of controls that will be updated by the AjaxManager - - - - Summary description for ConfiguredControls. - - - - The default constructor for AjaxSettingsCollection class. - - - - This method adds a new AjaxSetting to the collection by building one from its - parameters. - - The web control to be ajaxified (the initiator of the AJAX request) - The web control that has to be updated. - - - Adds an item to the collection. - An instance of AjaxSetting to be added. - - - Removes an item from the collection. - An instance of AjaxSetting to be removed - - - Checks wether the item is present in the collection. - An instance of AjaxSetting - - - Determines the index of the specified item. - An instance of AjaxSetting - - - Inserts an item at the specificed index in the collection. - An instance of AjaxSetting - - - Default indexer for the collection. - - - Redirects the page to another location. - None. - - This method is usually used in the AJAX event handler instead of - Response.Redirect(). It provides the only way to redirect to a page which does not - contain any AJAX control at all. - - - The following code redirects from a button's click event handler. Note the control - should be ajaxified in order redirection to work. - - private void Button1_Click(object sender, System.EventArgs e) - { - RadAjaxManager1.Redirect("support.aspx"); - } - - - Private Sub Button1_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles Button1.Click - RadAjaxManager1.Redirect("support.aspx") - End Sub 'Button1_Click - - - - - Displays an alert message at client-side. - None. - - This is the easiest way to show a message, generated from the server, on the - client in a message box. - Note: Special characteres are not escaped. - - - The following example illustrates a sample usage of the Alert - method. - - private void Button1_Click(object sender, System.EventArgs e) - { - if (!UserAccessAllowed(UserProfile)) - { - RadAjaxManager1.Alert("You are not allowed to access this user control!"); - } - else - { - LoadSecretControl(); - } - } - - - Private Sub Button1_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles Button1.Click - If Not UserAccessAllowed(UserProfile) Then - RadAjaxManager1.Alert("You are not allowed to access this user control!") - Else - LoadSecretControl() - End If - End Sub 'Button1_Click - - - - - - Gets client side code which raises an AjaxRequest event in either AJAX Manager or - AJAX Panel. - - - - private void Page_Load(object sender, System.EventArgs e) - { - // Create a generic AJAX Request when the button is clicked. - // "return false" to prevent postbacks - Button1.Attributes["onclick"] = RadAjaxPanel1.GetAjaxEventReference("argument...") + " return false;"; - // Generic requests can be fired on both AJAX Manager and AJAX Panel - Button1.Attributes["onclick"] = RadAjaxManager1.GetAjaxEventReference("argument...") + " return false;"; - } - - - Private Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles Page.Load - ' Create a generic AJAX Request When the button Is clicked. - ' "return false" To prevent postbacks - Button1.Attributes["onclick"] = RadAjaxPanel1.GetAjaxEventReference("argument...") & " return false;" - ' Generic requests can be fired On both AJAX Manager And AJAX Panel - Button1.Attributes["onclick"] = RadAjaxManager1.GetAjaxEventReference("argument...") & " return false;" - End Sub - - - - - - Sets focus to the specified web control after the AJAX Request is - finished. - - - - - Sets focus to the specified web control after the AJAX Request is - finished. - - - - - Gets or sets the value, indicating whether to render script references to the embedded scripts or not. - - - - If EnableEmbeddedScripts is set to false you will have to register the needed Scripts files by hand. - - - - - - Enables browser back/forward buttons state (browser history). - Please, review the RadAjax "Changes and backwards compatibility" - "Back and Forward buttons" article for more info. - - - - - By design ASP.NET AJAX Framework cancels the ongoing ajax request if you try to initiate another one prior to receiving the response for the first request. - By setting the RequestQueueSize property to a value greater than zero, you are enabling the queuing mechanism of RadAjax - that will allow you to complete the ongoing request and then initiate the pending requests in the control queue. - - - If the queue is full (queue size equals RequestQueueSize), an attempt for new ajax request will be discarded. - - - The default value is 0 (queuing disabled). - - - - - This enumeration defines the possible positions of the RadAjaxLoadingPanel background - image. This property matters only if the Skin property is set. The default value is Center. - - - - - Registers the CSS references - - - - - Returns the names of all embedded skins. Used by Telerik.Web.Examples. - - - - - - - - - Gets or sets the value, indicating whether to render script references to the embedded scripts or not. - - - - If EnableEmbeddedScripts is set to false you will have to register the needed Scripts files by hand. - - - - - - - - - - Gets or sets transparency in percentage. Default value is 0 percents. - - - - - Defines whether the transparency set in the skin will be applied. - Default value is True. - - - - - Gets or sets the z-index of the loading panel. Default value is 90,000. - - - - - Gets or sets the position of the skin background image. Default value is center. - - - - - The IsSticky property of the Loading Panel controls where - the panel will appear during the AJAX request. If this property is set to - true, the panel will appear where you have placed it on your - webform. If this property is set to false, the Loading panel will - appear on the place of the updated control(s). - By default this property is set to false. - - - - - Gets or sets a value specifying the delay in milliseconds, after which the - RadAjaxLoadingPanel will be shown. If the request returns before this time, - the RadAjaxLoadingPanel will not be shown. - - - - - Gets or sets a value that specifies the minimum time in milliseconds that the - RadAjaxLoadingPanel will last. The control will not be updated before this - period has passed even if the request returns. This will ensure more smoother interface - for your page. - - - - Gets or sets the skin name for the control user interface. - A string containing the skin name for the control user interface. The default is string.Empty. - - - If this property is not set, the control will not use any skin (backwards compatibility) - If EnableEmbeddedSkins is set to false, the control will not register a skin CSS file automatically. - - - - - - For internal use. - - - - Gets or sets the value, indicating whether to render links to the embedded skins or not. - - - If EnableEmbeddedSkins is set to false you will have to register the needed CSS files by hand. - - - - - Gets or sets the value, indicating whether to render the link to the embedded base stylesheet of the control or not. - - - If EnableEmbeddedBaseStylesheet is set to false you will have to register the needed control base CSS file by hand. - - - - - - Gets the real skin name for the control user interface. If Skin is not set, returns - an empty string, otherwise returns Skin. - - - - Gets or sets the value, indicating whether to render the skin CSS files during Ajax requests - - - If EnableAjaxSkinRendering is set to false you will have to register the needed control base CSS file by hand when adding/showing the control with Ajax. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - This class is required as a base class for any page that hosts a - RadAjaxManager control and runs under Medium trust privileges. - - Inheriting from RadAjaxPage is not required if you run under Full trust. - - - - This property specifies the layout of the AjaxPanel. When this is set to FALSE, - the AjaxPanel contents will not be wrapped to a new line no matter how wide the control - is. - - - - - This property specifies the horizontal alignment of the RadAjaxPanel - contents. - - - - - This property specifies the image that should be displayed as background in the - AjaxPanel. If left blank, no background image is applied. - - - - - Summary description for CalendarDayCollection. - - - - - IClientData is used to provide a standard way of generating data output from a component, - which will be processed and streamed thereafter to the client. - - - - - gets the data that is required on the client. The returned ArrayList should be processed - further and serialized as clientside array of values. - - ArrayList with the properties to serialize to the client. - - - - Adds a RadCalendarDay object to the collection of CalendarDays. - - The RadCalendarDay object to add to the collection. - - - - Returns a zero based index of a RadCalendarDay object depending on the passed index. - - The zero-based index, RadCalendarDay object or the date represented by the searched RadCalendarDay object. - A zero based index of the RadCalendarDay object in the collection, or -1 if the RadCalendarDay object is not found. - - - - Adds a RadCalendarDay object in the collection at the specified index. - - The index after which the RadCalendarDay object is inserted. - The RadCalendarDay object to insert. - - - - Deletes a RadCalendarDay object from the collection. - - The RadCalendarDay object to remove. - - - - Deletes the RadCalendarDay object from the collection at the specified index. - - The index in collection at which the RadCalendarDay object will be deleted. - - - - Removes all RadCalendarDay objects in the collection of CalendarDays. - - - - - Checks whether a specific RadCalendarDay object is in the collection of CalendarDays. - - The RadCalendarDay object to search. - True if the RadCalendarDay is found, false otherwise. - - - - - Copies the elements of CalendarDayCollection to a new - of elements. - - A one-dimensional of - elements containing copies of the elements of the . - Please refer to for details. - - - - Please refer to for details. - - - - - Returns a RadCalendarDay object depending on the passed index. - Only integer and string indexes are valid. - - - - - Summary description for DayTemplatess. - - - - - Summary description for CalendarViewCollection. - - - - - Adds a CalendarView object to the collection of CalendarDays. - - The CalendarView object to add to the collection. - - - - Returns a zero based index of a CalendarView object depending on the passed index. - - The zero-based index, CalendarView object or the date represented by the searched CalendarView object. - A zero based index of the CalendarView object in the collection, or -1 if the CalendarView object is not found. - - - - Adds a CalendarView object in the collection at the specified index. - - The index after which the CalendarView object is inserted. - The CalendarView object to insert. - - - - Deletes a CalendarView object from the collection. - - The CalendarView object to remove. - - - - Deletes the CalendarView object from the collection at the specified index. - - The index in collection at which the CalendarView object will be deleted. - - - - Removes all CalendarView objects in the collection of CalendarDays. - - - - - Checks whether a specific CalendarView object is in the collection of CalendarDays. - - The CalendarView object to search. - True if the CalendarView is found, false otherwise. - - - - - Copies the elements of CalendarViewCollection to a new - of elements. - - A one-dimensional of - elements containing copies of the elements of the . - Please refer to for details. - - - - Please refer to for details. - - - - - Returns a CalendarView object depending on the passed index. - Only integer and string indexes are valid. - - - - - Adds a DateTime object to the collection of CalendarDays. - - The RadDate object to add to the collection. - - - - Returns a zero based index of a DateTime object depending on the passed index. - - The zero-based index, DateTime object or the date represented by the searched DateTime object. - A zero based index of the DateTime object in the collection, or -1 if the DateTime object is not found. - - - - Adds a DateTime object in the collection at the specified index. - - The index after which the DateTime object is inserted. - The DateTime object to insert. - - - - Deletes a DateTime object from the collection. - - The DateTime object to remove. - - - - Deletes the DateTime object from the collection at the specified index. - - The index in collection at which the DateTime object will be deleted. - - - - Removes all DateTime objects in the collection of CalendarDays. - - - - - Checks whether a specific DateTime object is in the collection of CalendarDays. - - The DateTime object to search. - True if the DateTime is found, false otherwise. - - - - - Copies the elements of DateTimeCollection to a new - of elements. - - A one-dimensional of - elements containing copies of the elements of the . - Please refer to for details. - - - - Please refer to for details. - - - - - Returns a DateTime object depending on the passed index. - Only integer and string indexes are valid. - - - - - Summary description for Constants. - - - - - For internal use only. - - - - - - - Base class based on the PropertyBag implementation, which descends from WebControl class. - - - - - Implements the PropertyBag class that is the foundation for building Telerik RadCalendar and - handles properties values.Used by the ViewState mechanism also. - - - - - Create controls from template, fill ContentPanes and add them to Controls collection. - - - - - This method supports the Telerik RadCalendar infrastructure and - is not intended to be used directly from your code. - - - - - Recursively searches for a control with the specified id in the passed controls collection. - - The id of the control to look for. - The current Controls collection to search in. - The found control or null if nothing was found. - - - - When using templates, their content is instantiated and "lives" inside the - Controls - collection of RadCalendar class. To access the controls instantiated from the - templates they must be found using this method (RadCalendar implements - INamingContainer interface). - - Reference to the found control or null if no control was found. - The ID of the searched control. - - - - Restores view-state information from a previous page request that was saved by the SaveViewState method. - - The saved view state. - - - - Saves any server control view-state changes that have occurred since the time the page was posted back to the server. - - The saved view state. - - - - Gets or sets the - MonthYearFastNavigationSettings - object whose inner properties can be used to modify the fast Month/Year client - navigation settings. - - MonthYearFastNavigationSettings - - - - Returns whether RadCalendar is currently in design mode. - - - - Gets or sets default path for the grid images when EnableEmbeddedSkins is set to false. - A string containing the path for the grid images. The default is string.Empty. - - - - - - - - - - Gets or sets the Cascading Style Sheet (CSS) class rendered by the Web server - control on the client. - - - The CSS class rendered by the Web server control on the client. The default is - calendarWrapper_[skin name]. - - - - - Gets or sets a collection of type - - CalendarDayTemplateCollection which stores the created templates to use with - RadCalendar. All of the - items are represented by - DayTemplate - instances. - - - - - Gets the instance of - - CalendarClientEvents class which defines the JavaScript functions (client-side - event handlers) that are invoked when specific client-side events are raised. - - - - - Gets or sets whether the repeatable days logic should be supported on the client - (effective for client calendar - with set property - AutoPostBack="false"). - - - true, if the repeatable days logic should be supported on the - client; otherwise, false. The default value is - true. - - - The EnableRepeatableDaysOnClient property has effect over the - logic of the recurring events to the calendar. It should be true, if you wants the - repeatable days to be supported by a calendar with AutoPostBack="false". If you are not - using repeatable days or/and client calendar, you can improve the calendar performance - by setting it to false. - - SpecialDays Property - - - - Gets or sets the format string that will be applied to the dates presented in the - calendar area. - - - For additional details see Date Format Pattern - topic - - - - - Gets or sets the the count of rows to be displayed by a single - CalendarView. - - - If the calendar represents a multi view, this property applies to the child views - inside the multi view. - - - - - Gets or sets the the count of columns to be displayed by a single - CalendarView. - - - If the calendar represents a multi view, this property applies to the child views - inside the multi view. - - - - - Gets or sets the Width applied to a single - CalendarView. - - - If the calendar represents a multi view, this property applies to the child views - inside the multi view. - - - - - Gets or sets the Height applied to a single - CalendarView. - - - If the calendar represents a multi view, this property applies to the child views - inside the multi view. - - - - - Gets or sets the predefined pairs of rows and columns, so that the product of - the two values is exactly 42, which guarantees valid calendar layout. It is applied - on a single view level to every - MonthView - instance in the calendar. - - - The following values are applicable and defined in the MonthLayout - enumeration:
-
- Layout_7columns_x_6rows - horizontal layout
-
- Layout_14columns_x_3rows - horizontal layout
-
- Layout_21columns_x_2rows - horizontal layout
-
- Layout_7rows_x_6columns - vertical layout, required when - UseDaysAsSelectors - is true and - Orientation - is set to - - RenderInColumns.
-
- Layout_14rows_x_3columns - vertical layout, required when - UseDaysAsSelectors - is true and - Orientation - is set to - - RenderInColumns.
-
- Layout_21rows_x_2columns - vertical layout, required when - UseDaysAsSelectors - is true and - Orientation - is set to - - RenderInColumns.
-
-
- - - Gets or sets the horizontal alignment of the date cells content inside the - calendar area. - The HorizontalAlign enumeration is defined in - System.Web.UI.WebControls - - - - - - Member name - - - Description - - - - - Center - - The contents of a container are centered. - - - Justify - The contents of a container are uniformly spread out and - aligned with both the left and right margins. - - - Left - The contents of a container are left justified. - - - NotSet - The horizontal alignment is not set. - - - Right - The contents of a container are right justified. - - - - - - - Gets or sets the vertical alignment of the date cells content inside the - calendar area. - The VerticalAlign enumeration is defined in - System.Web.UI.WebControls - - - - - Member name - Description - - - Bottom - Text or object is aligned with the bottom of the enclosing - control. - - - Middle - Text or object is aligned with the center of the enclosing - control. - - - NotSet - Vertical alignment is not set. - - - Top - Text or object is aligned with the top of the enclosing - control. - - - - - - - Gets or sets the the count of rows to be displayed by a multi month - CalendarView. - - - - - Gets or sets the the count of columns to be displayed by a multi month - CalendarView. - - - - - Gets or sets the maximum date valid for selection by - Telerik RadCalendar. Must be interpreted as the Higher bound of the valid - dates range available for selection. Telerik RadCalendar will not allow - navigation or selection past this date. - - - This property has a default value of 12/30/2099 - (Gregorian calendar date). - - - - - Gets or sets the minimal date valid for selection by - Telerik RadCalendar. Must be interpreted as the Lower bound of the valid - dates range available for selection. Telerik RadCalendar will not allow - navigation or selection prior to this date. - - - This property has a default value of 1/1/1980 - (Gregorian calendar date). - - - - - Specifies the day to display as the first day of the week on the - RadCalendar - control. - The FirstDayOfWeek enumeration can be found in - System.Web.UI.WebControls Namespace. - - - The FirstDayOfWeek enumeration represents the values that specify - which day to display as the first day of the week on the - RadCalendar - control. - - - Member name - Description - - - Default - The first day of the week is specified by the system - settings. - - - Friday - The first day of the week is Friday. - - - Monday - The first day of the week is Monday. - - - Saturday - The first day of the week is Saturday. - - - Sunday - The first day of the week is Sunday. - - - Thursday - The first day of the week is Thursday. - - - Tuesday - The first day of the week is Tuesday. - - - Wednesday - The first day of the week is Wednesday. - - - - - - - Sets or returns the currently selected date. The default value is the value of - System.DateTime.MinValue. - - - Use the SelectedDate property to determine the selected date on the - RadCalendar - control. - The SelectedDate property and the - SelectedDates - collection are closely related. When the - EnableMultiSelect - property is set to false, a mode that allows only a single date selection, - SelectedDate and SelectedDates[0] have the same value and - SelectedDates.Count equals 1. When the EnableMultiSelect property is - set to true, mode that allows multiple date selections, SelectedDate - and SelectedDates[0] have the same value. - The SelectedDate property is set using a System.DateTime - object. - When the user selects a date on the RadCalendar control, the - SelectionChanged - event is raised. The SelectedDate property is updated to the selected date. - The SelectedDates collection is also updated to contain just this - date. -
- Note Both the SelectedDate property and the - SelectedDates collection are updated before the SelectionChanged - event is raised. You can override the date selection by using the - OnSelectionChanged event handler to manually set the - SelectedDate property. The SelectionChanged event does not get - raised when this property is programmatically set. -
-
-
- - - Gets or sets the value that is used by - RadCalendar to determine - the viewable area displayed . - - - By default, the FocusedDate property returns the current - system date when in runtime, and in design mode defaults to - System.DateTime.MinValue. When the FocusedDate is - set, from that point, the value returned by the FocusedDate - property is the one the user sets. - - - - - Gets or sets the row index where the - FocusedDate - (and the month view it belongs to) will be positioned inside a multi view area. - - - - - Gets or sets the column index where the - FocusedDate - (and the month view it belongs to) will be positioned inside a multi view area. - - - - - Gets a collection of - RadDate objects (that - encapsulate values of type System.DateTime) that represent the - selected dates on the RadCalendar control. - - - A - - DateTimeCollection that contains a collection of - RadDate objects (that - encapsulate values of type System.DateTime) representing the selected - dates on the RadCalendar control. The default value is an empty - DateTimeCollection. - - - Use the SelectedDates collection to determine the currently selected - dates on the - RadCalendar - control. - The - SelectedDate - property and the SelectedDates collection are closely related. When the - EnableMultiSelect - property is set to false, a mode that allows only a single date selection, - SelectedDate and SelectedDates[0] have the same value and - SelectedDates.Count equals 1. When the - EnableMultiSelect - property is set to true, mode that allows multiple date selections, - SelectedDate and SelectedDates[0] have the same value. - The SelectedDates property stores a collection of - RadDate objects (that - encapsulate values of type System.DateTime). - When the user selects a date or date range (for example with the column or - rows selectors) on the RadCalendar control, the - SelectionChanged - event is raised. The selected dates are added to the SelectedDates - collection, accumulating with previously selected dates. The range of dates are not - sorted by default. The SelectedDate property is also updated to - contain the first date in the SelectedDates collection. - You can also use the SelectedDates collection to programmatically - select dates on the Calendar control. Use the - - Add, - - Remove, - - Clear, and - - SelectRange methods to programmatically manipulate the selected dates in the - SelectedDates collection. -
- Note Both the SelectedDate property and the - SelectedDates collection are updated before the SelectionChanged - event is raised.You can override the dates selection by using the - OnSelectionChanged event handler to manually set the - SelectedDates collection. The SelectionChanged event is not - raised when this collection is programmatically set. -
-
-
- - - Gets or sets an integer value representing the number of - CalendarView - views that will be scrolled when the user clicks on a fast navigation link. - - - - - Specifies the display formats for the days of the week used as selectors by - RadCalendar. - - - Use the DayNameFormat property to specify the name format for the days - of the week. This property is set with one of the DayNameFormat - enumeration values. You can specify whether the days of the week are displayed as - the full name, short (abbreviated) name, first letter of the day, or first two - letters of the day. - The DayNameFormat enumeration represents the display formats for the - days of the week used as selectors by RadCalendar. - - - Member name - Description - - - FirstLetter - The days of the week displayed with just the first letter. For - example, T. - - - FirstTwoLetters - The days of the week displayed with just the first two - letters. For example, Tu. - - - Full - The days of the week displayed in full format. For example, - Tuesday. - - - Short - The days of the week displayed in abbreviated format. For - example, Tues. - - - - - - - Gets or sets a DateTimeFormatInfo instance that defines the - culturally appropriate format of displaying dates and times as specified by the default - culture. - - - A DateTimeFormatInfo can be created only for the invariant - culture or for specific cultures, not for neutral cultures. - The cultures are generally grouped into three sets: the invariant culture, - the neutral cultures, and the specific cultures. - The invariant culture is culture-insensitive. You can specify the invariant - culture by name using an empty string ("") or by its culture identifier 0x007F. - InvariantCulture retrieves an instance of the invariant culture. - It is associated with the English language but not with any country/region. It can - be used in almost any method in the Globalization namespace that requires a - culture. If a security decision depends on a string comparison or a case-change - operation, use the InvariantCulture to ensure that the behavior will be - consistent regardless of the culture settings of the system. However, the invariant - culture must be used only by processes that require culture-independent results, - such as system services; otherwise, it produces results that might be - linguistically incorrect or culturally inappropriate. - A neutral culture is a culture that is associated with a language but not - with a country/region. A specific culture is a culture that is associated with a - language and a country/region. For example, "fr" is a neutral culture and "fr-FR" - is a specific culture. Note that "zh-CHS" (Simplified Chinese) and "zh-CHT" - (Traditional Chinese) are neutral cultures. - The user might choose to override some of the values associated with the - current culture of Windows through Regional and Language Options (or Regional - Options or Regional Settings) in Control Panel. For example, the user might choose - to display the date in a different format or to use a currency other than the - default for the culture. - If UseUserOverride is true and the specified culture - matches the current culture of Windows, the CultureInfo uses those - overrides, including user settings for the properties of the - DateTimeFormatInfo instance returned by the DateTimeFormat property, - the properties of the NumberFormatInfo instance returned by the - NumberFormat property, and the properties of the - CompareInfo instance returned by the CompareInfo - property. If the user settings are incompatible with the culture associated with - the CultureInfo (for example, if the selected calendar is not one of the - OptionalCalendars ), the results of the methods and the values of - the properties are undefined.
-
- Note: In this version of RadCalendar the - NumberFormatInfo instance returned by the - NumberFormat property is not taken into account.
-
-
- - - Gets or sets the CultureInfo instance that represents - information about the culture of this RadCalendar object. - A CultureInfo class describes information about the culture of this - RadCalendar instance including the names of the culture, the writing system, and - the calendar used, as well as access to culture-specific objects that provide - methods for common operations, such as formatting dates and sorting strings. - - - The culture names follow the RFC 1766 standard in the format - "<languagecode2>-<country/regioncode2>", where <languagecode2> is - a lowercase two-letter code derived from ISO 639-1 and <country/regioncode2> - is an uppercase two-letter code derived from ISO 3166. For example, U.S. English is - "en-US". In cases where a two-letter language code is not available, the - three-letter code derived from ISO 639-2 is used; for example, the three-letter - code "div" is used for cultures that use the Dhivehi language. Some culture names - have suffixes that specify the script; for example, "-Cyrl" specifies the Cyrillic - script, "-Latn" specifies the Latin script. - The following predefined CultureInfo names and identifiers are - accepted and used by this class and other classes in the System.Globalization - namespace. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Culture NameCulture IdentifierLanguage-Country/Region
"" (empty string)0x007Finvariant culture
af0x0036Afrikaans
af-ZA0x0436Afrikaans - South Africa
sq0x001CAlbanian
sq-AL0x041CAlbanian - Albania
ar0x0001Arabic
ar-DZ0x1401Arabic - Algeria
ar-BH0x3C01Arabic - Bahrain
ar-EG0x0C01Arabic - Egypt
ar-IQ0x0801Arabic - Iraq
ar-JO0x2C01Arabic - Jordan
ar-KW0x3401Arabic - Kuwait
ar-LB0x3001Arabic - Lebanon
ar-LY0x1001Arabic - Libya
ar-MA0x1801Arabic - Morocco
ar-OM0x2001Arabic - Oman
ar-QA0x4001Arabic - Qatar
ar-SA0x0401Arabic - Saudi Arabia
ar-SY0x2801Arabic - Syria
ar-TN0x1C01Arabic - Tunisia
ar-AE0x3801Arabic - United Arab Emirates
ar-YE0x2401Arabic - Yemen
hy0x002BArmenian
hy-AM0x042BArmenian - Armenia
az0x002CAzeri
az-AZ-Cyrl0x082CAzeri (Cyrillic) - Azerbaijan
az-AZ-Latn0x042CAzeri (Latin) - Azerbaijan
eu0x002DBasque
eu-ES0x042DBasque - Basque
be0x0023Belarusian
be-BY0x0423Belarusian - Belarus
bg0x0002Bulgarian
bg-BG0x0402Bulgarian - Bulgaria
ca0x0003Catalan
ca-ES0x0403Catalan - Catalan
zh-HK0x0C04Chinese - Hong Kong SAR
zh-MO0x1404Chinese - Macau SAR
zh-CN0x0804Chinese - China
zh-CHS0x0004Chinese (Simplified)
zh-SG0x1004Chinese - Singapore
zh-TW0x0404Chinese - Taiwan
zh-CHT0x7C04Chinese (Traditional)
hr0x001ACroatian
hr-HR0x041ACroatian - Croatia
cs0x0005Czech
cs-CZ0x0405Czech - Czech Republic
da0x0006Danish
da-DK0x0406Danish - Denmark
div0x0065Dhivehi
div-MV0x0465Dhivehi - Maldives
nl0x0013Dutch
nl-BE0x0813Dutch - Belgium
nl-NL0x0413Dutch - The Netherlands
en0x0009English
en-AU0x0C09English - Australia
en-BZ0x2809English - Belize
en-CA0x1009English - Canada
en-CB0x2409English - Caribbean
en-IE0x1809English - Ireland
en-JM0x2009English - Jamaica
en-NZ0x1409English - New Zealand
en-PH0x3409English - Philippines
en-ZA0x1C09English - South Africa
en-TT0x2C09English - Trinidad and Tobago
en-GB0x0809English - United Kingdom
en-US0x0409English - United States
en-ZW0x3009English - Zimbabwe
et0x0025Estonian
et-EE0x0425Estonian - Estonia
fo0x0038Faroese
fo-FO0x0438Faroese - Faroe Islands
fa0x0029Farsi
fa-IR0x0429Farsi - Iran
fi0x000BFinnish
fi-FI0x040BFinnish - Finland
fr0x000CFrench
fr-BE0x080CFrench - Belgium
fr-CA0x0C0CFrench - Canada
fr-FR0x040CFrench - France
fr-LU0x140CFrench - Luxembourg
fr-MC0x180CFrench - Monaco
fr-CH0x100CFrench - Switzerland
gl0x0056Galician
gl-ES0x0456Galician - Galician
ka0x0037Georgian
ka-GE0x0437Georgian - Georgia
de0x0007German
de-AT0x0C07German - Austria
de-DE0x0407German - Germany
de-LI0x1407German - Liechtenstein
de-LU0x1007German - Luxembourg
de-CH0x0807German - Switzerland
el0x0008Greek
el-GR0x0408Greek - Greece
gu0x0047Gujarati
gu-IN0x0447Gujarati - India
he0x000DHebrew
he-IL0x040DHebrew - Israel
hi0x0039Hindi
hi-IN0x0439Hindi - India
hu0x000EHungarian
hu-HU0x040EHungarian - Hungary
is0x000FIcelandic
is-IS0x040FIcelandic - Iceland
id0x0021Indonesian
id-ID0x0421Indonesian - Indonesia
it0x0010Italian
it-IT0x0410Italian - Italy
it-CH0x0810Italian - Switzerland
ja0x0011Japanese
ja-JP0x0411Japanese - Japan
kn0x004BKannada
kn-IN0x044BKannada - India
kk0x003FKazakh
kk-KZ0x043FKazakh - Kazakhstan
kok0x0057Konkani
kok-IN0x0457Konkani - India
ko0x0012Korean
ko-KR0x0412Korean - Korea
ky0x0040Kyrgyz
ky-KZ0x0440Kyrgyz - Kazakhstan
lv0x0026Latvian
lv-LV0x0426Latvian - Latvia
lt0x0027Lithuanian
lt-LT0x0427Lithuanian - Lithuania
mk0x002FMacedonian
mk-MK0x042FMacedonian - FYROM
ms0x003EMalay
ms-BN0x083EMalay - Brunei
ms-MY0x043EMalay - Malaysia
mr0x004EMarathi
mr-IN0x044EMarathi - India
mn0x0050Mongolian
mn-MN0x0450Mongolian - Mongolia
no0x0014Norwegian
nb-NO0x0414Norwegian (Bokmål) - Norway
nn-NO0x0814Norwegian (Nynorsk) - Norway
pl0x0015Polish
pl-PL0x0415Polish - Poland
pt0x0016Portuguese
pt-BR0x0416Portuguese - Brazil
pt-PT0x0816Portuguese - Portugal
pa0x0046Punjabi
pa-IN0x0446Punjabi - India
ro0x0018Romanian
ro-RO0x0418Romanian - Romania
ru0x0019Russian
ru-RU0x0419Russian - Russia
sa0x004FSanskrit
sa-IN0x044FSanskrit - India
sr-SP-Cyrl0x0C1ASerbian (Cyrillic) - Serbia
sr-SP-Latn0x081ASerbian (Latin) - Serbia
sk0x001BSlovak
sk-SK0x041BSlovak - Slovakia
sl0x0024Slovenian
sl-SI0x0424Slovenian - Slovenia
es0x000ASpanish
es-AR0x2C0ASpanish - Argentina
es-BO0x400ASpanish - Bolivia
es-CL0x340ASpanish - Chile
es-CO0x240ASpanish - Colombia
es-CR0x140ASpanish - Costa Rica
es-DO0x1C0ASpanish - Dominican Republic
es-EC0x300ASpanish - Ecuador
es-SV0x440ASpanish - El Salvador
es-GT0x100ASpanish - Guatemala
es-HN0x480ASpanish - Honduras
es-MX0x080ASpanish - Mexico
es-NI0x4C0ASpanish - Nicaragua
es-PA0x180ASpanish - Panama
es-PY0x3C0ASpanish - Paraguay
es-PE0x280ASpanish - Peru
es-PR0x500ASpanish - Puerto Rico
es-ES0x0C0ASpanish - Spain
es-UY0x380ASpanish - Uruguay
es-VE0x200ASpanish - Venezuela
sw0x0041Swahili
sw-KE0x0441Swahili - Kenya
sv0x001DSwedish
sv-FI0x081DSwedish - Finland
sv-SE0x041DSwedish - Sweden
syr0x005ASyriac
syr-SY0x045ASyriac - Syria
ta0x0049Tamil
ta-IN0x0449Tamil - India
tt0x0044Tatar
tt-RU0x0444Tatar - Russia
te0x004ATelugu
te-IN0x044ATelugu - India
th0x001EThai
th-TH0x041EThai - Thailand
tr0x001FTurkish
tr-TR0x041FTurkish - Turkey
uk0x0022Ukrainian
uk-UA0x0422Ukrainian - Ukraine
ur0x0020Urdu
ur-PK0x0420Urdu - Pakistan
uz0x0043Uzbek
uz-UZ-Cyrl0x0843Uzbek (Cyrillic) - Uzbekistan
uz-UZ-Latn0x0443Uzbek (Latin) - Uzbekistan
vi0x002AVietnamese
vi-VN0x042AVietnamese - Vietnam
-
-
- - - Gets the default System.Globalization.Calendar instance as - specified by the default culture. - - - A calendar divides time into measures, such as weeks, months, and years. The - number, length, and start of the divisions vary in each calendar. - Any moment in time can be represented as a set of numeric values using a - particular calendar. For example, the last vernal equinox occurred at (0.0, 0, 46, - 8, 20, 3, 1999) in the Gregorian calendar. An implementation of Calendar can - map any DateTime value to a similar set of numeric values, and - DateTime can map such sets of numeric values to a textual representation - using information from Calendar and DateTimeFormatInfo. The - textual representation can be culture-sensitive (for example, "8:46 AM March 20th - 1999 AD" for the en-US culture) or culture-insensitive (for example, - "1999-03-20T08:46:00" in ISO 8601 format). - A Calendar implementation can define one or more eras. The - Calendar class identifies the eras as enumerated integers where the current - era (CurrentEra) has the value 0. - In order to make up for the difference between the calendar year and the - actual time that the earth rotates around the sun or the actual time that the moon - rotates around the earth, a leap year has a different number of days than a - standard calendar year. Each Calendar implementation defines leap years - differently. - For consistency, the first unit in each interval (for example, the first - month) is assigned the value 1. - The System.Globalization namespace includes the following - Calendar implementations: GregorianCalendar, - HebrewCalendar, HijriCalendar, - JapaneseCalendar, JulianCalendar, - KoreanCalendar, TaiwanCalendar, and - ThaiBuddhistCalendar. - - - - - Gets or sets the default type used by RadCalendar to handle its - layout, and how will react to user interaction. - - - - - Member - Description - - - Interactive - Interactive - user is allowed to select dates, navigate, - etc. - - - Preview - Preview - does not allow user interaction, for presentation - purposes only. - - - - - - - Gets or sets the orientation (rendering direction) of the calendar component. - Default value is RenderInRows. - - - - - Member - Description - - - RenderInRows - Renders the calendar data row after row. - - - RenderInColumns - RenderInColumns - Renders the calendar data column after - column. - - - None - Enforces fallback to the default Orientation for - Telerik RadCalendar. - - - - - - - Gets or sets a value indicating whether a postback to the server automatically occurs when the user interacts with the control. - - - Setting this property to true will make Telerik RadCalendar postback to the server - on date selection or when navigating to a different month. - - - The default value is false. - - - - - Gets or sets a value indicating whether a tooltips for day cells should be rendered. - - - Setting this property to false will force Telerik RadCalendar to not render day cell tooltips - - - The default value is true. - - - - - Gets or sets a value for navigation controls summary. - - - Setting this property to empty string will force Telerik RadCalendar to not render summary attribute - - - The default value is "title and navigation". - - - - - Gets or sets a value for RadCalendar summary. - - - Setting this property to empty string will force Telerik RadCalendar to not render summary attribute - - - The default value is "Calendar". - - - - - Gets or sets the System.Web.UI.ITemplate that defines how the - header section of the RadCalendar control is displayed. - - - Header section of the RadCalendar control is displayed under - the title section and above the main calendar area (the section that displays the - dates information). - Use this property to create a template that controls how the header section - of a RadCalendar control is displayed. -
- CAUTION This control can be used to display user input, which - might include malicious client script. Check any information that is sent from - a client for executable script, SQL statements, or other code before displaying - it in your application. ASP.NET provides an input request validation feature to - block script and HTML in user input. Validation server controls are also - provided to assess user input. For more information, see Validation - Server Controls in MSDN. -
-
- The default value is a null reference (Nothing in Visual Basic). -
- - The default value is a null reference (Nothing in Visual Basic). - - Gets or sets the System.Web.UI.ITemplate that defines how the - footer section of the RadCalendar control is displayed. - - - Footer section of the RadCalendar control is displayed under - the main calendar area (the section that displays the dates information). - Use this property to create a template that controls how the footer section - of a RadCalendar control is displayed. -
- CAUTION This control can be used to display user input, which - might include malicious client script. Check any information that is sent from - a client for executable script, SQL statements, or other code before displaying - it in your application. ASP.NET provides an input request validation feature to - block script and HTML in user input. Validation server controls are also - provided to assess user input. For more information, see Validation - Server Controls in MSDN. -
-
-
- - - Gets or sets whether the navigation controls in the title section will be - displayed. - - - - - Gets or sets whether the month/year fast navigation controls in the title section will be - enabled. - - - - - Gets or sets the text displayed for the previous month navigation control. Will be - applied only if there is no image set (see - NavigationPrevImage). - - - Use the NavigationPrevText property to provide custom text for the - previous month navigation element in the title section of - RadCalendar. - Note that the NavigationPrevImage has priority and - its value should be set to an empty string in order to be applied the - NavigationPrevText value. -
- - - - - This property does not automatically encode to HTML. You need - to convert special characters to the appropriate HTML value, unless - you want the characters to be treated as HTML. For example, to - explicitly display the greater than symbol (>), you must use the - value &gt;. - - - -
- Because this property does not automatically encode to HTML, it is possible - to specify an HTML tag for the NavigationPrevText property. For example, - if you want to display an image for the next month navigation control, you can set - this property to an expression that contains an <img> - element. However note that - NavigationPrevImage - property is available for this type of functionality. - This property applies only if the EnableNavigation property - is set to true. -
- - The text displayed for the CalendarView previous month - navigation cell. The default value is "&lt;". - -
- - - Gets or sets the text displayed for the next month navigation control. Will be - applied if there is no image set (see - NavigationNextImage). - - - The text displayed for the CalendarView next month navigation - cell. The default value is "&gt;". - - - Use the NavigationNextText property to provide custom text for the - next month navigation element in the title section of - RadCalendar. - Note that the NavigationNextImage has priority and - its value should be set to an empty string in order to be applied the - NavigationNextText value. -
- - - - - This property does not automatically encode to HTML. You need - to convert special characters to the appropriate HTML value, unless - you want the characters to be treated as HTML. For example, to - explicitly display the greater than symbol (>), you must use the - value &gt;. - - - -
- Because this property does not automatically encode to HTML, it is possible - to specify an HTML tag for the NavigationNextText property. For example, - if you want to display an image for the next month navigation control, you can set - this property to an expression that contains an <img> - element. However note that - NavigationNextImage - property is available for this type of functionality. - This property applies only if the EnableNavigation property - is set to true. -
-
- - - Gets or sets the text displayed for the fast navigation previous month control. - Will be applied if there is no image set (see - FastNavigationPrevImage). - - - The text displayed for the CalendarView selection element in the - fast navigation previous month cell. The default value is - "&lt;&lt;". - - - Use the FastNavigationPrevText property to provide custom text for - the next month navigation element in the title section of - RadCalendar. - Note that the FastNavigationPrevImage has priority - and its value should be set to an empty string in order to be applied the - FastNavigationPrevText value. -
- - - - - This property does not automatically encode to HTML. You need - to convert special characters to the appropriate HTML value, unless - you want the characters to be treated as HTML. For example, to - explicitly display the greater than symbol (>), you must use the - value &gt;. - - - -
- Because this property does not automatically encode to HTML, it is possible - to specify an HTML tag for the FastNavigationPrevText property. For - example, if you want to display an image for the next month navigation control, you - can set this property to an expression that contains an - <img> element. However note that - FastNavigationPrevImage - property is available for this type of functionality. - This property applies only if the EnableNavigation property - is set to true. -
-
- - - Gets or sets the text displayed for the fast navigation next month control. Will be - applied if there is no image set (see - FastNavigationNextImage). - - - The text displayed for the CalendarView selection element in the - fast navigation next month cell. The default value is "&gt;&gt;". - - - Use the FastNavigationNextText property to provide custom text for - the next month navigation element in the title section of - RadCalendar. - Note that the FastNavigationNextImage has priority - and its value should be set to an empty string in order to be applied the - FastNavigationNextText value. -
- - - - - This property does not automatically encode to HTML. You need - to convert special characters to the appropriate HTML value, unless - you want the characters to be treated as HTML. For example, to - explicitly display the greater than symbol (>), you must use the - value &gt;. - - - -
- Because this property does not automatically encode to HTML, it is possible - to specify an HTML tag for the FastNavigationNextText property. For - example, if you want to display an image for the next month navigation control, you - can set this property to an expression that contains an - <img> element. However note that - FastNavigationNextImage - property is available for this type of functionality. - This property applies only if the EnableNavigation property - is set to true. -
-
- - - Gets or sets name of the image that is displayed for the previous month navigation control. - - - When using this property, the whole image URL is generated using also the - ImagesBaseDir - (if no skin is applied) or the - SkinPath - (if skin is applied) properties values. -
- Example when skin is NOT defined:
- ImagesBaseDir = "Img/"
- RowSelectorImage = "nav.gif"
- complete image URL : "Img/nav.gif"
- Example when skin is defined:
- SkinPath = "RadControls/Calendar/Skins/"
- RowSelectorImage = "nav.gif"
- complete image URL : "RadControls/Calendar/Skins/nav.gif"
-
-
- - - Gets or sets the name of the image that is displayed for the next month navigation control. - - - When using this property, the whole image URL is generated using also the - ImagesBaseDir - (if no skin is applied) or the - SkinPath - (if skin is applied) properties values. -
- Example when skin is NOT defined:
- ImagesBaseDir = "Img/"
- RowSelectorImage = "nav.gif"
- complete image URL : "Img/nav.gif"
- Example when skin is defined:
- SkinPath = "RadControls/Calendar/Skins/"
- RowSelectorImage = "nav.gif"
- complete image URL : "RadControls/Calendar/Skins/nav.gif"
-
-
- - - Gets or sets the name of the image that is displayed for the previous month fast - navigation control. - - - When using this property, the whole image URL is generated using also the - ImagesBaseDir - (if no skin is applied) or the - SkinPath - (if skin is applied) properties values. -
- Example when skin is NOT defined:
- ImagesBaseDir = "Img/"
- RowSelectorImage = "nav.gif"
- complete image URL : "Img/nav.gif"
- Example when skin is defined:
- SkinPath = "RadControls/Calendar/Skins/"
- RowSelectorImage = "nav.gif"
- complete image URL : "RadControls/Calendar/Skins/nav.gif"
-
-
- - - Gets or sets the name of the image that is displayed for the next month fast - navigation control. - - - When using this property, the whole image URL is generated using also the - ImagesBaseDir - (if no skin is applied) or the - SkinPath - (if skin is applied) properties values. -
- Example when skin is NOT defined:
- ImagesBaseDir = "Img/"
- RowSelectorImage = "nav.gif"
- complete image URL : "Img/nav.gif"
- Example when skin is defined:
- SkinPath = "RadControls/Calendar/Skins/"
- RowSelectorImage = "nav.gif"
- complete image URL : "RadControls/Calendar/Skins/nav.gif"
-
-
- - - Gets or sets the text displayed as a tooltip for the previous month navigation control. - - - Use the NavigationPrevToolTip property to provide custom text for the - tooltip of the previous month navigation element in the title section of - RadCalendar. - - - The tooltip text displayed for the CalendarView previous month - navigation cell. The default value is "&lt;". - - - - - Gets or sets the text displayed as a tooltip for the next month navigation control. - - - The tooltip text displayed for the CalendarView next month - navigation cell. The default value is "&gt;". - - - Use the NavigationNextToolTip property to provide custom text for the - tooltip of the next month navigation element in the title section of - RadCalendar. - - - - - Gets or sets the text displayed as a tooltip for the fast navigation previous - month control. - - - Use the FastNavigationPrevToolTip property to provide custom text for - the tooltip of the fast navigation previous month element in the title section of - RadCalendar. - - - The tooltip text displayed for the CalendarView fast navigation - previous month cell. The default value is "&lt;&lt;". - - - - - Gets or sets the text displayed as a tooltip for the fast navigation next month - control. - - - Use the FastNavigationNextToolTip property to provide custom text for - the tooltip of the fast navigation next month element in the title section of - RadCalendar. - - - The tooltip text displayed for the CalendarView fast navigation - next month cell. The default value is "&gt;&gt;". - - - - - Gets or sets the cell spacing that is applied to the title table. - - - - - Gets or sets the cell padding that is applied to the title table. - - - - - Gets or sets the horizontal alignment of the calendar title. - The HorizontalAlign enumeration is defined in - System.Web.UI.WebControls - - - - - - Member name - - - Description - - - - - Center - - The contents of a container are centered. - - - Justify - The contents of a container are uniformly spread out and - aligned with both the left and right margins. - - - Left - The contents of a container are left justified. - - - NotSet - The horizontal alignment is not set. - - - Right - The contents of a container are right justified. - - - - - - Gets or sets the format string that is applied to the calendar title. - - The property should contain either a format specifier character or a - custom format pattern. For more information, see the summary page for - System.Globalization.DateTimeFormatInfo. - By default this property uses formatting string of - 'MMMM yyyy'. Valid formats are all supported by the .NET - Framework. - Example: -
    -
  • "d" is the standard short date pattern.
  • -
  • "%d" returns the day of the month; "%d" is a custom pattern.
  • -
  • "d " returns the day of the month followed by a white-space character; "d " - is a custom pattern.
  • -
-
-
- - Gets or sets the format string that is applied to the days cells tooltip. - - The property should contain either a format specifier character or a - custom format pattern. For more information, see the summary page for - System.Globalization.DateTimeFormatInfo. - By default this property uses formatting string of - 'dddd, MMMM dd, yyyy'. Valid formats are all supported by the .NET - Framework. - Example: -
    -
  • "d" is the standard short date pattern.
  • -
  • "%d" returns the day of the month; "%d" is a custom pattern.
  • -
  • "d " returns the day of the month followed by a white-space character; "d " - is a custom pattern.
  • -
-
-
- - - Gets or sets the separator string that will be put between start and end months in a multi view title. - - - - - Gets or sets the name of the file containing the CSS definition used by RadCalendar. Use "~/" (tilde) as a substitution of the web-application root directory. - - - - - Gets or sets the cell padding of the table where are rendered the calendar days. - - - - - Gets or sets the cell spacing of the table where are rendered the calendar days. - - - - - A collection of special days in the calendar to which may be applied specific formatting. - - SpecialDays online example - - - - Gets the style properties for the days in the displayed month. - - - A TableItemStyle that contains the style properties for the days in the displayed month. - - - - - Gets the style properties for the weekend dates on the Calendar control. - - - A TableItemStyle that contains the style properties for the weekend dates on the Calendar. - - - - - Gets the style properties for the Calendar table container. - - - A TableItemStyle that contains the style properties for the Calendar table container. - - - - - Gets the style properties for the days on the Calendar control that are not in the displayed month. - - - A TableItemStyle that contains the style properties for the days on the Calendar control that are not in the displayed month. - - - - - Gets the style properties for the days on the Calendar control that are out of the valid range for selection. - - - A TableItemStyle that contains the style properties for the days on the Calendar control that are out of the valid range for selection. - - - - - Gets the style properties for the disabled dates. - - - A TableItemStyle that contains the style properties for the disabled dates. - - - - - Gets the style properties for the selected dates. - - - A TableItemStyle that contains the style properties for the selected dates. - - - - - Gets the style properties applied when hovering over the Calendar days. - - - A TableItemStyle that contains the style properties applied when hovering over the Calendar days. - - - - - Gets the style properties of the title heading for the Calendar control. - - - A TableItemStyle that contains the style properties of the title heading for the Calendar. - - - - - Gets the style properties for the row and column headers. - - - A TableItemStyle that contains the style properties for the row and column headers. - - - - Gets the style properties for the Month/Year fast navigation. - - A TableItemStyle that contains the style properties for the the Month/Year fast - navigation. - - - - - Gets the style properties for the view selector cell. - - - A TableItemStyle that contains the style properties for the view selector cell. - - - - - Exposes the top instance of CalendarView or its derived - types. - Every CalendarView class handles the real calculation and - rendering of RadCalendar's calendric information. The - CalendarView has the - - ChildViews collection which contains all the sub views in case of multi view - setup. - - - - Gets or sets whether the column headers will appear on the calendar. - - - Gets or sets whether the row headers will appear on the calendar. - - - - Gets or sets whether a selector for the entire CalendarView ( - MonthView ) will appear on the calendar. - - - - - Gets or sets whether the month matrix, when rendered will show days from other (previous or next) - months or will render only blank cells. - - - - - When the - ShowColumnHeaders - and/or - ShowRowHeaders - properties are set to true, the UseColumnHeadersAsSelectors property specifies - whether to use the days of the week, which overrides the used text/image header if - any. - - - - - When the - ShowColumnHeaders - and/or - ShowRowHeaders - properties are set to true, the UseRowHeadersAsSelectors property - specifies whether to use the number of the week, which overrides the used text/image - selector if any. - - - - - Use the RowHeaderText property to provide custom text for - the CalendarView complete row header element. -
- - - - - This property does not automatically encode to HTML. You need - to convert special characters to the appropriate HTML value, unless - you want the characters to be treated as HTML. For example, to - explicitly display the greater than symbol (>), you must use the - value &gt;. - - - -
- Because this property does not automatically encode to HTML, it is possible - to specify an HTML tag for the RowHeaderText property. For - example, if you want to display an image for the next month navigation control, you - can set this property to an expression that contains an - <img> element. - This property applies only if the ShowRowsHeaders - property is set to true. -
- - The text displayed for the CalendarView header element. The default value is "". - - - Gets or sets the text displayed for the row header element. - -
- - - The image displayed for the CalendarView row header element. The default value is "". - - - Gets or sets the image displayed for the row header element. - - - This property applies only if the ShowRowHeaders property is - set to true. If RowHeaderText is set too, its - value is set as an alternative text to the image of the row header. - When using this property, the whole image URL is generated using also the - ImagesBaseDir - value. - Example:
- ShowRowHeaders = "true"
- ImagesBaseDir = "Img/"
- RowHeaderImage = "selector.gif"
- complete image URL : "Img/selector.gif"
-
-
- - - Use the ColumnHeaderText property to provide custom text - for the CalendarView complete column header element. -
- - - - - This property does not automatically encode to HTML. You need - to convert special characters to the appropriate HTML value, unless - you want the characters to be treated as HTML. For example, to - explicitly display the greater than symbol (>), you must use the - value &gt;. - - - -
- Because this property does not automatically encode to HTML, it is possible - to specify an HTML tag for the ColumnHeaderText property. For - example, if you want to display an image for the next month navigation control, you - can set this property to an expression that contains an - <img> element. - This property applies only if the ShowColumnHeaders - property is set to true. -
- - The text displayed for the CalendarView column header element. The default value is "". - - - Gets or sets the text displayed for the column header element. - -
- - - The image displayed for the CalendarView column header element in the - header cells. The default value is "". - - - Gets or sets the image displayed for the column header element. - - - This property applies only if the ShowColumnHeaders property - is set to true. If ColumnHeaderText is set too, - its value is set as an alternative text to the image of the column header. - When using this property, the whole image URL is generated using also the - ImagesBaseDir - value. - Example: - ShowColumnHeaders="true"
- ImagesBaseDir = "Img/"
- ColumnHeaderImage = "selector.gif"
- complete image URL : "Img/selector.gif"
-
-
- - - Gets or sets the text displayed for the complete - CalendarView - selection element in the view selector cell. - - - The text displayed for the CalendarView selection element in the - selector cell. The default value is "". - - - Use the ViewSelectorText property to provide custom text for - the CalendarView complete selection element in the selector - cell. -
- - - - - This property does not automatically encode to HTML. You need - to convert special characters to the appropriate HTML value, unless - you want the characters to be treated as HTML. For example, to - explicitly display the greater than symbol (>), you must use the - value &gt;. - - - -
- Because this property does not automatically encode to HTML, it is possible - to specify an HTML tag for the ViewSelectorText property. For - example, if you want to display an image for the next month navigation control, you - can set this property to an expression that contains an - <img> element. - This property applies only if the EnableViewSelector - property is set to true. -
-
- - - Gets or sets the image displayed for the complete - CalendarView - selection element in the view selector cell. - - - The image displayed for the CalendarView selection element in - the selector cell. The default value is "". - - - When using this property, the whole image URL is generated using also the - ImagesBaseDir - value. - Example:
- ImagesBaseDir = "Img/"
- ViewSelectorImage = "selector.gif"
- complete image URL : "Img/selector.gif"
-
-
- - - Allows the selection of multiple dates. If not set, only a single date is selected, and if any dates - are all ready selected, they are cleared. - - - - - Enables the animation shown when the calendar navigates to a different view. - - - - - Gets or sets the name of the skin used. All skins reside in the location set by - the SkinsPath - Property. - - - For additional information please refer to the - Visual Settings topic in this manual. - - - - - DayRender event is fired after the generation of every calendar cell - object and just before it gets rendered to the client. It is the last place where - changes to the already constructed calendar cells can be made. - - - - - HeadeCellRender event is fired after the generation of every calendar header cell - object and just before it gets rendered to the client. It is the preferred place where - changes to the constructed calendar header cells can be made. - - - - - SelectionChanged event is fired when a new date is added or removed from - the - SelectedDates - collection. - - - - - DefaultViewChanged event is fired a a navigation to a different date - range occurred. Generally this is done by using the normal navigation buttons or the - fast date navigation popup that allows "jumping" to a specified date. - - - - - A control which ensures the date entered by the user is verified and - accurate. - - - The following example demonstrates how to dynamically add - RadDateInput to the page. - - private void Page_Load(object sender, System.EventArgs e) - { - RadDateInput dateInput = new RadDateInput(); - dateInput.ID = "dateInput"; - dateInput.Format = "d"; //Short date format - dateInput.Culture = new CultureInfo("en-US"); - dateInput.SelectedDate = DateTime.Now; - - DateInputPlaceholder.Controls.Add(dateInput); - } - - - Private Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles MyBase.Load - Dim dateInput As New RadDateInput() - dateInput.ID = "dateInput" - dateInput.Format = "d" 'Short Date Format - dateInput.Culture = New CultureInfo("en-US") - dateInput.SelectedDate = DateTime.Now - - DateInputPlaceholder.Controls.Add(dateInput) - End Sub - - - - You need to set the DateFormat Property to specify the - relevant format for the date. You can also specify the culture information by - setting the Culture Property. - - - - Sets input focus to a RadInput. - - Use the Focus method to set the initial focus of the Web page to the - RadInput. The page will be opened in the browser with the control - selected. - The Focus method causes a call to the page focus script to be emitted on the - rendered page. If the page does not contain a control with an HTML ID attribute - that matches the control that the Focus method was invoked on, then page focus will - not be set. An example where this can occur is when you set the focus on a user - control instead of setting the focus on a child control of the user control. In - this scenario, you can use the FindControl method to find the child control of the - user control and invoke its Focus method. - - - Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media - Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP - Starter Edition - The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft - Windows XP SP2, and Windows Server 2003 SP1. - .NET Framework
- Supported in: 3.0, 2.0, 1.1, 1.0
-
-
- - - Registers the control with the ScriptManager - - - - - Occurs after all child controls of the RadDateInput control have been created. - You can customize the control there, and add additional child controls. - - - - - Gets or sets the text of the - - - A string used as a label for the control. The default value is empty string - (""). - - - If the value of this property has not been set, a tag will not be rendered. Keep - in mind that accessibility standards require labels for all input controls. - - - Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media - Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP - Starter Edition - The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft - Windows XP SP2, and Windows Server 2003 SP1. - .NET Framework
- Supported in: 3.0, 2.0, 1.1, 1.0
-
- - The following code example demonstrates how to use the Label property: -
-            </%@ Page Language="C#" AutoEventWireup="True" /%>  
</%@ Register Assembly="RadInput.Net2" Namespace="Telerik.WebControls" TagPrefix="radI" /%>
- - <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
- <head>
- <title>RadTextBox Example </title>
-
<script runat="server">
-
-
protected void RadTextBox1_TextChanged(object sender, EventArgs e)
- {
this.RadTextBox1.Label = this.RadTextBox1.Text;
}
</script>
-
</head>
<body>
<form id="form1" runat="server">
<h3>
- RadTextBox Example
</h3>
- <radI:RadTextBox ID="RadTextBox1" AutoPostBack="true" EmptyMessage="Type Here" Label="Default Label: " runat="server" OnTextChanged="RadTextBox1_TextChanged">
- </radI:RadTextBox>
-
</form>
</body>
</html> -
-
-
- - - Gets or sets the CSS class applied to the tag rendered along with RadInput - control. - - - A string used specifying the CSS class of the label of the control. The default - value is empty string (""). - - This property is applicable only if the Label property has been set. - - - - Gets or sets a value indicating whether an automatic post back to the server - occurs whenever the user presses the ENTER or the TAB key while in the RadInput - control. - - - Use the AutoPostBack property to specify whether an automatic post back to the - server will occur whenever the user presses the ENTER or the TAB key while in the - RadInput control. - - - true if an automatic postback occurs whenever the user presses the ENTER or the - TAB key while in the RadInput control; otherwise, false. The default is - false. - - - The following code example demonstrates how to use the AutoPostBack property - to automatically display the sum of the values entered in the RadTextBoxes when the - user presses the ENTER or the TAB key. - [C#] -
-            </%@ Page Language="C#" AutoEventWireup="True" /%>  
</%@ Register Assembly="RadInput.Net2" Namespace="Telerik.WebControls" TagPrefix="radI" /%>
- <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
<title>RadTextBox Example </title>
-
<script runat="server">
-
protected void Page_Load(Object sender, EventArgs e)
{
int Answer;
-
// Due to a timing issue with when page validation occurs, call the
- // Validate method to ensure that the values on the page are valid.
Page.Validate();
-
// Add the values in the text boxes if the page is valid.
if(Page.IsValid)
{
Answer = Convert.ToInt32(Value1.Text) + Convert.ToInt32(Value2.Text);
-
AnswerMessage.Text = Answer.ToString();
}
-
}
</script>
-
</head>
<body>
<form id="form1" runat="server">
<h3>
RadTextBox Example
- </h3>
<table>
<tr>
<td colspan="5">
Enter integer values into the text boxes.
- <br />
The two values are automatically added
<br />
when you tab out of the text boxes.
- <br />
</td>
</tr>
<tr>
<td colspan="5">
-
</td>
</tr>
<tr align="center">
<td>
- <radI:RadTextBox ID="Value1" Columns="2" MaxLength="3" AutoPostBack="True" Text="1" runat="server" />
</td>
<td>
- +
</td>
<td>
<radI:RadTextBox ID="Value2" Columns="2" MaxLength="3" AutoPostBack="True" Text="1" runat="server" />
- </td>
<td>
=
</td>
<td>
<asp:Label ID="AnswerMessage" runat="server" />
- </td>
</tr>
<tr>
<td colspan="2">
- <asp:RequiredFieldValidator ID="Value1RequiredValidator" ControlToValidate="Value1"
ErrorMessage="Please enter a value.<br />" EnableClientScript="False" Display="Dynamic"
- runat="server" />
<asp:RangeValidator ID="Value1RangeValidator" ControlToValidate="Value1" Type="Integer"
- MinimumValue="1" MaximumValue="100" ErrorMessage="Please enter an integer <br /> between than 1 and 100.<br />"
- EnableClientScript="False" Display="Dynamic" runat="server" />
</td>
- <td colspan="2">
<asp:RequiredFieldValidator ID="Value2RequiredValidator" ControlToValidate="Value2"
- ErrorMessage="Please enter a value.<br />" EnableClientScript="False" Display="Dynamic"
runat="server" />
- <asp:RangeValidator ID="Value2RangeValidator" ControlToValidate="Value2" Type="Integer"
MinimumValue="1" MaximumValue="100" ErrorMessage="Please enter an integer <br /> between than 1 and 100.<br />"
- EnableClientScript="False" Display="Dynamic" runat="server" />
</td>
<td>
&nbsp
</td>
</tr>
</table>
- </form>
</body>
</html>
-
- [Visual Basic] -
-            </%@ Page Language="VB" AutoEventWireup="True" /%>

</%@ Register Assembly="RadInput.Net2" Namespace="Telerik.WebControls" TagPrefix="radI" /%>

<!DOCTYPE html Public "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
<title>RadTextBox Example </title>

<script runat="server">

- Protected Sub Page_Load(sender As Object, e As EventArgs)

Dim Answer As Integer

' Due to a timing issue with when page validation occurs, call the
' Validate method to ensure that the values on the page are valid.
- Page.Validate()

' Add the values in the text boxes if the page is valid.
If Page.IsValid Then

Answer = Convert.ToInt32(Value1.Text) + Convert.ToInt32(Value2.Text)

- AnswerMessage.Text = Answer.ToString()

End If

End Sub
</script>

</head>
<body>
<form id="form1" runat="server">
<h3>
- RadTextBox Example
</h3>
<table>
<tr>
- <td colspan="5">
Enter Integer values into the text boxes.
- <br />
The two values are automatically added
- <br />
When you tab out of the text boxes.
- <br />
</td>
</tr>
- <tr>
<td colspan="5">

</td>
- </tr>
<tr align="center">
<td>
- <radI:RadTextBox ID="Value1" Columns="2" MaxLength="3" AutoPostBack="True" Text="1" runat="server" />
- </td>
<td>
+
</td>
- <td>
- <radI:RadTextBox ID="Value2" Columns="2" MaxLength="3" AutoPostBack="True" Text="1" runat="server" />
- </td>
<td>
=
</td>
- <td>
<asp:Label ID="AnswerMessage" runat="server" />
- </td>
</tr>
<tr>
<td colspan="2">
- <asp:RequiredFieldValidator ID="Value1RequiredValidator" ControlToValidate="Value1"
- ErrorMessage="Please enter a value.<br />" EnableClientScript="False" Display="Dynamic"
- runat="server" />
- <asp:RangeValidator ID="Value1RangeValidator" ControlToValidate="Value1" Type="Integer"
- MinimumValue="1" MaximumValue="100" ErrorMessage="Please enter an integer <br /> between than 1 and 100.<br />"
- EnableClientScript="False" Display="Dynamic" runat="server" />
</td>
- <td colspan="2">
- <asp:RequiredFieldValidator ID="Value2RequiredValidator" ControlToValidate="Value2"
- ErrorMessage="Please enter a value.<br />" EnableClientScript="False" Display="Dynamic"
- runat="server" />
- <asp:RangeValidator ID="Value2RangeValidator" ControlToValidate="Value2" Type="Integer"
- MinimumValue="1" MaximumValue="100" ErrorMessage="Please enter an integer <br /> between than 1 and 100.<br />"
- EnableClientScript="False" Display="Dynamic" runat="server" />
- </td>
<td>
&nbsp
</td>
- </tr>
</table>
</form>
</body>
</html> -
-
- - Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media - Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP - Starter Edition - The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft - Windows XP SP2, and Windows Server 2003 SP1. - .NET Framework
- Supported in: 3.0, 2.0, 1.1, 1.0
-
-
- - - Gets or sets a value indicating whether validation is performed when the - RadInput control is set to validate when a postback occurs. - - - true if validation is performed when the RadInput control is set to validate - when a postback occurs; otherwise, false. The default value is false. - - - Use the CausesValidation property to determine whether validation is - performed on both the client and the server when a RadInput control is set to - validate when a postback occurs. Page validation determines whether the input - controls associated with a validation control on the page all pass the validation - rules specified by the validation control. - By default, a RadInput control does not cause page validation when the - control loses focus. To set the RadInput control to validate when a postback - occurs, set the CausesValidation property to true and the AutoPostBack property to - true. - When the value of the CausesValidation property is set to true, you can also - use the ValidationGroup property to specify the name of the validation group for - which the RadInput control causes validation. - This property cannot be set by themes or style sheet themes. - - - Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media - Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP - Starter Edition - The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft - Windows XP SP2, and Windows Server 2003 SP1. - .NET Framework
- Supported in: 3.0, 2.0
-
-
- - Gets or sets the maximum number of characters allowed in the text box. - - The maximum number of characters allowed in the text box. The default is 0, which - indicates that the property is not set. - - - Use the MaxLength property to limit the number of characters that can be entered - in the RadInput control. This property cannot be set by themes or style sheet - themes. For more information, see ThemeableAttribute and Introduction to ASP.NET - Themes. - - - The following code example demonstrates how to use the MaxLength property to - limit the number of characters allowed in the RadTextBox control to 3. This example - has a RadTextBox that accepts user input, which is a potential security threat. By - default, ASP.NET Web pages validate that user input does not include script or HTML - elements. - [C#] -
-            </%@ Page Language="C#" AutoEventWireup="True" /%>  
- </%@ Register Assembly="RadInput.Net2" Namespace="Telerik.WebControls" TagPrefix="radI" /%>
- <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
- <title>RadTextBox Example </title>
-
<script runat="server">
-
protected void AddButton_Click(Object sender, EventArgs e)
{
- int Answer;
-
Answer = Convert.ToInt32(Value1.Text) + Convert.ToInt32(Value2.Text);
-
AnswerMessage.Text = Answer.ToString();
-
}
-
</script>
-
</head>
<body>
<form id="form1" runat="server">
- <h3>
RadTextBox Example
</h3>
<table>
- <tr>
<td colspan="5">
Enter integer values into the text boxes.
- <br />
Click the Add button to add the two values.
- <br />
Click the Reset button to reset the text boxes.
- </td>
</tr>
<tr>
<td colspan="5">
- -
</td>
</tr>
<tr align="center">
- <td>
- <radI:RadTextBox ID="Value1" Columns="2" MaxLength="3" Text="1" runat="server" />
- </td>
<td>
+
</td>
- <td>
<radI:RadTextBox ID="Value2" Columns="2" MaxLength="3" Text="1" runat="server" />
- </td>
<td>
=
</td>
- <td>
<asp:Label ID="AnswerMessage" runat="server" />
</td>
- </tr>
<tr>
<td colspan="2">
- <asp:RequiredFieldValidator ID="Value1RequiredValidator" ControlToValidate="Value1"
- ErrorMessage="Please enter a value.<br />" Display="Dynamic" runat="server" />
- <asp:RangeValidator ID="Value1RangeValidator" ControlToValidate="Value1" Type="Integer"
- MinimumValue="1" MaximumValue="100" ErrorMessage="Please enter an integer <br /> between than 1 and 100.<br />"
- Display="Dynamic" runat="server" />
</td>
<td colspan="2">
- <asp:RequiredFieldValidator ID="Value2RequiredValidator" ControlToValidate="Value2"
- ErrorMessage="Please enter a value.<br />" Display="Dynamic" runat="server" />
- <asp:RangeValidator ID="Value2RangeValidator" ControlToValidate="Value2" Type="Integer"
- MinimumValue="1" MaximumValue="100" ErrorMessage="Please enter an integer <br /> between than 1 and 100.<br />"
- Display="Dynamic" runat="server" />
</td>
<td>
- &nbsp
</td>
</tr>
<tr align="center">
- <td colspan="4">
<asp:Button ID="AddButton" Text="Add" OnClick="AddButton_Click" runat="server" />
- </td>
<td>
-
</td>
</tr>
</table>
</form>
</body>
</html>
-
- [Visual Basic] -
-            </%@ Page Language="VB" AutoEventWireup="True" /%>

- </%@ Register Assembly="RadInput.Net2" Namespace="Telerik.WebControls" TagPrefix="radI" /%>
- <!DOCTYPE html Public "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
- <html>
<head>
<title>RadTextBox Example </title>

<script runat="server">

- Protected Sub AddButton_Click(sender As Object, e As EventArgs)

Dim Answer As Integer

- Answer = Convert.ToInt32(Value1.Text) + Convert.ToInt32(Value2.Text)

AnswerMessage.Text = Answer.ToString()
-
End Sub

</script>

</head>
<body>
<form id="form1" runat="server">
- <h3>
RadTextBox Example
</h3>
<table>
<tr>
- <td colspan="5">
Enter Integer values into the text boxes.
- <br />
Click the Add button To add the two values.
- <br />
Click the Reset button To reset the text boxes.
- </td>
</tr>
<tr>
<td colspan="5">

- </td>
</tr>
<tr align="center">
<td>
- <radI:RadTextBox ID="Value1" Columns="2" MaxLength="3" Text="1" runat="server" />
- </td>
<td>
+
</td>
- <td>
<radI:RadTextBox ID="Value2" Columns="2" MaxLength="3" Text="1" runat="server" />
- </td>
<td>
=
</td>
- <td>
<asp:Label ID="AnswerMessage" runat="server" />
- </td>
</tr>
<tr>
<td colspan="2">
- <asp:RequiredFieldValidator ID="Value1RequiredValidator" ControlToValidate="Value1"
- ErrorMessage="Please enter a value.<br />" Display="Dynamic" runat="server" />
- <asp:RangeValidator ID="Value1RangeValidator" ControlToValidate="Value1" Type="Integer"
- MinimumValue="1" MaximumValue="100" ErrorMessage="Please enter an integer <br /> between than 1 and 100.<br />"
- Display="Dynamic" runat="server" />
</td>
- <td colspan="2">
- <asp:RequiredFieldValidator ID="Value2RequiredValidator" ControlToValidate="Value2"
- ErrorMessage="Please enter a value.<br />" Display="Dynamic" runat="server" />
- <asp:RangeValidator ID="Value2RangeValidator" ControlToValidate="Value2" Type="Integer"
- MinimumValue="1" MaximumValue="100" ErrorMessage="Please enter an integer <br /> between than 1 and 100.<br />"
- Display="Dynamic" runat="server" />
</td>
- <td>
&nbsp
</td>
</tr>
- <tr align="center">
<td colspan="4">
- <asp:Button ID="AddButton" Text="Add" OnClick="AddButton_Click" runat="server" />
- </td>
<td>

</td>
- </tr>
</table>
</form>
</body>
</html> -
-
- - Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media - Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP - Starter Edition - The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft - Windows XP SP2, and Windows Server 2003 SP1. - .NET Framework
- Supported in: 3.0, 2.0, 1.1, 1.0
-
-
- - - Gets or sets a value indicating whether the contents of the RadInput control - can be changed. - - - true if the contents of the RadInput control cannot be changed; otherwise, - false. The default value is false. - - - Use the ReadOnly property to specify whether the contents of the RadInput - control can be changed. Setting this property to true will prevent users from entering - a value or changing the existing value. Note that the user of the RadInput control - cannot change this property; only the developer can. The Text value of a RadInput - control with the ReadOnly property set to true is sent to the server when a postback - occurs, but the server does no processing for a read-only RadInput. This prevents a - malicious user from changing a Text value that is read-only. The value of the Text - property is preserved in the view state between postbacks unless modified by - server-side code. This property cannot be set by themes or style sheet themes. - - - The following code example demonstrates how to use the ReadOnly property to - prevent any changes to the text displayed in the RadTextBox control. This example - has a RadTextBox that accepts user input, which is a potential security threat. By - default, ASP.NET Web pages validate that user input does not include script or HTML - elements. - [C#] -
-            </%@ Page Language="C#" AutoEventWireup="True" /%>  
- </%@ Register Assembly="RadInput.Net2" Namespace="Telerik.WebControls" TagPrefix="radI" /%>
- <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
- <title>MultiLine TextBox Example </title>
-
<script runat="server">
protected void SubmitButton_Click(Object sender, EventArgs e)
- {
-
Message.Text = "Thank you for your comment: <br />" + Comment.Text;
-
}
-
protected void Check_Change(Object sender, EventArgs e)
{
-
Comment.Wrap = WrapCheckBox.Checked;
Comment.ReadOnly = ReadOnlyCheckBox.Checked;
-
}
-
</script>
-
</head>
<body>
<form id="form1" runat="server">
<h3>
- MultiLine TextBox Example
</h3>
Please enter a comment and click the submit button.
- <br />
<br />
- <radI:RadTextBox ID="Comment" TextMode="MultiLine" Columns="50" Rows="5" runat="server" />
- <br />
<asp:RequiredFieldValidator ID="Value1RequiredValidator" ControlToValidate="Comment"
- ErrorMessage="Please enter a comment.<br />" Display="Dynamic" runat="server" />
- <asp:CheckBox ID="WrapCheckBox" Text="Wrap Text" Checked="True" AutoPostBack="True"
- OnCheckedChanged="Check_Change" runat="server" />
-
<asp:CheckBox ID="ReadOnlyCheckBox" Text="ReadOnly" Checked="False" AutoPostBack="True"
- OnCheckedChanged="Check_Change" runat="server" />
-
<asp:Button ID="SubmitButton" Text="Submit" OnClick="SubmitButton_Click" runat="server" />
- <hr />
<asp:Label ID="Message" runat="server" />
</form>
</body>
- </html> -
- [Visual Basic] -
-            </%@ Page Language="VB" AutoEventWireup="True" /%>  
- </%@ Register Assembly="RadInput.Net2" Namespace="Telerik.WebControls" TagPrefix="radI" /%>
- <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
- <title>MultiLine RadTextBox Example </title>
-
<script runat="server">
-
Protected Sub SubmitButton_Click(sender As Object, e As EventArgs )
-
Message.Text = "Thank you for your comment: <br />" + Comment.Text
-
End Sub
-
Protected Sub Check_Change(sender As Object, e As EventArgs )
-
Comment.Wrap = WrapCheckBox.Checked
Comment.ReadOnly = ReadOnlyCheckBox.Checked
-
End Sub
-
</script>
-
</head>
<body>
<form id="form1" runat="server">
<h3>
- MultiLine RadTextBox Example
</h3>
Please enter a comment and click the submit button.
- <br />
<br />
- <radI:RadTextBox ID="Comment" TextMode="MultiLine" Columns="50" Rows="5" runat="server" />
- <br />
<asp:RequiredFieldValidator ID="Value1RequiredValidator" ControlToValidate="Comment"
- ErrorMessage="Please enter a comment.<br />" Display="Dynamic" runat="server" />
- <asp:CheckBox ID="WrapCheckBox" Text="Wrap Text" Checked="True" AutoPostBack="True"
- OnCheckedChanged="Check_Change" runat="server" />
-
<asp:CheckBox ID="ReadOnlyCheckBox" Text="ReadOnly" Checked="False" AutoPostBack="True"
- OnCheckedChanged="Check_Change" runat="server" />
-
<asp:Button ID="SubmitButton" Text="Submit" OnClick="SubmitButton_Click" runat="server" />
- <hr />
<asp:Label ID="Message" runat="server" />
</form>
</body>
- </html> -
-
- - This example has a text box that accepts user input, which is a potential - security threat. By default, ASP.NET Web pages validate that user input does not - include script or HTML elements. - - - Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media - Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP - Starter Edition - The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft - Windows XP SP2, and Windows Server 2003 SP1. - .NET Framework
- Supported in: 3.0, 2.0, 1.1, 1.0
-
-
- - Gets or sets a value message shown when the control is empty. - - A string specifying the empty message. The default value is empty string. - (""). - - - Shown when the control is empty and loses focus. You can set the empty message - text through EmptyMessage property. - - - The following code example demonstrates how to set an empty message in code - behind: - [C#] -
-            </%@ Page Language="C#" /%>  
- </%@ Register Assembly="RadInput.Net2" Namespace="Telerik.WebControls" TagPrefix="radI" /%>
- <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
- <title>Untitled Page</title>
<script runat="server">
- protected void Button1_Click(object sender, EventArgs e)
{
- RadNumericTextBox1.EmptyMessage = RadNumericTextBox1.Text;
RadNumericTextBox1.Text = String.Empty;
- }
</script>
</head>
<body>
<form id="form1" runat="server">
- <radI:RadTextBox EmptyMessage="Type Here" ID="RadNumericTextBox1" runat="server">
- </radI:RadTextBox>
- <asp:Button ID="Button1" runat="server" Text="Set Empty Message" OnClick="Button1_Click" />
- </form>
</body>
</html>
-
- [Visual Basic] -
-            </%@ Page Language="VB" /%>
- </%@ Register Assembly="RadInput.Net2" Namespace="Telerik.WebControls" TagPrefix="radI" /%>
- <!DOCTYPE html Public "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
- <title>Untitled Page</title>
<script runat="server">
- Protected Sub Button1_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles Button1.Click
- RadNumericTextBox1.EmptyMessage = RadNumericTextBox1.Text
RadNumericTextBox1.Text = String.Empty
- End Sub
</script>
</head>
<body>
<form id="form1" runat="server">
- <radI:RadTextBox EmptyMessage="Type Here" ID="RadNumericTextBox1" runat="server">
- </radI:RadTextBox>
<asp:Button ID="Button1" runat="server" Text="Set Empty Message" />
- </form>
</body>
</html> -
-
- - Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media - Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP - Starter Edition - The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft - Windows XP SP2, and Windows Server 2003 SP1. - .NET Framework
- Supported in: 3.0, 2.0, 1.1, 1.0
-
-
- - Gets or sets the selection on focus options for the RadInput control - - A Telerik.WebControls.SelectionOnFocus object that represents the selection on - focus in RadInput control. The default value is "None". - - None - CaretToBeginning - CaretToEnd - SelectAll - - - - Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media - Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP - Starter Edition - The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft - Windows XP SP2, and Windows Server 2003 SP1. - .NET Framework
- Supported in: 3.0, 2.0, 1.1, 1.0
-
- - Use this property to provide selection on focus of RadInput control. You - can set one of the following values: - - - The following example demonstrates how to set the SelectionOnFocus property - from DropDownList: -
-            </%@ Page Language="C#" /%>  
- </%@ Register Assembly="RadInput.Net2" Namespace="Telerik.WebControls" TagPrefix="radI" /%>
- <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
- <title>RadTextBox selection</title>
<script runat="server">
- protected void DropDownList1_SelectedIndexChanged(object sender, EventArgs e)
{
- if (DropDownList1.SelectedValue == "CaretToBeginning")
{
- this.RadTextBox1.SelectionOnFocus = Telerik.WebControls.SelectionOnFocus.CaretToBeginning;
- }
else if (DropDownList1.SelectedValue == "CaretToEnd")
{
- this.RadTextBox1.SelectionOnFocus = Telerik.WebControls.SelectionOnFocus.CaretToEnd;
- }
else if (DropDownList1.SelectedValue == "SelectAll")
{
- this.RadTextBox1.SelectionOnFocus = Telerik.WebControls.SelectionOnFocus.SelectAll;
- }
}
</script>
</head>
<body>
- <form id="form1" runat="server">
<div>
- <radI:RadTextBox SelectionOnFocus="CaretToBeginning" ID="RadTextBox1" runat="server"></radI:RadTextBox>
- <br />
- <asp:DropDownList AutoPostBack="true" ID="DropDownList1" runat="server" OnSelectedIndexChanged="DropDownList1_SelectedIndexChanged">
- <asp:ListItem Text="CaretToBeginning">CaretToBeginning</asp:ListItem>
- <asp:ListItem Text="CaretToEnd">CaretToEnd</asp:ListItem>
- <asp:ListItem Text="SelectAll">SelectAll</asp:ListItem>
- </asp:DropDownList></div>
</form>
</body>
</html> -
-
-
- - - The InvalidStyleDuration property is used to determine how long (in milliseconds) - the control will display its invalid style when incorrect data is entered. - - - - - Gets or sets an instance of the Telerik.WebControls.InputClientEvents class which defines - the JavaScript functions (client-side event handlers) that are invoked when specific client-side events are raised. - - - - - Gets or sets a value indicating whether the button is displayed in the - RadInput control. - - - true if the button is displayed; otherwise, false. The default value is true, - however this property is only examined when the ButtonTemplate property is not a null - reference (Nothing in Visual Basic). - - - Use the ShowButton property to specify whether the button is displayed in the - RadInput control. - The contents of the button are controlled by the ButtonTemplate - property. - - - The following code example demonstrates how to use the ShowButton property to - display the button in the RadInput control. -
-            </%@ Page Language="C#" /%>    
</%@ Register Assembly="RadInput.Net2" Namespace="Telerik.WebControls" TagPrefix="radI" /%>
- <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
- -
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
- <title>Untitled Page</title>
- <script language="javascript" type="text/javascript">
function Click(sender)
{
- alert("click");
}
</script>
</head>
<body>
- <form id="form1" runat="server">
- <radI:RadTextBox ShowButton="true" ID="RadNumericTextBox1" runat="server">
- <ClientEvents OnButtonClick="Click" />
<ButtonTemplate>
- <input type="button" value="click here" />
</ButtonTemplate>
- </radI:RadTextBox>
</form>
</body>
</html> -
-
- - Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media - Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP - Starter Edition - The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft - Windows XP SP2, and Windows Server 2003 SP1. - .NET Framework
- Supported in: 3.0, 2.0, 1.1, 1.0
-
-
- - - Gets or sets a value that indicates whether the button should be positioned left or right of the RadInput box. - - - - Gets or sets the text content of the RadInput control. - - The text displayed in the RadInput control. The default is an empty string - (""). - - - Use the Text property to specify or determine the text displayed in the - RadInput control. To limit the number of characters accepted by the control, set - the MaxLength property. If you want to prevent the text from being modified, set - the ReadOnly property. - The value of this property, when set, can be saved automatically to a - resource file by using a designer tool. - - - The following code example demonstrates how to use the Text property to - specify the text displayed in the RadTextBox control. - [C#] -
-            </%@ Page Language="C#" AutoEventWireup="True" /%>  
- </%@ Register Assembly="RadInput.Net2" Namespace="Telerik.WebControls" TagPrefix="radI" /%>
- <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
- <title>RadTextBox Example </title>
-
<script runat="server">
-
-
protected void AddButton_Click(object sender, EventArgs e)
{
- int Answer;
-
Answer = Convert.ToInt32(Value1.Text) + Convert.ToInt32(Value2.Text);
-
AnswerMessage.Text = Answer.ToString();
}
</script>
-
</head>
<body>
<form id="form1" runat="server">
<h3>
- RadTextBox Example
</h3>
<table>
<tr>
- <td colspan="5">
Enter integer values into the text boxes.
- <br />
Click the Add button to add the two values.
- <br />
Click the Reset button to reset the text boxes.
- </td>
</tr>
<tr>
<td colspan="5">
-
</td>
</tr>
<tr align="center">
- <td>
<radI:RadTextBox ID="Value1" Columns="2" MaxLength="3" Text="1" runat="server" />
- </td>
<td>
+
</td>
- <td>
<radI:RadTextBox ID="Value2" Columns="2" MaxLength="3" Text="1" runat="server" />
- </td>
<td>
=
</td>
- <td>
<asp:Label ID="AnswerMessage" runat="server" />
- </td>
</tr>
<tr>
<td colspan="2">
- <asp:RequiredFieldValidator ID="Value1RequiredValidator" ControlToValidate="Value1"
- ErrorMessage="Please enter a value.<br />" Display="Dynamic" runat="server" />
- <asp:RangeValidator ID="Value1RangeValidator" ControlToValidate="Value1" Type="Integer"
- MinimumValue="1" MaximumValue="100" ErrorMessage="Please enter an integer <br /> between than 1 and 100.<br />"
- Display="Dynamic" runat="server" />
</td>
- <td colspan="2">
- <asp:RequiredFieldValidator ID="Value2RequiredValidator" ControlToValidate="Value2"
- ErrorMessage="Please enter a value.<br />" Display="Dynamic" runat="server" />
- <asp:RangeValidator ID="Value2RangeValidator" ControlToValidate="Value2" Type="Integer"
- MinimumValue="1" MaximumValue="100" ErrorMessage="Please enter an integer <br /> between than 1 and 100.<br />"
- Display="Dynamic" runat="server" />
</td>
<td>
- &nbsp
</td>
</tr>
<tr align="center">
- <td colspan="4">
- <asp:Button ID="AddButton" Text="Add" OnClick="AddButton_Click" runat="server" />
- </td>
<td>
-
</td>
</tr>
</table>
</form>
</body>
- </html> -
- [Visual Basic] -
-            </%@ Page Language="VB" AutoEventWireup="True" /%>

</%@ Register Assembly="RadInput.Net2" Namespace="Telerik.WebControls" TagPrefix="radI" /%>
- <!DOCTYPE html Public "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
- <title>RadTextBox Example </title>

<script runat="server">

- Protected Sub AddButton_Click(sender As Object, e As EventArgs)

Dim Answer As Integer

- Answer = Convert.ToInt32(Value1.Text) + Convert.ToInt32(Value2.Text)

- AnswerMessage.Text = Answer.ToString()

End Sub

</script>

</head>
- <body>
<form id="form1" runat="server">
<h3>
RadTextBox Example
- </h3>
<table>
<tr>
<td colspan="5">
- Enter Integer values into the text boxes.
<br />
- Click the Add button To add the two values.
<br />
- Click the Reset button To reset the text boxes.
</td>
- </tr>
<tr>
<td colspan="5">

</td>
- </tr>
<tr align="center">
<td>
- <radI:RadTextBox ID="Value1" Columns="2" MaxLength="3" Text="1" runat="server" />
- </td>
<td>
+
</td>
- <td>
<radI:RadTextBox ID="Value2" Columns="2" MaxLength="3" Text="1" runat="server" />
- </td>
<td>
=
</td>
- <td>
<asp:Label ID="AnswerMessage" runat="server" />
</td>
- </tr>
<tr>
<td colspan="2">
- <asp:RequiredFieldValidator ID="Value1RequiredValidator" ControlToValidate="Value1"
- ErrorMessage="Please enter a value.<br />" Display="Dynamic" runat="server" />
- <asp:RangeValidator ID="Value1RangeValidator" ControlToValidate="Value1" Type="Integer"
- MinimumValue="1" MaximumValue="100" ErrorMessage="Please enter an integer <br /> between than 1 and 100.<br />"
- Display="Dynamic" runat="server" />
</td>
- <td colspan="2">
- <asp:RequiredFieldValidator ID="Value2RequiredValidator" ControlToValidate="Value2"
- ErrorMessage="Please enter a value.<br />" Display="Dynamic" runat="server" />
- <asp:RangeValidator ID="Value2RangeValidator" ControlToValidate="Value2" Type="Integer"
- MinimumValue="1" MaximumValue="100" ErrorMessage="Please enter an integer <br /> between than 1 and 100.<br />"
- Display="Dynamic" runat="server" />
</td>
<td>
&nbsp
- </td>
</tr>
<tr align="center">
<td colspan="4">
- <asp:Button ID="AddButton" Text="Add" OnClick="AddButton_Click" runat="server" />
- </td>
- <td>

</td>
- </tr>
</table>
</form>
</body>
</html> -
-
- - Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media - Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP - Starter Edition - The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft - Windows XP SP2, and Windows Server 2003 SP1. - .NET Framework
- Supported in: 3.0, 2.0, 1.1, 1.0
-
-
- - - Gets or sets the group of controls for which the ra.a.d.input control causes - validation when it posts back to the server. - - - The group of controls for which the RadInput control causes validation when it - posts back to the server. The default value is an empty string (""). - - - Validation groups allow you to assign validation controls on a page to a - specific category. Each validation group can be validated independently from other - validation groups on the page. Use the ValidationGroup property to specify the name - of the validation group for which the RadInput control causes validation when it - posts back to the server. - This property has an effect only when the CausesValidation property is set to - true. When you specify a value for the ValidationGroup property, only the - validation controls that are part of the specified group are validated when the - RadInput control posts back to the server. If you do not specify a value for - this property and the CausesValidation property is set to true, all validation - controls on the page that are not assigned to a validation group are validated when - the control posts back to the server. - This property cannot be set by themes or style sheet themes. - - - Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media - Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP - Starter Edition - The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft - Windows XP SP2, and Windows Server 2003 SP1. - .NET Framework
- Supported in: 3.0, 2.0
-
-
- - - Gets the style properties for RadInput when when the control is - empty. - - - A Telerik.WebControls.TextBoxStyle object that represents the style properties - for RadInput control. The default value is an empty TextBoxStyle object. - - - The following code example demonstrates how to set EmptyMessageStyle - property: -
-            </%@ Page Language="C#" /%>    
</%@ Register Assembly="RadInput.Net2" Namespace="Telerik.WebControls" TagPrefix="radI" /%>
- <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>Untitled Page</title>
- </head>
<body>
<form id="form1" runat="server">
- <radI:RadTextBox EmptyMessage="EmptyMessage" ID="RadNumericTextBox1" runat="server">
- <EnabledStyle BackColor="red" />
<EmptyMessageStyle BackColor="AliceBlue" />
- <FocusedStyle BackColor="yellow" />
<HoveredStyle BackColor="blue" />
- </radI:RadTextBox>
</form>
</body>
</html> -
-
- - Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media - Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP - Starter Edition - The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft - Windows XP SP2, and Windows Server 2003 SP1. - .NET Framework
- Supported in: 3.0, 2.0, 1.1, 1.0
-
- - Use this property to provide a custom style for the empty message state of - RadInput control. Common style attributes that can be adjusted include - foreground color, background color, font, and alignment within the RadInput. - Providing a different style enhances the appearance of the RadInput - control. - Empty message style properties in the RadInput control are inherited from - one style property to another through a hierarchy. For example, if you specify a - red font for the EnabledStyle property, all other style properties in the - RadInput control will also have a red font. This allows you to provide a common - appearance for the control by setting a single style property. You can override the - inherited style settings for an item style property that is higher in the hierarchy - by setting its style properties. For example, you can specify a blue font for the - FocusedStyle property, overriding the red font specified in the EnabledStyle - property. - To specify a custom style, place the <EmptyMessageStyle> tags between - the opening and closing tags of the RadInput control. You can then list the - style attributes within the opening <EmptyMessageStyle> tag. - -
- - Gets the style properties for focused RadInput control. - - A Telerik.WebControls.TextBoxStyle object that represents the style properties - for focused RadInput control. The default value is an empty TextBoxStyle - object. - - - The following code example demonstrates how to set FocusedStyle - property: -
-            </%@ Page Language="C#" /%>    
</%@ Register Assembly="RadInput.Net2" Namespace="Telerik.WebControls" TagPrefix="radI" /%>
- <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
- <title>Untitled Page</title>
</head>
<body>
- <form id="form1" runat="server">
- <radI:RadTextBox EmptyMessage="EmptyMessage" ID="RadNumericTextBox1" runat="server">
- <EnabledStyle BackColor="red" />
<EmptyMessageStyle BackColor="AliceBlue" />
- <FocusedStyle BackColor="yellow" />
<HoveredStyle BackColor="blue" />
- </radI:RadTextBox>
</form>
</body>
</html> -
-
- - Use this property to provide a custom style for the focused RadInput - control. Common style attributes that can be adjusted include foreground color, - background color, font, and alignment within the RadInput. Providing a different - style enhances the appearance of the RadInput control. - Focused style properties in the RadInput control are inherited from one - style property to another through a hierarchy. For example, if you specify a red - font for the EnabledStyle property, all other style properties in the RadInput - control will also have a red font. This allows you to provide a common appearance - for the control by setting a single style property. You can override the inherited - style settings for an item style property that is higher in the hierarchy by - setting its style properties. For example, you can specify a blue font for the - FocusedStyle property, overriding the red font specified in the EnabledStyle - property. - To specify a custom style, place the <FocusedStyle> tags between the - opening and closing tags of the RadInput control. You can then list the style - attributes within the opening <FocusedStyle> tag. - - - Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media - Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP - Starter Edition - The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft - Windows XP SP2, and Windows Server 2003 SP1. - .NET Framework
- Supported in: 3.0, 2.0, 1.1, 1.0
-
-
- - Gets the style properties for disabled RadInput control. - - A Telerik.WebControls.TextBoxStyle object that represents the style properties - for disabled RadInput control. The default value is an empty TextBoxStyle - object. - - - The following code example demonstrates how to set - DisabledStyle property: -
-            </%@ Page Language="C#" /%>      
</%@ Register Assembly="RadInput.Net2" Namespace="Telerik.WebControls" TagPrefix="radI" /%>
- <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>Untitled Page</title>
- </head>
<body>
<form id="form1" runat="server">
- <radI:RadTextBox EmptyMessage="EmptyMessage" ID="RadNumericTextBox1" runat="server">
- <EnabledStyle BackColor="red" />
<EmptyMessageStyle BackColor="AliceBlue" />
- <FocusedStyle BackColor="yellow" />
<HoveredStyle BackColor="blue" />
- </radI:RadTextBox>
</form>
</body>
</html> -
-
- - Use this property to provide a custom style for the disabled RadInput - control. Common style attributes that can be adjusted include foreground color, - background color, font, and alignment within the RadInput. Providing a different - style enhances the appearance of the RadInput control. - Disabled style properties in the RadInput control are inherited from one - style property to another through a hierarchy. For example, if you specify a red - font for the EnabledStyle property, all other style properties in the RadInput - control will also have a red font. This allows you to provide a common appearance - for the control by setting a single style property. You can override the inherited - style settings for an item style property that is higher in the hierarchy by - setting its style properties. For example, you can specify a blue font for the - DisabledStyle property, overriding the red font specified in the EnabledStyle - property. - To specify a custom style, place the <DisabledStyle> tags between the - opening and closing tags of the RadInput control. You can then list the style - attributes within the opening <DisabledStyle> tag. - - - Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media - Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP - Starter Edition - The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft - Windows XP SP2, and Windows Server 2003 SP1. - .NET Framework
- Supported in: 3.0, 2.0, 1.1, 1.0
-
-
- - Gets the style properties for invalid state of RadInput control. - - A Telerik.WebControls.TextBoxStyle object that represents the style properties - for invalid RadInput control. The default value is an empty TextBoxStyle - object. - - - The following code example demonstrates how to set InvalidStyle - property: -
-            </%@ Page Language="C#" /%>      
</%@ Register Assembly="RadInput.Net2" Namespace="Telerik.WebControls" TagPrefix="radI" /%>
- <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>Untitled Page</title>
- </head>
<body>
<form id="form1" runat="server">
- <radI:RadTextBox EmptyMessage="EmptyMessage" ID="RadNumericTextBox1" runat="server">
- <EnabledStyle BackColor="red" />
<EmptyMessageStyle BackColor="AliceBlue" />
- <FocusedStyle BackColor="yellow" />
<HoveredStyle BackColor="blue" />
</radI:RadTextBox>
- </form>
</body>
</html>
-
-
- - Use this property to provide a custom style for the invalid state RadInput - control. Common style attributes that can be adjusted include foreground color, - background color, font, and alignment within the RadInput. Providing a different - style enhances the appearance of the RadInput control. - Enabled style properties in the RadInput control are inherited from one - style property to another through a hierarchy. For example, if you specify a red - font for the EnabledStyle property, all other style properties in the RadInput - control will also have a red font. This allows you to provide a common appearance - for the control by setting a single style property. You can override the inherited - style settings for an item style property that is higher in the hierarchy by - setting its style properties. For example, you can specify a blue font for the - InvalidStyle property, overriding the red font specified in the EnabledStyle - property. - To specify a custom style, place the <InvalidStyle> tags between the - opening and closing tags of the RadInput control. You can then list the style - attributes within the opening <InvalidStyle> tag. - - - Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media - Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP - Starter Edition - The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft - Windows XP SP2, and Windows Server 2003 SP1. - .NET Framework
- Supported in: 3.0, 2.0, 1.1, 1.0
-
-
- - Gets the style properties for hovered RadInput control. - - A Telerik.WebControls.TextBoxStyle object that represents the style properties - for hovered RadInput control. The default value is an empty TextBoxStyle - object. - - - The following code example demonstrates how to set HoveredStyle - property: -
-            </%@ Page Language="C#" /%>     
</%@ Register Assembly="RadInput.Net2" Namespace="Telerik.WebControls" TagPrefix="radI" /%>
- <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
- <title>Untitled Page</title>
</head>
<body>
<form id="form1" runat="server">
- <radI:RadTextBox EmptyMessage="EmptyMessage" ID="RadNumericTextBox1" runat="server">
- <EnabledStyle BackColor="red" />
<EmptyMessageStyle BackColor="AliceBlue" />
- <FocusedStyle BackColor="yellow" />
<HoveredStyle BackColor="blue" />
- </radI:RadTextBox>
</form>
</body>
</html> -
-
- - Use this property to provide a custom style for the hovered RadInput - control. Common style attributes that can be adjusted include foreground color, - background color, font, and alignment within the RadInput. Providing a different - style enhances the appearance of the RadInput control. - Hovered style properties in the RadInput control are inherited from one - style property to another through a hierarchy. For example, if you specify a red - font for the EnabledStyle property, all other style properties in the RadInput - control will also have a red font. This allows you to provide a common appearance - for the control by setting a single style property. You can override the inherited - style settings for an item style property that is higher in the hierarchy by - setting its style properties. For example, you can specify a blue font for the - HoveredStyle property, overriding the red font specified in the EnabledStyle - property. - To specify a custom style, place the <HoveredStyle> tags between the - opening and closing tags of the RadInput control. You can then list the style - attributes within the opening <HoveredStyle> tag. - - - Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media - Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP - Starter Edition - The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft - Windows XP SP2, and Windows Server 2003 SP1. - .NET Framework
- Supported in: 3.0, 2.0, 1.1, 1.0
-
-
- - - Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media - Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP - Starter Edition - The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft - Windows XP SP2, and Windows Server 2003 SP1. - .NET Framework
- Supported in: 3.0, 2.0, 1.1, 1.0
-
- Gets the style properties for enabled RadInput control. - - A Telerik.WebControls.TextBoxStyle object that represents the style properties - for enabled RadInput control. The default value is an empty TextBoxStyle - object. - - - Use this property to provide a custom style for the enabled RadInput - control. Common style attributes that can be adjusted include foreground color, - background color, font, and alignment within the RadInput. Providing a different - style enhances the appearance of the RadInput control. - Enabled style properties in the RadInput control are inherited from one - style property to another through a hierarchy. For example, if you specify a red - font for the EnabledStyle property, all other style properties in the RadInput - control will also have a red font. This allows you to provide a common appearance - for the control by setting a single style property. You can override the inherited - style settings for an item style property that is higher in the hierarchy by - setting its style properties. For example, you can specify a blue font for the - FocusedStyle property, overriding the red font specified in the EnabledStyle - property. - To specify a custom style, place the <EnabledStyle> tags between the - opening and closing tags of the RadInput control. You can then list the style - attributes within the opening <EnabledStyle> tag. - - - The following code example demonstrates how to set EnabledStyle - property: -
-            </%@ Page Language="C#" /%>    
</%@ Register Assembly="RadInput.Net2" Namespace="Telerik.WebControls" TagPrefix="radI" /%>
- <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>Untitled Page</title>
</head>
- <body>
<form id="form1" runat="server">
- <radI:RadTextBox EmptyMessage="EmptyMessage" ID="RadNumericTextBox1" runat="server">
- <EnabledStyle BackColor="red" />
<EmptyMessageStyle BackColor="AliceBlue" />
- <FocusedStyle BackColor="yellow" />
<HoveredStyle BackColor="blue" />
- </radI:RadTextBox>
</form>
</body>
</html> -
-
-
- - Gets control that contains the buttons of RadInput control - The ShowButton or ShowSpinButton properties must be set to true - - Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media - Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP - Starter Edition - The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft - Windows XP SP2, and Windows Server 2003 SP1. - .NET Framework
- Supported in: 3.0, 2.0, 1.1, 1.0
-
-
- - - Clears the selected date of the RadDateInput control and displays a blank date. - - - - - Gets or sets a value that indicates the end of the century that is used to interpret - the year value when a short year (single-digit or two-digit year) is entered in the input. - - - The year when the century ends. Default is 2029. - - - Having a value of 2029 indicates that a short year will be interpreted as a year between 1930 and 2029. - For example 55 will be interpreted as 1955 but 12 -- as 2012 - - - - - Gets a value that indicates the start of the century that is used to interpret - the year value when a short year (single-digit or two-digit year) is entered in the input. - - - The year when the century starts. Default is 2029. - - - Having a value of 2029 indicates that a short year will be interpreted as a year between 1930 and 2029. - For example 55 will be interpreted as 1955 but 12 -- as 2012 - - - - - Gets or sets the display date format used by - RadDateInput.(Visible when the control is not on focus.) - - - You can examine DateTimeFormatInfo class for a list of all - available format characters and patterns. - - - - private void Page_Load(object sender, System.EventArgs e) - { - RadDateInput1.DisplayDateFormat = "M/d/yyyy"; //Short date pattern. The same as "d". - } - - - Private Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles MyBase.Load - RadDateInput1.DisplayDateFormat = "M/d/yyyy" 'Short date pattern. The same as "d". - End Sub - - - - A string specifying the display date format used by RadDateInput. The default - value is "d" (short date format). If the DisplayDateFormat is left - blank, the DateFormat will be used both for editing and - display. - - - - - Gets or sets the date and time format used by - RadDateInput. - - - A string specifying the date format used by RadDateInput. The - default value is "d" (short date format). - - - - private void Page_Load(object sender, System.EventArgs e) - { - RadDateInput1.DateFormat = "M/d/yyyy"; //Short date pattern. The same as "d". - } - - - Private Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles MyBase.Load - RadDateInput1.DateFormat = "M/d/yyyy" 'Short date pattern. The same as "d". - End Sub - - - - - Gets or sets the date content of RadDateInput. - - A DateTime object that represents the selected - date. The default value is MinDate. - - - The following example demonstrates how to use the SelectedDate - property to set the content of RadDateInput. - - private void Page_Load(object sender, System.EventArgs e) - { - RadDateInput1.SelectedDate = DateTime.Now; - } - - - Private Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles MyBase.Load - RadDateInput1.SelectedDate = DateTime.Now - End Sub - - - - - - Gets or sets the date content of RadDateInput in a - database-friendly way. - - - A DateTime object that represents the selected - date. The default value is MinDate. - - - The following example demonstrates how to use the SelectedDate - property to set the content of RadDateInput. - - private void Page_Load(object sender, System.EventArgs e) - { - RadDateInput1.DbSelectedDate = tableRow["BirthDate"]; - } - - - Private Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles MyBase.Load - RadDateInput1.DbSelectedDate = tableRow("BirthDate") - End Sub - - - - This property behaves exactly like the SelectedDate property. - The only difference is that it will not throw an exception if the new value is null or - DBNull. Setting a null value will revert the selected date to the MinDate value. - - - - - Gets or sets the culture used by RadDateInput to format the - date. - - - A CultureInfo object that - represents the current culture used. The default value is - System.Threading.Thread.CurrentThread.CurrentUICulture. - - - The following example demonstrates how to use the Culture - property. - - private void Page_Load(object sender, System.EventArgs e) - { - RadDateInput1.Culture = new CultureInfo("en-US"); - } - - - Private Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles MyBase.Load - RadDateInput1.Culture = New CultureInfo("en-US") - End Sub - - - - - - This property is used by the RadDateInput's internals only. It - is subject to change in the future versions. Please do not use. - - - - - Gets or sets the smallest date value allowed by - RadDateInput. - - - A DateTime object that represents the smallest - date value by RadDateInput. The default value is 1/1/1980. - - - - - Gets or sets the largest date value allowed by - RadDateInput. - - - A DateTime object that represents the largest - date value allowed by RadDateInput. The default value is - 12/31/2099. - - - - Used to determine if RadDateInput is empty. - - true if the date is empty; otherwise false. - - - - - Gets or sets the JavaScript event handler fired whenever the date of - RadDateInput changes. - - - A string specifying the name of the JavaScript event handling routine. The - default value is empty string (""). - - - The event handler function is called with 2 parameters: - - A reference to the RadDateInput object, which triggered - the event; - - An event arguments object that contains the following properties: -
    -
  • OldDate - The old date of the - RadDateInput
  • -
  • NewDate - The new date of the - RadDateInput
  • -
-
-
-
- - This example demonstrates the usage of the - OnClientDateChanged property. -
-            <script type="text/javascript&quot>
function onDateChange(dateInput, args)
{
alert("New date:" + args.NewDate);
}
</script>
-
<radI:RadDateInput
ID="RadDateInput1"
runat="server"
OnClientDateChanged="onDateChange">
</radI:RadDateInput> -
-
-
- - - Summary description for AutoPostBackControl. - - - - - Without AutoPostBack - - 0 - - - - Automatically postback to the server after the Date or Time is modified. - - 1 - - - - Automatically postback to the server after the Time is modified. - - 2 - - - - Automatically postback to the server after the Date is modified. - - 3 - - - - Internal enumeration used by the component - - - - Specifies the type of a selector sell. - - - - Rendered as the first cell in a row. When clicked if UseRowHeadersAsSelectors is true, - it will select the entire row. - - - - - Rendered as the first cell in a column. When clicked if UseColumnHeadersAsSelectors is true, - it will select the entire column. - - - - - Rendered in the top left corner of the calendar view. When clicked if EnableViewSelector is true, - it will select the entire view. - - - - - Summary description for MonthLayout. - Layout_7columns_x_6rows - horizontal layout - Layout_14columns_x_3rows - horizontal layout - Layout_21columns_x_2rows - horizontal layout - Layout_7rows_x_6columns - vertical layout, required when UseColumnHeadersAsSelectors is true and Orientation is set to RenderInColumns. - Layout_14rows_x_3columns - vertical layout, required when UseColumnHeadersAsSelectors is true and Orientation is set to RenderInColumns. - Layout_21rows_x_2columns - vertical layout, required when UseColumnHeadersAsSelectors is true and Orientation is set to RenderInColumns. - - - - - Allows the calendar to display the days in a 7 by 6 matrix. - - 1 - - - - Alows the calendar to display the days in a 14 by 3 matrix. - - 2 - - - - Allows the calendar to display the days in a 21 by 2 matrix. - - 4 - - - - Allows the calendar to display the days in a 7 by 6 matrix, required when UseColumnHeadersAsSelectors is true and Orientation is set to RenderInColumns. - - 8 - - - - Allows the calendar to display the days in a 14 by 3 matrix, required when UseColumnHeadersAsSelectors is true and Orientation is set to RenderInColumns. - - 16 - - - - Allows the calendar to display the days in a 21 by 2 matrix, required when UseColumnHeadersAsSelectors is true and Orientation is set to RenderInColumns. - - 32 - - - - Summary description for Orientation. - RenderInRows - Renders the calendar data row after row. - RenderInColumns - Renders the calendar data column after column. - None - Enforces fallback to the default Orientation for Telerik RadCalendar. - - - - - Renders the calendar data row after row. - - 1 - - - - RenderInColumns - Renders the calendar data column after column. - - 3 - - - - Describes how RadCalendar will handle its layout, and how will - react to user interaction. Interactive - user is allowed to select dates, navigate, - etc. Preview - does not allow user interaction, for presentation purposes only. - - - - - Interactive - user is allowed to select dates, navigate, etc. - - 1 - - - - Preview - does not allow user interaction, for presentation purposes only. - - 2 - - - - Summary description for RecurringEvents. - DayInMonth - Only the day part of the date is taken into account. That gives the ability to serve events repeated every month on the same day. - DayAndMonth - The month and the day part of the date is taken into account. That gives the ability to serve events repeated in a specific month on the same day. - Today - gives the ability to control the visual appearace of today's date. - None - Default value, means that the day in question is a single point event, no recurrences. - - - - - Only the day part of the date is taken into account. That gives the ability to serve events repeated every month on the same day. - - 1 - - - - The month and the day part of the date are taken into account. That gives the ability to serve events repeated in a specific month on the same day. - - 2 - - - - The week day is taken into account. That gives the ability to serve events repeated in a specific day of the week. - - 4 - - - - The week day and the month are taken into account. That gives the ability to serve events repeated in a specific week day in a specific month. - - 8 - - - - Gives the ability to control the visual appearace of today's date. - - 16 - - - - The week number, the weekday (Mon, Tue, etc.) and the month are taken into account. That gives the ability to serve public holiday events - repeated each year (e.g. Martin Luther King Jr. Day is observed on the third Monday of January each year - so you would specify as a date Jan 21st, 2008 (or Jan 19th, 2009 -- it would have the same effect). - - 32 - - - - Default value, means that the day in question is a single point event, no recurrence. - - 64 - - - Specifies the type of a selector sell. - - - - Rendered as the first cell in a row. When clicked, it will select the entire - row. - - - - - Rendered as the first cell in a column. When clicked, it will select the entire - column. - - - - - Rendered in the top left corner of the calendar view. When clicked, it will - select the entire view. - - - - - Defines the JavaScript functions (client-side event handlers) that are invoked - when specific client-side event is raised. - - - - - This class implements the PropertyBag "enabled" base object class, from which all other - classes in Telerik RadCalendar descend, excluding those that are descendents of PropertiesControl. - - - - - Event fired after the RadCalendar client object has been completely initialized. - - - - - The event is fired immediately after the page onload event. - - - - - Event fired when a valid date is being selected. - Return false to cancel selection. - - - - - Event fired after a valid date has been selected. Can be used in combination with - OnDateClick for maximum convenience. This event can be used to conditionally process the - selected date or any related event with it on the client. - - - - - Event fired when a calendar cell, representing a date is clicked. This event is not the same as - OnDateSelected. One can have an OnDateClick event for a disabled or read only calendar - cell which does not allow.s OnDateSelected event to be fired. - This event can be used to conditionally process some information/event based on the clicked - date. - Return false to cancel the click event. - - - - - Event fired when a calendar row header is clicked. This event is not the same as - OnDateClick. One can have an OnRowHeaderClick event for a disabled or read only calendar - cell which does not allow to select calendar dates. - This event can be used to conditionally process some information/event based on the clicked - row header. - Return false to cancel the click event. - - - - - Event fired when a calendar column header is clicked. This event is not the same as - OnDateClick. One can have an OnColumnHeaderClick event for a disabled or read only calendar - cell which does not allow selection of calendar dates. - This event can be used to conditionally process some information/event based on the clicked - column header. - Return false to cancel the click event. - - - - - Event fired when a calendar view selector is clicked. This event is not the same as - OnDateClick. One can have an OnViewSelectorClick event for a disabled or read only calendar - cell which does not allow selection of calendar cell. - This event can be used to conditionally process some information/event based on the clicked - view selector. - Return false to cancel the click event. - - - - - Event fired when the calendar view is about to change. - Return false to cancel the event. - - - - - Event fired when the calendar view has changed. Generally - the event is raised as a result of using the built-in navigation controls. Event is - raised before the results are rendered, so that custom logic could be executed, and the - change could be prevented if necessary. There is no way to find whether the operation - was accomplished successfully. This event can be used to preprocess some conditions or - visual styles/content before the final rendering of the calendar. Return false to - cancel the event. - - - - - Event fired for every calendar day cell when the calendar is rendered as a result of a client-side navigation (i.e. only in OperationType="Client"). - This event mimics the server-side DayRender event -- gives final control over the output of a specific calendar cell. - This event can be used to apply final changes to the output (content and visial styles) just before the content is displayed. - - - - - Summary description for DatePickerClientEvents. - - - - - - Gets or sets the name of the client-side event handler that is executed whenever - the selected date of the datepicker is changed. - - -
-            [ASPX/ASCX]
-            
-
-            <script type="text/javascript" >
function DatePicker_OnDateSelected(pickerInstance, args)
{
alert("The picker date has been chanded from " + args.OldDate + " to " + args.NewDate);
}
</script>
<radCln:RadDatePicker ID="RadDatePicker1" runat="server" >
<ClientEvents OnDateSelected="DatePicker_OnDateSelected" />
</radCln:RadDatePicker> -
-
- -
- - - Gets or sets the name of the client-side event handler that is executed prior to - opening the calendar popup and its synchronizing with the DateInput value. - - - There can be some conditions you do want not to open the calendar popup on - click of the popup button. Then you should cancel the event either by return - false; or set its argument args.CancelOpen = true; -
-            <script type="text/javascript">
function Opening(sender, args)
{
args.CancelOpen = true;
//or
return false;
}
</script>
<radCln:RadDatePicker ID="RadDatePicker1" runat="server">
<ClientEvents OnPopupOpening="Opening"/>
</radCln:RadDatePicker> -
- Set the args.CancelSynchronize = true; to override the default - DatePicker behavior of synchronizing the date in the DateInput and Calendar - controls. This is useful for focusing the Calendar control on a date different from - the DateInput one. -
-            <script type="text/javascript">
function Opening(sender, args)
{
args.CancelCalendarSynchronize = true;
sender.Calendar.NavigateToDate([2006,12,19]);
}
</script>
<radCln:RadDatePicker ID="RadDatePicker1" runat="server" >
<ClientEvents OnPopupOpening="Opening"/>
</radCln:RadDatePicker> -
-
- -
-            [ASPX/ASCX]        
-            
-
-            <script type="text/javascript">
function OnPopupOpening(datepickerInstance, args)
{
......
}
</script>

<radcln:RadDatePicker ID="RadDatePicker1" runat="server">
<ClientEvents OnPopupOpening="OnPopupOpening" />
</radcln:RadDatePicker> -
-
-
- - - Gets or sets the name of the client-side event handler that is executed prior to - closing the calendar popup. - - -
-            [ASPX/ASCX]        
-            
-
-            <script type="text/javascript">
function OnPopupClosing(datepickerInstance, args)
{
......
}
</script>

<radcln:RadDatePicker ID="RadDatePicker1" runat="server">
<ClientEvents OnPopupClosing="OnPopupClosing" />
</radcln:RadDatePicker> -
-
- - There can be some conditions you do want not to close the calendar popup on - click over it. Then you should cancel the event either by return false; or - set its argument args.CancelClose = true; -
-            <script type="text/javascript">
function Closing(sender, args)
{
args.CancelClose = true;
//or
return false;
}
</script>
<radCln:RadDatePicker ID="RadDatePicker1" runat="server">
<ClientEvents OnPopupClosing="Closing"/>
</radCln:RadDatePicker> -
-
-
- - - Arguments class used with the DayRender event. - - - - - Gets a reference to the TableCell object that represents the specified day to render. - - - - - Gets a reference to the RadCalendarDay object that represents the specified day to render. - - - - - Gets a reference to the MonthView object that represents the current View, corresponding to the specified day to render. - - - - - Arguments class used when the DefaultViewChanged event is fired. - - - - - Gets the CalendarView instance that was the default one prior to the rise of DefaultViewChanged - event. - - - - - Gets the new default CalendarView instance set by the DefaultViewChanged event. - - - - - Arguments class used with the DayRender event. - - - - - Gets a reference to the TableCell object that represents the specified day to render. - - - - - Gets a reference to the RadCalendarDay object that represents the specified day to render. - - - - - Provides data for the SelectedDateChanged event of the DatePicker control. - - - - - Arguments class used when the SelectionChanged event is fired. - - - - - Gets a reference to the SelectedDates collection, represented by the Telerik RadCalendar component - that rise the SelectionChanged event. - - - - - The MonthYearFastNavigationSettings class can be used to configure RadCalendar's - client-side fast navigation. - - - - Gets or sets the value of the "Today" button caption; - - This property can be used to localize the button caption. The default is - "Today". - - - - Gets or sets the value of the "OK" button caption; - - This property can be used to localize the button caption. The default is - "OK". - - - - Gets or sets the value of the "Cancel" button caption; - - This property can be used to localize the button caption. The default is - "Cancel". - - - - Gets or sets the value of the "Date is out of range" error message. - - This property can be used to localize the message the user sees when she tries to navigate to a date outside the allowed range. - The default is "Date is out of range.". - - - - Gets or sets the value indicating whether the Today button should perform date selection or simple navigation. - - The default value is false (i.e. Today button works as a navigation enhancement only). - - - - - Summary description for PropertyItem. - - - - - Wrapper class for System.DateTime, which allows implementing persistable DateTime collections - like DateTimeCollection. - - - - - The System.DateTime represented by this RadDate wrapper class. - - - - - The control that toggles the calendar popup. - You can customize the appearance by setting the object's properties. - - - - - Gets or sets the popup button image URL. - - - - - Gets or sets the popup button hover image URL. - - - - - Override this method to provide any last minute configuration changes. Make sure you call the base implementation. - - - - - Override this method to provide any last minute configuration changes. Make sure you call the base implementation. - - - - - Clears the selected date of the RadDatePicker control and displays a blank date. - - - - IPostBackDataHandler implementation - - - Gets or sets default path for the grid images when EnableEmbeddedSkins is set to false. - A string containing the path for the grid images. The default is string.Empty. - - - - - - - - - Occurs after all child controls of the DatePicker control have been created. - You can customize the control there, and add additional child controls. - - - - - Occurs when the selected date of the DatePicker changes between posts to the server. - - - - - Gets the RadCalendar instance of the datepicker control. - - - - - Gets the RadDateInput instance of the datepicker control. - - - - - Gets the DatePopupButton instance of the datepicker control. - You can use the object to customize the popup button's appearance and behavior. - - - - - Gets or sets a value indicating whether a postback to the server automatically occurs when the user interacts with the control. - - - Setting this property to true will make RadDatePicker postback to the server - on date selection through the Calendar or the DateInput components. - - - The default value is false. - - - - Gets or sets the date content of RadDatePicker. - - A DateTime object that represents the selected - date. The default value is MinDate. - - - The following example demonstrates how to use the SelectedDate - property to set the content of RadDatePicker. - - private void Page_Load(object sender, System.EventArgs e) - { - RadDatePicker1.SelectedDate = DateTime.Now; - } - - - Private Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles MyBase.Load - RadDatePicker1.SelectedDate = DateTime.Now - End Sub - - - - - - This property is used by the RadDateInput's internals only. It is subject to - change in the future versions. Please do not use. - - - - Gets or sets the date content of RadDatePicker in a database friendly way. - - A DateTime object that represents the selected - date. The default value is null (Nothing in VB). - - - The following example demonstrates how to use the DbSelectedDate - property to set the content of RadDatePicker. - - private void Page_Load(object sender, System.EventArgs e) - { - RadDatePicker1.DbSelectedDate = tableRow["BirthDate"]; - } - - - Private Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles MyBase.Load - RadDatePicker1.DbSelectedDate = tableRow("BirthDate") - End Sub - - - - This property behaves exactly like the SelectedDate property. The only difference - is that it will not throw an exception if the new value is null or DBNull. Setting a - null value will internally revert the SelectedDate to the null value, i.e. the input value will be empty. - - - - - Used to determine if RadDatePicker is empty. - - - true if the date is empty; otherwise false. - - - - - Enables or disables typing in the date input box. - - - true if the user should be able to select a date by typing in the date input box; otherwise - false. The default value is true. - - - - - Gets or sets the minimal range date for selection. - Selecting a date earlier or equal to that will not be allowed. - - - This property has a default value of 1/1/1980 - - - - - Gets or sets the latest valid date for selection. - Selecting a date later than that will not be allowed. - - - This property has a default value of 12/31/2099 - - - - Gets or sets the culture used by RadDatePicker to format the date. - - A CultureInfo object that represents the current culture used. The default value is System.Threading.Thread.CurrentThread.CurrentUICulture. - - - The following example demonstrates how to use the Culture - property. - - private void Page_Load(object sender, System.EventArgs e) - { - RadDatePicker1.Culture = new CultureInfo("en-US"); - } - - - Private Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles MyBase.Load - RadDatePicker1.Culture = New CultureInfo("en-US") - End Sub - - - - - - Gets or sets the ID of the calendar that will be used for picking dates. This - property allows you to configure several datepickers to use a single RadCalendar - instance. - - - RadDatePicker will look for the RadCalendar instance in a way similar to how - ASP.NET validators work. It will not go beyond the current naming container which - means that you will not be able to configure a calendar that is inside a control in - another naming container. You can still share a calendar, but you will have to pass - a direct object reference via the SharedCalendar - property. - - The string ID of the RadCalendar control if set; otherwise String.Empty. - - - - Gets or sets the reference to the calendar that will be used for picking dates. - This property allows you to configure several datepickers to use a single RadCalendar - instance. - - The RadCalendar instance if set; otherwise null; - - This property is not accessible from the VS.NET designer and you will have to - set it from the code-behind. It should be used when the shared calendar instance is - in another naming container or is created dynamically at runtime. - - - - - Gets or sets the date that the - Calendar uses for - focusing itself whenever the - RadDateInput component of - the RadDatePicker is - empty. - - - - - Gets or sets the width of the datepicker in pixels. - - - - - Gets or sets an instance of - DatePickerClientEvents - class which defines the JavaScript functions (client-side event handlers) that are - invoked when specific client-side events are raised. - - - - - This property is used by the RadDateTimeInput's internals only. It is subject to - change in the future versions. Please do not use. - - - - - Gets the RadTimeView instance of the datetimepicker control. - - - - - Gets the TimePopupButton instance of the RadDateTimeView - control. - - - You can use the object to customize the popup button's appearance and - behavior. - - - - - Gets or sets a value indicating whether a postback to the server - automatically occurs when the user interacts with the control. - - The default value is false. - - Setting this property to true will make RadDateTimePicker postback to the server - on date selection through the Calendar and Time popups or the DateInput - components. - - - - - Gets or sets the culture used by RadDateTimePicker to format the date and time - value. - - - A CultureInfo object that - represents the current culture used. The default value is - System.Threading.Thread.CurrentThread.CurrentUICulture. - - - The following example demonstrates how to use the Culture - property. - - private void Page_Load(object sender, System.EventArgs e) - { - RadDateTimePicker1.Culture = new CultureInfo("en-US"); - } - - - Private Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles MyBase.Load - RadDateTimePicker1.Culture = New CultureInfo("en-US") - End Sub - - - - - - Gets or sets a value indicating whether a postback to the server automatically - occurs when the user changes the list selection. - - The default value is None - - Set this to Both, TimeView or Calendar if the server needs to capture the - selection changed event. - This property is effective only for RadDateTimePicker; for RadTimePicker use the AutoPostBack property. - - - - - Gets or sets the ID of the timeview that will be used for picking time. This - property allows you to configure several datetimepickers to use a single RadTimeView - instance. - - - RadDateTimePicker will look for the RadTimeView instance in a way similar to how - ASP.NET validators work. It will not go beyond the current naming container which - means that you will not be able to configure a timeview that is inside a control in - another naming container. You can still share a timeview, but you will have to pass - a direct object reference via the SharedTimeView - property. - - The string ID of the RadTimeView if set; otherwise String.Empty. - - - - Gets or sets the reference to the timeview that will be used for picking time. - This property allows you to configure several datetimepickers to use a single RadTimeView - instance. - - The RadTimeView instance if set; otherwise null; - - This property is not accessible from the VS.NET designer and you will have to - set it from the code-behind. It should be used when the shared timeview instance is - in another naming container or is created dynamically at runtime. - - - - - Occurs when an item is data bound to the RadTimeView - control. - - - The ItemDataBound event is raised after an item is data - bound to the RadTimeView control. This event provides you with the - last opportunity to access the data item before it is displayed on the client. - After this event is raised, the data item is no longer available. - - - [ASPX] - <%@ Page Language="C#" AutoEventWireup="true" CodeFile="Default.aspx.cs" Inherits="_Default" %>
-
- <%@ Register Assembly="RadCalendar.Net2" Namespace="Telerik.WebControls" TagPrefix="radCln" %>
-
- <!DOCTYPE html PUBLIC - "-//W3C//DTD XHTML 1.0 Transitional//EN" - "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
- <html xmlns="http://www.w3.org/1999/xhtml" >
- <head runat="server">
- <title>Untitled Page</title>
- </head>
- <body>
- <form id="form1" - runat="server">
- <div>
- <radCln:RadTimePicker
- OnItemDataBound=
- "RadTimePicker1_ItemDataBound"
- ID="RadTimePicker1"
- runat="server">
- </radCln:RadTimePicker>
- </div>
- </form>
- </body>
- </html>
- - using System; - using System.Data; - using System.Configuration; - using System.Web; - using System.Web.Security; - using System.Web.UI; - using System.Web.UI.WebControls; - using System.Web.UI.WebControls.WebParts; - using System.Web.UI.HtmlControls; - - public partial class _Default : System.Web.UI.Page - { - protected void RadTimePicker1_ItemDataBound(object sender, Telerik.WebControls.Base.Calendar.Events.TimePickerEventArgs e) - { - if (e.Item.ItemType == ListItemType.AlternatingItem) - { - e.Item.Controls.Add(new LiteralControl("AlternatingItem")); - } - } - } - - - Imports System - Imports System.Data - Imports System.Configuration - Imports System.Web - Imports System.Web.Security - Imports System.Web.UI - Imports System.Web.UI.WebControls - Imports System.Web.UI.WebControls.WebParts - Imports System.Web.UI.HtmlControls - Public Class _Default - Inherits System.Web.UI.Page - - Protected Sub RadTimePicker1_ItemDataBound(ByVal sender As Object, ByVal e As Telerik.WebControls.Base.Calendar.Events.TimePickerEventArgs) - If (e.Item.ItemType = ListItemType.AlternatingItem) Then - e.Item.Controls.Add(New LiteralControl("AlternatingItem")) - End If - End Sub - End Class - -
-
- - - Occurs on the server when an item in the RadTimeView control is - created. - - - The ItemCreated event is raised when an item in the - RadTimeView control is created, both during round-trips and at the - time data is bound to the control. - The ItemCreated event is commonly used to control the - content and appearance of a row in the RadTimeView control. - - - The following code example demonstrates how to - specify and code a handler for the ItemCreated event to set the CSS styles on the - RadTimeView. - [ASPX] - <%@ Page Language="C#" AutoEventWireup="true" CodeFile="Default.aspx.cs" Inherits="_Default" %>
-
- <%@ Register Assembly="RadCalendar.Net2" Namespace="Telerik.WebControls" TagPrefix="radCln" %>
-
- <!DOCTYPE html PUBLIC - "-//W3C//DTD XHTML 1.0 Transitional//EN" - "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
- <html xmlns="http://www.w3.org/1999/xhtml" >
- <head runat="server">
- <title>Untitled Page</title>
- <style type="text/css">
- .TimeCss
- {
- background-color: Red;
- }
- .AlternatingTimeCss
- {
- background-color: Yellow;
- }
- </style>
- </head>
- <body>
- <form id="form1" - runat="server">
- <div>
- <radCln:RadTimePicker
- OnItemCreated=
- "RadTimePicker1_ItemCreated"
- ID="RadTimePicker1"
- runat="server">
- </radCln:RadTimePicker>
- </div>
- </form>
- </body>
- </html>
- - protected void RadTimePicker1_ItemCreated(object sender, Telerik.WebControls.Base.Calendar.Events.TimePickerEventArgs e) - { - if (e.Item.ItemType == ListItemType.Item) - { - e.Item.CssClass = "TimeCss"; - } - - if (e.Item.ItemType == ListItemType.AlternatingItem) - { - e.Item.CssClass = "AlternatingTimeCss"; - } - } - - - Protected Sub RadTimePicker1_ItemCreated(sender As Object, e As Telerik.WebControls.Base.Calendar.Events.TimePickerEventArgs) - If e.Item.ItemType = ListItemType.Item Then - e.Item.CssClass = "TimeCss" - End If - - If e.Item.ItemType = ListItemType.AlternatingItem Then - e.Item.CssClass = "AlternatingTimeCss" - End If - End Sub 'RadTimePicker1_ItemCreated - -
-
- - - Gets or sets a value indicating whether a postback to the server automatically occurs when the user interacts with the control. - - - Setting this property to true will make RadTimePicker postback to the server - on time selection through the TimeView or the DateInput components. - - - The default value is false. - - - - - Restores view-state information from a previous page request that was saved by the SaveViewState method. - - The saved view state. - - - - Saves any server control view-state changes that have occurred since the time the page was posted back to the server. - - The saved view state. - - - Gets a data bound list control that displays items using templates. - - - Gets or sets the template for alternating time cells in the RadTimeView. - - Use the AlternatingTimeTemplate property to control the - contents of alternating items in the RadTimeView control. The - appearance of alternating time cells is controlled by the - AlternatingTimeStyle property. - To specify a template for the alternating time cells, place the - <AlternatingTimeTemplate> tags between the opening and closing tags of the - RadTimeView control. You can then list the contents of the - template between the opening and closing <AlternatingTimeTemplate> - tags. - - - The following code example demonstrates how to use the - AlternatingTimeTemplate property to control the contents of - alternating items in the RadTimeView control. -
- - - - - - -
-
- - <%@ Page Language="C#" AutoEventWireup="true" CodeFile="Default.aspx.cs" Inherits="_Default" %> - - <%@ Register Assembly="RadCalendar.Net2" Namespace="Telerik.WebControls" TagPrefix="radCln" %> - - <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> - - <html xmlns="http://www.w3.org/1999/xhtml" > - <head runat="server"> - <title>Untitled Page</title> - </head> - <body> - <form id="form1" runat="server"> - <div> - <radCln:RadTimePicker - ID="RadTimePicker1" - runat="server"> - <TimeView> - <AlternatingTimeTemplate> - <input type="button" id="button1" value='<%# DataBinder.Eval(((DataListItem)Container).DataItem, "time", "{0:t}") %>' /> - </AlternatingTimeTemplate> - </TimeView> - </radCln:RadTimePicker> - </div> - </form> - </body> - </html> - -
-
- - - Gets or sets the template for the footer section of the - RadTimeView control. - - - To specify a template for the footer section, place the - <FooterTemplate> tags between the opening and closing tags of the - RadTimeView control. You can then list the contents of the - template between the opening and closing <FooterTemplate> tags. - The ShowFooter property must be set to true for this property to be - visible. - - - The following code example demonstrates how to use the - FooterTemplate property to control the contents of the footer - section of the RadTimeView control. - - <%@ Page Language="C#" AutoEventWireup="true" CodeFile="Default.aspx.cs" Inherits="_Default" %> - - <%@ Register Assembly="RadCalendar.Net2" Namespace="Telerik.WebControls" TagPrefix="radCln" %> - - <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> - - <html xmlns="http://www.w3.org/1999/xhtml" > - <head runat="server"> - <title>Untitled Page</title> - </head> - <body> - <form id="form1" runat="server"> - <div> - <radCln:RadTimePicker - ID="RadTimePicker1" - runat="server"> - <TimeView ShowFooter="true"> - <FooterTemplate> - <asp:Label ID="Label1" runat="server" Text="Footer"></asp:Label> - </FooterTemplate> - </TimeView> - </radCln:RadTimePicker> - </div> - </form> - </body> - </html> - - - - - - Gets or sets the template for the heading section of the RadTimeView - control. - - - Use the HeaderTemplate property to control the contents of - the heading section. The appearance of the header section is controlled by the - HeaderStyle property. - To specify a template for the heading section, place the - <HeadingTemplate> tags between the opening and closing tags of the - RadTimeView control. You can then list the contents of the - template between the opening and closing <HeadingTemplate> tags. - The ShowHeader property must be set to true for this property to be - visible. - - - The following code example demonstrates how to use the - HeaderTemplate property to control the contents of the heading - section of the RadTimeView control. - - <%@ Page Language="C#" AutoEventWireup="true" CodeFile="Default.aspx.cs" Inherits="_Default" %> - - <%@ Register Assembly="RadCalendar.Net2" Namespace="Telerik.WebControls" TagPrefix="radCln" %> - - <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> - - <html xmlns="http://www.w3.org/1999/xhtml" > - <head runat="server"> - <title>Untitled Page</title> - </head> - <body> - <form id="form1" runat="server"> - <div> - <radCln:RadTimePicker - ID="RadTimePicker1" - runat="server"> - <TimeView> - <HeaderTemplate> - <asp:Label ID="Label1" runat="server" Text="Header"></asp:Label> - </HeaderTemplate> - </TimeView> - </radCln:RadTimePicker> - </div> - </form> - </body> - </html> - - - - - - Gets or sets the template for the heading section of the RadTimeView - control. - - - Use the HeaderTemplate property to control the contents of - the heading section. The appearance of the header section is controlled by the - HeaderStyle property. - To specify a template for the heading section, place the - <HeadingTemplate> tags between the opening and closing tags of the - RadTimeView control. You can then list the contents of the - template between the opening and closing <HeadingTemplate> tags. - The ShowHeader property must be set to true for this property to be - visible. - - - The following code example demonstrates how to use the - HeaderTemplate property to control the contents of the heading - section of the RadTimeView control. - - <%@ Page Language="C#" AutoEventWireup="true" CodeFile="Default.aspx.cs" Inherits="_Default" %> - - <%@ Register Assembly="RadCalendar.Net2" Namespace="Telerik.WebControls" TagPrefix="radCln" %> - - <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> - - <html xmlns="http://www.w3.org/1999/xhtml" > - <head runat="server"> - <title>Untitled Page</title> - </head> - <body> - <form id="form1" runat="server"> - <div> - <radCln:RadTimePicker - ID="RadTimePicker1" - runat="server"> - <TimeView> - <HeaderTemplate> - <asp:Label ID="Label1" runat="server" Text="Header"></asp:Label> - </HeaderTemplate> - </TimeView> - </radCln:RadTimePicker> - </div> - </form> - </body> - </html> - - - - - - Gets or sets the foreground color (typically the color of the text) of the - RadTimeView control. - - - A System.Drawing.Color that represents the foreground color of the control. The - default is Color.Empty. - - - Use the ForeColor property to specify the foreground color - of the RadTimeView control. The foreground color is usually the - color of the text. This property will render on browsers earlier than Microsoft - Internet Explorer version 4. - Note: On browsers that do not support styles, this property is rendered as a - FONT element. - - - On browsers that do not support styles, this property is rendered as a FONT - element. - - - - - Gets or sets the background color of the RadTimeView - control. - - - Use the BackColor property to specify the background color - of the RadTimeView control. This property is set using a - System.Drawing.Color object. - In general, only controls that render as a <table> tag can display a - background color in HTML 3.2, whereas almost any control can in HTML 4.0. - For controls that render as a <span> tag (including Label, all - validation controls, and list controls with their RepeatLayout property set to - RepeatLayout.Flow), this property will work in Microsoft Internet Explorer version - 5 or later, but not for Microsoft Internet Explorer version 4. - - - - Gets or sets the border color of the RadTimeView control. - - Use the BorderColor property to specify the border color of the - RadTimeView control. This property is set using a System.Drawing.Color - object. - - - A System.Drawing.Color that represents the border color of the control. The - default is Color.Empty, which indicates that this property is not set. - - - - Gets or sets the border style of the RadTimeView control. - - One of the BorderStyle enumeration values. The default is - NotSet. - - - Use the BorderStyle property to specify the border style for - the RadTimeView control. This property is set using one of the - BorderStyle enumeration values. The following table lists the - possible values. - - - - Border Style - Description - - - NotSet - The border style is not set. - - - None - No border - - - Dotted - A dotted line border. - - - Dashed - A dashed line border. - - - Solid - A solid line border. - - - Double - A solid double line border. - - - Groove - A grooved border for a sunken border - appearance. - - - Ridge - A ridged border for a raised border - appearance. - - - Inset - An inset border for a sunken control - appearance. - - - - Note: This property will not render on some browsers. - - - - Gets or sets the border width of the RadTimeView control. - - A Unit that represents the border width of a RadTimeView control. The default - value is Unit.Empty, which indicates that this property is not set. - - - Use the BorderWidth property to specify a border width for a - control. - This property is set with a Unit object. If the Value property of the Unit - contains a negative number, an exception is thrown. - - - - - Gets or sets the cascading style sheet (CSS) class rendered by the - RadTimeView on the client. - - - The CSS class rendered by the RadTimeView control on the client. - The default is String.Empty. - - - Use the CssClass property to specify the CSS class to render on the client - for the RadTimeView control. This property will render on browsers - for all controls. It will always be rendered as the class attribute, regardless of - the browser. - For example, suppose you have the following RadTimeVeiw - control declaration: - <asp:TextBox id="TextBox1" ForeColor="Red" CssClass="class1" /> - The following HTML is rendered on the client for the previous - RadTimeView control declaration: - - - - Gets or sets the height of the RadTimeView control. - - A Unit that represents the height of the RadTimeView - control. The default is Empty. - - - Use the Height property to specify the height of the - RadTimeView control. - - - - Gets or sets the width of the RadTimeView control. - - A Unit that represents the width of the RadTimeView control. The - default is Empty. - - - Use the Width property to specify the width of the - RadTimeView control. - - - - - Gets the font properties associated with the RadTimeView - control. - - A FontInfo that represents the font properties of the Web server control. - - Use the Font property to specify the font properties of the - RadTimeView control. This property includes subproperties that can be - accessed declaratively in the form of Property-Subproperty (for example Font-Bold) or - programmatically in the form of Property.Subproperty (for example Font.Bold). - - - - Gets or sets default path for the grid images when EnableEmbeddedSkins is set to false. - A string containing the path for the grid images. The default is string.Empty. - - - - - - - - - - Gets or sets a value that specifies whether the border between the cells of the - RadTimeView control is displayed. - - - One of the GridLines enumeration values. The default is - Both. - - - Use the GridLines property to specify whether the border between - the cells of the data list control is displayed. This property is set with one of the - GridLines enumeration values. - - - - - Gets or sets the hetader associated with the RadTimeView - control. - - Use HeaderText when UseAccessibleHeader is set to true - - - Gets or sets the alignemt of the associated caption. - - - - Indicates that the control should use accessible header cells in its containing - table control. - - - - Gets or sets the descriptive caption associated with the control. - - - - Occurs on the client when an time sell in the RadTimeView - control is selected. - - The default value is String.Empty - - The following example demonstrates how to attach the - OnClientSelectedEvent - - <%@ Page Language="C#" AutoEventWireup="true" CodeFile="Default.aspx.cs" Inherits="_Default" %> - - <%@ Register Assembly="RadCalendar.Net2" Namespace="Telerik.WebControls" TagPrefix="radCln" %> - - <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> - - <html xmlns="http://www.w3.org/1999/xhtml" > - <head runat="server"> - <title>Untitled Page</title> - <script language="javascript"> - function ClientTimeSelected(sender, args) - { - alert(args.oldTime); - alert(args.newTime); - } - </script> - </head> - <body> - <form id="form1" runat="server"> - <div> - <radCln:RadTimePicker - ID="RadTimePicker1" - runat="server"> - <TimeView OnClientTimeSelected="ClientTimeSelected"> - </TimeView> - </radCln:RadTimePicker> - </div> - </form> - </body> - </html> - - - - - - Gets or sets the horizontal alignment of the RadTimeView - control. - - - One of the HorizontalAlign enumeration values. The default is - NotSet. - - - Use the HorizontalAlign property to specify the horizontal - alignment of the data list control within its container. This property is set with one - of the HorizontalAlign enumeration values. - - - - - Gets or sets the amount of space between the contents of the cell and the cell's - border. - - - The distance (in pixels) between the contents of a cell and the cell's border. - The default is -1, which indicates that this property is not set. - - - Use the CellPadding property to control the spacing between - the contents of a cell and the cell's border. The padding amount specified is added - to all four sides of a cell. - All cells in the same column of a data listing control share the same cell - width. Therefore, if the content of one cell is longer than the content of other - cells in the same column, the padding amount is applied to the widest cell. All - other cells in the column are also set with this cell width. - Similarly, all cells in the same row share the same height. The padding - amount is applied to the height of the tallest cell in the row. All other cells in - the same row are set with this cell height. Individual cell sizes cannot be - specified. - The value of this property is stored in view state. - - - - - Gets or sets the distance between time cells of the - RadTimeView. - - - The distance (in pixels) between table cells. The default is -1, which indicates - that this property is not set. - - - Use the CellSpacing property to control the spacing between - adjacent cells in a data listing control. This spacing is applied both vertically - and horizontally. The cell spacing is uniform for the entire data list control. - Individual cell spacing between each row or column cannot be specified. - The value of this property is stored in view state. - - - - - Gets or sets the number of columns to display in the RadTimeView - control. - - - Use this property to specify the number of columns that display items in the - RadTimeView control. For example, if you set this property to 5, the - RadTimeView control displays its items in five columns. - - - The following code example demonstrates how to use the Columns - property to specify the number of columns to display in the - RadTimeView control. - - <%@ Page Language="C#" AutoEventWireup="true" CodeFile="Default.aspx.cs" Inherits="_Default" %> - - <%@ Register Assembly="RadCalendar.Net2" Namespace="Telerik.WebControls" TagPrefix="radCln" %> - - <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> - - <html xmlns="http://www.w3.org/1999/xhtml" > - <head runat="server"> - <title>Untitled Page</title> - </head> - <body> - <form id="form1" runat="server"> - <div> - <radCln:RadTimePicker - ID="RadTimePicker1" - runat="server"> - <TimeView Columns="5" > - </TimeView> - </radCln:RadTimePicker> - </div> - </form> - </body> - </html> - - - - - - Gets or sets a value indicating whether the footer section is displayed in - the RadTimeView control. - - - true if the footer section is displayed; otherwise, false. The default value is - true, however this property is only examined when the FooterTemplate - property is not a null reference (Nothing in Visual Basic). - - - Use the ShowFooter property to specify whether the footer - section is displayed in the RadTimeView control. - You can control the appearance of the footer section by setting the - FooterStyle property. The contents of the footer section are - controlled by the FooterTemplate property. - - - The following code example demonstrates how to use the - ShowFooter property to display the footer section in the - RadTimeView control. - - <%@ Page Language="C#" AutoEventWireup="true" CodeFile="Default.aspx.cs" Inherits="_Default" %> - - <%@ Register Assembly="RadCalendar.Net2" Namespace="Telerik.WebControls" TagPrefix="radCln" %> - - <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> - - <html xmlns="http://www.w3.org/1999/xhtml" > - <head runat="server"> - <title>Untitled Page</title> - </head> - <body> - <form id="form1" runat="server"> - <div> - <radCln:RadTimePicker - ID="RadTimePicker1" - runat="server"> - <TimeView ShowFooter="true" > - <FooterTemplate> - <asp:Label ID="Label1" runat="server" Text="Hello Footer!"></asp:Label> - </FooterTemplate> - </TimeView> - </radCln:RadTimePicker> - </div> - </form> - </body> - </html> - - - - - - Gets or sets a value indicating whether the header section is displayed in the - RadTimeView control. - - - true if the header is displayed; otherwise, false. The default value is true, - however this property is only examined when the HeaderTemplate - property is not a null reference (Nothing in Visual Basic). - - - Use the ShowHeader property to specify whether the header - section is displayed in the RadTimeView control. - You can control appearance of the header section by setting the - HeaderStyle property. The contents of the header section are - controlled by the HeaderTemplate property. - - - The following code example demonstrates how to use the - ShowHeader property to display the header section in the - RadTimeView control. - - <%@ Page Language="C#" AutoEventWireup="true" CodeFile="Default.aspx.cs" Inherits="_Default" %> - - <%@ Register Assembly="RadCalendar.Net2" Namespace="Telerik.WebControls" TagPrefix="radCln" %> - - <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> - - <html xmlns="http://www.w3.org/1999/xhtml" > - <head runat="server"> - <title>Untitled Page</title> - </head> - <body> - <form id="form1" runat="server"> - <div> - <radCln:RadTimePicker - ID="RadTimePicker1" - runat="server"> - <TimeView ShowHeader="true"> - <HeaderTemplate> - <asp:Label ID="Label1" runat="server" Text="Hello Header!"></asp:Label> - </HeaderTemplate> - </TimeView> - </radCln:RadTimePicker> - </div> - </form> - </body> - </html> - - - - - Gets or sets the start time of the control. - - - - Provides information about a specific culture. The information includes the names - for the culture, the writing system, the calendar used, and formatting for the - times. - - - The CultureInfo class renders culture-specific information, - such as the associated language, sublanguage, country/region, calendar, and - cultural conventions. This class also provides access to culture-specific instances - of DateTimeFormatInfo, NumberFormatInfo, CompareInfo, and TextInfo. These objects - contain the information required for culture-specific operations, such as casing, - formatting dates and numbers, and comparing strings. - - - - ite - - - - Gets or sets the interval between StartTime and - EndTime - - - - Gets or sets the format of the time. - - A custom Time format string consists of one or more custom Time format - specifiers, and that format string defines the text representation of a DateTime - object that is produced by a formatting operation. - Custom Time format specifiers. - - - - h - Represents the hour as a number from 1 through 12, that - is, the hour as represented by a 12-hour clock that counts the whole - hours since midnight or noon. Consequently, a particular hour after - midnight is indistinguishable from the same hour after noon. The hour - is not rounded, and a single-digit hour is formatted without a leading - zero. For example, given a time of 5:43, this format specifier displays - "5". For more information about using a single format specifier, see - Using Single Custom Format Specifiers. - - - hh, hh (plus any number of additional "h" specifiers) - Represents the hour as a number from 01 through 12, that - is, the hour as represented by a 12-hour clock that counts the whole - hours since midnight or noon. Consequently, a particular hour after - midnight is indistinguishable from the same hour after noon. The hour - is not rounded, and a single-digit hour is formatted with a leading - zero. - - - H - Represents the hour as a number from 0 through 23, that - is, the hour as represented by a zero-based 24-hour clock that counts - the hours since midnight. A single-digit hour is formatted without a - leading zero. - - - HH, HH (plus any number of additional "H" specifiers) - Represents the hour as a number from 00 through 23, that - is, the hour as represented by a zero-based 24-hour clock that counts - the hours since midnight. A single-digit hour is formatted with a - leading zero. - - - m - Represents the minute as a number from 0 through 59. The - minute represents whole minutes passed since the last hour. A - single-digit minute is formatted without a leading zero. - - - mm, mm (plus any number of additional "m" specifiers) - Represents the minute as a number from 00 through 59. The - minute represents whole minutes passed since the last hour. A - single-digit minute is formatted with a leading zero. - - - s - Represents the seconds as a number from 0 through 59. The - second represents whole seconds passed since the last minute. A - single-digit second is formatted without a leading zero. - - - ss, ss (plus any number of additional "s" specifiers) - Represents the seconds as a number from 00 through 59. The - second represents whole seconds passed since the last minute. A - single-digit second is formatted with a leading zero. - - - t - Represents the first character of the A.M./P.M. designator - defined in the current - System.Globalization.DateTimeFormatInfo.AMDesignator or - System.Globalization.DateTimeFormatInfo.PMDesignator property. The A.M. - designator is used if the hour in the time being formatted is less than - 12; otherwise, the P.M. designator is used. - - - tt, tt (plus any number of additional "t" specifiers) - Represents the A.M./P.M. designator as defined in the - current System.Globalization.DateTimeFormatInfo.AMDesignator or - System.Globalization.DateTimeFormatInfo.PMDesignator property. The A.M. - designator is used if the hour in the time being formatted is less than - 12; otherwise, the P.M. designator is used. - - - -
- Standard Time Format Specifiers
- - - - t - ShortTimePattern - For example, the custom format string - for the invariant culture is "HH:mm". - - - T - LongTimePattern - For example, the custom format string - for the invariant culture is "HH:mm:ss". - - - -
-
- - - Gets the style properties for the time cells in the RadTimeView - control. - - - Use this property to provide a custom style for the items of the - RadTimeView control. Common style attributes that can be adjusted - include foreground color, background color, font, and content alignment within the - cell. Providing a different style enhances the appearance of the - RadTimeView control. - If you specify a red font for the TimeStyle property, all - other item style properties in the RadTimeView control will also - have a red font. This allows you to provide a common appearance for the control by - setting a single item style property. You can override the inherited style settings - for an item style property that is higher in the hierarchy by setting its style - properties. For example, you can specify a blue font for the - AlternatingTimeStyle property, overriding the red font specified - in the TimeStyle property. - To specify a custom style for the items of the RadTimeView - control, place the <TimeStyle> tags between the opening and closing tags of - the RadTimeView control. You can then list the style attributes - within the opening <TimeStyle> tag. - You can also use the AlternatingTimeStyle property to provide a different - appearance for the alternating items in the RadTimeView - control. - - - The following code example demonstrates how to use the TimeStyle - property to specify a different background color for the time cells in the - RadTimeView control. - - <%@ Page Language="C#" AutoEventWireup="true" CodeFile="Default.aspx.cs" Inherits="_Default" %> - - <%@ Register Assembly="RadCalendar.Net2" Namespace="Telerik.WebControls" TagPrefix="radCln" %> - - <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> - - <html xmlns="http://www.w3.org/1999/xhtml" > - <head runat="server"> - <title>Untitled Page</title> - </head> - <body> - <form id="form1" runat="server"> - <div> - <div> - <asp:DropDownList AutoPostBack="true" ID="DropDownList1" runat="server" OnSelectedIndexChanged="DropDownList1_SelectedIndexChanged"> - <asp:ListItem Text="Select" Value=""></asp:ListItem> - <asp:ListItem Text="DarkGray" Value="DarkGray"></asp:ListItem> - <asp:ListItem Text="Khaki" Value="Khaki"></asp:ListItem> - <asp:ListItem Text="DarkKhaki" Value="DarkKhaki"></asp:ListItem> - </asp:DropDownList> - </div> - <radCln:RadTimePicker - ID="RadTimePicker1" - runat="server"> - <TimePopupButton ImageUrl="clock.gif" HoverImageUrl="clock.gif" /> - <TimeView Skin="None"> - </TimeView> - </radCln:RadTimePicker> - </div> - </form> - </body> - </html> - - - using System; - using System.Data; - using System.Configuration; - using System.Web; - using System.Web.Security; - using System.Web.UI; - using System.Web.UI.WebControls; - using System.Web.UI.WebControls.WebParts; - using System.Web.UI.HtmlControls; - - public partial class _Default : System.Web.UI.Page - { - protected void DropDownList1_SelectedIndexChanged(object sender, EventArgs e) - { - this.RadTimePicker1.TimeView.TimeStyle.BackColor = - System.Drawing.Color.FromName(this.DropDownList1.SelectedItem.Value); - } - } - - - - - - Gets the style properties for alternating time sells in the - RadTimeView control. - - - Use the AlternatingTimeStyle property to provide a custom - style for the alternating time cells in the RadTimeView control. - Common style attributes that can be adjusted include foreground color, background - color, font, and content alignment within the cell. Providing a different style - enhances the appearance of the RadTimeView control. - If you specify a red font for the TimeStyle property, all - other item style properties in the RadTimeView control will also - have a red font. This allows you to provide a common appearance for the control by - setting a single item style property. You can override the inherited style settings - for an item style property that is higher in the hierarchy by setting its style - properties. For example, you can specify a blue font for the - AlternatingTimeStyle property, overriding the red font specified - in the TimeStyle property. - To specify a custom style for the alternating items, place the - <AlternatingTimeStyle> tags between the opening and closing tags of the - RadTimeView control. You can then list the style attributes within - the opening <AlternatingTimeStyle> tag. - - - The following code example demonstrates how to use the - AlternatingTimeStyle property to specify a different background - color for alternating items in the RadTimeView control. - - <%@ Page Language="C#" AutoEventWireup="true" CodeFile="Default.aspx.cs" Inherits="_Default" %> - - <%@ Register Assembly="RadCalendar.Net2" Namespace="Telerik.WebControls" TagPrefix="radCln" %> - - <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> - - <html xmlns="http://www.w3.org/1999/xhtml" > - <head runat="server"> - <title>Untitled Page</title> - </head> - <body> - <form id="form1" runat="server"> - <div> - <div> - <asp:DropDownList AutoPostBack="true" ID="DropDownList1" runat="server" OnSelectedIndexChanged="DropDownList1_SelectedIndexChanged"> - <asp:ListItem Text="Select" Value=""></asp:ListItem> - <asp:ListItem Text="DarkGray" Value="DarkGray"></asp:ListItem> - <asp:ListItem Text="Khaki" Value="Khaki"></asp:ListItem> - <asp:ListItem Text="DarkKhaki" Value="DarkKhaki"></asp:ListItem> - </asp:DropDownList> - </div> - <radCln:RadTimePicker - ID="RadTimePicker1" - runat="server"> - <TimePopupButton ImageUrl="clock.gif" HoverImageUrl="clock.gif" /> - <TimeView Skin="None"> - </TimeView> - </radCln:RadTimePicker> - </div> - </form> - </body> - </html> - - - using System; - using System.Data; - using System.Configuration; - using System.Web; - using System.Web.Security; - using System.Web.UI; - using System.Web.UI.WebControls; - using System.Web.UI.WebControls.WebParts; - using System.Web.UI.HtmlControls; - - public partial class _Default : System.Web.UI.Page - { - protected void DropDownList1_SelectedIndexChanged(object sender, EventArgs e) - { - this.RadTimePicker1.TimeView.AlternatingTimeStyle.BackColor = - System.Drawing.Color.FromName(this.DropDownList1.SelectedItem.Value); - } - } - - - - - - Gets the style properties for the heading section of the - RadTimeView control. - - - Use this property to provide a custom style for the heading of the - RadTimeView control. Common style attributes that can be adjusted - include foreground color, background color, font, and content alignment within the - cell. Providing a different style enhances the appearance of the - RadTimeView control. - To specify a custom style for the heading section, place the - <HeaderStyle> tags between the opening and closing tags of the - RadTimeView control. You can then list the style attributes within - the opening <HeaderStyle> tag. - Note: The ShowHeader property must be set - to true for this property to be visible. - - - The following code example demonstrates how to use the HeaderStyle - property to specify a custom background color for the heading section of the - RadTimeView control. - - <%@ Page Language="C#" AutoEventWireup="true" CodeFile="Default.aspx.cs" Inherits="_Default" %> - - <%@ Register Assembly="RadCalendar.Net2" Namespace="Telerik.WebControls" TagPrefix="radCln" %> - - <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> - - <html xmlns="http://www.w3.org/1999/xhtml" > - <head runat="server"> - <title>Untitled Page</title> - </head> - <body> - <form id="form1" runat="server"> - <div> - <radCln:RadTimePicker - ID="RadTimePicker1" - runat="server"> - <TimePopupButton ImageUrl="clock.gif" HoverImageUrl="clock.gif" /> - <TimeView Skin="None" ShowHeader="true"> - <HeaderStyle BackColor="red" /> - </TimeView> - </radCln:RadTimePicker> - </div> - </form> - </body> - </html> - - - - - - Gets the style properties for the footer section of the - RadTimeView control. - - - Use this property to provide a custom style for the footer section of the - radTimeView control. Common style attributes that can be adjusted - include foreground color, background color, font, and content alignment within the - cell. Providing a different style enhances the appearance of the - RadTimeView control. - The FooterStyle property of the RadTimeView - control inherits the style settings of the ControlStyle property. For example, if - you specify a red font for the ControlStyle property, the - FooterStyle property will also have a red font. This allows you to - provide a common appearance for the control by setting a single style property. You - can override the inherited style settings by setting the - FooterStyle property. For example, you can specify a blue font for - the FooterStyle property, overriding the red font specified in the - ControlStyle property. - To specify a custom style for the footer section, place the - <FooterStyle> tags between the opening and closing tags of the - RadTimeView control. You can then list the style attributes within - the opening <FooterStyle> tag. - Note: The ShowFooter property must be set - to true for this property to be visible. - - - The following code example demonstrates how to use the - FooterStyle property to specify a custom background color for the - footer section of the RadTimeView control. - - <%@ Page Language="C#" AutoEventWireup="true" CodeFile="Default.aspx.cs" Inherits="_Default" %> - - <%@ Register Assembly="RadCalendar.Net2" Namespace="Telerik.WebControls" TagPrefix="radCln" %> - - <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> - - <html xmlns="http://www.w3.org/1999/xhtml" > - <head runat="server"> - <title>Untitled Page</title> - </head> - <body> - <form id="form1" runat="server"> - <div> - <radCln:RadTimePicker - ID="RadTimePicker1" - runat="server"> - <TimePopupButton ImageUrl="clock.gif" HoverImageUrl="clock.gif" /> - <TimeView Skin="None" ShowFooter="true"> - <FooterStyle BackColor="Aqua" /> - </TimeView> - </radCln:RadTimePicker> - </div> - </form> - </body> - </html> - - - - - - The control that toggles the TimeView popup. - You can customize the appearance by setting the object's properties. - - - - - Custom Type convertor that gives enhanced selection abilities for the properties that - reffer to collections like CalendarDayCollection. - - - - - Summary description for JsBuilder. - - - - - Summary description for Utility. - - - - - This static member is used translating .NET arrays to JS arrays. - Acts like a compressor. - - The 1D array to compress - The compressed string - - - - Converts an input 2D JavaScript array like [[5,10,2005],[6,10,2005],[7,10,2005]] into a DateTimeCollection. - - The DateTimeCollection that will be filled. - The input string. - - - - RadCalendarDay represents a object that maps date value to corresponding visual settings. - Also the object implements Boolean properties that represent the nature of the selected date - - whether it is a weekend, disabled or selected in the context of the calendar. Mostly the values - of those properties are set at runtime when a RadCalendarDay instance is constructed and passed - to the DayRender event. - - - - - Summary description for RichUITemplateControl. - - - - - Reset all properties to their defaults. - - - - - Persists the ID of the template used by this instance of RichUITemplateControl if - any. The TemplateID could be used to index the Templates collection and instantiate - the required template. - - - - - Gets or sets the date represented by this RadCalendarDay. - - - - - Gets the style properties for the RadCalendarDay - instance. - - - A TableItemStyle that contains the style properties for the RadCalendarDay instance. - - - - - Gets or sets a value indicating whether the RadCalendarDay is qualified as available for selection. - - - - - Gets or sets a value indicating whether the RadCalendarDay is selected - - - - - Gets or sets a value indicating whether the RadCalendarDay is disabled - - - - - Gets or sets a value indicating whether the RadCalendarDay represents the current date. - - - - - Gets or sets a value indicating whether the RadCalendarDay settings are repeated/recurring through out the valid - date range displayed by the calendar. - - - The RecurringEvents enumeration determines which part of the date is handled (day or day and month). - - - - - Gets or sets a value indicating whether the RadCalendarDay is mapped to a date that represents a non working - day/weekend. - - - - - Gets or sets the text displayed when the mouse pointer hovers over the calendar day. - - - - - Summary description for BaseRenderer. - - - - - Summary description for CalendarView. - - - - - Returns an ArrayList of all properties of RadCalendar that are to be exported on the client. - - - - - - Summary description for CalendarView. - - - - - Descendent of Control, DayTemplate implements an ITemplate wrapper, required for building - collections of templates like CalendarDayTemplateCollection. - - - - - This is the control that is used to instantiate any required template. - - - - - The class represents the base functionality of the RadChart. - - - - - Adds a new data series to the RadChart's series collection. - - - - - - Creates a new instance of RadChart. - - - - - Restores control-state information from a previous page request that was saved by the SaveControlState() method. - - An System.Object that represents the control state to be restored - - - - Saves any server control state changes that have occurred since the time the page was posted back to the server. - - Returns the chart control's current state. If there is no state associated - with the control, this method returns null. - - - - The control-state information - - Returns the chart control's current state as objects array - - - - Resets current chart's skin to default - - - - - Loads user skin from a TextWriter object - - - - - - Exports current chart's settings into TextWriter object - - - - - - Saves the chart's state into XML file in the specified by fileName location. - - Path to the file - - - - Loads RadChart's settings and data from external XML file. - - - - - - Loads entire chart settings from a TextWriter object - - - - - - Exports current chart's skin into TextWriter object - - - - - - Removes the data series associated with the chart control. - - - - - Removes all data series from the series collection without removing axis items. - - - - - Removes the data series at the specified index. - - - - - - Gets a reference to the data series object at the specified index. - - - - - - - Gets a reference to the data series object with the specified name. - - - - - - - Gets a reference to the data series object with the specified color. - - - - - - - Creates a new chart series and adds it to the series collection. - - - - - - - - - - Saves the chart with the specified file name. - - - - - - Saves the chart with the specified file name and the specified image format. - - - - - - - Changes the DataSourceID property without DataBind method call - - - - - - Binds a data source to the invoked server control and all its child controls. - - - - - Gets or sets a value indicating whether RadChart should automatically check for the - ChartHttpHandler existence in the system.web section of the application configuration file. - - - Set this property to false if you are running your application under IIS7 Integrated Mode - and have set the validateIntegratedModeConfiguration flag that does not allow legacy - HttpHandler registration under the system.web configuration section. - - - - - Gets or sets a value indicating the URL to the ChartHttpHandler that is necessary for the correct operation - of the RadChart control. - - - Returns the URL of the ChartHttpHandler. The default value is "ChartImage.axd". - - - Generally the default relative value should work as expected and you do not need to modify it manually here; - however in some scenarios where url rewriting is involved, the default value might not work out-of-the-box - and you can customize it via this property to suit the requirements of your application. - - - - - Specifies the custom palettes for chart - - - - - Chart engine - - - - - Default chart series type - - - - - Specifies AutoLayout mode to all items on the chart control. - - - - - Specifies AutoLayout mode to all items on the chart control. - - - - - Specifies the series palette - - - - - Chart style - - - - - Should skin override user setting or not - - - - - Data management support object - - - - - Collection of the chart's data series. - - - - - Chart height - - - - - Chart width - - - - - Gets or sets RadChart's legend object. - - - - - Specifies the chart's plot area. - - - - - The chart title message. - - - - - Enables or disables use of session. - - - - - Enables or disables use of image maps. - - - - - Sets folder for the chart's temp images. - - - - - Gets or sets RadChart's content file path and file name. - - - - - Specifies the image format in which the image is streamed. - - - - - The alternate text displayed when the image cannot be shown. - - - - - Specifies the custom palettes for chart - - - - - Specifies the orientation of chart series on the plot area. - - - - - Enables / disables Intelligent labels logic for series items labels in all plot areas. - - - - - - Image maps support - - - - Client-side settings. - - - - - Gets or sets the ID of the control from which the data-bound control retrieves its list of data items. - - - - - The DataSource object - - Gets or sets the object from which the chart control retrieves its list of data items - - - - Gets or sets the name of the list of data that the data-bound control binds to, in cases where the data source contains more than one distinct list of data items. - - - - - Gets or sets the name of the DataSource column (member) that will be used to split one column data into several chart Series - - - - - This property supports the RadChart infrastructure and is not intended for public use. - - - - RadComboBox for ASP.NET AJAX is a powerful drop-down list AJAX-based control - - - The RadComboBox control supports the following features: - - - Databinding that allows the control to be populated from various - datasources - Programmatic access to the RadComboBox object model - which allows to dynamic creation of comboboxes, populate items, set - properties. - Customizable appearance through built-in or user-defined skins. - -

Items

- - Each item has a Text and a Value property. - The value of the Text property is displayed in the RadComboBox control, - while the Value property is used to store any additional data about the item, - such as data passed to the postback event associated with the item. - -
-
- - Gets or sets the index of the selected item in the ComboBox control. - - Use the SelectedIndex property to programmatically specify or determine - the index of the selected item from the combobox control - - - - - Raises the ItemDataBound event. - - - - - - Raises the ItematCreated event. - - - - - - Clears out the list selection and sets the Selected property - of all items to false. - - Use this method to reset the control so that no items are selected. - - - RadComboBox1.ClearSelection() - - - RadComboBox1.ClearSelection(); - - - - - - Signals the RadComboBox control to notify the ASP.NET application that the state of the control has changed. - - - - - Raises the TextChanged event. This allows you to handle the event directly. - - - - - Raises the SelectedIndexChanged event. This allows you to handle the event directly. - - - - - Raises the ItemRequestEvent event. This allows you to handle the event directly. - - - - - Finds the first RadComboBoxItem with Text that - matches the given text value. - - - The first RadComboBoxItem that matches the - specified text value. - - - - Dim item As RadComboBoxItem = RadComboBox1.FindItemByText("New York") - - - RadComboBoxItem item = RadComboBox1.FindItemByText("New York"); - - - The string to search for. - - - - Finds the first RadComboBoxItem with Text that - matches the given text value. - - - The first RadComboBoxItem that matches the - specified text value. - - - - Dim item As RadComboBoxItem = RadComboBox1.FindItemByText("New York",true) - - - RadComboBoxItem item = RadComboBox1.FindItemByText("New York",true); - - - The string to search for. - A Boolean indicating a case-sensitive or insensitive comparison (true indicates a case-insensitive comparison). - - - - Finds the first RadComboBoxItem with Value that - matches the given value. - - - The first RadComboBoxItem that matches the - specified value. - - - - Dim item As RadComboBoxItem = RadComboBox1.FindItemByValue("1") - - - RadComboBoxItem item = RadComboBox1.FindItemByValue("1"); - - - The value to search for. - - - - Finds the first RadComboBoxItem with Value that - matches the given value. - - - The first RadComboBoxItem that matches the - specified value. - - - - Dim item As RadComboBoxItem = RadComboBox1.FindItemByValue("1", true) - - - RadComboBoxItem item = RadComboBox1.FindItemByValue("1", true); - - - The value to search for. - A Boolean indicating a case-sensitive or insensitive comparison (true indicates a case-insensitive comparison). - - - - Returns the index of the first RadComboBoxItem with - Text that matches the given text value. - - The string to search for. - - - - Returns the index of the first RadComboBoxItem with - Text that matches the given text value. - - The string to search for. - A Boolean indicating a case-sensitive or insensitive comparison (true indicates a case-insensitive comparison). - - - - Returns the index of the first RadComboBoxItem with - Value that matches the given value. - - The value to search for. - - - - Returns the index of the first RadComboBoxItem with - Value that matches the given value. - - The value to search for. - A Boolean indicating a case-sensitive or insensitive comparison (true indicates a case-insensitive comparison). - - - - Returns the first RadComboBoxItem - that matches the conditions defined by the specified predicate. - The predicate should returns a boolean value. - - - The following example demonstrates how to use the FindItem method. - - void Page_Load(object sender, EventArgs e) - { - RadComboBox1.FindItem(ItemWithEqualsTextAndValue); - } - private static bool ItemWithEqualsTextAndValue(RadComboBoxItem item) - { - if (item.Text == item.Value) - { - return true; - } - else - { - return false; - } - } - - - Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs) - RadComboBox1.FindItem(ItemWithEqualsTextAndValue) - End Sub - Private Shared Function ItemWithEqualsTextAndValue(ByVal item As RadComboBoxItem) As Boolean - If item.Text = item.Value Then - Return True - Else - Return False - End If - End Function - - - The Predicate <> that defines the conditions of the element to search for. - - - - Loads combobox items from an XML content file. - - - - RadComboBox1.LoadContentFile("~/myfile.xml") - - - RadComboBox1.LoadContentFile("~/myfile.xml"); - - - The name of the XML file. - - - Sorts the items in the RadComboBox. - - - - RadComboBox1.Sort=RadComboBoxSort.Ascending - RadComboBox1.SortItems() - - - RadComboBox1.Sort=RadComboBoxSort.Ascending; - RadComboBox1.SortItems(); - - - - - Sorts the items in the RadComboBox. - - An object from IComparer interface. - - - - - RadComboBox1.Sort=RadComboBoxSort.Ascending - Dim comparer As MyComparer = New MyComparer() - RadComboBox1.SortItems(comparer) - Public Class MyComparer - Implements IComparer - - Public Function Compare(ByVal x As Object, ByVal y As Object) As Integer - Dim p1 As New RadComboBoxItem() - Dim p2 As New RadComboBoxItem() - - If TypeOf x Is RadComboBoxItem Then - p1 = TryCast(x, RadComboBoxItem) - Else - Throw New ArgumentException("Object is not of type RadComboBoxItem.") - End If - - If TypeOf y Is RadComboBoxItem Then - p2 = TryCast(y, RadComboBoxItem) - Else - Throw New ArgumentException("Object is not of type RadComboBoxItem.") - End If - - Dim cmp As Integer = 0 - If p1.ComboBoxParent.Sort = RadComboBoxSort.Ascending Then - cmp = [String].Compare(p1.Value, p2.Value, Not p1.ComboBoxParent.SortCaseSensitive) - End If - If p1.ComboBoxParent.Sort = RadComboBoxSort.Descending Then - cmp = [String].Compare(p1.Value, p2.Value, Not p1.ComboBoxParent.SortCaseSensitive) * -1 - End If - - Return cmp - End Function - - End Class - - - - RadComboBox1.Sort=RadComboBoxSort.Ascending; - MyCoparer comparer = new MyComparer(); - RadComboBox1.SortItems(comparer); - public class MyComparer : IComparer - { - - public int Compare(object x, object y) - { - RadComboBoxItem p1 = new RadComboBoxItem(); - RadComboBoxItem p2 = new RadComboBoxItem(); - - if (x is RadComboBoxItem) - p1 = x as RadComboBoxItem; - else - throw new ArgumentException("Object is not of type RadComboBoxItem."); - - if (y is RadComboBoxItem) - p2 = y as RadComboBoxItem; - else - throw new ArgumentException("Object is not of type RadComboBoxItem."); - - int cmp = 0; - if (p1.ComboBoxParent.Sort == RadComboBoxSort.Ascending) - { - cmp = String.Compare(p1.Value, p2.Value, !p1.ComboBoxParent.SortCaseSensitive); - } - if (p1.ComboBoxParent.Sort == RadComboBoxSort.Descending) - { - cmp = String.Compare(p1.Value, p2.Value, !p1.ComboBoxParent.SortCaseSensitive) * -1; - } - - return cmp; - } - - } - - - - - - Gets a list of all client-side changes (adding an item, removing an item, changing an item's property) which have occurred. - - - A list of objects which represent all client-side changes the user has performed. - By default the ClientChanges property returns empty list. Client-changes are recorded if and only if the client-side - methods trackChanges()/commitChanges() have been invoked. - - - You can use the ClientChanges property to respond to client-side modifications such as - - adding a new item - removing existing item - clearing the children of an item or the control itself - changing a property of the item - - The ClientChanges property is available in the first postback (ajax) request after the client-side modifications - have taken place. After this moment the property will return empty list. - - - The following example demonstrates how to use the ClientChanges property - - foreach (ClientOperation<RadComboBoxItem> operation in RadToolBar1.ClientChanges) - { - RadComboBoxItem item = operation.Item; - - switch (operation.Type) - { - case ClientOperationType.Insert: - //An item has been inserted - operation.Item contains the inserted item - break; - case ClientOperationType.Remove: - //An item has been inserted - operation.Item contains the removed item. - //Keep in mind the item has been removed from the combobox. - break; - case ClientOperationType.Update: - UpdateClientOperation<RadComboBoxItem> update = operation as UpdateClientOperation<RadComboBoxItem> - //The "UpdateOperation" provides an additional property "PropertyName". This is the property whose value was changed from the client side. - break; - case ClientOperationType.Clear: - //All children of the combobox have been removed - operation.Item will always be null. - break; - } - } - - - For Each operation As ClientOperation(Of RadComboBoxItem) In RadToolBar1.ClientChanges - Dim item As RadComboBoxItem = operation.Item - Select Case operation.Type - Case ClientOperationType.Insert - 'An item has been inserted - operation.Item contains the inserted item - Exit Select - Case ClientOperationType.Remove - 'An item has been inserted - operation.Item contains the removed item. - 'Keep in mind the item has been removed from the combobox. - Exit Select - Case ClientOperationType.Update - Dim update As UpdateClientOperation(Of RadComboBoxItem) = TryCast(operation, UpdateClientOperation(Of RadComboBoxItem)) - 'The "UpdateOperation" provides an additional property "PropertyName". This is the property whose value was changed from the client side. - Exit Select - Case ClientOperationType.Clear - //All children of the combobox have been removed - operation.Item will always be Nothing. - Exist Select - End Select - Next - - - - - - Gets a RadComboBoxItemCollection object that contains theitems of the current RadComboBox control. - - - A RadComboBoxItemCollection that contains the items of the current RadComboBox control. By default - the collection is empty (RadComboBox has no children). - - - Use the Items property to access the child items of RadComboBox - You can add, remove or modify items from the Items collection. - - - The following example demonstrates how to programmatically modify the properties of items. - - RadComboBox1.Items[0].Text = "Example"; - RadComboBox1.Items[0].Value = "1"; - - - RadComboBox1.Items(0).Text = "Example" - RadComboBox1.Items(0).Value = "1" - - - - - - Gets or sets a value indicating whether any databinding expressions specified in the ItemTemplate should be evaluated for - unbound items (items added inline or programmatically). - - true if databinding expressions should be evaluated; otherwise false; The default value is false. - - - - - Occurs on the server when an item in the RadComboBox control is - created. - - - The ItemCreated event is raised every time a new item is - added. - The ItemCreated event is not related to data binding and you - cannot retrieve the DataItem of the item in the event - handler. - The ItemCreated event is often useful in scenarios where you want - to initialize all items - for example setting the ToolTip of each - RadComboBoxItem to be equal to the Text property. - - - - - Occurs after an item is data bound to the RadComboBox - control. - - - This event provides you with the last opportunity to access the data item - before it is displayed on the client. After this event is raised, the data item is - nulled out and no longer available. - - - - Occurs when the SelectedIndex property has changed. - - You can create an event handler for this event to determine when the selected - index in the RadComboBox has been changed. This can be useful when - you need to display information in other controls based on the current selection in - the RadComboBox. You can use the event handler to load the - information in the other controls. - - - - - Gets or sets a value indicating whether a postback to the server automatically - occurs when the user changes the RadComboBox selection. - - - Set this property to true if the server needs to capture the selection - as soon as it is made. For example, other controls on the Web page can be - automatically filled depending on the user's selection from a list control. - This property can be used to allow automatic population of other controls on - the Web page based on a user's selection from a list. - The value of this property is stored in view state. - - The server-side event that is fired is - SelectedIndexChanged. - - - - - - Occurs when RadComboBox initiates an AJAX callback to the - server. - - - - - Gets a value indicating whether the current instance of the combobox has child - items. - - - - If RadComboBox1.IsEmpty - ' - ' - ' - End If - - - if (RadComboBox1.IsEmpty) - { - // - // - // - } - - - - - Sets or gets the position (left or right) of the arrow image dropdown. - - - RadComboBox1.RadComboBoxImagePosition = RadComboBoxImagePosition.Left; - - - RadComboBox1.RadComboBoxImagePosition = RadComboBoxImagePosition.Right - - - - By default the image is shown on the right. Left can be used in RTL - (right-to-left) language scenarios. - - - - - Gets or sets the text content of the RadComboBox - control. - - - In standard mode, the currently selected text can be accessed using both the - Text property or RadCombobox.SelectedItem.Text. In - AJAX callback modes, only the Text property can be used because - end-users can type or paste text that does not match the text of any item and - SelectedItem can be null. - - - - string comboText = RadComboBox1.Text - - - Dim comboText As String = RadComboBox1.Text - - - - - - The value of the message that is shown in RadComboBox while AJAX - callback call is in effect. - - - This property can be used for customizing and localizing the text of the loading - message. - - - - - Gets the settings for the web service used to populate items. - - - An WebServiceSettings that represents the - web service used for populating items. - - - - Use the WebServiceSettings property to configure the web - service used to populate items on demand. - You must specify both - Path and - Method - to fully describe the service. - - - In order to use the integrated support, the web service should have the following signature: - - - [ScriptService] - public class WebServiceName : WebService - { - [WebMethod] - public RadComboBoxItemData[] WebServiceMethodName(object context) - { - // We cannot use a dictionary as a parameter, because it is only supported by script services. - // The context object should be cast to a dictionary at runtime. - IDictionary<string, object> contextDictionary = (IDictionary<string, object>) context; - - //... - } - } - - - - - - - Specifies the timeout after each keypress before RadComboBox - fires an AJAX callback to the ItemsRequested server-side event. - - - In miliseconds. ItemRequestTimeout = 500 is equal to half a - second delay. - - - - The HTML Z-index of the items dropdown of RadComboBox.Its default value is 6000. - - Can be used when the dropdown is to be shown over content with a specified - Z-index. If the combobox items dropdown is displayed below the content, set the - ZIndex property to a value higher than the value of the HTML content - below. - - - - - Gets or sets a value that indicates whether the dropdown of the combobox should - be opened by default on loadnig the page. - - - - - Gets or sets a value that indicates whether the combobox autocompletion logic is - case-sensitive or not. - - - - - Gets or sets a value indicating whether the combobox should display the box for - requesting additional items - - - - - Gets or sets a value indicating whether the combobox should automatically - autocomplete and highlight the currently typed text to the closest item text - match. - - - - - Gets or sets a value indicating whether the combobox should automatically - autocomplete and highlight the currently typed text to the all items text - match. - - - - - Gets or sets a value indicating whether the combobox should issue a callback to - the server whenever end-users change the text of the combo (keypress, paste, - etc). - - - In Load On Demand mode, the combobox starts a callback after a specified amount of - time (see ItemRequestTimeout) and calls the - server-side ItemsRequested event. Depending on the - value of the event arguments, you can add new items to the combobox object and the - items will be propagated to the browser after the request. - - - - - Gets or sets a value indicating whether the combobox should cache items loaded on demand or via webservice - - - - - Gets or sets a value indicating whether the combobox should load items on demand (via callback) - during scrolling-down the drop-down area. - - - - - Gets or sets a value indicating whether the text of combobox should be selected - - - - - Gets or sets a value indicating whether the dropdown image next to the combobox - text area should be displayed. - - - The dropdown image is located in the Skins folder of the combo - by - default ~/RadControls/ComboBox/Skins/{SkinName}/DropArrow.gif. You can - custmoize or modify the image and place it in the respective folder of the skin you are - using. - - - - - Gets or sets a value indicating whether the text in a combobox item - automatically continues on the next line when it reaches the end of the - dropdown. - - - - Determines whether drop down should be closed on blur - - - Determines whether custom text can be entered into the input field of RadComboBox. - - - Determines whether the text can be entered into the input field of RadComboBox during keyboard navigation - - - Determines the custom error message to be shown after the Load On Demand Callback error appears. - - - Determines whether the dropdown shows when the user clicks in the input field. - - - Determines whether the Screen Boundaries Detection is enabled or not. - - - - Gets or sets a value indicating whether items defined in the - ItemTemplate template should be automatically - highlighted on mouse hover or keyboard navigation. - - - - - Gets or sets a list of separators: autocomplete logic is reset afer a separator - is entered and users can autocomplete multiple items. - - You can use several separators at once. - - - RadComboBox1.AutoCompleteSeparator = ";,"; - - - RadComboBox1.AutoCompleteSeparator = ";," - - - - - Determines whether the noscript tag containing select element to be rendered. - - - Gets the currently selected item in the combobox. - - - <telerik:radcombobox id="RadComboBox1" Runat="server" ></telerik:radcombobox> - - private void RadComboBox1_SelectedIndexChanged(object o, Telerik.WebControls.RadComboBoxSelectedIndexChangedEventArgs e) - { - Label1.Text = RadComboBox1.SelectedItem.Text; - } - - - <telerik:radcombobox id="RadComboBox1" Runat="server" ></telerik:radcombobox> - - Private Sub RadComboBox1_SelectedIndexChanged(ByVal o As Object, ByVal e As Telerik.WebControls.RadComboBoxSelectedIndexChangedEventArgs) Handles RadComboBox1.SelectedIndexChanged - Label1.Text = RadComboBox1.SelectedItem.Text - End Sub - - - - SelectedItem can be null in load-on-demand or - AllowCustomText modes. End-users can type any - text. - - - - Gets the index of the currently selected item in the combobox. - - - - Gets or sets a value indicating the horizontal offset of the combobox dropdown - - - An integer specifying the horizontal offset of the combobox dropdown (measured in - pixels). The default value is 0 (no offset). - - - Use the OffsetX property to change the position of the combobox dropdown - - To customize the vertical offset use the OffsetY - property. - - - - - - Gets or sets a value indicating the vertical offset of the combobox dropdown. - - - An integer specifying the vertical offset of the combobox dropdown(measured in - pixels). The default value is 0 (no offset). - - - Use the OffsetY property to change the position where the combobox dropdown - will appear. - - To customize the horizontal offset use the OffsetX - property. - - - - - - Gets or sets the width of the dropdown in pixels. - - - - - Gets or sets the max height of the dropdown in pixels. - - - - Gets the value of the currently selected item in the combobox. - - - - Gets or sets the template for displaying header in - RadcomboBox. - - - - - Gets or sets the template for displaying footer in - RadcomboBox. - - - - - Get a header of - RadcomboBox. - - - - - Get a footer of - RadcomboBox. - - - - - Gets or sets the template for displaying the items in - RadcomboBox. - - - A ITemplate implemented object that contains the template - for displaying combo items. The default value is a null reference (Nothing in - Visual Basic), which indicates that this property is not set. - The ItemTemplate property sets a template that will be used - for all combo items. - - - The following example demonstrates how to use the - ItemTemplate property to add a CheckBox for each item. - ASPX: - <telerik:RadComboBox runat="server" ID="RadComboBox1"> -
- <ItemTemplate> -
- <asp:CheckBox runat="server" - ID="CheckBox"></asp:CheckBox>
- <asp:Label runat="server" ID="Label1"
-
- Text='<%# DataBinder.Eval(Container, "Text") %>' - ></asp:Label> -
-
- </ItemTemplate> - <Items> -
- <telerik:RadComboBoxItem Text="News" /> - <telerik:RadComboBoxItem Text="Sports" /> - <telerik:RadComboBoxItem Text="Games" /> -
- </Items> -
- </telerik:RadComboBox> -
-
- - Gets or sets the maximum number of characters allowed in the combobox. - - - - Indicates whether the combobox will be visible while loading. - - - - Gets the settings for the animation played when the dropdown opens. - - An AnnimationSettings that represents the - expand animation. - - - - Use the ExpandAnimation property to customize the expand - animation of RadComboBox. You can specify the - Type, - Duration and the - To disable expand animation effects you should set the - Type to - AnimationType.None.
- To customize the collapse animation you can use the - CollapseAnimation property. -
-
- - The following example demonstrates how to set the ExpandAnimation - of RadComboBox. - - ASPX: - - - <telerik:RadComboBox ID="RadComboBox1" runat="server"> - <ExpandAnimation Type="OutQuint" Duration="300" - /> - <Items> - <telerik:RadComboBoxItem Text="News" > - </telerik:RadComboBoxItem> - </Items> - - - </telerik:RadComboBox> - - - void Page_Load(object sender, EventArgs e) - { - RadComboBox1.ExpandAnimation.Type = AnimationType.Linear; - RadComboBox1.ExpandAnimation.Duration = 300; - } - - - Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Load - RadComboBox1.ExpandAnimation.Type = AnimationType.Linear - RadComboBox1.ExpandAnimation.Duration = 300 - End Sub - - -
- - - Gets or sets a value indicating the timeout after which a dropdown starts to - open. - - - An integer specifying the timeout measured in milliseconds. The default value is - 100 milliseconds. - - - Use the ExpandDelay property to delay dropdown opening. - - To customize the timeout prior to item closing use the - CollapseDelay property. - - - - The following example demonstrates how to specify a half second (500 - milliseconds) timeout prior to dropdown opening: - ASPX: - <telerik:RadComboBox ID="RadComboBox1" runat="server" - ExpandDelay="500" /> - - - - Gets the settings for the animation played when an item closes. - - An AnnimationSettings that represents the - collapse animation. - - - - Use the CollapseAnimation property to customize the collapse - animation of RadComboBox. You can specify the - Type, - Duration and the - items are collapsed.
- To disable collapse animation effects you should set the - Type to - AnimationType.None. To customize the expand animation you can - use the CollapseAnimation property. -
-
- - The following example demonstrates how to set the - CollapseAnimation of RadComboBox. - - ASPX: - - - <telerik:RadComboBox ID="RadComboBox1" runat="server"> - <CollapseAnimation Type="OutQuint" Duration="300" - /> - <Items> - <telerik:RadComboBoxItem Text="News" > - </telerik:RadComboBoxItem> - </Items> - - - </telerik:RadComboBox> - - - - - - - void Page_Load(object sender, EventArgs e) - { - RadComboBox1.CollapseAnimation.Type = AnimationType.Linear; - RadComboBox1.CollapseAnimation.Duration = 300; - } - - - Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Load - RadComboBox1.CollapseAnimation.Type = AnimationType.Linear - RadComboBox1.CollapseAnimation.Duration = 300 - End Sub - - -
- - - Gets or sets a value indicating the timeout after which a dropdown starts to - close. - - - An integer specifying the timeout measured in milliseconds. The default value is - 500 (half a second). - - - Use the CollapseDelay property to delay dropdown closing. To - cause immediate item closing set this property to 0 (zero). - - To customize the timeout prior to item closing use the - ExpandDelay property. - - - - The following example demonstrates how to specify one second (1000 - milliseconds) timeout prior to dropdown closing: - ASPX: - <telerik:RadComboBox ID="RadComboBox1" runat="server" - ClosingDelay="1000" /> - - - - - Automatically sorts items alphabetically (based on the Text - property) in ascending or descending order. - - - - RadComboBox1.Sort = RadComboBoxSort.Ascending; - RadComboBox1.Sort = RadComboBoxSort.Descending; - RadComboBox1.Sort = RadComboBoxSort.None; - - - RadComboBox1.Sort = RadComboBoxSort.Ascending - RadComboBox1.Sort = RadComboBoxSort.Descending - RadComboBox1.Sort = RadComboBoxSort.None - - - - - - Gets/sets whether the sorting will be case-sensitive or not. - By default is set to true. - - - - RadComboBox1.SortCaseSensitive = false; - - - - RadComboBox1.SortCaseSensitive = false - - - - - - Occurs when the text of the RadComboBox changes between postbacks to the server. - - - - - The client-side event that is fired when the selected index of the - RadComboBox is about to be changed. - - - - The event handler receives two parameters: the instance of of the RadComboBox - client-side object and event argument of the newly selected item. - - - The event can be cancelled - simply call - args.set_cancel(true); - from the event handler and the item will not be changed. - - - - - <script type="text/javascript"> - function onSelectedIndexChanging(sender, eventArgs) - { - var item = eventArgs.get_item(); - if (item.get_text() == "LA") - { - // do not allow selecting item with text "LA" - return false; - } - else - { - // alert the new item text and value. - alert(item.get_text() + ":" + item.get_value()); - } - } - </script> - - <telerik:radcombobox ID="RadComboBox1" runat="server" - OnClientSelectedIndexChanging="onSelectedIndexChanging"> - </telerik:radcombobox> - - - - - - The client-side event that is fired after the selected index of the RadComboBox has - been changed. - - - The event handler receives two parameters: the instance of of the combobox - client-side object and event argument with the newly selected item. - - - - <script language="javascript"> - function onSelectedIndexChanged(sender,eventArgs) - { - var item = eventArgs.get_item(); - // alert the new item text and value. - alert(item.get_text() + ":" + item.get_value()); - } - </script> - - <telerik:radcombobox ID="RadComboBox1" runat="server" - OnClientSelectedIndexChanged="onSelectedIndexChanged"> - </telerik:radcombobox> - - - - - - Gets or sets a value indicating the client-side event handler that is called when - the RadComboBox is about to be populated (for example from web service). - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - <script type="text/javascript">
- function onItemRequestingHandler(sender, eventArgs)
- {
- var context = eventArgs.get_context();
- context["Parameter1"] = "Value";
- }
- </script>
- <telerik:RadComboBox ID="RadComboBox1"
- runat="server"
- OnClientItemPopulating="onClientItemPopulatingHandler">
- ....
- </telerik:RadComboBox>
-
- - If specified, the OnClientItemsRequesting client-side event - handler is called when the RadComboBox is about to be populated. - Two parameters are passed to the handler: - - sender, the menu client object; - eventArgs with three properties: - - get_context(), an user object that will be passed to the web service. - set_cancel(), used to cancel the event. - - - - This event can be cancelled. - -
- - - Gets or sets a value indicating the client-side event handler that is called when - the RadComboBox items were just populated (for example from web service). - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - <script type="text/javascript">
- function onItemsRequested(sender, eventArgs)
- {
- alert("Loading finished");
- }
- </script>
- <telerik:RadComboBox ID="RadComboBox1"
- runat="server"
- OnClientItemsRequested="onItemsRequested">
- ....
- </telerik:RadComboBox>
-
- - If specified, the OnClientItemsRequested client-side event - handler is called when the RadComboBox items were just populated. - Two parameters are passed to the handler: - - sender, the menu client object; - eventArgs, null for this event. - - This event cannot be cancelled. - -
- - - Gets or sets a value indicating the client-side event handler that is called when - the operation for populating the RadComboBox has failed. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - <script type="text/javascript">
- function onItemsRequestFailed(sender, eventArgs)
- {
- alert("Error: " + errorMessage);
- eventArgs.set_cancel(true);
- }
- </script>
- <telerik:RadComboBox ID="RadComboBox1"
- runat="server"
- OnClientItemsRequestFailed="onItemsRequestFailed">
- ....
- </telerik:RadComboBox>
-
- - If specified, the OnClientItemsRequestFailed client-side event - handler is called when the operation for populating the RadComboBox has failed. - Two parameters are passed to the handler: - - sender, the menu client object; - eventArgs with one property: - - set_cancel(), set to true to suppress the default action (alert message). - - - - This event can be cancelled. - -
- - - Gets or sets the name of the JavaScript function called when an Item is created during Web Service Load on Demand. - - - - - The client-side event that is fired when the user presses a key inside the - combobox. - - - - <telerik:radcombobox - Runat="server" - ID="RadComboBox3" - OnClientKeyPressing="HandleKeyPress" - ... - /> - - <script type="text/javascript"> - - function HandleKeyPress(sender, e) - { - if (e.keyCode == 13) - { - document.forms[0].submit(); - } - } - - </script> - - - - The event handler receives two parameters: - - the instance of the combobox client-side object; - browser event arguments. - - You can use the browser event arguments (and the keyCode - property in particular) to detect which key was pressed and to write your own - custom logic. - - - - - The client-side event that is fired before the dropdown of the combobox is - opened. - - - - <script language="javascript"> - - function HandleOpen(sender,args) - { - if (someCondition) - { - args.set_cancel(true); - } - else - { - alert("Opening combobox with " + comboBox.get_items().get_count() + " items"); - } - } - - </script> - - - <telerik:radcombobox - id="RadComboBox1" - Runat="server" - OnClientDropDownOpening="HandleOpen"> - </telerik:radcombobox> - - - - The event handler receives two parameter: the instance of the combobox - client-side object and event args. The event can be cancelled - simply set args.set_cancel to true args.set_cancel(true); - from the event handler and the combobox dropdown will not be opened. - - - - - The client-side event that is fired after the dropdown of the combobox is - opened. - - - - <script language="javascript"> - - function HandleOpen(sender,args) - { - alert("Opening combobox with " + comboBox.get_items().get_count() + " items"); - - } - - </script> - - - <telerik:radcombobox - id="RadComboBox1" - Runat="server" - OnClientDropDownOpened="HandleOpen"> - </telerik:radcombobox> - - - - The event handler receives two parameter: the instance of the combobox - client-side object and event args. The event cannot be cancelled. - - - - - The client-side event that is fired when when the combo gains focus - - - - <script type="text/avascript"> - - function OnClientFocus(sender,args) - { - alert("focus"); - } - - </script> - - - <telerik:radcombobox - id="RadComboBox1" - Runat="server" - OnClientFocus="OnClientFocus"> - </telerik:radcombobox> - - - - The event handler receives two parameter: the instance of the combobox - client-side object and event args. - - - - - The client-side event that is fired when when the combo loses focus - - - - <script type="text/avascript"> - - function OnClientBlur(sender,args) - { - alert("blur"); - } - - </script> - - - <telerik:radcombobox - id="RadComboBox1" - Runat="server" - OnClientBlur="OnClientBlur"> - </telerik:radcombobox> - - - - The event handler receives two parameter: the instance of the combobox - client-side object and event args. - - - - - The client-side event that is fired before the dropdown of the combobox is - closed. - - - The event handler receives two parameter: the instance of the combobox - client-side object and event args. The event can be cancelled - simply set args.set_cancel to true args.set_cancel(true); - from the event handler and the combobox dropdown will not be closed. - - - - <script language="javascript"> - - function HandleClose(sender, args) - { - if (someCondition) - { - args.set_cancel(true); - } - else - { - alert("Closing combobox with " + sender.get_items().get_count() + " items"); - } - } - - </script> - - - <telerik:radcombobox - id="RadComboBox1" - Runat="server" - OnClientDropDownClosing="HandleClose"> - </telerik:radcombobox> - - - - - - The client-side event that is fired after the dropdown of the combobox is - closed. - - - The event handler receives two parameter: the instance of the combobox - client-side object and event args. The event can not be cancelled - - - - <script language="javascript"> - - function HandleClose(sender, args) - { - alert("Closed combobox with " + sender.get_items().get_count() + " items"); - - } - - </script> - - - <telerik:radcombobox - id="RadComboBox1" - Runat="server" - OnClientDropDownClosed="HandleClose"> - </telerik:radcombobox> - - - - - - If specified, the OnClienLoad client-side event handler is - called after the combobox is fully initialized on the client. - A single parameter - the combobox client object - is passed to the - handler. - This event cannot be cancelled. - - - <script type="text/javascript">
- function onClientLoadHandler(sender)
- {
- alert(sender.get_id());
- }
- </script>
- <telerik:RadComboBox ID="RadComboBox1"
- runat= "server"
- OnClientLoad="onClientLoadHandler">
- ....
- </telerik:RadComboBox>
-
- - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - Gets or sets a value indicating the client-side event handler that is called - after the RadComboBox client-side object is initialized. - -
- - - RadComboBoxItem class. - - - - - - - - - - - - - The ID property is reserved for internal use. Please use the Value property or - use the Attributes collection if you need to assign - custom data to the item. - - - - - Gets the zero based index of the item. - - - - - - - - - - - - - - - - - Compares two instance for equality. - returns 0 if equal, a positive number if the first is greater than the - second, and a negative number otherwise. - - - - - - Gets or sets the text caption for the combobox item. - The text of the item. The default value is empty string. - - Use the Text property to specify the text to display for the - item. - - - - Gets or sets the value for the combobox item. - The value of the item. The default value is empty string. - - Use the Value property to specify the value - - - - - Gets the RadComboBox instance which contains the current item. - - - - - Gets the RadComboBox instance which contains the current item. - - - - Gets or sets the selected state of the combobox item. - The default value is true. - - Use the Selected property to determine whether the item is selected or not. - - - - Gets or sets the tooltip of the combobox item. - - - - Sets or gets whether the item is separator. It also represents a logical state of - the item. Might be used in some applications for keyboard navigation to omit processing - items that are marked as separators. - - - - Gets or sets the path to an image to display for the item. - - The path to the image to display for the item. The default value is empty - string. - - - Use the ImageUrl property to specify the image for the item. If - the ImageUrl property is set to empty string no image will be - rendered. Use "~" (tilde) when referring to images within the current ASP.NET - application. - - - - Gets or sets the path to an image to display for the item when it is disabled. - - The path to the image to display for the item. The default value is empty - string. - - - Use the DisabledImageUrl property to specify the image for the item when it is disabled. If - the DisabledImageUrl property is set to empty string no image will be - rendered. Use "~" (tilde) when referring to images within the current ASP.NET - application. - - - - - A collection of RadComboBoxItem objects in a - RadComboBox control. - - - The RadComboBoxItemCollection class represents a collection of - RadComboBoxItem objects. - - - Use the indexer to programmatically retrieve a - single RadComboBoxItem from the collection, using array notation. - - - Use the Count property to determine the total - number of combo items in the collection. - - - Use the Add method to add items in the collection. - - - Use the Remove method to remove items from the - collection. - - - - - - - - Initializes a new instance of the RadComboBoxItemCollection class. - - The owner of the collection. - - - - Appends the specified RadComboBoxItem object to the end of the current RadComboBoxItemCollection. - - - The RadComboBoxItem to append to the end of the current RadComboBoxItemCollection. - - - The following example demonstrates how to programmatically add items in a - RadComboBox control. - - RadComboBoxItem newsItem = new RadComboBoxItem("News"); - RadComboBox1.Items.Add(newsItem); - - - Dim newsItem As RadPanelItem = New RadComboBoxItem("News") - RadComboBox1.Items.Add(newsItem) - - - - - - Finds the first RadComboBoxItem with Text that - matches the given text value. - - - The first RadComboBoxItem that matches the - specified text value. - - The string to search for. - This method is not recursive. - - - - Finds the first RadComboBoxItem with Value that - matches the given value. - - - The first RadComboBoxItem that matches the - specified value. - - The value to search for. - This methos is not recursive. - - - - Searches the items in the collection for a RadComboBoxItem which contains the specified attribute and attribute value. - - The name of the target attribute. - The value of the target attribute - The RadComboBoxItem that matches the specified arguments. Null (Nothing) is returned if no node is found. - This method is not recursive. - - - - Finds the first RadComboBoxItem with Text that - matches the given text value. - - - The first RadComboBoxItem that matches the - specified text value. - - - - Dim item As RadComboBoxItem = RadComboBox1.FindItemByText("New York",true) - - - RadComboBoxItem item = RadComboBox1.FindItemByText("New York",true); - - - The string to search for. - A Boolean indicating a case-sensitive or insensitive comparison (true indicates a case-insensitive comparison). - - - - Finds the first RadComboBoxItem with Value that - matches the given value. - - - The first RadComboBoxItem that matches the - specified value. - - - - Dim item As RadComboBoxItem = RadComboBox1.FindItemByValue("1", true) - - - RadComboBoxItem item = RadComboBox1.FindItemByValue("1", true); - - - The value to search for. - A Boolean indicating a case-sensitive or insensitive comparison (true indicates a case-insensitive comparison). - - - - Returns the index of the first RadComboBoxItem with - Text that matches the given text value. - - The string to search for. - - - - Returns the index of the first RadComboBoxItem with - Text that matches the given text value. - - The string to search for. - A Boolean indicating a case-sensitive or insensitive comparison (true indicates a case-insensitive comparison). - - - - Returns the index of the first RadComboBoxItem with - Value that matches the given value. - - The value to search for. - - - - Returns the index of the first RadComboBoxItem with - Value that matches the given value. - - The value to search for. - A Boolean indicating a case-sensitive or insensitive comparison (true indicates a case-insensitive comparison). - - - - Returns the first RadComboBoxItem - that matches the conditions defined by the specified predicate. - The predicate should returns a boolean value. - - - The following example demonstrates how to use the FindItem method. - - void Page_Load(object sender, EventArgs e) - { - RadComboBox1.FindItem(ItemWithEqualsTextAndValue); - } - private static bool ItemWithEqualsTextAndValue(RadComboBoxItem item) - { - if (item.Text == item.Value) - { - return true; - } - else - { - return false; - } - } - - - Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs) - RadComboBox1.FindItem(ItemWithEqualsTextAndValue) - End Sub - Private Shared Function ItemWithEqualsTextAndValue(ByVal item As RadComboBoxItem) As Boolean - If item.Text = item.Value Then - Return True - Else - Return False - End If - End Function - - - The Predicate <> that defines the conditions of the element to search for. - - - - Determines whether the specified RadComboBoxItem object is in the current - RadComboBoxItemCollection. - - - The RadComboBoxItem object to find. - - - true if the current collection contains the specified RadComboBoxItem object; - otherwise, false. - - - - Appends the specified array of RadComboBoxItem objects to the end of the - current RadComboBoxItemCollection. - - - The following example demonstrates how to use the AddRange method - to add multiple items in a single step. - - RadComboBoxItem[] items = new RadComboBoxItem[] { new RadComboBoxItem("First"), new RadComboBoxItem("Second"), new RadComboBoxItem("Third") }; - RadComboBox1.Items.AddRange(items); - - - Dim items() As RadComboBoxItem = {New RadComboBoxItem("First"), New RadComboBoxItem("Second"), New RadComboBoxItem("Third")} - RadComboBox1.Items.AddRange(items) - - - - The array of RadComboBoxItem o append to the end of the current - RadComboBoxItemCollection. - - - - - Determines the index of the specified RadComboBoxItem object in the collection. - - - The RadComboBoxItem to locate. - - - The zero-based index of item within the current RadComboBoxItemCollection, - if found; otherwise, -1. - - - - - Inserts the specified RadComboBoxItem object in the current - RadComboBoxItemCollection at the specified index location. - - The zero-based index location at which to insert the RadComboBoxItem. - The RadComboBoxItem to insert. - - - - Removes the specified RadComboBoxItem object from the current - RadComboBoxItemCollection. - - - The RadComboBoxItem object to remove. - - - - - Removes the specified RadComboBoxItem object from the current - RadComboBoxItemCollection. - - - The zero-based index of the index to remove. - - - - - Sort the items from RadComboBoxItemCollection. - - - - - Sort the items from RadComboBoxItemCollection. - - - An object from IComparer interface. - - - - - Gets the RadComboBoxItem object at the specified index in - the current RadComboBoxItemCollection. - - - The zero-based index of the RadComboBoxItem to retrieve. - - - The RadComboBoxItem at the specified index in the - current RadComboBoxItemCollection. - - - - - For internal use only. - - - - - - - Clientside implementation of visual element resize functionality - - - - - - - - - Clientside implementation of visual element resize functionality - - - - - This class is intended to simply define the common scripts reference - - - - - Used from DialogLoaderBase to extract the definition - of the dialog to be loaded - - - The parameters got from the DialogLoader. They must include - either VirtualPath or Type for the control to be loaded. - - - - - Used from a RadControl (Editor, Spell) to define an UserControl dialog - - The path to the ascx to be loaded - The parameters to be passed to the dialog - - - - Used from a RadControl (Editor, Spell) to define a WebControl dialog - - The type of the control to be loaded - The parameters to be passed to the dialog - - - - Gets or sets a value indicating the behavior of this dialog - if it can be - resized, has expand/collapse commands, closed command, etc. - - - - - This is the default dialog handler class for Telerik dialogs. It requires Session State to be enabled - - - - - This class can be used instead of the default (DialogHandler) class for Telerik dialogs. It does not require Session State to be enabled. - - - - - - - - - This control has no skin! This property will prevent the SkinRegistrar from - registering the missing CSS references. - - - - - A read-only property that returns the RadWindow instance used in the RadDialogOpener control. - - - - - Gets or sets an additional querystring appended to the dialog URL. - - A String, appended to the dialog URL - TODO - - - - Gets the DialogDefinitionDictionary, containing the DialogDefinitions of the managed dialogs. - - TODO - TODO - - - - Gets or sets a value, indicating if classic windows will be used for opening a dialog. - - A boolean, indicating if classic windows will be used - for opening a dialog - When set to true, the RadDialogOpener shows a dialog similar to the - ones opened by window.open and window.showModalDialog; - - - Gets or sets the localization language for the user interface. - - The localization language for the user interface. The default value is - en-US. - - - - Gets or sets the skin name for the control user interface. - A string containing the skin name for the control user interface. The default is string.Empty. - - - If this property is not set, the control will render using the skin named "Default". - If EnableEmbeddedSkins is set to false, the control will not render skin. - - - - - Gets or sets the value, indicating whether to render the link to the embedded base stylesheet of the control or not. - - - If EnableEmbeddedBaseStylesheet is set to false you will have to register the needed control base CSS file by hand. - - - - - Gets or sets the value, indicating whether to render links to the embedded skins or not. - - - If EnableEmbeddedSkins is set to false you will have to register the needed CSS files by hand. - - - - - Gets or sets the value, indicating whether to render links to the embedded scripts or not. - - - If EnableEmbeddedScripts is set to false you will have to register the needed script files by hand. - - - - - Gets or sets the value, indicating whether to render the skin CSS files during Ajax requests - - - If EnableAjaxSkinRendering is set to false you will have to register the needed control base CSS file by hand when adding/showing the control with Ajax. - - - - - - Gets or sets the client-side script that gets executed when the dialog opening event is raised - - - - - Gets or sets the client-side script that gets executed when the dialog closing event is raised - - - - - Gets or sets the location of a CSS file, that will be added in the dialog window. If you need to include - more than one file, use the CSS @import url(); rule to add the other files from the first. - This property is needed if you are using a custom skin. It allows you to include your custom skin - CSS in the dialogs, which are separate from the main page. - - - - - Gets or sets the location of a JavaScript file, that will be added in the dialog window. If you need to include - more than one file, you will need to combine the scripts into one first. - This property is needed if want to override some of the default functionality without loading the dialog - from an external ascx file. - - - - - Get/Set the animation effect of the window - - - - - This class is provided for backwards compatibility with old solutions. - - - - - An empty class to just indicate that the parameters must be taken in a querystring/javascript manner - - - - - Instantiates the DialogParametersProvider - - The page that uses the DialogParametersProvider - - - - Returns the DialogParameters for a dialog - - the unique identifier of the dialogOpener, which - parameters are stored - the name of the dialog which parameters are requested - the DialogParameters for the specified dialog of the exact editor - - - - Stores the DialogParameters for - all the dialogs of a specified RadDialogOpener - - the unique identifier of the editor - which DialogParameters - will be stored - The list of dialog parameters - - - - DialogParametersSerializer - serializes a DialogParameters object to a string and deserializes it. - - - Known limitations: - - When deserializing, the enum values are passed as ints and an implicit cast is required. - If a string array with a one element == string.Empty is passed, the deserialized array will have no elements - - - - - - - Defines the RadDock titlebar and grips behavior. - - - - - The control will not have titlebar or grips. - - - - - The control will have only titlebar. - - - - - The control will have only grips. - - - - - Provides data for the SaveDockLayout and the LoadDockLayout events. - - - - - Initializes a new instance of the DockLayoutEventArgs class - - - - - Dictionary, containing UniqueName/DockZoneID pairs. - - - - - Dictionary, containing UniqueName/Index pairs. - - - - - Represents the method that handles a SaveDockLayout or LoadDockLayout events - - The source of the event - A DockLayoutEventArgs that contains the event data - - - - Defines the docking behavior of a RadDock control - - - - - The RadDock control is able to float (to be undocked) - - - - - The RadDock control is able to dock into zones - - - - - The RadDock control is able to be both docked and undocked. - - - - - Represents the PinUnpin command item in a RadDock control. - - - - - Initializes a new instance of the DockPinUnpinCommand class - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Defines the commands which should appear in the RadDock control - titlebar when its Commands property is not set. - - - - - No commands will appear - - - - - Close command - - - - - ExpandCollapse command - - - - - PinUnpin command - - - - - All commands - - - - - Provides data for the DockPositionChanged event. - - - - - Contains the ClientID of the dock zone the dock has been dropped to. - If the dock was not dropped in a zone (undocked) the value will be - string.Empty. - - - - - Contains the index of the dock in the new dock zone - - - - - Represents the method that handles a DockPositionChanged event - - The source of the event - A DockPositionChangedEventArgs that contains the event data - - - - Defines the state of a DockToggleCommand item - - - - - The command is in primary state. It will be initially rendered - using the CssClass and Text properties. - - - - - The command is in alternate state. It will be initially rendered - using the AlternateCssClass and AlternateText properties. - - - - - Use this attribute to set the width of a DropDown - - - - - Use this attribute to set the height of a DropDown - - - - - Use this attribute to set the popup class name of a DropDown - - - - - Use this attribute to let the DropDown to adjust its size to its content automatically - - - - - Use this attribute to set the number of the items per row in a DropDown - - - - - Copied from Reflector - - - - - This control has no skin! This property will prevent the SkinRegistrar from - registering the missing CSS references. - - - - - Gets or sets a string containing the localization language for the RadEditor UI - - - - - Gets or sets a value indicating where the editor will look for its dialogs. - - - A relative path to the dialogs location. For example: "~/controls/RadEditorDialogs/". - - - If specified, the ExternalDialogsPath - property will allow you to customize and load the editor dialogs from normal ASCX files. - - - - - Gets or sets a value indicating where the control will look for its .resx localization files. - By default these files should be in the App_GlobalResources folder. However, if you cannot put - the resource files in the default location or .resx files compilation is disabled for some reason - (e.g. in a DotNetNuke environment), this property should be set to the location of the resource files. - - - A relative path to the dialogs location. For example: "~/controls/RadEditorResources/". - - - If specified, the LocalizationPath - property will allow you to load the control localization files from any location in the - web application. - - - - - Represents a CssFile item. - - - - - A strongly typed collection of EditorCssFile objects - - - - - - - - This property instructs the tool to attach its own click handlers and not to rely on a tool adapter - - - - - This property sets the tool name in the client script. - - - - - This property sets the tool name in the client script. - - - - - - This property sets the tool name in the client script. - - - - - This property sets the tool name in the client script. - - - - - Encapsulates the properties used for FileBrowser dialog management. - - - The FileManagerDialogConfiguration members are passed in a secure manner to - the respective dialogs using the DialogParameters - collection of the editor. - - - - - Gets or sets the view paths of the FileManager dialog. - - - A String array, containing virtual paths which subfolders and files - the FileManager dialog will search and display. The default value is an empty String array. - - - - - Gets or sets the upload paths of the FileManager dialog. - - - A String array, containing virtual paths to which files - can be uploaded or subfolders can be created. The default value is an empty String array. - - - As only files/folders, contained in the ViewPaths - array will be displayed, users are able to upload files/create subfolders only - to folders, belonging to the intersection of the ViewPaths and - UploadPaths properties. - - - - - Gets or sets the delete paths of the FileManager dialog. - - - A String array, containing virtual paths in which files or - subdirectories can be deleted. The default value is an empty String array. - - - As only files/folders, contained in the ViewPaths - array will be displayed, users are able to delete only the files/folders, - belonging to the intersection of the ViewPaths and - UploadPaths properties. - - - - - Gets or sets the extension patterns for files to be displayed in the FileManager dialog. - - - A String array, containing extension patterns for - files to be displayed in the FileManager dialog. - - - Values can contain wildcars (e.g. *.*, *.j?g) - - - - - Gets or sets the max filesize which users are able to upload in bytes - - - An Int32, representing the max filesize which users are able - to upload in bytes. - - - The value of the MaxUploadFileSize property should be less or equal - to the <httpRuntime maxRequestLength...> website property, specified in either - the web.config or machine.config files. The <httpRuntime maxRequestLength...> - property controls the allowed post request length for the website. - - - - - Gets or sets the fully qualified type name of the FileBrowserContentProvider used in the dialog, - including the assembly name, version, culture, public key token. - - - The default value is string.Empty - - - When the value of this property is string.Empty (default), the dialog will use the integrated - FileSystemContentProvider. - - - - - A RadEditor color picker color - - - - - Initializes a new instance of the class. - - - - - Initializes a new instance of the class. - - - - - Initializes a new instance of the class. - - - - - A strongly typed collection of EditorColor objects - - - - - Initializes a new instance of the class. - - - - - Adds a EditorColor object, initialized with the specified value. - - - - - When overridden in a derived class, instructs an object contained by the collection to record its entire state to view state, rather than recording only change information. - - The that should serialize itself completely. - - - - Represents a RadEditor context menu. - - - - - - - - - - - - - - - - - - - - - Gets or sets the name of the tag, this EditorContextMenu will be associated to. - - - - - Gets or sets a value indicating whether this is enabled. - - true if enabled; otherwise, false. - - - - Gets the collection of EditorTool objects, placed in this context menu instance. - - - - - A strongly typed collection of EditorContextMenu objects - - - - - Adds the specified item to the collection. If the collection already contains an item - with the same TagName, it will be replaced with the new item. - - - - - - - - - Represents a CssClass dropdown item. - - - - - A strongly typed collection of EditorCssClass objects - - - - - Represents a FontName dropdown item. - - - - - A strongly typed collection of EditorFont objects - - - - - Represents a FontSize dropdown item. - - - - - A strongly typed collection of EditorFontSize objects - - - - - A strongly typed collection of EditorLink objects - - - - - Represents a FormatBlock dropdown item. - - - - - The tag which the selected text will be enclosed with. - - - - - The text which will be displayed in the FormatBlock dropdown - - - - - A strongly typed collection of EditorParagraph objects - - - - - Represents a RealFontSize dropdown item. - - - - - A strongly typed collection of EditorRealFontSize objects - - - - - Represents a InsertSnippet dropdown item. - - - - - A strongly typed collection of EditorSnippet objects - - - - - Represents a InsertSymbol dropdown item. - - - - - A strongly typed collection of EditorSymbol objects - - - - - Represents a SpellCheck dropdown item. - - - - - A strongly typed collection of SpellCheckerLanguage objects - - - - - A special EditorTool object, which is rendered as a separator by the default - ToolAdapter. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Gets or sets a value indicating whether this is visible. - - true if visible; otherwise, false. - - - - Gets the custom attributes which will be serialized on the client. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Gets or sets the type of the tool - by default it is a button - - The type of the tool on the client. - - - - - - - - Adds the specified item. - - The item. - - - - Determines whether the collection contains the specified item. - - The item. - - true if the collection contains the specified item; otherwise, false. - - - - - Copies the collection items to the specified array. - - - - - Adds the specified items to the collection. - - - - - Gets the index of the specified item. - - - - - Inserts the specified item at the specified index. - - - - - Removes the specified item. - - - - - Removes the item at the specified index. - - The zero-based index of the item to remove. - index is not a valid index in the . - The is read-only.-or- The has a fixed size. - - - - - - - - - - - - - - - - Gets or sets the tool at the specified index. - - - - - - - - - Represents a ToolStrip RadEditor tool, containing other tools. - - - - - - - - - - - - - - - - - - - - - Gets or sets the name of the tool strip. - - The name. - - - - Gets the collection of EditorTool objects, inside the tool strip. - - The tools. - - - - Encapsulates the properties used for ImageManager dialog management. - - - - - Gets or sets the default suffix for thumbnails. - - - A String, specifying the default thumbnail suffix. The default value - is "thumb". - - - Used in the ImageManager dialog. The value of the ImageEditorFileSuffix property is - used to determine if an image selected in the file browser is a thumbnail of another image - in the same folder. When a thumbnail image is selected in the file list, additional controls - for the image insertion appear - if the inserted image should link to the original one and - if the link that will be inserted will open in a new window. - - - - - Gets or sets a value indicating whether to show the Image Editor tool in the Image Manager dialog. - - - - - - - - - - - - - - - - - - - - - - - - - Gets the custom attributes which will be serialized on the client. - - - - Gets or sets the suffix for the custom dictionary files. - The default is -Custom - - The filenames are formed with the following scheme: Language + CustomDictionarySuffix + - ".txt". Different suffixes can be used to create different custom dictionaries for - different users. - - - - Gets or sets the path for the dictionary files. - The default is ~/App_Data/Spell/ - - This is the path that contains the TDF files, and the custom dictionary TXT - files. - - - - - Gets or sets a the edit distance. If you increase the value, the checking speed - decreases but more suggestions are presented. Applicable only in EditDistance mode. - - The default is 1 - - This property takes effect only if the - SpellCheckProvider property is set to - EditDistanceProvider. - - - - Gets or sets the value indicating whether the spell will allow adding custom words. - The default is true - - - - Gets or sets the spellcheck language if different than the Language property. - - - - - Configures the spellchecker engine, so that it knows whether to skip URL's, email - addresses, and filenames and not flag them as erros. - - - - - Specifies the type name for a custom spell check provider. - - - - - Specifies the spellchecking algorithm that will be used. - - - The default is TelerikProvider - - - - - Gets or sets the value used to configure the spellchecker engine to ignore words containing: UPPERCASE, some - CaPitaL letters, numbers; or to ignore repeated words (very very) - - - - - Gets or sets the URL, to which the spellchecker engine AJAX call will be made. Check the help for more information. - - - - - Gets or sets the type for the spell custom dictionary provider. - - - - - This property sets the tool name in the client script. - - - - - This property gets or sets a value, indicating whether to show the input box of the spin box element - - - - - This property sets the tool name in the client script. - - - - - This property sets the tool name in the client script. - - - - - This property sets the tool name in the client script. - - - - - This property sets the tool name in the client script. - - - - - Parses the ToolsFileContent property of RadEditor and initializes the corresponding - collections. - - - - - Initializes the Colors collection from the ToolsFileContent property of RadEditor. - - - - - Initializes the ContextMenus collection from the ToolsFileContent property of RadEditor. - - - - - Initializes the CssClasses collection from the ToolsFileContent property of RadEditor. - - - - - Initializes the CssFiles collection from the ToolsFileContent property of RadEditor. - - - - - Initializes the Links collection from the ToolsFileContent property of RadEditor. - - - - - Initializes the Links collection from the ToolsFileContent property of RadEditor. - - - - - Initializes the Languages collection from the ToolsFileContent property of RadEditor. - - - - - Initializes the Links collection from the ToolsFileContent property of RadEditor. - - - - - Initializes the Modules collection from the ToolsFileContent property of RadEditor. - - - - - Initializes the Paragraphs collection from the ToolsFileContent property of RadEditor. - - - - - Initializes the Links collection from the ToolsFileContent property of RadEditor. - - - - - Initializes the Snippets collection from the ToolsFileContent property of RadEditor. - - - - - Initializes the Symbols collection from the ToolsFileContent property of RadEditor. - - - - - Initializes the Tools collection from the ToolsFileContent property of RadEditor. - - - - This is a base class for all column editors for GridCheckBoxColumn. - It defines the base properties for controls that can edit boolean values. - - - - Interface that describes the baseic column editor functionality, needed for a - class that should be responsible for editing of a content of a cell in a - - - - Implement column editor to provide extended editing functionality in RadGrid. The column-editor inheritors should provide the methods for - creating the column editor control inside the container (generally a grid TableCell). For example the default column editor for GridBoundColumn - creates a TextBox control and adds it to the corresponding GridtableCell when the InstantiateInControl method is called. - To inherit the base implementation of a column editor control in RadGrid you may consider deriving from instead implementing the IColumnEditor interface. - - - - - Implement this member to add control int the given container. - After the call to this method the ContainerControl property should return the instance of containerControl parameter passed to this function. - - - - - - The editor should recreate its state and imput controls from the Container. - - control (generally a TableCell) that contains the input controls, previously instantiated within the InitializeInControl method call - - - - Gets the instance of the Container control (generally a TableCell), after the last call of InstantiateInControl method - - - - - Get value if the editor has been initialized after an InitializeInControl or InitializeFromControl method call - - - - - Get a value indicating if the column/row the editor currently is instantiated is in edit mode. - - - - - Copy setting from given column editor - - - - - - Create the input/edit controls belonging to the editor and prepare for AddControlsToContainer call. - - - - - Implement this member to create the edit controls in the grid cell. - This method is called from each column's InitializeCell method, when a initializes its cells. - - - - - This method should recrteate the state of the column editor (edit controls, etc) from the container. - This method is called when method is called, or when is called. - - - This method is should prepare the column editor to extract values from the edit controls residign in a TableCell of the grid. - - - - - Gets or sets the value for each cell in a - GridCheckBoxColumn. - - - - - Provides a reference to the control in the corresponding grid cell of the current - GridCheckBoxColumn. - - - - - Gets or sets the style defining the appearance of the corresponding - check-box. - - - - - - - - - Gets or sets the value for each cell in a - GridCheckBoxColumn. - - - - - Summary description for GridCreateColumnEditorEvent. - - - - - Summary description for GridDropDownColumnEditor. - - - - - Base class that intruduces the editor of GridBoundColumn. THis can be an editor that creates a simple TextBox control, ot RichTexst editors, that has a single string property Text. - - - - - Class tha implements data editing of a GridBoundColumn with a single TextBox control. - - - - - Gets The text box instance created of extracted from a cell after calls to AddControlsToContainer or LoadControlsFromContainer methods. - - - - - Gets the instace of the Style that would be applied to the TextBox control, when initializing in a TableCell. - - - - - A column type for the RadGrid control that is bound to a field in a data - source. - - Grid column types - - The default data binding (when AutoGenerateColumns property - is set to true) generates GridBoundColumn type of columns. It - displays each item from the DataSource field as text. This column is - editable (implements the - IGridEditableColumn - interface) and provides by default GridTextColumnEditor, used for - editing the text in each item. - GridBoundColumn has three similar and yet different - properties controlling its visibility and rendering in a browser in regular and in - edit mode: - - Display - concerns only the appearance of the column in - browser mode, client-side. The column will be rendered in the browser but all - the cells will be styled with display: none. The column editor will be - visible in edit mode. - Visible - will stop the column cells from rendering in - browser mode. The column will be visible in edit mode. - - ReadOnly - the column will be displayed according to the - settings of previous properties in browser mode but will not appear in the - edit-form.
-
- - - None of these properties can prevent you from - accessing the column cells' content server-side using the - UniqueName of the column. - - -
-
-
-
- -
-            <telerik:GridBoundColumn FooterText="BoundColumn footer" UniqueName="CustomerID" SortExpression="CustomerID"
HeaderText="Bound<br/>Column" DataField="CustomerID">
</telerik:GridBoundColumn> -
-
- Grid Column types - Adding columns design-time - Using columns -
- - - All columns in RadGrid that have editing capabilities derive from GridEditableColumn. - This class implements the base functionality for editing, using column editors etc. - - - Provides IGridEditableColumn interface, which RadGrid uses to operate with the - state of all the editable columns. - - - - - A Column is the main logic unit that relates the content of the grid to - properties of the objects in the DataSource. - The GridColumn defines the properties and methods that are common to all - column types in RadGrid. As it is an abstract class (MustInherit in VB.NET) - GridColumn class can not be created directly. You should inherit it and use its - children. - - - GridColumn is the base abstract class that implements the - functionality of a grid column. All inherited classes modify the base behavior - corresponding to the specific data that should be displayed/edited in RadGrid. The - columns that have editing capabilities derrive from - class. Other instances display data, buttons, and - so on in the cells of the grid regarding the type of the Item/row in which the cell - resides. In you code you can create only instances of the derrived classes. In order to - display a column in the grid you should add it in the corresponding - collection. Since the column collection is - fully persisted in the ViewSteate you should follow the rules that apply to creating - asp.net server controls dynamically, when adding columns to grid tables - programmatically. - - - - - Using the FooterStyle property lets you enhance the appearance - of the footer section of the column. You can set forecolor, backcolor, font and content - alignment. - - - - - Using the HeaderStyle property lets you enhance the appearance - of the header section of the column. You can set forecolor, backcolor, font and content - alignment. - - - - - Use this property to enhance the appearance of the item cells of the column. You - can provide a custom style for Common style attributes that can be adjusted such as: - forecolor, backcolor, font, and content alignment within the cell. - - - - Creates and initializes a new column with its base properties. - - - - The Initialize method is inherited by a derived - GridColumn class. Is is used to reset a column of the derived - type. - - - This method is mainly used to reset properties common for all column types - derived from GridColumn class. - The Initialize method is usually called during data-binding, prior to the - first row being bound. - - - - - After a call to this method the column should add the corresponding controls - (text, labels, input controls) into the cell given, regarding the inItem type and - column index. - Note: This method is called within RadGrid and is not intended - to be used directly from your code. - - - - - This method should be used in case you develop your own column. It returns true - if the column supports filtering. - - - - - Modifies the CurrentFilterFunction and - CurrentFilterValue properties according to the function given and the - corresponding filter text-box control in the filtering item. - - - - - Modifies the CurrentFilterValue property according to the - corresponding selected item in the filter text-box control in the filtering - item. - - - - - Sets the value of the property CurrentFilterValue as a text on the TextBox control found in the cell - - - - - - Gets the value of the Text property of a textbox control found in the cell, used to set the value of the CurrentFilterValue property. - - - - - - - Gets a string representing a filter expression, based on the settings of all - columns that support filtering, with a syntax ready to be used by a - DataView object - - - - - Instantiates the filter controls (text-box, image.) in the cell given - - - - - - Gets a list of filter functions based on the settings of the property. - - - - - - - - Prepares the cell of the item given, when grid is rendered. - - - - - - - - - - - Resets the values of the and - properties to their defaults. - - - - - By default returns the SortExpression of the column. If the SortExpression is not set explicitly, it would be calculated, based on the - DataField of the column. - - - - - - Calculate the default Group-by expression based on the settings of the - DataField (if available) - - - For example, if a column's DataField is ProductType the default group-by expression will be: - 'ProductType Group By ProductType' - - - - - Note: When implementing/overriding this method be sure to call - the base member or call CopyBaseProperties to be sure that all base - properties will be copied accordingly - - Creates a copy of the current column. - - - - This method returns true if the column is bound to the specified field - name. - - The name of the DataField, which will be checked. - - - - - - - - This method should be used in case you develop your own column. It returns the - full list of DataFields used by the column. - GridTableView uses this to decide which DataFields - from the specified DataSource will be inlcuded in case of - GridTableView.RetrieveAllDataFields is set to - false. - - - - Gets or sets a value of the currently applied filter. - - This property returns a string, representing the - current value, for which the columns is filtered (the value, which the user has entered - in the filtering text box). - - - - - Should override if sorting will be disabled - - - - Gets or sets the current function used for filtering. - - This property returns a value of type - Telerik.Web.UI.GridKnownFunction. The possible - values are: - GridKnownFunction.Between
- GridKnownFunction.Contains
- GridKnownFunction.Custom
- GridKnownFunction.DoesNotContain
- GridKnownFunction.EndsWith
- GridKnownFunction.EqualTo
- GridKnownFunction.GreaterThan
- GridKnownFunction.GridKnownFunction
- GridKnownFunction.GreaterThanOrEqualTo
- GridKnownFunction.IsEmpty
- GridKnownFunction.IsNull
- GridKnownFunction.LessThan
- GridKnownFunction.LessThanOrEqualTo
- GridKnownFunction.NoFilter
- GridKnownFunction.NotBetween
- GridKnownFunction.NotEqualTo
- GridKnownFunction.NotIsEmpty
- GridKnownFunction.NotIsNull
- GridKnownFunction.StartsWith
-
-
- - - Gets or sets the value indincating which of the filter functions should be - available for that column. For more information see - enumaration. - - - This property returns a value of type - Telerik.Web.UI.GridFilterListOptions. The possible - values are: - - Telerik.Web.UI.GridFilterListOptions.AllowAllFilters
- Telerik.Web.UI.GridFilterListOptions.VaryByDataType
- Telerik.Web.UI.GridFilterListOptions.VaryByDataTypeAllowCustom
-
-
- - - Gets or sets a value indicating whether the grid should automatically postback, - when the value in the filter text-box changes, and the the focus moves to another - element. - - - This property returns a Boolean value, indicating - whether the grid will postback, once the focus moves to another element, and the text - of the filtering textbox has changed. - - - - - Gets or sets a string representing the URL to the image used in the filtering - box. - - - A string, representing the URL to the image used in the - filtering box. - - - - - Gets or sets a string representing the URL to the image used for sorting in - ascending mode. - - - A string, representing the URL to the image used for - sorting in ascending mode - - - - - Gets or sets a string representing the URL to the image used for sorting in - descending mode. - - - A string, representing the URL to the image used for - sorting in descending mode - - - - - Gets the string representation of the DataType property of the - column, needed for the client-side grid instance. - - - - - Gets or sets the template, which will be rendered in the filter item cell of the column. - - A value of type ITemplate. - - - - Style of the cell in the footer item of the grid, corresponding to the column. - - - - - Use the FooterText property to specify your own or determine the current - text for the footer section of the column. - - - - - Gets or sets the URL of an image in the cell in the header item of the grid - current column. You can use a relative or an absolute URL. - - - - - Style of the cell in the header item of the grid, corresponding to the column. - - - - - Use the HeaderText property to specify your own or determine the current - text for the header section of the column. - - - - - Style of the cells, corresponding to the column. - - - - - Gets the instance of the GridTableVeiw wich owns this column instance. - - - - - The string representing a filed-name from the DataSource that should be used when grid sorts by this column. For example: - 'EmployeeName' - - - - - The group-expression that should be used when grid is grouping-by this column. If - not set explicitly, RadGrid will generate a group expression based on the DataField of - the column (if available), using the - method. - The grouping can be turned on/off for columns like GridBoundColumn using - property. - For more information about the Group-By expressions and their syntax, see - class. - - - - - Get or Sets a value indicating whether a sort icon should appear next to the - header button, when a column is sorted. - - - This property returns a Boolean value, indicating - whether a sort icon should appear next to the header button, when a column is - sorted. - - - - - Gets or sets a value indicating if the column and all corresponding cells would be rendered. - - - This property returns a Boolean value, indicating - whether the cells corresponding to the column, would be visible on the client, and - whether they would be rendered on the client. - - - - - Gets or sets a value indicating whether the cells corresponding to a column would be rendered with a 'display:none' style attribute (end-user-not-visible). - To completely prevent cells from rendering, set the property to false, instead of the Display property. - - - This property returns a Boolean value, indicating - whether the cells corresponding to the column would be rendered with a 'display:none' - style attribute (end-user-not-visible). - - - - - Gets the value of the ClientID property of the GridTableView that owns this column. This property value is used by grid's client object - - - The return value of this property is a string, - representing the clientID of the GridTableView, which contains the column. This is the - ClientID of the grid instance, followed by "_" and another string, representing the - place of the container in the control hierarchy. For the MasterTableView, the default - OwnerID for a column will look like: "RadGrid1_ctl01". - - - - - Gets the value of the ClientID property of the RadGrid instance that owns this column. This property value is used by grid's client object - - - This property returns a string, which represents a the - ClientID for the control. - - - - - Gets or sets a value indicating whether the column can be resized client-side. - You can use this property, by setting it to false, to disable resizing for a particular - column, while preserving this functionality for all the other columns. - - - The property returns a boolean value, indicating - whether the column can be resized on the client. - - - - - Gets or sets a value indicating whether the column can be reordered client-side. - - - This property returns a boolean value, indicating whether the column is - reorderable. The default value is true, meaning that the column can be reordered, using - the SwapColumns client side method. - - - - - Gets or sets a value indicating whether you will be able to group - Telerik RadGrid by that column. By default this property is - true. - - - A boolean value of either true, when you are able to group by - that column, or false. - - - See Telerik RadGrid manual for details about using grouping. If - Groupable is false the column header cannot be dragged to the - GroupPanel. - - - - Using this property, you can easily turn off grouping for one or more - columns, while still allowing this functionality for all other columns in the - control. This is demonstrated in the code sample below: -
-            <radG:GridBoundColumn
DataField="ContactName"
HeaderText="ContactName"
SortExpression="ContactName"
UniqueName="ContactName"
Groupable="false">
</radG:GridBoundColumn> -
-
-
- - - Gets the string representation of the type-name of this instance. The value is - used by RadGrid to determine the type of the columns persisted into the ViewState, when - recreating the grid after postback. The value is also used by the grid client-side - object. This property is read only. - - - - - Gets or sets the button type of the button rendered in the header item, used - for sorting. The possible values that this property accepts are: - Telerik.Web.UI.GridHeaderButtonType.LinkButton
- Telerik.Web.UI.GridHeaderButtonType.PushButton
- Telerik.Web.UI.GridHeaderButtonType.TextButton
-
- - The return value for this property is of type - Telerik.Web.UI.GridHeaderButtonType - -
- - - Gets or sets the order index of column in the collection of - . Use - method for reordering the columns. - - - - We recommend using this property only for getting the order index for a - specific column instead of setting it. Use - method for reordering columns. - - Note that changing the column order index will change the order of the cells - in the grid items, after the grid is rebound. - - The value of the property would not affect the order of the column in the - collection. - - - - integer representing the current column index. You should have - in mind that GridExpandColumn and RowIndicatorColumn - are always in front of data columns so that's why you columns will start from index - 2. - - - - protected void RadGrid1_PreRender(object sender, EventArgs e) - { - foreach (GridBoundColumn column in RadGrid1.MasterTableView.Columns) - { - Response.Write(column.UniqueName + column.OrderIndex + "<br>"); - } - - RadGrid1.MasterTableView.SwapColumns(2, 4); - - foreach (GridBoundColumn column in RadGrid1.MasterTableView.Columns) - { - Response.Write(column.UniqueName + column.OrderIndex + "<br>"); - } - } - - - Protected Sub RadGrid1_PreRender(sender As Object, e As EventArgs) - Dim column As GridBoundColumn - For Each column In RadGrid1.MasterTableView.Columns - Response.Write((column.UniqueName + column.OrderIndex + "<br>")) - Next column - - RadGrid1.MasterTableView.SwapColumns(2, 4) - - Dim column As GridBoundColumn - For Each column In RadGrid1.MasterTableView.Columns - Response.Write((column.UniqueName + column.OrderIndex + "<br>")) - Next column - End Sub 'RadGrid1_PreRender - - - - - - This property is supposed for developers of new grid columns. It gets whether - a column is currently ReadOnly. The ReadOnly property determines whether a column - will be editable in edit mode. A column for which the ReadOnly property is true - will not be present in the automatically generated edit form. - - A boolean value, indicating whether a specific column is editable. - - - - Specifies the vertical collumn number where this column will appear when - using EditForms editing mode and the form is autogenerated. See the remarks for - details. - - - A practicle example of using this property is to deterimine the number of - columns rendered in the edit form. If there will be only one column in the rendered - edit form, when we retrieve the value of this property for a column, as shown in - the code below: -
- - - - - - -
- - protected void RadGrid1_PreRender(object sender, EventArgs e)
{
- int columnIndex = RadGrid1.MasterTableView.Columns[3].EditFormColumnIndex;
}
-
-
-
- it will be equal to 0, meaning the the column belongs to the first group of - columns in the edit form. -
-
- - - Each column in Telerik RadGrid has an UniqueName - property (string). This property is assigned automatically by the designer (or the - first time you want to access the columns if they are built dynamically). - - - You can also set it explicitly, if you prefer. However, the automatic - generation handles most of the cases. For example a - GridBoundColumn with DataField 'ContactName' - would generate an UniqueName of 'ContactName'. - Additionally, there may be occasions when you will want to set the UniqueName - explicitly. You can do so simply by specifying the custom name that you want to - choose: -
- - - - - - -
- - <radG:GridTemplateColumn
UniqueName="ColumnUniqueName">
</radG:GridTemplateColumn>
-
-
-
-
- - When you want to access a cell within a grid item, you - should use the following code to obtain the right cell: - TableCell cell = gridDataItem["ColumnUniqueName"]; - or - gridDataItem["ColumnUniqueName"].Text = - to access the Text property - Using this property you can index objects of type - %GridDataItem:GridDataItem% or - %GridEditFormItem:GridEditFormItem% (or all descendants of - %GridEditableItem:GridEditableItem% class) - In events related to creating, binding or for commands in items, the event - argument has a property Item to access the item that event is - fired for. To get an instance of type GridDataItem, you should use - the following: - //presume e is the event argument object
- if (e.Item is GridDataItem)
- {
- GridDataItem gridDataItem = e.Item as GridDataItem;
-
-
- - - String that formats the HeaderText when the column is displayed in an edit form - - - The following code demonstrates one possible use of this property: -
- - - - - - -
-
- In this way, once a record enters edit mode, the name of the column will be - followed by the custom text entered in the example above. - [ASPX/ASCX] - <radG:GridBoundColumn DataField="CustomerID"
- HeaderText="CustomerID"
- SortExpression="CustomerID"
- UniqueName="CustomerID"
- EditFormHeaderTextFormat="{0} is currently in edit mode" - >
- </radG:GridBoundColumn>
-
-
- - - Gets or sets (see the Remarks) the type of the data from the DataField as it - was set in the DataSource. - - - The DataType property supports the following base .NET Framework data - types: - - Boolean - Byte - Char - DateTime - Decimal - Double - Int16 - Int32 - Int64 - SByte - Single - String - TimeSpan - UInt16 - UInt32 - UInt64 - - - - - - Use this property to set width to the filtering control (depending on the column type, this may be a normal textbox, RadNumericTextBox, RadDatePicker, etc.) - - - - - Interface that RadGrid uses to determine the editable columns, their current state etc. - - - - protected void RadGrid1_UpdateCommand(object source, Telerik.Web.UI.GridCommandEventArgs e) - { - GridEditableItem editedItem = e.Item as GridEditableItem; - GridEditManager editMan = editedItem.EditManager; - - foreach( GridColumn column in e.Item.OwnerTableView.RenderColumns ) - { - if ( column is IGridEditableColumn ) - { - IGridEditableColumn editableCol = (column as IGridEditableColumn); - if ( editableCol.IsEditable ) - { - IGridColumnEditor editor = editMan.GetColumnEditor( editableCol ); - - string editorType = editor.ToString(); - string editorText = "unknown"; - object editorValue = null; - - if ( editor is GridTextColumnEditor ) - { - editorText = (editor as GridTextColumnEditor).Text; - editorValue = (editor as GridTextColumnEditor).Text; - } - - if ( editor is GridBoolColumnEditor ) - { - editorText = (editor as GridBoolColumnEditor).Value.ToString(); - editorValue = (editor as GridBoolColumnEditor).Value; - } - - if ( editor is GridDropDownColumnEditor ) - { - editorText = (editor as GridDropDownColumnEditor).SelectedText + "; " + - (editor as GridDropDownColumnEditor).SelectedValue; - editorValue = (editor as GridDropDownColumnEditor).SelectedValue; - } - - try - { - DataRow[] changedRows = this.EmployeesData.Tables["Employees"].Select( "EmployeeID = " + editedItem.OwnerTableView.DataKeyValues[editedItem.ItemIndex]["EmployeeID"] ); - changedRows[0][column.UniqueName] = editorValue; - this.EmployeesData.Tables["Employees"].AcceptChanges(); - } - catch(Exception ex) - { - RadGrid1.Controls.Add(new LiteralControl ("<strong>Unable to set value of column '" + column.UniqueName + "'</strong> - " + ex.Message)); - e.Canceled = true; - break; - } - } - } - } - } - - - Private Sub RadGrid1_UpdateCommand(ByVal source As System.Object, ByVal e As Telerik.Web.UI.GridCommandEventArgs) Handles RadGrid1.UpdateCommand - - Dim editedItem As GridEditableItem = CType(e.Item, GridEditableItem) - Dim editMan As GridEditManager = editedItem.EditManager - - Dim column As GridColumn - - For Each column In e.Item.OwnerTableView.Columns - If Typeof column Is IGridEditableColumn Then - Dim editableCol As IGridEditableColumn = CType(column, IGridEditableColumn) - If (editableCol.IsEditable) Then - Dim editor As IGridColumnEditor = editMan.GetColumnEditor(editableCol) - - Dim editorType As String = CType(editor, Object).ToString() - Dim editorText As String = "unknown" - Dim editorValue As Object = Nothing - - If (Typeof editor Is GridTextColumnEditor) Then - editorText = CType(editor, GridTextColumnEditor).Text - editorValue = CType(editor, GridTextColumnEditor).Text - End If - - If (Typeof editor Is GridBoolColumnEditor) Then - editorText = CType(editor, GridBoolColumnEditor).Value.ToString() - editorValue = CType(editor, GridBoolColumnEditor).Value - End If - - If (Typeof editor Is GridDropDownColumnEditor) Then - editorText = CType(editor, GridDropDownColumnEditor).SelectedText & "; " & CType(editor, GridDropDownColumnEditor).SelectedValue - editorValue = CType(editor, GridDropDownColumnEditor).SelectedValue - End If - - Try - Dim changedRows As DataRow() = Me.EmployeesData.Tables("Employees").Select("EmployeeID = " & editedItem.OwnerTableView.DataKeyValues(editedItem.ItemIndex)("EmployeeID")) - changedRows(0)(column.UniqueName) = editorValue - Me.EmployeesData.Tables("Employees").AcceptChanges() - Catch ex As Exception - RadGrid1.Controls.Add(New LiteralControl("<strong>Unable to set value of column '" & column.UniqueName & "'</strong> - " + ex.Message)) - e.Canceled = True - End Try - - End If - End If - Next - End Sub - - - Using column editors - - - - Get value based on the current IsEditable state, item edited state and ForceExtractValue setting. - - item to check to extract values from - - - - Extracts the values from the editedItem and fills the names/values pairs for each data-field edited by the column in the newValues dictionary. - - dictionary to fill. This param should not be null (Nothing in VB.NET) - the GridEditableItem to extract values from - - - - Get whether a column is currently read-only - - - - - Gets the column editor instance for this column - - - - - Gets the GridColumn instance implementing this interface - - - - - Force RadGrid to extract values from EditableColumns that are ReadOnly (or IsEditable is false). - - - - - Extracts the values from the editedItem and fills the names/values pairs for each data-field edited by the column in the newValues dictionary. - - dictionary to fill. This param should not be null (Nothing in VB.NET) - the GridEditableItem to extract values from - - - - Get value based on the current IsEditable state, item edited state and ForceExtractValue setting. - - item to check to extract values from - - - - Get the current colum editor. If the column editor is not assigned at the moment the column will search for the ColumnEditorID on the page or should - create its default column editor - - - - - Convert the emty string to null when extracting values for inserting, updating, deleting - - - - - Gets or sets the readonly status of the column. The column will be displayed in - browser mode (unless its Visible property is false) - but will not appear in the edit-form. - - - A boolean value, indicating whether a column is - ReadOnly. - - - - - Force RadGrid to extract values from EditableColumns that are ReadOnly (or IsEditable is false). - - - - Resets the GridBoundColumn to its initial state. - - - - Resets the specified cell in the GridBoundColumn to its initial - state. - - - - - Gets or sets the field name from the specified data source to bind to the - GridBoundColumn. - - - A string, specifying the data field from the data - source, from which to bind the column. - - - - - Gets or sets the field name from the specified data source to bind to the - GridBoundColumn. - - - A string, specifying the data field from the data - source, from which to bind the column. - - - - - Sets or gets whether cell content must be encoded. Default value is - false. - - - - - Sets or gets default text when column is empty. Default value is - "&nbsp;" - - - - - Gets or Sets an integer, specifying the maximum number of characters, which will - be accepted in the edit textbox for the field, when in edit mode. - - - An integer, specifying the maximum number of - characters, which the item will accept when in edit mode. - - - - -
- Use the DataFormatString property to provide a custom format for the items - in the column. - The data format string consists of two parts, separated by a colon, in the form { - A : Bxx }.
- For example, the formatting string {0:C2} displays a currency formatted number with two - decimal places.
- Note: The entire string must be enclosed in braces to indicate - that it is a format string and not a literal string. Any text outside the braces is - displayed as literal text. - The value before the colon (A in the general - example) specifies the parameter index in a zero-based list of parameters. -
- Note: This value can only be set to 0 because there is only one - value in each cell.
- The value before the colon (A in the general - example) specifies the parameter index in a zero-based list of parameters. - The character after the colon (B in the general - example) specifies the format to display the value in. The following table lists the - common formats. -
-
- - - - Format character - - Description - - - C - - Displays numeric values in currency format. - - - D - - Displays numeric values in decimal format. - - - E - - Displays numeric values in scientific (exponential) - format. - - - F - - Displays numeric values in fixed format. - - - G - - Displays numeric values in general format. - - - N - - Displays numeric values in number format. - - - X - - Displays numeric values in hexadecimal - format.
-
- Note: The format character is not case-sensitive, except for - X, which displays the hexadecimal characters in the case specified.
-
The value after the format character - (xx in the general example) specifies the number of - significant digits or decimal places to display.
- For more information on formatting strings, see - Formatting - Overview (external link to MSDN library).
-
- - Gets or sets the string that specifies the display format for items in the - column. - - - A string that specifies the display format for items in - the column - -
- - Gets or sets whether the column data can be filtered. - A boolean value, indicating whether the column data can be filtered. - - - Gets or sets a whether the column data can be sorted. - - A boolean value, indicating whether the column data can - be sorted. - - - - - Gets a boolean value, indicating whether the column is editable. A ReadOnly - column will return a false value for this property. The property is readOnly. - - - A boolean value, indicating whether the column is - editable - - - - Defines what button will be rendered in a GridButtonColumn - - - Renders a standard hyperlink button. - - - Renders a standard button. - - - Renders an image that acts like a button. - - - Defines what kind of confirm dialog will be used in a GridButtonColumn - - - Standard browser confirm dialog. - - - RadWindow confirm dialog. - - - It displays a button for each item in the column. - Grid column types - - - This column renderes a button of the specified ButtonType in each corresponding - cell of the items of type and - . You can use this buttons to fire command - events that can be handeled in event - handler. This, in combination with the - event - bubbling mechanism in Telerik RadGrid, allows you to create a - column of custom button controls, such as Add, - Remove, Select or Edit - buttons. - - The available buttons types are: - PushButton,LinkButton and ImageButton. - Telerik RadGrid comes with two types of button columns: - - Select - when a button in this column is pressed, it - will select the whole row. The Select column below uses a - PushButton. - Remove selection - when a button in this column is - pressed, it will delete the row. The Remove selection column - below uses a LinkButton. - - - -
-                <radG:GridButtonColumn FooterText="PushButtonColumn<br/>footer" DataTextFormatString="Select {0}"
ButtonType="PushButton" UniqueName="column" HeaderText="PushButton<br/>Column"
CommandName="Select" DataTextField="CustomerID">
</radG:GridButtonColumn> -
-
- Grid Column types - Adding columns design-time - Using columns -
- - Constructs a new GridButtonColumn object. - - - - The Initialize method is inherited by a derived - GridButtonColumn class. Is is used to reset a column of the derived - type. - - - - - After a call to this method the column should add the corresponding button into - the cell given, regarding the inItem type and column index. - Note: This method is called within RadGrid and is not intended - to be used directly from your code. - - - - Returns a copy of the GridButtonColumn. - - - - Gets or sets the title that will be shown on the RadWindow confirmation dialog when a button - in this column is clicked. - - - - - Gets or sets a value indicating the type of the button that will be rendered. The - type should be one of the specified by the - enumeration. - - - - - LinkButton - Renders a standard hyperlink button. - - PushButton - Renders a standard button. - - ImageButton - Renders an image that acts like a - button. - - - - - Gets or sets the CssClass of the button - - - - - Gets or sets a value defining the name of the command that will be fired when a - button in this column is clicked. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Fired By controls within DataItems - showing and - editing data
CancelCommandNameRepresents the Cancel command name. Fires RadGrid.CancelCommand - event and sets Item.Edit to false for the parent - Item.
DeleteCommandNameRepresents the Delete command name. Fires RadGrid.DeleteCommand - event. Under .Net 2.0 performs automatic delete operation and then sets - Item.Edit to false.
UpdateCommandNameRepresents the Update command name. Fires RadGrid.UpdateCommand - event. Under .Net 2.0 performs automatic update operation and then sets - Item.Edit to false.
- EditCommandNameRepresents the Edit command name. Sets Item.Edit to - true.
- SelectCommandNameRepresents the Select command name. Sets Item.Selected to - true.
- DeselectCommandNameRepresents the Deselect command name. Sets Item.Selected to - false.
- Can be fired by controls within any Item
- InitInsertCommandNameBy default grid renders an image button in the CommandItem. Opens - the insert item.
- PerformInsertCommandNameFires RadGrid.InsertCommand event. Under .Net 2.0 Perfoms - automatic insert operation and closes the insert item.
- RebindGridCommandNameBy default grid renders an image button in the CommandItem. Forces - RadGrid.Rebind
- SortCommandNameRepresents the Sort command name. By default it is fired by image buttons in the - header item when Sorting is enabled. The argument for the SortCommand - must be the DataField name for the DataField to be - sorted.
-
-
- - - Gets or sets an optional parameter passed to the Command event along with the - associated - CommandName. - - - - - Use the DataTextField property to specify the field name - from the data source to bind to the - Text property of the - buttons in the - GridButtonColumn object. - Binding the column to a field instead of directly setting the Text - property allows you to display different captions for the buttons in the - GridButtonColumn by using - the values in the specified field. - Tip: This property is most - often used in combination with - - DataTextFormatString Property. - - - Gets or sets a value from the specified datasource field. This value will then be - displayed in the GridBoundColumn. - - -
- - - - - - -
-
- - [ASPX/ASCX]<br/><br/><radg:RadGrid id=<font class="string">"RadGrid1"</font> runat=<font class="string">"server"</font>><br/> <MasterTableView AutoGenerateColumns=<font class="string">"False"</font>><br/> <Columns><br/> <radg:GridButtonColumn HeaderText=<font class="string">"Customer ID"</font><font color="red">DataTextField=<font class="string">"CustomerID"</font></font><br/><font color="red">DataTextFormatString=<font class="string">"Edit Customer {0}"</font></font> ButtonType=<font class="string">"LinkButton"</font> UniqueName=<font class="string">"ButtonColumn"</font>><br/> </radg:GridButtonColumn> - - - - - -
-
- - - Use the DataTextFormatString property to provide a custom - display format for the caption of the buttons in the - GridButtonColumn. - Note: The entire - string must be enclosed in braces to indicate that it is a format string and not a - literal string. Any text outside the braces is displayed as literal text. - - - - - - - - -
- - [ASPX/ASCX]<br/><br/><radg:RadGrid id=<font color="black"><font class="string">"RadGrid1"</font> runat=<font class="string">"server"</font>><br/> <MasterTableView AutoGenerateColumns=<font class="string">"False"</font>><br/> <Columns><br/> <radg:GridButtonColumn HeaderText=<font class="string">"Customer ID"</font></font><font color="red">DataTextField=<font class="string">"CustomerID"</font><br/>DataTextFormatString=<font class="string">"Edit Customer {0}"</font></font> ButtonType=<font class="string" color="black">"LinkButton"</font> UniqueName=<font color="black"><font class="string">"ButtonColumn"</font>><br/> </radg:GridButtonColumn></font> - -
- - Gets or sets the string that specifies the display format for the caption in each - button. - -
- - Gets or sets a value indicating the text that will be shown for a button. - - - - Gets or sets a value indicating the URL for the image that will be used in a - Image button. should be set to - ImageButton. - - - - - Gets or sets the text that will be shown on the confirmation dialog when a button - in this column is clicked. The prompt is automatically enabled when this property is - set. - - - - - Gets or sets a value indicating whether this column can be used for grouping. If - set to false the column header cannot be dragged to the - . - - - - Gets the status of property. - - - - - If the corresponding is in edit mode - specifies whether this column will - render an Enabled=true button control, when the corresponding item is edit - mode. - - - - - - Displays a CheckBox control for each item in the column. This allows you - to edit for example Boolean field(s) from data table(s). - - Grid column types - - This column is editable (implements the IGridEditableColumn - interface) and provides by default GridBoolColumnEditor, used for - editing the text in each item. You can persist the checked state of a checkbox, if you - use it within GridTemplateColumn - ( - see here). - - -
-                <radG:GridCheckBoxColumn FooterText="CheckBoxColumn footer" UniqueName="Bool" HeaderText="CheckBox<br/>Column"
DataField="Bool">
</radG:GridCheckBoxColumn> -
-
- Grid Column types - Adding columns design-time - Using columns - Similarities/Differences between GridCheckBoxColumn and GridTemplateColumn with - checkbox -
- - - Gets or sets the field name from the specified data source to bind to the - column. - - - A string, specifying the data field from the data - source, from which to bind the column. - - - - Gets or sets a whether the column data can be sorted. - - A boolean value, indicating whether the column data can - be sorted. - - - - Gets or sets whether the column data can be filtered. - A boolean value, indicating whether the column data can be filtered. - - - - Gets a boolean value, indicating whether the column is editable. A ReadOnly - column will return a false value for this property. The property is readOnly. - - - A boolean value, indicating whether the column is - editable. - - - - - A special type of GridButtonColumn, including a delete buttons in each row. It - provides the functionality of erasing records client-side, without making a round trip - to the server. - - - This optimizes the performance and the source data is automatically refreshed - on the subsequent post to the server. The user experience is improved because the - delete action is done client-side and the table presentation is updated - immediately. - Its ConfirmText property can be assigned like with the default - GridButtonColumn showing a dialog which allows the user to cancel the - action. - - -
-            <radG:GridClientDeleteColumn ConfirmText="Are you sure you want to delete the selected row?" HeaderStyle-Width="35px" ButtonType="ImageButton" ImageUrl="~/RadControls/Grid/Skins/WebBlue/Delete.gif" />
-                
-
- Client-side delete feature - Grid column types - Client-side delete - Web Grid -
- - - Gets or sets a value indicating the URL for the image that will be used in a - Image button. should be set to - ImageButton. - - - - - Displays a Checkbox control for each item in the column. This - allows you to select grid rows client-side automatically when you change the status of - the checkbox to checked. - - Column types - Client selection - - If you choose AllowMultiRowSelection = true for the grid, a - checkbox will be displayed in the column header to toggle the checked/selected stated - of the rows simultaneously (according to the state of that checkbox in the - header).
-
- To enable this feature you need to turn on the client selection of the grid - (ClientSettings -> Selecting -> AllowRowSelect = true). -
- -
-            <radG:GridClientSelectColumn UniqueName="CheckboxSelectColumn" HeaderText="CheckboxSelect column <br />" />
-                
-
- Grid Column types - Adding columns design-time - Using columns -
- - - The collection of columns of RadGrid or its tables. Accessible through - Columns property of RadGrid and GridTableView (MasterTableView) - classes. - - - Its items are of the available Grid - column - types. - - - - GridBoundColumn boundColumn; - boundColumn = new GridBoundColumn(); - boundColumn.DataField = "CustomerID"; - boundColumn.HeaderText = "CustomerID"; - RadGrid1.MasterTableView.Columns.Add(boundColumn); - - boundColumn = new GridBoundColumn(); - boundColumn.DataField = "ContactName"; - boundColumn.HeaderText = "Contact Name"; - RadGrid1.MasterTableView.Columns.Add(boundColumn); - - RadGrid1.MasterTableView.Columns.Add( new GridExpandColumn() ); - - - Dim boundColumn As GridBoundColumn - boundColumn = New GridBoundColumn() - boundColumn.DataField = "CustomerID" - boundColumn.HeaderText = "CustomerID" - RadGrid1.MasterTableView.Columns.Add(boundColumn) - - boundColumn = New GridBoundColumn() - boundColumn.DataField = "ContactName" - boundColumn.HeaderText = "Contact Name" - RadGrid1.MasterTableView.Columns.Add(boundColumn) - - RadGrid1.MasterTableView.Columns.Add(New GridExpandColumn()) - - - - - Adds a column object to the GridColumnCollection. - The GridColumn object to add to the collection. - - - - Determines whether the CridColumnCollection contains the value specified - by the given GridColumn object. - - - true if the GridColumn is found in the - GridColumnCollection; otherwise, false. - - GridColumn object to locate in the GridColumnCollection. - - - - Determines the index of a specific column in the - GridColumnCollection. - - - The index of value if found in the collection; - otherwise, -1. - - The object to locate in the GridColumnCollection. - - - - Inserts a column to the GridColumnCollectino at the specified - index. - - - The zero-based index at which column should be - inserted. - - - - The to insert into the collection. - - - - - - Removes the first occurrence of an object from the - GridColumnCollection. - - The object to remove from the collection. - - - - Determines the index of a specific column in the - GridColumnCollection. - - - The index of value if found in the collection; - otherwise, -1. - - - The to locate in the - GridColumnCollection. - - - - - Removes the first occurrence of a column from the - GridColumnCollection. - - The column to remove from the collection. - - - - Removes the GridColumnCollection item at the specified - index. - - The zero-based index of the item(column) to remove. - - - - Gets the first column with UniqueName found. Throws GridException if no column is found. - - - - - - - Gets the first column with UniqueName found. Returns null if no column is found. - - - - - - - Gets the first column found bound to the DataField. Throws GridException if no column is bound to this DataField - - - - - - - Gets the first column found bound to the DataField. Returns null is no column is bound to this DataField - - - - - - - Gets all columns found bound to the DataField specified. Returns null is no column is bound to this DataField - - - - - - Gets the number of columns added programmatically or declaratively. - - Note that this is not the actual number of column in a - . See also - - - RenderColumns Property (Telerik.Web.UI.GridTableView) - - - - If the column/detail table structure is created after the control has been - initialized (indicated by RadGrid.Init event ) the state of the - columns/detail tables may have been lost. This happens when properties have been set to - GridColumn/GridTableView instance before it has been - added to the corresponding collection of - Columns/DetailTables. Then a - GridException is thrown with message: "Failed accessing - GridColumn by index. Please verify that you have specified the structure of RadGrid - correctly." - - - - - - Here is the mechanism which Telerik RadGrid uses to present - values for GridDropDownColumn. Consider the snippet below: - <radg:GridDropDownColumn
- UniqueName="LevelID"
- ListDataMember="Level"
- ListTextField="Description"
- ListValueField="LevelID"
- HeaderText="LevelID"
- DataField="LevelID"
- />
- -
- As you can see, a requirement for the proper functioning of - GridDropDownColumn is that all column - values referenced by the DataField - attribute match the column values referenced by the - ListValueField attribute.
- If there are values in the LevelID column of the LevelID table which do not - have corresponding equal values in the LevelID column of the Level table, then - the grid will display the default first value from the Description column as it - will not "know" what is the correct field. -
-
- - Displays a DropDown control for each item in the column. This allows you - to edit for example lookup field(s) from data table(s). - - Grid column types - Grid Column types - Adding columns design-time - Using columns -
- - - The ListDataMember property points to the data table (part - of the dataset used for grid data-source) which is the source for the - GridDropDownColumn generation. - - - - - A string, specifying the ID of the datasource control, which will be used to - populate the dropdown with data. - - - A string, specifying the ID of the datasource control, - which will be used to populate the dropdown with data. - - - - - The ListTextField points to the column in the data table - from which the grid will extract the values for the dropdown. - - - - - The ListValueField points to the column in the data table - which will be used as a pointer to retrieve the items for the dropdown in the - GridDropDownColumn. - - - - - The DataField property points to the column in the grid - data-source containing values which will be compared at a later stage with the - values available in the column, referenced by the - %ListValueField:ListValueField% property. - - - - - A Boolean value, indicating whether the dropdown column will be bound to a - default value/text when there is no data source specified, from which to fetch the - data. - - - A Boolean value, specifying whether the dropdown column - accepts EmptyListItemText and EmptyListItemValue strings. - - - - - A string, specifying the text to be displayed in normal mode, when there is no - Data Source specified for the column. In edit mode, this value is rendered as a - dropdown list item. When in edit mode, and there is a valid DataSource specified for - the control, this value is appended as the first item of the dropdown box. - - - A string, specifying the text to be displayed in - normal/edit mode, when there is no Data Source specified for the column. - - - - - A string value, representing the value, associated with the - . - - - A string value, representing the value, associated with - the . - - - - - Gets or sets the type of the dropdown control associated with the column. - - - Returns a value from the GridDropDownColumnControlType enumeration; default value is RadComboBox. - - - - - A Boolean value, indicating whether a dropdown column is editable. If it is - editable, it will be represented as an active dropdown box in edit mode. - - - A Boolean value, indicating whether a dropdown column - is editable. - - - - Gets or sets a whether the column data can be sorted. - - A boolean value, indicating whether the column data can - be sorted. - - - - - A Boolean property, which specifies whether filtering will be enabled for the - column. - - - A Bollean value, indicating whether a particular - dropdown column can be filtered. - - - - - Force RadGrid to extract values from EditableColumns that are ReadOnly. - See also the method. - - - - - No values would be extracted from ReadOnly column - - - - - Values will be extracted only when an item is NOT in edit mode - - - - - Values will be extracted only when an item is in edit mode - - - - - Values will be extracted in all cases. - - - - - Initially only the [Edit] button is shown. When it is pressed, the [Update] and - [Cancel] appear at its place and the cells on this row become editable. - - Grid column types - Web Grid - -
-            <radg:GridEditCommandColumn ButtonType="ImageButton" UpdateImageUrl="..\Img\Update.gif"
EditImageUrl="..\Img\Edit.gif" InsertImageUrl="..\Img\Insert.gif"
CancelImageUrl="..\Img\Cancel.gif" UniqueName="EditCommandColumn">
</radg:GridEditCommandColumn> -
-
- Grid Column types - Adding columns design-time - Using columns -
- - - Gets or sets a value indicating what type of buttons will be used in the - GridEditCommandColumn items. - - - - - Gets or sets a string representing the text that will be used for the Cancel - button, in the Edit/Insert form. - - string, representing the text that will be used for the Cancel button. - - - string, representing the text that will be used for the Edit button. - - Gets or sets a string, representing the text of the edit linkbutton, which is - located in the GridEditCommandColumn, and which will replace the default "Edit" - text. - - - - - A string, representing the text that will be used for - the Update button. - - - Gets or sets a string, representing the text that will be used for the Update - button. - - - - - A string, representing the text that will be used for - the Insert button. - - - Gets or sets a string, representing a text, which will be displayed instead of - the default "Insert" text for the GridEditFormInsertItem item. - - - - - Gets or sets the URL for the image that will be used to fire the Insert command. - This property should be used in conjunction with ButtonType set to - ImageButton. - - string, representing the URL of the image that is used. - - - - Gets or sets the URL for the image that will be used to fire the Update command. - This property should be used in conjunction with set - to ImageButton. - - string, representing the URL of the image that is used. - - - - A string, representing the URL of the image that is - used. - - - Gets or sets the URL for the image that will be used to fire the Edit command. - This property should be used in conjunction with ButtonType set to - ImageButton. - - - - - - A string, representing the url path to the image that will be used instead of the - default cancel linkbutton, in the EditForm. - - - A string, representing the url path to the image that - will be used instead of the default cancel linkbutton, in the EditForm. - - - - - - - - Gets or sets a unique name for this column. The unique name can be used to - reference particular columns, or cells within grid rows. - - - A string, representing the Unique name of the - column. - - - - - This column appears when the grid has a hierarchical structure, to facilitate the - expand/collapse functionality. The expand column is always placed in front of all other - grid content columns and can not be moved. - - Column Types - How to hide images of ExpandCollapse column when no records - - - - Gets or sets a string, specifying the URL to the image, which will be used - instead of the default Expand image for the GridGroupSplitterColumn (the plus - sign). - - - A string, specifying the URL to the image, which will - be used instead of the default Expand image for the GridGroupSplitterColumn - - - - - Gets or sets a string, specifying the URL to the image, which will be used - instead of the default Collapse image for the GridGroupSplitterColumn (the minus - sign). - - - A string, specifying the URL to the image, which will - be used instead of the default Collapse image for the GridGroupSplitterColumn - - - - - Gets a Telerik.Web.UI.GridExpandColumnType value, indicating the type of the - button. The button of the GridExpandColumn is always of type ImageButton. - - - A Telerik.Web.UI.GridExpandColumnType value, indicating the type of the - button. - - - - - Gets or sets a string, specifying the Unique name of the column. The default value - is "ExpandColumn". - - function - GridCreated() { - } - - - - A string, specifying the Unique name of the - column. - - - - - Gets a Boolean value indicating whether the - GridGroupSplitterColumn is groupable. This value is always false. - - - Gets a Boolean value indicating whether the - GridGroupSplitterColumn is groupable. - - - - - Gets a Boolean value, indicating whether the GridExpandColumn is reorderable. - This value is always false, due to the specificity of the column, which should always - be positioned first. - - - A Boolean value, indicating whether the - GridExpandColumn is reorderable. - - - - - Gets a Boolean value, indicating whether the GridExpandColumn is resizable. - This value is always false, due to the specificity of the column, which should always - be positioned first. - - - A Boolean value, indicating whether the - GridExpandColumn is resizable. - - - - - Gets a Boolean value, indicating whether the GridExpandColumn is visible. - This value is always false, due to the specificity of the column. - - - A Boolean value, indicating whether the - GridExpandColumn is visible. - - - - - Gets or sets a string, representing the CommandName of the GridExpandColumn. The - command name's default value is "ExpandCollapse". It can be used to determine the - type of command in the ItemCommand event handler. - - function - GridCreated() { - } - - - - A string, representing the CommandName of the - GridExpandColumn. - - - - - This column appears when grouping is enabled, to facilitate the expand/collapse - functionality. The group splitter column is always placed first and can not be - moved. - - Grid Column types - Grouping demo with GridGroupSplitterColumn - - - - Gets or sets a string, specifying the URL to the image, which will be used - instead of the default Expand image for the GridGroupSplitterColumn (the plus - sign). - - - A string, specifying the URL to the image, which will - be used instead of the default Expand image for the GridGroupSplitterColumn - - - - - Gets or sets a string, specifying the URL to the image, which will be used - instead of the default Collapse image for the GridGroupSplitterColumn (the minus - sign). - - - A string, specifying the URL to the image, which will - be used instead of the default Collapse image for the GridGroupSplitterColumn - - - - - Gets a Boolean value indicating whether the - GridGroupSplitterColumn is groupable. This value is always false. - - - Gets a Boolean value indicating whether the - GridGroupSplitterColumn is groupable. - - - - - - This property is for internal usage. - - - - An enumeration, used to get/set the button type of the headers of the - columns. The default value is LinkButton. The possible values are: - - LinkButton - PushButton - TextButton - - If set to a value other than LinkButton, the property is only honored when - sorting is enabled. - - - - - Each row in a Hyperlink column will contain a predefined - hyperlink. This link is not the same for the whole column and can be defined for each - row individually. - - Grid column types - - The content of the column can be bound to a field in a data source or to a - static text. You can customize the look of the links by - using - CSS classes. - You can set multiple fields to a GridHyperlinkColumn through - its DataNavigateUrlFields property. These fields can later be used - when setting the DataNavigateUrlFormatString property and be part - of a query string: -
- - - - - - -
-
-            							
-            <radG:GridHyperLinkColumn
DataNavigateUrlFields= "ProductID,OrderID"
DataNavigateUrlFormatString= "~/Details.aspx?ProductID={0}&OrderID={1}">
</radG:GridHyperLinkColumn>
-
-
-
-
-
- Grid Column types - Adding columns design-time - Using columns -
- - - Gets or sets a string, representing a comma-separated enumeration of DataFields - from the data source, which will form the url of the windwow/frame that the hyperlink - will target. - - - A string, representing a comma-separated enumeration of - DataFields from the data source, which will form the url of the windwow/frame that the - hyperlink will target. - - - - - Gets or sets a string, specifying the FormatString of the DataNavigateURL. - Essentially, the DataNavigateUrlFormatString property sets the formatting for the url - string of the target window or frame. - - - A string, specifying the FormatString of the - DataNavigateURL. - - - - - Gets or sets a string, representing the DataField name from the data source, - which will be used to supply the text for the hyperlink in the column. This text can - further be customized, by using the DataTextFormatString property. - - - A string, representing the DataField name from the data - source, which will be used to supply the text for the hyperlink in the column. - - - - - Gets or sets a string, specifying the format string, which will be used to format - the text of the hyperlink, rendered in the cells of the column. - - - A string, specifying the format string, which will be - used to format the text of the hyperlink, rendered in the cells of the column. - - - - - Gets or sets a string, specifying the url, to which to navigate, when a hyperlink - within a column is pressed. This property will be honored only if the - DataNavigateUrlFields are not set. If either - DataNavigateUrlFields are set, they will override the - NavigateUrl property. - - - A a string, specifying the url, to which to navigate, - when a hyperlink within a column is pressed. - - - - - Sets or gets a string, specifying the window or frame at which to target - content. The possible values are: - _blank - the target URL will open in a new window
- _self - the target URL will open in the same frame as it was clicked
- _parent - the target URL will open in the parent frameset
- _top - the target URL will open in the full body of the window
-
- - A string, specifying the window or frame at which to - target content. - -
- - - Gets or sets a string, specifying the text to be displayed by the hyperlinks in - the column, when there is no DataTextField specified. - - - A string, specifying the text to be displayed by the - hyperlinks in the column, when there is no DataTextField specified. - - - - - Gets or sets whether the column data can be filtered. The default value is - true. - - - A Boolean value, indicating whether the column can be - filtered. - - - - - Displays each item in the column in accordance with a specified templates (item, - edit item, header and footer templates). This allows you to provide custom controls in - the column. - - Grid column types - -
-            <radG:GridTemplateColumn UniqueName="TemplateColumn" SortExpression="CompanyName">
<FooterTemplate>
<img src="Img/image.gif" alt="" style="vertical-align: middle" />
Template footer
- </FooterTemplate>
<HeaderTemplate>
- <table id="Table1" cellspacing="0" cellpadding="0" width="300" border="1">
<tr>
<td colspan="2" align="center">
<b>Contact details</b></td>
</tr>
<tr>
<td style="width: 50%" align="center">
- <asp:LinkButton CssClass="Button" Width="140" ID="btnContName" Text="Contact name"
- ToolTip="Sort by ContactName" CommandName='Sort' CommandArgument='ContactName'
- runat="server" /></td>
<td style="width: 50%" align="center">
- <asp:LinkButton CssClass="Button" Width="140" ID="btnContTitle" Text="Contact title"
- ToolTip="Sort by ContactTitle" CommandName='Sort' CommandArgument='ContactTitle'
- runat="server" /></td>
</tr>
</table>
- </HeaderTemplate>
<ItemTemplate>
- <table cellpadding="1" cellspacing="1" class="customTable">
- <tr>
<td style="width: 50%">
- </%# Eval("ContactName") /%>
</td>
- <td style="width: 50%">
- </%# Eval("ContactTitle") /%>
- </td>
</tr>
<tr>
- <td colspan="2" align="center">
- <a href='</%# "http://www.google.com/search?hl=en&q=" + DataBinder.Eval(Container.DataItem, "ContactName") + "&btnG=Google+Search"/%>'>
- <em>Search Google for
</%# Eval("ContactName") /%>
- </em></a>
</td>
</tr>
<tr>
<td colspan="2" align="center">
<img src="Img/image.gif" alt="" />
- </td>
</tr>
</table>
- </ItemTemplate>
</radG:GridTemplateColumn> -
-
- Grid Column types - Adding columns design-time - Using columns - Customizing with GridTemplateColumn - Persisting CheckBox control state in GridTemplateColumn on Rebind - - You can view and set templates using the Edit Templates command in grid's - Smart Tag. - You can also create the template columns programmatically and bind the - controls in the code-behind (see - Programmatic creation of - Telerik RadGrid). - Note: Unlike other grid columns, GridTemplateColumn cannot - be set as read-only. - - Programmatic creation -
- - - Gets or sets a string, specifying which DataField from the data source the - control will use to handle the automatic filtering. - - - A string, specifying which DataField from the data - source the control will use to handle the automatic filtering. - - - - - Gets or sets whether the column data can be filtered. The default value is - true. - - - A Boolean value, indicating whether the column can be - filtered. - - - - - Gets or sets the ItemTemplate, which is rendered in the control in edit mode. - - A value of type ITemplate - - - - Gets or sets the template, which will be rendered in the footer of the template - column. - - A value of type ITemplate. - - - - Gets or sets the template, which will be rendered in the header of the template - column. - - A value of type ITemplate. - - - - Gets or sets the ItemTemplate, which is rendered in the control in normal - (non-Edit) mode. - - A value of type ITemplate - - - - Gets a Boolean value, indicating whether the column is editable. If a template - column is editable, it will render the contents of the EditItemTemplate in the edit - form. If there are no contents in the EditItemTemplate, the column will not be - editable. - - - A Boolean value, indicating whether the column is - editable. - - - - - Set to false if templates should overwrite other controls in header cell (sort image, etc) - - - - - Number of items in the group - - - - - Number of items displayed on the page - - - - - if true Group is countinued from the previous page or it continues - on the next page if value of false - - - - - Summary description for DataSetHelper. - - - - - Summary description for DefaultValueChecker. - - - - - Type of the edit forms in RadGrid - - - - - Form is autogenerated, based on the column that each GridTableView exposes. - - - - - The edit form is a WebUserControl specified by - - - - - The template specified by is used as an edit form. - - - - - Settings for the edit forms generated by a for each item that is in edit mode and the - is set to . - - - Set the type of the EditForm using . - If the type is then the form will be autogenerated based on the - columns of the corresponding table view. Note that only the columns that are editable wil be included. Those are - the standatrd columns that have editing capabilities - such that has - set to false. All the style properties apply only to the autogenerated edit form. - See for more details on the types of the edit forms. - - - - - Set properties of the update-cancel buttons column that appears in an edit form - - - - - Number of vertical columns to split all edit fields on the form when it is autogenerated. - Each GridColumn has a to choose the column where - the editor would appear. - - - - - Data field to incude in form's caption - - - - - Caption format string - {0} parameter must be included and would be repaced with DataField value - - - - - Style of the forms's area (rendered as a DIV elemet) - - - - - Style of the forms' table element - - - - - Style of the forms' main table element - - - - - Style of the table row that shows the caption of the form - - - - - Style of the normal rows in the edit-form's table - - - - - Style of the alternating rows in the edit-form's table - - - - - Style of the footer row of the table, where the update-cancel buttons appear - - - - - Specifies the type of the edit form. See about details for - the possible values and their meanings. - - - - - - EditForm template - if EditFormType if is of type . - - - - - Gets a reference to class providing properties - related to PopUp EditForm. - - - - - Gets or sets a value specifying the grid height in pixels (px). - - the default value is 300px - - - - Gets or sets a value specifying the grid height in pixels (px). - - the default value is 400px - - - - Summary description for GridEditManager. - - - - - Serves as the abstract base class for data tables. This class provides the - methods and properties common to all tables in - Telerik RadGrid. - - - - - - - - - - - - - - - - - Registers the control with the ScriptManager - - - - - Registers the CSS references - - - - - Loads the client state data - - - - - - Saves the client state data - - - - - - - - - - - - - - - - - - - - - - Returns the names of all embedded skins. Used by Telerik.Web.Examples. - - - - - Executed when post data is loaded from the request - - - - - - - - Executed when post data changes should invoke a chagned event - - - - Gets or sets the skin name for the control user interface. - A string containing the skin name for the control user interface. The default is string.Empty. - - - If this property is not set, the control will render using the skin named "Default". - If EnableEmbeddedSkins is set to false, the control will not render skin. - - - - - - - For internal use. - - - - - Gets or sets the value, indicating whether to render script references to the embedded scripts or not. - - - - If EnableEmbeddedScripts is set to false you will have to register the needed Scripts files by hand. - - - - - Gets or sets the value, indicating whether to render links to the embedded skins or not. - - - If EnableEmbeddedSkins is set to false you will have to register the needed CSS files by hand. - - - - - - Gets or sets the value, indicating whether to render the link to the embedded base stylesheet of the control or not. - - - If EnableEmbeddedBaseStylesheet is set to false you will have to register the needed control base CSS file by hand. - - - - - - Gets the real skin name for the control user interface. If Skin is not set, returns - "Default", otherwise returns Skin. - - - - Gets or sets the value, indicating whether to render the skin CSS files during Ajax requests - - - If EnableAjaxSkinRendering is set to false you will have to register the needed control base CSS file by hand when adding/showing the control with Ajax. - - - - - - - - - - The CssClass property will now be used instead of the former Skin - and will be modified in AddAttributesToRender() - - - protected override string CssClassFormatString - { - get - { - return "RadDock RadDock_{0} rdWTitle rdWFooter"; - } - } - - - - - - - - - - - - - Occurs when a different item is selected in a table between posts to the - server. - - - - Gets or sets the tab index of the Web server control. - - - - Gets or sets the amount of space between the contents of a cell and the cell's - border. - - - - Gets or sets the amount of space between cells. - - - - - - - - Gets or sets a value that specifies whether the border between the cells of a - data table is displayed. - - - - - Gets or sets the horizontal alignment of a data table within its - container. - - - - - This event is fired when the grid request data using client-side data-binding. - - - - - This event is fired when the grid client-side data-binding is finished. - - - - - This event is fired before grid creation. - - - - Fired by - RadGrid - - - Arguments - N/A - - - Can be canceled - No - - Examples - - - ascx/aspx - <ClientEvents - OnGridCreating="GridCreating" ... - - JavaScript - <script> -
- function - GridCreating() - { - alert("Creting grid with ClientID: " + this.ClientID); - }
- </script>
-
- This client-side event is fired before grid creation. -
- - - This event is fired after the grid is created. - - - - Fired by - RadGrid - - - Arguments - N/A - - - Can be canceled - No - - - Examples - - - ascx/aspx - <ClientEvents - OnGridCreated="GridCreated" ... - - JavaScript - <script> - function GridCreated() - { - alert("Grid with ClientID: " + this.ClientID + " was created"); - } - </script> - - This client-side event is fired after the grid is created. - - - - This event is fired when RadGrid object is destroyed, i.e. on each - window.onunload - - - - Fired by - RadGrid - - - Arguments - N/A - - - Can be canceled - No - - Examples - - - ascx/aspx - <ClientEvents - OnGridCreating="GridDestroying" ... - - JavaScript - <script> - function - GridDestroying() - { - alert("Destroying grid with ClientID: " + this.ClientID); - } - </script> - - - This client-side event is fired when RadGrid object is - destroyed, i.e. on each window.onunload - - - - - This event is fired before the MasterTableView is created. - - - - Fired by - RadGrid - - - Arguments - N/A - - - Can be canceled - No - - Examples - - - ascx/aspx - <ClientEvents - OnMasterTableViewCreating="MasterTableViewCreating" ... - - JavaScript - <script> - function - MasterTableViewCreating() - { - alert("Creating MasterTableView"); - } - </script> - - This client-side event is fired before the MasterTableView is created. - - - - This event is fired after the MasterTableView is created. - - - - Fired by - RadGrid - - - Arguments - N/A - - - Can be canceled - No - - - Examples - - - ascx/aspx - <ClientEvents - OnMasterTableViewCreated="MasterTableViewCreated" ... - - JavaScript - <script> - function - MasterTableViewCreated() - { - alert("MasterTableView was created"); - } - </script> - - This client-side event is fired after the MasterTableView is created. - - - - This event is fired before table creation. - - - - Fired by - RadGrid - - - Arguments - N/A - - - Can be canceled - No - - - Examples - - - ascx/aspx - <ClientEvents - OnTableCreating="TableCreating" ... - - JavaScript - <script> - function - TableCreating() - { - alert("Creating DetailTable"); - } - </script> - - This client-side event is fired before table creation. - - - - This event is fired after the table is created. - - - - Fired by - RadGrid - - - Arguments - RadGridTable Object - - - Can be canceled - No - - Examples - - - ascx/aspx - <ClientEvents - OnTableCreated="TableCreated" ... - - JavaScript - <script> - function - TableCreated(tableObject) - { - alert("DetailTable with ClientID: " + tableObject.ClientID + " was - created"); - } - </script> - - This client-side event is fired after the table is created. - - - - This event is fired when table object is destroyed. - - - - Fired by - RadGrid - - - Arguments - N/A - - - Can be canceled - No - - - Examples - - - ascx/aspx - <ClientEvents - OnTableDestroying="TableDestroying" ... - - JavaScript - <script> - function - TableDestroying() - { - alert("Destroing DetailTable with ClientID: " + this.ClientID); - } - </script> - - This client-side event is fired when table object is destroyed. - - - - This event is fired before column available at client-side creation. - - - - Fired by - RadGridTable - - - Arguments - N/A - - - Can be canceled - No - - - Examples - - - ascx/aspx - <ClientEvents - OnColumnCreating="ColumnCreating" ... - - JavaScript - <script> - function - ColumnCreating() - { - alert("Creating column); - } - </script> - - - This client-side event is fired before column available at client-side - creation. - - - - - This event is fired after a column available at client-side is created. - - - - Fired by - RadGridTable - - - Arguments - RadGridTableColumn object - - - Can be canceled - No - - Examples - - - ascx/aspx - <ClientEvents - OnColumnCreated="ColumnCreated" ... - - JavaScript - <script> - function - ColumnCreated(columnObject) - { - alert("Column with Index: " + columnObject.Index + " was created"); - } - </script> - - - This client-side event is fired after a column available at client-side is - created. - - - - - This event is fired when a column object is destroyed. - - - - Fired by - RadGridTable - - - Arguments - N/A - - - Can be canceled - No - - - Examples - - - ascx/aspx - <ClientEvents - OnColumnDestroying="ColumnDestroying" ... - - JavaScript - <script> - function - ColumnDestroying() - { - alert("Destroing column with Index: " + this.Index); - } - </script> - - This client-side event is fired when a column object is destroyed. - - - - This event is fired before a column is resized. - - - - Fired by - RadGridTable - - - Arguments - columnIndex, columnWidth - - - Can be canceled - Yes, return false to cancel - - - Examples - - - ascx/aspx - <ClientEvents - OnColumnResizing="ColumnResizing" ... - - JavaScript - <script> - function - ColumnResizing(columnIndex, columnWidth) - { - alert("Resizng column with Index: " + columnIndex + ", width: " + - columnWidth); - } - OR - function - ColumnResizing(columnIndex, columnWidth) - { - return false; //cancel ColumnResizing event - } - </script> - - This client-side event is fired before a column is resized. - - - FOR FUTURE VERSIONS - - - - The client-side script - for RadGrid.ClientSettings.ClientEvents.OnRowContextMenu kills any exceptions that - occur in the event handler. This can make bugs hard to track down because it - appears that nothing happens when actually the exception was killed before it - becomes visible. - You can avoid this problem by putting a try/catch block around the - event handler that sends an alert if an exception was thrown: -
-            RadGrid1.ClientSettings.ClientEvents.OnRowContextMenu = " try { ... my event handling code ... } catch (exp) { alert(exp.message); }";
-                
-
-
- - - Contains properties related to messages appearing as tooltips for various grid - actions. You can use this class for localizing the grid messages. - - - - - Gets or sets a string that will be displayed as a tooltip when you start dragging - a column header trying to reorder columns. - - - string, the tooltip that will be displayed when you try to - reorder columns. By default it states "Drop here to reorder". - - - - - Gets or sets a string that will be displayed as a tooltip when you hover a column - that can be dragged. - - - string, the tooltip that will be displayed hover a draggable - column. By default it states "Drag to group or reorder". - - - - - string, the tooltip that will be displayed when you hover the - resizing handle of a column. By default it states "Drag to - resize". - - - Gets or sets a string that will be displayed as a tooltip when you hover the - resizing handle of a column. - - - - - The format string used for the tooltip when using Ajax scroll paging or the Slider pager - - - - This method is for Telerik RadGrid internal usage. - - Checks if a client settings property value was changed and differs from its - default. - - - - - Gets a reference to class providing properties - related to client-side selection features. - - - - - Gets a reference to class providing properties - related to client-side selection features. - - - - Gets a reference to class. - - - - Gets a reference to class, holding properties - that can be used for localizing Telerik RadGrid. - - - - - Gets a reference to , which holds various - properties for setting the Telerik RadGrid scrolling features. - - - - - Gets a reference to , which holds properties related - to Telerik RadGrid resizing features. - - - - - Determines whether the alternating items will render with a different CSS class. - - - - - Gets or sets a value indicating whether the keyboard navigation will be enabled - in Telerik RadGrid. - - - true, if keyboard navigation is enabled, otherwise false (the default - value). - - -
    -
  • Arrowkey Navigation - allows end-users to navigate around - the menu structure using the arrow keys.
  • -
  • select grid items pressing the [SPACE] key
  • -
  • edit rows hitting the [ENTER] key
  • -
-
-
- - - Gets or sets a value indicating whether you will be able to drag column headers to - and let the grid automatically form - and group its data. - - - true, if you are able to drag group header to the group panel, - otherwise false (the default value) - - - - - Gets or sets a value indicating whether you will be able to reorder columns by - using drag&drop. By default it is false. - - ReorderColumnsOnClient Property - - true if reorder via drag&drop is enabled, otherwise - false (the default value). - - - - - Gets or sets a value indicating whether MasterTableView will be automatically scrolled when an item is dragged. - - - - - Gets or sets a value indicating whether columns will be reordered on the client. - This property is meaningful when used in conjunction with - set to true. - - - False by default, which means that each time you try to reorder columns a - postback will be performed. - Note that in case this property is true the order changes will be persisted - on the server only after postback. - - - true if columns are reordered on the client, otherwise - false (the default value. - - - - - Gets or sets a value indicating whether the expand/collapse functionality for - hierarchical structures in grid will be enabled. - The AllowExpandCollapse property of RadGrid is meaningful with client - hierarchy load mode only and determine
- whether the end user will be able to expand/collapse grid items. This property do - not control the visibility of the corresponding expand/collapse column.
-
- - This property should be set to true, when working in - HierarchyLoadMode.Client. - - - true if expand/collapse is enabled, otherwise - false (the default value). - -
- - - Gets or sets a value indicating whether the expand/collapse functionality for - grouped data in grid will be enabled. - The AllowGroupExpandCollapse property of RadGrid is meaningful with client - group load mode only and determine whether the end user will be able to - expand/collapse grid items. This property do not control the visibility of the - corresponding expand/collapse column. - - - true, if expand/collapse is enabled, otherwise - false (the default value). - - - - - Gets or sets a value indicating whether - event will be canceled. - - - true, if the event is canceled, otherwise - false. - - - - - Interface that provides the basic functionality needed for a class to be used to - send information to Command event handler. - - - - Override to fire the corresponding command. - - - Gets or sets a value, defining whether the command should be canceled. - - - For internal usage only. - - - - For internal usage only. - - - - Represents the method that will handle grid's Command events including - CancelCommand, DeleteCommand, EditCommand, InsertCommand, ItemCommand, SortCommand and - UpdateCommand. - - The source of the event. - A object that contains the event data. - - - - Provides data for Command events including CancelCommand, DeleteCommand, - EditCommand, InsertCommand, ItemCommand, SortCommand and UpdateCommand. - - - - - Fires the command stored in - property - - - - Gets the source of the command - - - // Get a reference to the control that triggered expand/collapse command - protected void RadGrid1_ItemCommand(object source, GridCommandEventArgs e) - { - if (e.CommandName == RadGrid.ExpandCollapseCommandName) - { - Control c = e.CommandSource as Control; - } - } - - - ' Get a reference to the control that triggered expand/collapse command - Protected Sub RadGrid1_ItemCommand([source] As Object, e As GridCommandEventArgs) - If e.CommandName = RadGrid.ExpandCollapseCommandName Then - Dim c As Control = e.CommandSource - End If - End Sub 'RadGrid1_ItemCommand - - - - - Gets the item containing the command source - - - protected void RadGrid1_UpdateCommand(object source, GridCommandEventArgs e) - { - if (e.Item is GridEditFormItem && e.Item.IsInEditMode) - { - GridEditFormItem item = e.Item as GridEditFormItem; - Hashtable newValues = new Hashtable(); - item.OwnerTableView.ExtractValuesFromItem(newValues, item); - if (newValues["Name"].ToString() == "DefaultName") - { - e.Canceled = true; - } - } - } - - - Protected Sub RadGrid1_UpdateCommand([source] As Object, e As GridCommandEventArgs) - If Typeof e.Item Is GridEditFormItem AndAlso e.Item.IsInEditMode Then - Dim item As GridEditFormItem = e.Item - Dim newValues As New Hashtable() - item.OwnerTableView.ExtractValuesFromItem(newValues, item) - If newValues("Name").ToString() = "DefaultName" Then - e.Canceled = True - End If - End If - End Sub - - - - - Gets or sets a value, defining whether the command should be canceled. - - - protected void RadGrid1_UpdateCommand(object source, GridCommandEventArgs e) - { - if (e.Item is GridEditFormItem && e.Item.IsInEditMode) - { - GridEditFormItem item = e.Item as GridEditFormItem; - Hashtable newValues = new Hashtable(); - item.OwnerTableView.ExtractValuesFromItem(newValues, item); - if (newValues["Name"].ToString() == "DefaultName") - { - e.Canceled = true; - } - } - } - - - Protected Sub RadGrid1_UpdateCommand([source] As Object, e As GridCommandEventArgs) - If Typeof e.Item Is GridEditFormItem AndAlso e.Item.IsInEditMode Then - Dim item As GridEditFormItem = e.Item - Dim newValues As New Hashtable() - item.OwnerTableView.ExtractValuesFromItem(newValues, item) - If newValues("Name").ToString() = "DefaultName" Then - e.Canceled = True - End If - End If - End Sub - - - - - For internal usage only. - - - - Fires RadGrid.SelectedIndexChanged event. - - - For internal usage only - - - - Fires RadGrid.SelectedIndexChanged event. - - - Represents a method that will handle grid's DetailTableDataBind event. - - - Provides data for DetailTableDataBind event. - - - protected void RadGrid1_DetailTableDataBind(object source, Telerik.Web.UI.GridDetailTableDataBindEventArgs e) - { - GridDataItem parentItem = e.DetailTableView.ParentItem as GridDataItem; - if (e.DetailTableView.DataSourceID == "AccessDataSource2") - { - Session["CustomerID"] = parentItem["CustomerID"].Text; - } - } - - - Protected Sub RadGrid1_DetailTableDataBind(ByVal source As Object, ByVal e As GridDetailTableDataBindEventArgs) Handles RadGrid1.DetailTableDataBind - Dim parentItem As GridDataItem = CType(e.DetailTableView.ParentItem, GridDataItem) - If (e.DetailTableView.DataSourceID = "AccessDataSource2") Then - Session("CustomerID") = parentItem("CustomerID").Text - End If - End Sub - - - - - - Fires RadGrid.DetailTableDataBind event - - - - - Gets a reference to the detail table being bound. - - - protected void RadGrid1_DetailTableDataBind(object source, Telerik.Web.UI.GridDetailTableDataBindEventArgs e) - { - GridDataItem parentItem = e.DetailTableView.ParentItem as GridDataItem; - if (e.DetailTableView.DataSourceID == "AccessDataSource2") - { - Session["CustomerID"] = parentItem["CustomerID"].Text; - } - } - - - Protected Sub RadGrid1_DetailTableDataBind(ByVal source As Object, ByVal e As GridDetailTableDataBindEventArgs) Handles RadGrid1.DetailTableDataBind - Dim parentItem As GridDataItem = CType(e.DetailTableView.ParentItem, GridDataItem) - If (e.DetailTableView.DataSourceID = "AccessDataSource2") Then - Session("CustomerID") = parentItem("CustomerID").Text - End If - End Sub - - - - - Gets or sets a value, defining whether the command should be canceled. - - - For internal usage only. - - - - - Expands/Collapses the containing the - - - - - For internal usage only. - - - - - Calculates and sets the to the corresponding - and rebinds the grid. - - - - - A collection that stores objects. You can access - this collection through property of a - parent . - - - - - - - Initializes a new instance of . - - - that would aggregate this instance - - - - - Initializes a new instance of based on another . - - - - A from which the contents are copied - - - - - - Initializes a new instance of containing any array of objects. - - - - An array of objects with which to intialize the collection - - - - - Adds a with the specified value to the - . - - The to add. - - The index at which the new element was inserted. - - - - - - Copies the elements of an array to the end of the . - - - An array of type containing the objects to add to the collection. - - - None. - - - - - - - Adds the contents of another to the end of the collection. - - - - A containing the objects to add to the collection. - - - None. - - - - - - Gets a value indicating whether the - contains the specified . - - The to locate. - - if the is contained in the collection; - otherwise, . - - - - - - Copies the values to a one-dimensional instance at the - specified index. - - The one-dimensional that is the destination of the values copied from . - The index in where copying begins. - - None. - - is multidimensional. -or- The number of elements in the is greater than the available space between and the end of . - is . - is less than "s lowbound. - - - - - Returns the index of a in - the . - - The to locate. - - The index of the of in the - , if found; otherwise, -1. - - - - - - Inserts a into the at the specified index. - - The zero-based index where should be inserted. - The to insert. - None. - - - - - Returns an enumerator that can iterate through - the . - - None. - - - - - Removes a specific from the - . - - The to remove from the . - None. - is not found in the Collection. - - - - Get the instance of that owns this instance - - - - - Represents the entry at the specified index of the . - - The zero-based index of the entry to locate in the collection. - - The entry at the specified index of the collection. - - is outside the valid range of indexes for the collection. - - - - Add DataColumns for grid columns with composite DataFields (sub properties) - - - - - Summary description for IGridEnumerable. - - - - - Container of misc. grouping settings of RadGrid control - - - - - A string specifying the name (without the extension) of the file that will be - created. The file extension is automatically added based on the method that is - used. - - Export Grid to Microsoft Excel, Microsoft Word - - - Determines whether only data will be exported. - Export Grid to Microsoft Excel, Microsoft Word - - - - Specifies whether all records will be exported or merely those on the current - page. - - Export Grid to Microsoft Excel, Microsoft Word - - - Opens the exported grid in a new instead of the same page. - Export Grid to Microsoft Excel, Microsoft Word - - - - Container of misc. grouping settings of RadGrid control - - - - - Gets or sets the row delimiter for RadGrid CSV export. - - - - - Gets or sets the row delimiter for RadGrid CSV export. - - - - - Predefined filter expression enumeration. Used by class. - - Basic Filtering - - Some functions are applicable (and are not displayed on filterting) to all - the data types: - String type supports all the functions. - Integer: NoFilter, EqualTo, NotEqualTo, GreaterThan, - LessThan, GreaterThanOrEqualTo, LessThanOrEqualTo, Between, NotBetween, IsNull and - NotIsNull are supported. Contains, DoesNotContain, - StartsWith, - EndsWith, IsEmpty and - NotIsEmpty - are not supported. - Date: same as Integer. - - Basic Filtering - How-To: Localizing filtering menu options - How-To: Reducing filtering menu options - - - - No filter would be applied, filter controls would be cleared - - - - Same as: dataField LIKE '/%value/%' - - - Same as: dataField NOT LIKE '/%value/%' - - - Same as: dataField LIKE 'value/%' - - - Same as: dataField LIKE '/%value' - - - - Same as: dataField = value - - - - Same as: dataField != value - - - Same as: dataField > value - - - - Same as: dataField < value - - - - Same as: dataField >= value - - - - Same as: dataField <= value - - - - - Same as: value1 <= dataField <= value2.
- Note that value1 and value2 should be separated by [space] when entered as - filter. -
-
- - - Same as: dataField <= value1 && dataField >= value2.
- Note that value1 and value2 should be separated by [space] when entered as - filter. -
-
- - - Same as: dataField = '' - - - - Same as: dataField != '' - - - - Only null values - - - - - Only those records that does not contain null values within the corresponding column - - - - - Custom function will be applied. The filter value should contain a valid filter expression, including DataField, operators and value - - - - - Choose which filter function will be enabled for a column - - Basic Filtering - Custom option for filtering (FilterListOptions -> - VaryByDataTypeAllowCustom) - - - - Depending of data type of the column, RadGrid will automatically choose which filters to be displayed in the list - - - - - As VaryByDataType with custom filtering enabled - - - - - All filters will be displayed. Note that some data types are not applicatble to some filter functions. For example you cannot apply - the 'like' function for integer data type. In such cases you should handle the filtering in a custom manner, handling - for 'Filter' command or - - - - - Used when column-based filtering feature of RadGrid is enabled. Defines properties and methods for formatting the - predefined filter expressions - - - - - Enumeration representing the aggregate functions which can be applied to a - GridGroupByField (part of - collection) - - - Meaningful only when GridGroupByField is part of - collection - - Programmatic GridGroupByField syntax - - - GridGroupByField gridGroupByField; - - gridGroupByField = new GridGroupByField(); - gridGroupByField.FieldName = "Freight"; - gridGroupByField.HeaderText = "Total shipping cost is "; - gridGroupByField.Aggregate = GridAggregateFunction.Sum; - expression.SelectFields.Add( gridGroupByField ); - - - Dim gridGroupByField As GridGroupByField - - gridGroupByField = New GridGroupByField - gridGroupByField.FieldName = "Freight" - gridGroupByField.HeaderText = "Total shipping cost is " - gridGroupByField.Aggregate = GridAggregateFunction.Sum - expression.SelectFields.Add(gridGroupByField) - - - - - - Field which is part of each - and collection - - - - Dim groupExpression As GridGroupByExpression = New GridGroupByExpression() - - Dim groupByField As GridGroupByField = New GridGroupByField() - - groupByField = New GridGroupByField() - groupByField.FieldName = "Received" - groupExpression.SelectFields.Add(groupByField) - - groupByField = New GridGroupByField() - groupByField.FieldName = "Received" - groupExpression.GroupByFields.Add(groupByField) - - RadGrid1.MasterTableView.GroupByExpressions.Add(groupExpression) - - - GridGroupByExpression groupExpression = new GridGroupByExpression(); - - GridGroupByField groupByField = new GridGroupByField(); - groupByField = new GridGroupByField(); - groupByField.FieldName = "Received"; - groupExpression.SelectFields.Add(groupByField); - - groupByField = new GridGroupByField(); - groupByField.FieldName = "Received"; - groupExpression.GroupByFields.Add(groupByField); - - RadGrid1.MasterTableView.GroupByExpressions.Add(groupExpression); - - - - Some of the GridGroupByField properties are meaningful only when present under - specific collection - or - - - Declarative GridGroupByField syntax - Programmatic GridGroupByField syntax - - - - Method setting the aggregate function applied for a - GridGroupByField which is part of the - collection. - - N/A - - - Dim groupExpression As GridGroupByExpression = New GridGroupByExpression() - - Dim groupByField As GridGroupByField = New GridGroupByField() - groupByField.FieldName = "Size" - groupByField.SetAggregate(GridAggregateFunction.Sum) - groupExpression.SelectFields.Add(groupByField) - - groupByField = New GridGroupByField() - groupByField.FieldName = "Received" - groupExpression.SelectFields.Add(groupByField) - - groupByField = New GridGroupByField() - groupByField.FieldName = "Received" - groupExpression.GroupByFields.Add(groupByField) - - RadGrid1.MasterTableView.GroupByExpressions.Add(groupExpression) - - - GridGroupByExpression groupExpression = new GridGroupByExpression(); - - GridGroupByField groupByField = new GridGroupByField(); - groupByField.FieldName = "Size"; - groupByField.SetAggregate(GridAggregateFunction.Sum); - groupExpression.SelectFields.Add(groupByField); - - groupByField = new GridGroupByField(); - groupByField.FieldName = "Received"; - groupExpression.SelectFields.Add(groupByField); - - groupByField = new GridGroupByField(); - groupByField.FieldName = "Received"; - groupExpression.GroupByFields.Add(groupByField); - - RadGrid1.MasterTableView.GroupByExpressions.Add(groupExpression); - - - - Meaningful only for GridGroupByFields from the - collection - - - - - Method setting the sort order applied for a GridGroupByField which - is part of the collection. - - N/A - - Meaningful only for GridGroupByFields from the - collection - - - - GridGroupByExpression groupExpression = new GridGroupByExpression(); - - groupByField = new GridGroupByField(); - groupByField.FieldName = "Received"; - groupExpression.SelectFields.Add(groupByField); - - groupByField = new GridGroupByField(); - groupByField.FieldName = "Received"; - groupByField.SetSortOrder(GridSortOrder.Ascending); - groupExpression.GroupByFields.Add(groupByField); - - RadGrid1.MasterTableView.GroupByExpressions.Add(groupExpression); - - - Dim groupExpression As GridGroupByExpression = New GridGroupByExpression() - - Dim groupByField As GridGroupByField = New GridGroupByField() - - groupByField = New GridGroupByField() - groupByField.FieldName = "Received" - groupExpression.SelectFields.Add(groupByField) - - groupByField = New GridGroupByField() - groupByField.FieldName = "Received" - groupByField.SetSortOrder(GridSortOrder.Descending) - groupExpression.GroupByFields.Add(groupByField) - - RadGrid1.MasterTableView.GroupByExpressions.Add(groupExpression) - - - - - - Method which gets the HeaderText value from GridGroupByField part - of the collection - - String containing the HeaderText value - - Meaningful only for GridGroupByFields from the - collection - - - - Dim groupExpression As GridGroupByExpression = RadGrid1.MasterTableView.GroupByExpressions(0) - Dim headerText as String = groupExpression.SelectFields(0).GetHeaderText() - - - GridGroupByExpression groupExpression = RadGrid1.MasterTableView.GroupByExpressions[0] as GridGroupByExpression; - String headerText = groupExpression.SelectFields[0].GetHeaderText() - - - - - - Method which gets the FormatString value from GridGroupByField - part of the collection - - String containing the FormatString value - - Meaningful only for GridGroupByFields from the - collection - - - - Dim groupExpression As GridGroupByExpression = RadGrid1.MasterTableView.GroupByExpressions(0) - Dim formatString As String = groupExpression.SelectFields(0).GetFormatString() - - - GridGroupByExpression groupExpression = RadGrid1.MasterTableView.GroupByExpressions[0] As GridGroupByExpression; - String formatString = groupExpression.SelectFields[0].GetFormatString() - - - - - Inherited but not used - - - - Method that retrieves a System.String that indicates the current - object - - The string format of the object. - Object.ToString() - - - Inherited but not used - - - - Gets or sets a string that represents the DataField column - property that will be used to form the GroupByExpression. - - - Unless you have specified a FieldAlias, the value of this - property will be used when Telerik RadGrid constructs the text for - GridGroupHeaderItem. FieldName has a meaning both for - SelectFields and GroupByFields of - GroupByExpression. - - - String representing the DataField for the corresponding grouped - column - - - - GridGroupByField gridGroupByField; - - //Add select fields (before the "Group By" clause) - gridGroupByField = new GridGroupByField(); - gridGroupByField.FieldName = "EmployeeID"; - gridGroupByField.HeaderText = "Employee"; - expression.SelectFields.Add( gridGroupByField ); - - //Add a field for group-by (after the "Group By" clause) - gridGroupByField = new GridGroupByField(); - gridGroupByField.FieldName = "EmployeeID"; - expression.GroupByFields.Add( gridGroupByField ); - - - Dim gridGroupByField As GridGroupByField - - 'Add select field (before the "Group By" clause) - gridGroupByField = New GridGroupByField() - gridGroupByField.FieldName = "EmployeeID" - gridGroupByField.HeaderText = "Employee" - expression.SelectFields.Add(gridGroupByField) - - 'Add a field for group-by (after the "Group By" clause) - gridGroupByField = New GridGroupByField() - gridGroupByField.FieldName = "EmployeeID" - expression.GroupByFields.Add(gridGroupByField) - - - Declarative GridGroupByField syntax - Programmatic GridGroupByField syntax - - - - Gets or sets a value representing a friendly name for the field used for forming - the group by expression. This name will be displayed in each group header when grouping - by the respective field. - - - - Use this property for setting the field text that will be displayed in the - GridGroupHeaderItem. If this property is not set, the value of - property will be used. Note that this property has - a meaning only for GridGroupByField part of the SelectFields of - GridGroupByExpression. - - This property is useful in cases when: - - you want to change the value displayed in group header (different than - the default DataField column value)
- or
- group by a template column and Telerik RadGrid cannot get the - header text for that column. -
-
- - - GridGroupByField gridGroupByField; - - //Add select fields (before the "Group By" clause) - gridGroupByField = new GridGroupByField(); - gridGroupByField.FieldName = "EmployeeID"; - gridGroupByField.FieldAlias = "EmployeeIdentificator"; - expression.SelectFields.Add( gridGroupByField ); - - - Dim gridGroupByField As GridGroupByField - - 'Add select fields (before the "Group By" clause) - gridGroupByField = New GridGroupByField - gridGroupByField.FieldName = "EmployeeID" - gridGroupByField.FieldAlias = "EmployeeIdentificator" - expression.SelectFields.Add(gridGroupByField) - - - String representing the friendly name shown - Declarative GridGroupByField syntax - Programmatic GridGroupByField syntax -
- - - Meaningful only for fields in the - collection. - - - Gets or sets aggregate function (from - enumeration values) that will be applied on the grouped data. - - - Returns the result from currently used aggregate function. This property defaults - to GridAggregateFunction.None - - - - GridGroupByField gridGroupByField; - - gridGroupByField = new GridGroupByField(); - gridGroupByField.FieldName = "Freight"; - gridGroupByField.HeaderText = "Total shipping cost is "; - gridGroupByField.Aggregate = GridAggregateFunction.Sum; - expression.SelectFields.Add( gridGroupByField ); - - - Dim gridGroupByField As GridGroupByField - - gridGroupByField = New GridGroupByField - gridGroupByField.FieldName = "Freight" - gridGroupByField.HeaderText = "Total shipping cost is " - gridGroupByField.Aggregate = GridAggregateFunction.Sum - expression.SelectFields.Add(gridGroupByField) - - - Programmatic GridGroupByField syntax - - - - Meaningful only for fields in the - collection. 'None' value is - not supported because it can not determine uniquely the order in which the groups - will be displayed. - - - Gets or sets the value representing how the data will be sorted. Acceptable values - are the values of enumeration except for None - (Ascending, Descending). - - - Returns the sorting mode applied to the grouped data. By default it is - Ascending. - - - - GridGroupByField gridGroupByField; - - gridGroupByField = new GridGroupByField(); - gridGroupByField.FieldName = "EmployeeID"; - gridGroupByField.SortOrder = GridSortOrder.Descending; - expression.GroupByFields.Add( gridGroupByField ); - - - Dim gridGroupByField As GridGroupByField - - gridGroupByField = New GridGroupByField - gridGroupByField.FieldName = "EmployeeID" - gridGroupByField.SortOrder = GridSortOrder.Descending - expression.GroupByFields.Add(gridGroupByField) - - - Programmatic GridGroupByField syntax - - - - - Meaningful only for fields in the - collection. - - When rendering RadGrid is using this expression to format field's value. It - is mandatory that {0} parameter is specified in the string - it will be replaced - with field's runtime value. - - - Gets or sets the string that will be used to format the GridGroupByField part of - the collection. - - - String, formated by the GridGroupByField's FormatString property. It defaults to: - "{0}". - - - - GridGroupByField gridGroupByField; - - gridGroupByField = new GridGroupByField(); - gridGroupByField.FieldName = "EmployeeID"; - gridGroupByField.FormatString = "<strong>{0}</strong>"; - expression.SelectFields.Add( gridGroupByField ); - - - Dim gridGroupByField As GridGroupByField - - gridGroupByField = New GridGroupByField - gridGroupByField.FieldName = "EmployeeID" - gridGroupByField.FormatString = "<strong>{0}</strong>" - expression.SelectFields.Add(gridGroupByField) - - - Declarative GridGroupByField syntax - Programmatic GridGroupByField syntax - - - - Meaningful only for fields in the - collection. When rendering - RadGrid will override the FieldAlias value with the - HeaderText specified. - - - string, copied from the column's HeaderText if this group - expression is based on a column. It defaults to the FieldAlias value - (if specified). - - - Gets or sets the expression that will be displayed in the - . - - - - GridGroupByField gridGroupByField; - - gridGroupByField = new GridGroupByField(); - gridGroupByField.FieldName = "EmployeeID"; - gridGroupByField.HeaderText = "EmployeeNo"; - expression.SelectFields.Add( gridGroupByField ); - - - Dim gridGroupByField As GridGroupByField - - gridGroupByField = New GridGroupByField - gridGroupByField.FieldName = "EmployeeID" - gridGroupByField.HeaderText = "EmployeeNo" - expression.SelectFields.Add(gridGroupByField) - - - Programmatic GridGroupByField syntax - - - - Gets or sets the string that separates header text from value text as the - field is rendered in the GroupHeaderItems. - - - string, represents the separator between the header text and value - text. - This field value defaults to ": ". - - - - GridGroupByField gridGroupByField; - - gridGroupByField = new GridGroupByField(); - gridGroupByField.FieldName = "EmployeeID"; - gridGroupByField.HeaderValueSeparator = " for current group: "; - expression.SelectFields.Add( gridGroupByField ); - - - Dim gridGroupByField As GridGroupByField - - gridGroupByField = New GridGroupByField - gridGroupByField.FieldName = "EmployeeID" - gridGroupByField.HeaderValueSeparator = " for current group: " - expression.SelectFields.Add(gridGroupByField) - - - - Meaningful only for fields in the - collection. - - Programmatic GridGroupByField syntax - Declarative GridGroupByField syntax - - - - - - - Container of miscellaneous grouping settings of RadGrid control - - - For internal usage only - - - - The group header message, indicating that the group continues on the next - page. - - Localizing the grid messages - - Localizing the grid messages topic lists all the tooltips and text messages which - can be modified. - - -
-            <GroupingSettings GroupContinuesFormatString="The group continues on the next page." />
-                
-
-
- - - The group header message indicating that this group continues from the previous - page. - - Localizing the grid messages - - Localizing the grid messages topic lists all the tooltips and text messages which - can be modified. - - -
-            <GroupingSettings GroupContinuedFormatString="This group continues from the previous page." />
-                
-
-
- - - A part of the string that formats the information label that appears on each - group header of a group that is split onto several pages parameter {0} will be replaced - with the number of actual items displayed on the page parameter {1} will be replaced - with the number of all items in the group - - - - - Gets or sets the format string that will be used when group is split, containing - the GroupSplitDisplayFormat or - GroupContinuedFormatString and - GroupContinuesFormatString or the three together. - - This property defaults to "({0})" - - - - String that separates each group-by field when displayed in - GridGroupHeaderItems. - - This property default to ";" - - - - Gets or sets a value indicating whether the grouping operations will be case - sensitive or not. - - - true if grouping is case sensitive, otherwise - false. The default value is true. - - - - - Gets or sets a string that will be displayed when the group expand image is - hovered. - - Localizing the grid messages - - Localizing the grid messages topic lists all the tooltips and text messages which - can be modified. - - -
-              <GroupingSettings ExpandTooltip="Click here to expand the group!" />
-            
-
-
- - - Gets or sets a string that will be displayed when the group collapse image is - hovered. - - Localizing the grid messages - - Localizing the grid messages topic lists all the tooltips and text messages which - can be modified. - - -
-              <GroupingSettings ExpandTooltip="Click here to collapse the group!" />
-                
-
-
- - - Gets or sets a string that will be displayed when a group panel item is - hovered. - - Localizing the grid messages - - Localizing the grid messages topic lists all the tooltips and text messages which - can be modified. - - -
-                <radG:RadGrid>
..
<GroupingSettings UnGroupTooltip="Wanna ungroup? Drag me back!" />
</radG:RadGrid> -
-
-
- - - Gets or sets value text of group panel item's ungroup button's tooltip - - - - - Gets or sets value indicating if group panel item's ungroup button should be shown - - - - - Holds properties specific for grouping mechanism such as performed action and - reference to GridTableView where the action was performed. - - - - - Gets a reference to enumeration, which - holds information about what action did fire the - event. - - - protected void RadGrid1_GroupsChanging(object source, - Telerik.Web.UI.GridGroupsChangingEventArgs e)
- {
- if (e.Action == GridGroupsChangingAction.Group)
- { ... } -
-
- - - Gets a reference to the GridTableView object where the grouping - is performed. - - a reference to GridTableView object. - - - - Gets or sets the that will be used for - grouping Telerik RadGrid. - - - - protected void RadGrid1_GroupsChanging(object source, Telerik.Web.UI.GridGroupsChangingEventArgs e) - { - if (e.Action == GridGroupsChangingAction.Group) - { - GridGroupByField countryGroupField = new GridGroupByField(); - countryGroupField.FieldName = "Country"; - GridGroupByField cityGroupField = new GridGroupByField(); - cityGroupField.FieldName = "City"; - - e.Expression.SelectFields.Clear(); - e.Expression.SelectFields.Add(countryGroupField); - e.Expression.SelectFields.Add(cityGroupField); - - e.Expression.GroupByFields.Clear(); - e.Expression.GroupByFields.Add(countryGroupField); - e.Expression.GroupByFields.Add(cityGroupField); - ... - } - } - - - Protected Sub RadGrid1_GroupsChanging(ByVal source As Object, ByVal e As Telerik.Web.UI.GridGroupsChangingEventArgs) - 'Expression is added (by drag/grop on group panel) - If (e.Action = GridGroupsChangingAction.Group) Then - Dim countryGroupField As GridGroupByField = New GridGroupByField - countryGroupField.FieldName = "Country" - Dim cityGroupField As GridGroupByField = New GridGroupByField - cityGroupField.FieldName = "City" - e.Expression.SelectFields.Clear - e.Expression.SelectFields.Add(countryGroupField) - e.Expression.SelectFields.Add(cityGroupField) - e.Expression.GroupByFields.Clear - e.Expression.GroupByFields.Add(countryGroupField) - e.Expression.GroupByFields.Add(cityGroupField) - End If - End Sub - - - - - Gets a reference to the currently used . - - - - Gets or sets a value indicating whether - event will be canceled. - - - true, if the event is canceled, otherwise - false. - - - - - Container of misc. grouping settings of RadGrid control - - - - - Gets or sets a string that represents the tooltip that will be shown when the - expand image is hovered. - - - - - Gets or sets a string that represents the tooltip that will be shown when the - collapse image is hovered. - - - - - Gets or sets a string that represents the tooltip that will be shown when the - self-hierarchy expand image is hovered. - - - - - Gets or sets a string that represents the tooltip that will be shown when the - self-hierarchy collapse image is hovered. - - - - - This is a collection of item indexes - each item index is unique within the - collection - - - - - Constructs and add item hierarchical index to the collection - of indexes. - - - The hierarchical-index is based on sequential numbers of - indxes of items and detail tables. For example - index Add(1) will construct the hierarchicalindex for Item 1 in MasterTableView. - Add(1, 0, 2) references to the item with index 2 that belongs to a child table 0 of - the item 1 in MastertableView. - - - - - - Summary description for GridItemDecorator. - - - - - Event info object. Cast to derrived classes to obtain the appropriate instance - - - - - Set to true to cancel the default event execution, if available. The ItemCreated and ItemDataBound events cannot be cancelled. - - - - - Specifies the position at which the user has dragged and dropped the source item(s) with regards to the - destination item. - - - - - The source item(s) is dropped above (before) the destination item. - - - - - The source item(s) is dropped below (after) the destination item. - - - - - Contains instance to which belongs the destinationItem - - - - - Contains raw RadGrid's HTML which will be transformed to PDF. - - - - - Contains export document which will be written to the response - - - - - Item that is displayed on top or at the bottom of the each GridTableView base on the settings of - property. Generally this item displays by default "Add new record" and "Refresh" button, - but it can be customized using the . The commands bubbled through this item will be fired by - RadGrid.ItemCommand event. - - - - - Class that represents the rows of each GridTableView with RadGrid. All Items in RadGrid inherit from this class. - RadGrid creates the items runtime, when it binds to data. - - - - - Initializes the base properties of an item. - - - - - - - - - Use this method to simulate item command event that bubbles to RadGrid and can be handeled automatically or in a custom manner, - handling RadGrid.ItemCommand event. - - command to bubble, for example 'Page' - command argument, for example 'Next' - - - - This method is not intended to be used directly from your code. - - - - - - - This method is not intended to be used directly from your code - - - - - - - This method is not intended to be used directly from your code - - - - - - Override this method to change the default logic for rendering the item - - - - - Override this method to change the default logic for item visibility - - - - - - Used after postback before ViewState becomes available - - for example in ItemCreated and ItemDataBound events - - - - - - - - - - - - - - - - - - - - - - - //get MasterTableView's second (index 1) nested view item - GridNestedViewItem firstLevelNestedViewItem = (GridNestedViewItem)RadGrid1.MasterTableView.GetItems(GridItemType.NestedView)[1]; - //get second nested view item at level 2 of the hierarchy - GridNestedViewItem secondLevelNestedViewItem = (GridNestedViewItem)firstLevelNestedViewItem.NestedTableViews[0].GetItems(GridItemType.NestedView)[1]; - //get the first item to be expanded - GridItem itemToExpand = secondLevelNestedViewItem.NestedTableViews[0].GetItems(GridItemType.Item)[0]; - itemToExpand.ExpandHierarchyToTop(); - - - 'get MasterTableView's second (index 1) nested view item - Dim firstLevelNestedViewItem As GridNestedViewItem = CType(RadGrid1.MasterTableView.GetItems(GridItemType.NestedView)(1), GridNestedViewItem) - 'get second nested view item at level 2 of the hierarchy - Dim secondLevelNestedViewItem As GridNestedViewItem = CType(firstLevelNestedViewItem.NestedTableViews(0).GetItems(GridItemType.NestedView)(1), GridNestedViewItem) - 'get the first item to be expanded - Dim itemToExpand As GridItem = secondLevelNestedViewItem.NestedTableViews(0).GetItems(GridItemType.Item)(0) - itemToExpand.ExpandHierarchyToTop() - - - Expands the hierarchy starting from the last level to the top - - - - Calculate column-span value for a cell using column list, when the cell indicated - with FromCellIndex should be spanned to ToCellIndex - - columns - visible property is taken in count - cell inbdex of spanned cell - cell index of next not-spanned cell or -1 for the last cell index - ColSpan number - - - - Gets a reference to the GridTableView that owns this - GridItem. - - - You can use the OwnerTableView property to get an instance of the GridTableView - that holds the item modified. For example in the - SelectedIndexChanged event handler you can get the - GridTableView object like this: - - protected void RadGrid1_SelectedIndexChanged(object sender, EventArgs e) - { - GridTableView tableview = RadGrid1.SelectedItems[0].OwnerTableView; - } - - - Protected Sub RadGrid1_SelectedIndexChanged(sender As Object, e As EventArgs) - Dim tableview As GridTableView = RadGrid1.SelectedItems(0).OwnerTableView - End Sub - - - - - - Gets the ClientID of the GridTableView that - owns this instance. - - - The OwnerID property will get the ClientID of the - GridTableView that owns the referenced instance. For example the - code below will return RadGrid1_ctl01 which is the ClientID of the MasterTableView - for basic RadGrid: - - protected void RadGrid1_SelectedIndexChanged(object sender, EventArgs e) - { - Label1.Text = RadGrid1.SelectedItems[0].OwnerID; - } - - - Protected Sub RadGrid1_SelectedIndexChanged(sender As Object, e As EventArgs) - Label1.Text = RadGrid1.SelectedItems(0).OwnerID - End Sub - - - - - - Gets the ClientID of the RadGrid instance that - owns the item. - - - The OwnerGridID property will get the ClientID of the - Grid instance that owns the referenced item. For example the code - below will return RadGrid1 which is the ClientID of the owner Grid instance. - - protected void RadGrid1_ItemCreated(object sender, GridItemEventArgs e) - { - if (e.Item is GridEditableItem && e.Item.IsInEditMode) - { - Response.Write(e.Item.OwnerGridID); - - } - } - - - Protected Sub RadGrid1_ItemCreated(sender As Object, e As GridItemEventArgs) - If Typeof e.Item Is GridEditableItem And e.Item.IsInEditMode Then - Response.Write(e.Item.OwnerGridID) - End If - End Sub - - - - This would be useful if several controls use the same eventhandler and you need - to diferentiate the Grid instances in the handler. - - - - - - - - - Gets a value indicating whether this item has child items - or items somehow - related to this. - - - For example the GridDataItem has child - NestedViewItem that holds the hierarchy tables when grid is - rendering hierarchy.
- GroupHeaderItems has the items with a group for children, and so - on. - - protected void RadGrid1_ItemCreated(object sender, GridItemEventArgs e) - { - if (e.Item is GridItem && (e.Item as GridItem).HasChildItems == true) - { - Label1.Text = "has items"; - } - } - - - Protected Sub RadGrid1_ItemCreated(ByVal sender As Object, ByVal e As GridItemEventArgs) - If (Typeof e.Item Is GridItem AndAlso CType(e.Item, GridItem).HasChildItems = True) Then - Label1.Text = "has items" - End If - End Sub - -
-
- - - Gets a value indicating whether the item can be "expanded" to show its child items - - - Shows whether an item can be "expanded" to show its child items - - protected void RadGrid1_ItemCreated(object sender, GridItemEventArgs e) - { - if (e.Item is GridItem && (e.Item as GridItem).CanExpand == true) - { - Label1.Text = "Item was expanded"; - } - } - - - Protected Sub RadGrid1_ItemCreated(ByVal sender As Object, ByVal e As GridItemEventArgs) - If (Typeof e.Item Is GridItem AndAlso CType(e.Item, GridItem).CanExpand = True) - Label1.Text = "Item was expanded" - End If - End Sub - - - - - - The original DataItem from the DataSource. See - examples section below. - - - For example if you bind the grid to a DataView object the - DataItem will represent the DataRowView object - extracted from the DataView for this GridItem. Note - that the DataItem object is available only when grid binds to data - (inside the ItemDataBound server event handler). - - - - - Gets the index of the GridDataItem in the underlying - DataTable/specified table from a DataSet. - - Integer - - This property has a meaning only when the Telerik RadGrid source is - DataTable. - - - - - Gets the index of the grid item among the - collection. This index also can be used to get the DataKeyValues - corresponding to this item from a GridTableView. - - - Gets a value representing the index of this item among the - collection. This index also can be used to - get the DataKeyValues corresponding to this item from a - GridTableView. - - - - - Gets the index of the row as in the html table object rendered on the client - - - - - - - Gets the index of the item in the rows collection of the underlying Table server control - - - - - - - Get the unique item index among all the item in the hierarchy. This index is used when setting item to selected, edited, etc - - - If we have three level hierarchy with two items each and select the first item in - the third level then the ItemIndexHierarchical will be 1:0_1:0_0 - - protected void RadGrid1_SelectedIndexChanged(object sender, EventArgs e) - { - Response.Write(RadGrid1.SelectedItems[0].ItemIndexHierarchical); - } - - - Protected Sub RadGrid1_SelectedIndexChanged(sender As Object, e As EventArgs) - Response.Write(RadGrid1.SelectedItems(0).ItemIndexHierarchical) - End Sub 'RadGrid1_SelectedIndexChanged - - - - - - Gets the respective GridItemType of the grid item. - - - Gets the respective GridItemType of the grid item. - - foreach (GridDataItem dataItem in rgdStateRules.MasterTableView.Items) - { - if (dataItem.ItemType == GridItemType.Item || - dataItem.ItemType == GridItemType.AlternatingItem) - { - string reqName = dataItem["SomeColumnUniqueName"]. Text; - .... - } - } - - - Dim dataItem As GridDataItem - For Each dataItem In rgdStateRules.MasterTableView.Items - If dataItem.ItemType = GridItemType.Item Or dataItem.ItemType = GridItemType.AlternatingItem Then - Dim reqName As String = dataItem("SomeColumnUniqueName").Text - End If - Next dataItem - - - - - - Gets or sets a value indicating whether the grid item is expanded or - collapsed. - - - The example below sets all expanded items to collapsed - - for(int i = 0; i < RadGrid.Items.Count - 1;i++) - if(RadGrid.Items[i].Expanded) - { - RadGrid.Items[i].Expanded = false; - } - - - Dim i As Integer - For i = 0 To (RadGrid.Items.Count - 1) Step -1 - If RadGrid.Items(i).Expanded Then - RadGrid.Items(i).Expanded = False - End If - Next i - - - - - - The example below will hide the GridCommandItem. - - if (e.Item is GridCommandItem) - { - e.Item.Display = false; - } - - - If Typeof e.Item Is GridCommandItem Then - e.Item.Display = False - End If - - - Sets whether the GridItem will be visible or with style="display:none;" - - - Gets or set a value indicating whether the grid item is selected - - You can check whether a certain item is selected using the Selected - property: - - protected void RadGrid1_PreRender(object sender, EventArgs e) - { - foreach (GridDataItem dataitem in RadGrid1.MasterTableView.Items) - { - if (dataitem.Selected == true) - { - //do your thing - } - } - } - - - Protected Sub RadGrid1_PreRender(sender As Object, e As EventArgs) - Dim dataitem As GridDataItem - For Each dataitem In RadGrid1.MasterTableView.Items - If dataitem.Selected = True Then - 'do your thing - End If - Next dataitem - End Sub 'RadGrid1_PreRender - - - - - Sets the Item in edit mode. Requires Telerik RadGrid to rebind. - - - If is set to InPlace, the grid column - editors will be displayed inline of this item. - - - If is set to EditForms, a new - GridItem will be created, which will be child of this item - (GridEditFormItem). The new item will hold the edit form. - - - - We suggest using IsInEditMode instead of Edit to check whether an Item is in - edit more or not. - - - - Gets the index of the Item in the group. This works only when grouping. - - This example expands all items that meet the condition: - - if (e.Item.GroupIndex == EditItemGroupIndex | EditItemGroupIndex.StartsWith(e.Item.GroupIndex + "_")) - { - e.Item.Expanded = true; - } - - - If e.Item.GroupIndex = EditItemGroupIndex Or EditItemGroupIndex.StartsWith(e.Item.GroupIndex & "_") Then - e.Item.Expanded = True - End If - - - - Returns a string formed: X_Y_Z, where:
- - X is a zero-based value representing the group index (the first group of results - will have index = 0)
- - Y is a zero-based value representing the group level. If you group the grid - using 2 criteria, the inner groups will have index = 1. - - Z is a zero-based value representing the GridItem index in the group (the - first item will have index = 0) - Note that if you use more criteria, you will have more - indexes returned: X_Y_Z_W, where the last one is always the item index in the - group. -
-
- - - Gets a value indicating whether the grid item is bound to a data source. - - - Default value is true when the grid is databound. - - - - - Gets a value indicating whether the grid item is in edit mode at the - moment. - - - Will locate the TextBox for Item in Edit mode: - - if (e.Item is GridEditableItem && e.Item.IsInEditMode) - { - TextBox txt = (e.Item as GridEditableItem)["SomeColumnName"].Controls[0] as TextBox; - } - - - If Typeof e.Item Is GridEditableItem And e.Item.IsInEditMode Then - ... - End If - - - - - - - - - - - - - - - - - - Represents the base class for any items that display and edit data in a - GridTableView of RadGrid. Inheritors has the - capabilities to: - - Locate a table cell based on the column unique names - Extract values from the cells of column editors - Has a dictionary of saved-old-values that are necessary for optimistic concurency - editing oprations - Edit/browse mode - EditManager instance, which is capable of locating the column - editors - - - - - - - - - Extracts values for each column, using - - This dictionary to fill, this parameter should not be null - - - - Extracts values for each column, using and updates values in provided object; - - This dictionary to fill, this parameter should not be null - - - - Get the DataKeyValues from the owner GridTableView with the corresponding item ItemIndex and keyName. - The keyName should be one of the specified in the array - - data key name - data key value - - - Allows you to access the column editors - - - GridEditManager editMan = editedItem.EditManager; - IGridEditableColumn editableCol = (column as IGridEditableColumn); - IGridColumnEditor editor = editMan.GetColumnEditor( editableCol ); - - - Dim editMan As GridEditManager = editedItem.EditManager - Dim editableCol As IGridEditableColumn = CType(column, IGridEditableColumn) - Dim editor As IGridColumnEditor = editMan.GetColumnEditor(editableCol) - - - - - - - - - - - - - Gets the old value of the edited item - - - foreach (DictionaryEntry entry in newValues) - { - Label1.Text += "\n<br />Key: " + entry.Key + "<br />New value: " + entry.Value + "<br /> Old value: " + editedItem.SavedOldValues[entry.Key] + "<br />"; - } - - - - - For Each entry As DictionaryEntry In newValues - Label1.Text += "" & Microsoft.VisualBasic.Chr(10) & "<br />Key: " + entry.Key + "<br />New value: " + entry.Value + "<br /> Old value: " + editedItem.SavedOldValues(entry.Key) + "<br />" - Next - - - - - - - - - - - string keyValues = ((GridEditableItem)e.Item).KeyValues; - if (keyValues.Contains("CustomerID")) - Session["CustomerID"] = keyValues.Substring(13, keyValues.Length - 1); - else - Session["OrderID"] = keyValues.Substring(10, keyValues.Length - 1); - - - Dim keyValues As String = CType(e.Item, GridEditableItem).KeyValues - If keyValues.Contains("CustomerID") Then - Session("CustomerID") = keyValues.Substring(13, keyValues.Length - 1) - Else - Session("OrderID") = keyValues.Substring(10, keyValues.Length - 1) - End If - - - - - - Summary description for GridDataItem. - - - - - Generates a client-side function which fires a command with a given name and arguments - - - GridTableView fireCommand - - - protected void RadGrid1_ItemCreated(object sender, GridItemEventArgs e) - { - if (e.Item is GridDataItem) - { - GridDataItem dataItem = (GridDataItem) e.Item; - ((Button) dataItem["MyTemplateColumn"].Controls[0]).OnClientClick = - dataItem.ClientFireCommandFunction("MyCommandName", ""); - } - } - - - Command's name - Command's argument - - - Sets the visibility of the children items. - This method is for Telerik RadGrid internal usage. - - - This method is for Telerik RadGrid internal usage. - - - - Item that loads an EditForm during binding if is . When in this mode - RadGrid loads an EditFormItem for each normal data-bound item. EditForm is generated only for the items that are in = true mode. - - - - - The table cell where the edit form will be instantiated, during data-binding. - - - - - FormColumns are only available when EditFormType is GridEditFormType.AutoGenerated. - These are the container controls for each edit-form-column. You cna find the edit controls - in these containers. You should not remove any controls from this containers. - - - - - The corresponding DataItem that the edit form is generated for. - - - - - It's an item, displaying input controls, which allows user to enter a filter values - for each visible column in a GridTableView. By default the columns render a textbox - and a button, displaying the filtering menu on click. This item is visible based on - the settings of property. - The items is displayed right under the header row of a GridTabelView. - - Setting filter textbox dimensions/changing default filter image - - - Protected Sub RadGrid1_ItemCreated(sender As Object, e As GridItemEventArgs) Handles RadGrid1.ItemCreated - If Typeof e.Item Is GridFilteringItem Then - Dim filteringItem As GridFilteringItem = CType(e.Item, GridFilteringItem) - - 'set dimensions for the filter textbox - Dim box As TextBox = CType(filteringItem("ContactName").Controls(0), TextBox) - box.Width = Unit.Pixel(30) - - 'set ImageUrl which points to your custom image - Dim image As Image = CType(filteringItem("ContactName").Controls(1), Image) - image.ImageUrl = "<my_image_url>" - End If - End Sub 'RadGrid1_ItemCreated - - - Protected void RadGrid1_ItemCreated(Object sender, GridItemEventArgs e) - { - If (e.Item Is GridFilteringItem) - { - GridFilteringItem filteringItem = e.Item As GridFilteringItem; - - //Set dimensions For the filter textbox - TextBox box = filteringItem["ContactName"].Controls[0] As TextBox; - box.Width = Unit.Pixel(30); - - //Set ImageUrl which points To your custom image - Image image = filteringItem["ContactName"].Controls[1] As Image; - image.ImageUrl = "<my_image_url>"; - } - } - - - - - - - - - - - - - - Displays the footer row of a GridTableView with cells for each column in the grid similar to GridHeaderItem. - - - - - - - - - - - - - The item which splits the groups (when utilizing the grouping feature of RadGrid) - and provides expand/collapse functionality for them. - - - Here is how you can get reference to the GridGroupHeaderItem on - ItemDataBound: - - Private Sub RadGrid1_ItemDataBound(sender As Object, e As Telerik.Web.UI.GridItemEventArgs) - If Typeof e.Item Is GridGroupHeaderItem Then - Dim item As GridGroupHeaderItem = CType(e.Item, GridGroupHeaderItem) - 'do something here - End If - End Sub 'RadGrid1_ItemDataBound - - - private void RadGrid1_ItemDataBound(object sender, Telerik.Web.UI.GridItemEventArgs e) - { - if ( e.Item is GridGroupHeaderItem ) - { - GridGroupHeaderItem item = (GridGroupHeaderItem)e.Item; - //do something here - } - } - } - - - Created and meaningful only with grouping enabled. - - should be applied to have such type of - item(s). - - Customize GridGroupHeaderItem - Performing calculations in group header - - - Marked for internal usage only - - - Inherited from Control, for internal usage only - - - Inherited from Control, for internal usage only - - - Inherited from Control, for internal usage only - - - - Method which returns the data items under the - group. - - An array of GridItem instances - - The code below can be used to loop through the data items in a group on button - click handler (for example): - - Dim groupHeader As GridGroupHeaderItem = RadGrid1.MasterTableView.GetItems(GridItemType.GroupHeader)(0) - Dim groupItems As GridItem() = groupHeader.GetChildItems() - 'traverse the items and operate with them further - - - GridGroupHeaderItem groupHeader= RadGrid1.MasterTableView.GetItems(GridItemType.GroupHeader)[0] as GridGroupHeaderItem; - GridItem [] groupItems = groupHeader.GetChildItems(); - //traverse the items and operate with them further - - - Meaningful only with grouping enabled. - - should be applied to have - available. - - - - - Method which shows/hides the items in the group designated by the - - - N/A - - The code below will hide the items under the first group in the grid: - - Dim groupHeader As GridGroupHeaderItem = RadGrid1.MasterTableView.GetItems(GridItemType.GroupHeader)(0) - groupHeader.SetVisibleChildren(False) - - - GridGroupHeaderItem groupHeader = RadGrid1.MasterTableView.GetItems(GridItemType.GroupHeader)[0] as GridGroupHeaderItem; - groupHeader.SetVisibleChildren(false); - - - Meaningful only with grouping enabled. - - should be applied to have - available. - - - boolean, determines whether the items in the group will be displayed or - hidden - - - - The cell holding the content of the - N/A - - Below is a sample code presenting how to customize the DataCell - content dynamically on ItemDataBound: - - Private Sub RadGrid1_ItemDataBound(sender As Object, e As Telerik.Web.UI.GridItemEventArgs) - If Typeof e.Item Is GridGroupHeaderItem Then - Dim item As GridGroupHeaderItem = CType(e.Item, GridGroupHeaderItem) - Dim groupDataRow As DataRowView = CType(e.Item.DataItem, DataRowView) - - 'Clear the present text of the cell - item.DataCell.Text = "" - Dim column As DataColumn - For Each column In groupDataRow.DataView.Table.Columns - - 'Check the condition and add only the field you need - If column.ColumnName = "Country" Then - item.DataCell.Text += "Customized display - Country is " + groupDataRow("Country").ToString() - End If - Next column - End If - End Sub 'RadGrid1_ItemDataBound - - - Private void RadGrid1_ItemDataBound(Object sender, Telerik.Web.UI.GridItemEventArgs e) - { - If ( e.Item Is GridGroupHeaderItem ) - { - GridGroupHeaderItem item = (GridGroupHeaderItem)e.Item; - DataRowView groupDataRow = (DataRowView)e.Item.DataItem; - - //Clear the present text of the cell - item.DataCell.Text = ""; - foreach( DataColumn column In groupDataRow.DataView.Table.Columns) - - //Check the condition And add only the field you need - If ( column.ColumnName == "Country" ) - { - item.DataCell.Text += "Customized display - Country is " + groupDataRow - ["Country"].ToString(); - } - } - } - - - Created and meaningful only with grouping enabled. - - should be applied to have - with DataCell. - - Customize GridGroupHeaderItem - Performing calculations in group header - - - - Boolean property indicating whether the relevant - has child items inside the group it forms. - - boolean - - - Dim groupHeader As GridGroupHeaderItem = grid.MasterTableView.GetItems(GridItemType.GroupHeader)(0) - If (groupHeader.HasChildItems) Then - 'operate with the items - Else - 'do something else - End If - - - GridGroupHeaderItem groupHeader = grid.MasterTableView.GetItems(GridItemType.GroupHeader)[0] as GridGroupHeaderItem; - if (groupHeader.HasChildItems) - { - //operate with the items - } - else - { - //do something else - } - - - Meaningful only with grouping enabled. - - should be applied to have - with this boolean property. - - - - Marked for internal usage - - - - Summary description for GridHeaderItem. - - - - - - - - - - - - - - - - - Summary description for GridMultiRowItem. - - - - - - - - - - - - - - - - - - - - - - - - - Item that contains the nested instances of GridTableView class, that appear as a child item of the corresponding GridDataItem - - - The child tables will be created when grid is databinding and will be added as controls of the - Then these tables can also be accessed using the array. - - - - - Creates an instance of GridNestedViewItem For - internal usage only. - - - - - An instance of GridTableView Class, which will - contain the created item - - - The value for ItemIndex Property - (Telerik.Web.UI.GridItem) property - - - The value for DataSetIndex Property - (Telerik.Web.UI.GridItem) property - - - - Defines the default logic for rendering the item. For internal usage only. - - - - - This method is not intended to be used directly from your code - - - - - This method is not intended to be used directly from your code - - - - - Gets the cell that contains the . - System.Web.UI.WebControls.TableCell - - - foreach (GridNestedViewItem nestedViewItem in radgrid1.MasterTableView.GetItems(GridItemType.NestedView)) - { - TableCell cell = nestedViewItem.NestedViewCell; - cell.BorderColor = System.Drawing.Color.Red; - } - - - Dim nestedViewItem As GridNestedViewItem - For Each nestedViewItem In RadGrid1.MasterTableView.GetItems(GridItemType.NestedView) - Dim cell As TableCell = nestedViewItem.NestedViewCell - cell.BorderColor = System.Drawing.Color.Red - Next nestedViewItem - - - - - - Gets an array of GridTableView objects residing in the . - - - - GridTableView nestedTable = RadGrid1.MasterTableView.Items[0].ChildItem.NestedTableViews[0]; - - - Dim nestedTable As GridTableView = RadGrid1.MasterTableView.Items(0).ChildItem.NestedTableViews(0) - - - - - - Gets a reference to a that is parent of this - - - - - - GridNoRecordsItem is used to display no records template, in the corresponding table view has is set to true (the default) - - - - - - - - - - - - - - - - - - - - - Summary description for GridPagerItem. - - - - - - - - - - - - - - - - - - - - Returns instance of control which contains grid numeric pager - - If you have already defined an GridPagerTemplate, but still standard numeric - pager is required you can attain this using the following code - - protected void RadGrid1_ItemCreated(object sender, Telerik.Web.UI.GridItemEventArgs e) - { - if (e.Item is GridPagerItem) - { - GridPagerItem gridPager = e.Item as GridPagerItem; - Control numericPagerControl = gridPager.GetNumericPager(); - gridPager.Controls[0].Controls.Add(numericPagerControl); - } - } - - - Protected Sub RadGrid1_ItemCreated(ByVal sender As Object, ByVal e As Telerik.Web.UI.GridItemEventArgs) - If Typeof e.Item Is GridPagerItem Then - Dim gridPager As GridPagerItem = TryCast(e.Item, GridPagerItem) - Dim numericPagerControl As Control = gridPager.GetNumericPager() - gridPager.Controls(0).Controls.Add(numericPagerControl) - End If - End Sub - - - - - Gets the position of the pager in the RadGrid. Default value is false. - - - if (((GridPagerItem)this.Item).IsTopPager) - { - Item.Visible = false; - return; - } - - - If CType(Me.Item, GridPagerItem).IsTopPager Then - Item.Visible = False - Return - End If - - - - - The Cell where the PagerItems are located - - - if (e.Item is GridPagerItem) - { - GridPagerItem pagerItem = (e.Item as GridPagerItem); - pagerItem.PagerContentCell.Controls.Clear(); - //custom paging - } - - - If Typeof e.Item Is GridPagerItem Then - Dim pagerItem As GridPagerItem = CType(e.Item, GridPagerItem) - pagerItem.PagerContentCell.Controls.Clear - 'custom paging - End If - - - - - - GridStatusBarItem is used to display information messages for - Telerik RadGrid status. Meaningful only when Telerik RadGrid is in AJAX - mode. - - - - - - - - - - - - - - - - - - - - - The mode of the pager defines what buttons will be displayed and how the pager - will navigate through the pages. - - - - The grid Pager will display only the Previous and Next link buttons. - - - The grid Pager will display only the page numbers as link buttons. - - - - The grid Pager will display the Previous button, then the page numbers and then - the Next button. - - - - - The grid Pager will display the Previous button, then the page numbers and then - the Next button. On the next Pager row, the Pager will display text boxes for - navigating to a specific page and setting the Page size (number of items per - page). - - - - - The grid Pager will display text boxes for navigating to a specific page and - setting the Page size (number of items per page). - - - - - The grid Pager will display a slider for very fast and AJAX-based navigation - through grid pages. - - - - This enumeration defines the possible positions of the pager item - - - - The Pager item will be displayed on the bottom of the grid. (Default - value) - - - - The Pager item will be displayed on the top of the grid. - - - - The Pager item will be displayed both on the bottom and on the top of the - grid. - - - - - RadGrid and GridTableView use instance of this class to set style of thir PagerItem-s when rendering - - - - - Summary description for GridTableItemStyle. - - - - - Returns 'True' if none of the properties have been set - - - - Returns true if none of the properties have been set. - - Gets a value indicating whether the default pager will be used, i.e. no - customizations have been made. - - - - - Gets a value indicating whether the pager is displayed on the bottom of the - grid. - - - Returns true if the pager will be displayed on the bottom of the - grid. Otherwise false. - - - - - Gets a value indicating whether the pager is displayed on the top of the - grid. - - - Returns true if the pager will be displayed on the top of the - grid. Otherwise false. - - - - - Gets or sets the mode of Telerik RadGrid Pager. The mode defines what - the pager will contain. This property accepts as values only members of the - GridPagerMode - Enumeration. - - - Returns the pager mode as one of the values of the - GridPagerMode - Enumeration. - - - You should have Paging enabled by setting the - property. - - - - - Text that would appear if Mode is PrevNext for 'next' page button - - - - - Text that would appear if Mode is PrevNext for 'last' page button - - - - - Gets or sets url for Previous Page image - - - - - Gets or sets url for Next Page image - - - - - Gets or sets url for first page image - - - - - Gets or sets url for first page image - - - - - ToolTip that would appear if Mode is PrevNext for 'next' page button - - - - - ToolTip that would appear if Mode is PrevNext for 'next' page button - - - - - ToolTip that would appear if Mode is PrevNext for 'last' page button - - - - - ToolTip that would appear if Mode is PrevNext for 'prev' page button - - - - - ToolTip that would appear if Mode is PrevNext for 'next' page button - - - - - ToolTip that would appear if Mode is PrevNext for 'prev' page button - - - - - Gets or sets the number of buttons that would be rendered if pager Mode is - - - - returns the number of button that will be displayed. The default value is 10 - buttons. - - - By default 10 buttons will be displayed. If the number of grid pages is greater - than 10, ellipsis will be displayed. - - - - - Gets or sets the Position of pager item(s).Accepts only values, members of the - GridPagerPosition - Enumeration. - - - Returns the Pager position as a value, member of the - GridPagerPosition - Enumeration. - - - - - Text that would appear if Mode is PrevNext for 'previous' page button - - - - - Text that would appear if Mode is PrevNext for 'first' page button - - - - Gets or sets the visibility of the pager item - - - - In order to display the grid pager regardless of the number of records returned - and the page size, you should set this property of the corresponding GridTableView to - true. Its default value is false. - - - Gets or set a value indicating whether the Pager will be visible regardless of - the number of items. (See the remarks) - - - true, if pager will be displayed, regardless of the number of - grid items, othewise false. By fefault it is - false. - - - - - Get or set a value indicating whether the SEO (Search Engine Optimized) paging - enabled - - December 15, 2006 - - - - Gets or sets the horizontal align of the pager. Accepts as values members of the - enumeration. - - - the horizontal align of the pager as a value from the - enumeration. - - - - - Gets or sets a value indicating whether the pager text or only the pager buttons - will be displayed. - - - true if both pager text and buttons will be displayed, otherwise - false. By default it is true. - - - - - The string used to format the description text that appears in a pager item. See - the remarks. - - - The parameters {0) - {4} are mandatory.
-
- Parameter {0} is used to display current page number.
- Parameter {1} is total number of pages.
- Parameter {2} will be replaced with the number of the first item in the current - page.
- Parameter {3} will be set to the number of the last item in the current page.
- Parameter {4} indicates where pager buttons would appear.
- Parameter {5} corresponds to number of all items in the datasource. -
- - The default value is:
- Change page: {4} Displaying page {0} of {1}, items {2} - to {3} of {5} -
-
- - - Summary description for GridPagingManager. - - - - - Number of items in the data-source - - - - - Number of items in the current page - - - - - Represents the paper size used when exporting to PDF. - - - - - Container of misc. grouping settings of RadGrid control - - - - - Gets or sets the physical paper size that RadGrid will use when exporting to PDF. - - - It will be overriden by setting PageWidth and PageHeight explicitly. - - - - - Gets or sets the page width that RadGrid will use when exporting to PDF. - - - This setting will override any predefined value that comes from the PaperSize property. - - - - - Gets or sets the page height that RadGrid will use when exporting to PDF. - - - This setting will override any predefined value that comes from the PaperSize property. - - - - - This property describes the different types of font embedding: Link, - Embed and Subset. - - - Possible values: - - -
- Link
- The font program is referenced by name in the rendered PDF. Anyone who - views a rendered PDF with a linked font program must have that font - installed on their computer otherwise it will not display correctly. -
-
- -
- Embed
- The entire font program is embedded in the rendered PDF. Embedding the - entire font program guarantees the PDF will display as intended by the - author on all computers, however this method does possess several - disadvantages: -
-
    -
  1. -
    - Font programs can be extremely large and will significantly - increase the size of the rendered PDF. For example, the MS - Gothic TrueType collection is 8MB! -
    -
  2. -
  3. -
    - Certain font programs cannot be embedded due to license - restrictions. If you attempt to embed a font program that - disallows embedding, RadGrid will substitute the font with a - base 14 font and generate a warning message. -
    -
  4. -
-
- -
- Subset (default value)
Subsetting a font will - generate a new font that is embedded in the rendered PDF that contains - only the chars referenced by RadGrid. For example, if a particular - RadGrid utilised the Verdana font referencing only the character 'A', a - subsetted font would be generated at run-time containing only the - information necessary to render the character 'A'.
-
- Subsetting provides the benefits of embedding and significantly reduces - the size of the font program. However, small processing overhead is - incurred to generated the subsetted font. -
-
-
-
-
- - - GridPropertyEvaluator - A DataBinder.Eval() workalike that is a bit more forgiving and does not throw exceptions when it can't find a property. - - - - - Summary description for GridResizing. - - - - - Contains properties related to customizing the settings for scrolling operation - in Telerik RadGrid. - - - - - Gets or sets a value indicating whether scrolling will be enabled in - Telerik RadGrid. - - true, if scrolling is enabled, otherwise false (the default value). - - - - Gets or sets a value specifying the grid height in pixels (px) beyond which the - scrolling will be enabled. - - the default value is 300px - - - - Gets or sets a value indicating whether grid column headers will scroll as the - rest of the grid items or will remain static (MS Excel ® style). - - - true if headers remain static on scroll, otherwise - false (the default value). - - - This property is meaningful only when used in conjunction with - set to true. - - - - - Gets or sets a value indicating whether Telerik RadGrid will keep the - scroll position during postbacks. - - - This property is meaningful only when used in conjunction with - set to true. - - - true (the default value), if Telerik RadGrid keeps - the scroll position on postback, otherwise false . - - - - - This property is particularly useful when working with huge datasets. Using - the grid scrollbar, you can change the grid pages just like in Microsoft - Word®. When scrolling with the virtual scrollbar, - Telerik RadGrid uses AJAX requests to change the pages, i.e. no - Postbacks are performed. The overall behavior is smooth and with no flicker. - Note that you should have AJAX enabled for Telerik RadGrid by - setting the EnableAJAX="True". - - - Gets or sets a value indicating whether Telerik RadGrid will change - the pages when you scroll using the grid scroller. This in terms of - Telerik RadGrid is called Virtual Scrolling. - - - true, if virtual scrolling is enabled, otherwise - false (the default value). - - - - - Provides properties related to setting the client-side selection in - Telerik RadGrid. - - - You can get a reference to this class using - property. - - - - not currently available - - - - - not currently available - - - - - - Gets or sets a value indicating whether you will be able to select a grid row on - the client by clicking on it with the mouse. - - - true, if you will be able to select a row on the client, otherwise false (the - default value). - - - - not currently available - - - - - not currently available - - - - - - Gets or sets a value indicating whether you will be able to select multiple rows - by dragging a rectangle around them with the mouse. - - - true, if you can select rows by dragging a rectangle with the mouse, otherwise - false (the default value) - - - - - Holds the column names presenting the self-referencing relations in the source - table. - - - <MasterTableView HierarchyDefaultExpanded="true" HierarchyLoadMode="Client" - EnableNoRecordsTemplate="false"
- DataKeyNames= "ID,ParentID" Width="100%">
- <SelfHierarchySettings ParentKeyName="ParentID" KeyName="ID" - />
- </MasterTableView> -
- Meaningful in cases of self-referenced grid. -
- - This method is for Telerik RadGrid internal usage. - - Checks if a self-hierarchy settings property value was changed and differs from its - default. - - - - - Gets or sets a value representing the parent ID field when building the - self-referencing hierarchy. - - - The value property must be included in the DataKeyNames array - for the MasterTableView. - - - string, representing the parent ID of the current table - level. - - - - - -
-            <radG:RadGrid ID="RadGrid1" EnableAJAX="True" ShowHeader="true" runat="server" Skin="None"
Width= "97%" GridLines="None" OnColumnCreated="RadGrid1_ColumnCreated"
OnItemCreated="RadGrid1_ItemCreated"
OnNeedDataSource= "RadGrid1_NeedDataSource">
<MasterTableView HierarchyDefaultExpanded="true" HierarchyLoadMode="Client" EnableNoRecordsTemplate="false"
- DataKeyNames= "ID,ParentID" Width="100%">
<SelfHierarchySettings ParentKeyName="ParentID" KeyName="ID" />
</MasterTableView>
<ClientSettings AllowExpandCollapse="true" /> - </radG:RadGrid> -
-
-
-
-
-
- - - Gets or sets a value, representing the ID of the current table level in - self-referencing hierarchy structure. - - string, representing the current table level. - - The value property must be included in the DataKeyNames array - for the MasterTableView. - - - - - -
-            <radG:RadGrid ID="RadGrid1" EnableAJAX="True" ShowHeader="true" runat="server" Skin="None"
Width= "97%" GridLines="None" OnColumnCreated="RadGrid1_ColumnCreated"
OnItemCreated="RadGrid1_ItemCreated"
OnNeedDataSource= "RadGrid1_NeedDataSource">
<MasterTableView HierarchyDefaultExpanded="true" HierarchyLoadMode="Client" EnableNoRecordsTemplate="false"
- DataKeyNames= "ID,ParentID" Width="100%">
<SelfHierarchySettings ParentKeyName="ParentID" KeyName="ID" />
</MasterTableView>
<ClientSettings AllowExpandCollapse="true" /> -
-
-
- - -
-            </radG:RadGrid>
-            
-
-
-
-
-
- - - This property can be set only once when the grid is initialized - and can not be modified. - - - Gets or sets a value indicating the level-depth limit of the nested - tables. - - - integer, representing the depth limit in levels of nesting. By - default the limit is 10 levels. - - - - Enumeration representing the order of sorting data in RadGrid - - - do not sort the grid data - - - sorts grid data in ascending order - - - sorts grid data in descending order - - - - Class that is used to define sort field and sort order for RadGrid - - - - - - - - - This method gives the string representation of the sorting order. It can be - either "ASC" or "DESC" - - - - - Returns a GridSortOrder enumeration based on the string input. Takes either "ASC" - or "DESC" - - - - - This method gives the string representation of the sorting order. It can be - either "ASC" or "DESC" - - - - - - - - - - - - - Sets the sort order. - The SortOrder paremeter should be either "Ascending", "Descending" or "None". - - - - - - - - - Parses a string representation of the sort order and returns - GirdSortExpression. - - - - Gets or sets the name of the field to which sorting is applied. - - - Sets or gets the current sorting order. - - - - A collection of objects. Depending on the value of - it holds single - or multiple sort expressions. - - - - - - - - - - - - - - - - - - - - - Returns an enumerator that iterates through the - GridSortExpressionCollection. - - - - Adds a to the collection. - - - Clears the GridSortExpressionCollection of all items. - - - - Find a SortExpression in the collection if it contains any with sort field = expression - - sort field - - - - - If is true adds the sortExpression in the collection. - Else any other expression previously stored in the collection wioll be removed - - - - - - If is true adds the sortExpression in the collection. - Else any other expression previously stored in the collection wioll be removed - - String containing sort field and optionaly sort order (ASC or DESC) - - - - Adds a to the collection at the specified - index. - - - As a convenience feature, adding at an index greater than zero will set the - to true. - - - - Removes the specified from the collection. - - - - Returns true or false depending on whether the specified sorting expression exists - in the collection. Takes a parameter. - - - - - Returns true or false depending on whether the specified sorting expression - exists in the collection. Takes a string parameter. - - - - - Adds the sort field (expression parameter) if the collection does not alreqady contain the field. Else the sort order of the field will be inverted. The default change order is - Asc -> Desc -> No Sort. The No-Sort state can be controlled using property - - - - - - Get a comma separated list of sort fields and sort-order, in the same format used by - DataView.Sort string expression. Returns null (Nothing) if there are no sort expressions in the collection - - Comma separated list of sort fields and optionaly sort-order, null if there are no sort expressions in the collection - - - - Searches for the specified - GridSortExpression and - returns the zero-based index of the first occurrence within the entire - GridSortExpressionCollection. - - - - - If false, the collection can contain only one sort expression at a time. - Trying to add a new one in this case will delete the existing expression - or will change the sort order if its FiledName is the same. - - - - Returns the number of items in the GridSortExpressionCollection. - - - - Gets a value indicating whether access to the GridSortExpressionCollection is - synchronized (thread safe). - - - - This is the default indexer of the collection - takes an integer value. - - - - - - - - - -
Gets an object that can be used to synchronize access to the - GirdSortExpressionCollection.
-
-
- - - Allow the no-sort state when changing sort order. - - - - - Holds miscellaneous properties related to sorting like the localization - properties. - - - - - Gets or sets the tooltip that will be displayed when you hover the sorting button - and there is no sorting applied. - - - - - Gets or sets the tooltip that will be displayed when you hover the sorting button - and the column is sorted ascending. - - - - - Gets or sets the tooltip that will be displayed when you hover the sorting button - and the column is sorted descending. - - - - - Defines whether a predefined CssClass will be applied to the sorted column's cells - Default value is True - - - - - State managemenet helper. This class is intended to be used only internally in RadGrid. - - - - This class holds settings related to the StatusBar item. - - <StatusBarSettingsReadyText="Stand - by"/> - - November 26, 2006 - - - Gets the ID of the Label that will display the status message. - - - - Gets or sets the text that will be displayed in - GridStatusBarItem when Telerik RadGrid does not perform - any operations. - - the default value is "Ready" - - - - Gets or sets the text that will be displayed in - GridStatusBarItem when Telerik RadGrid is performing an - AJAX request. - - the default value is "Loading..." - - - - A String Tokenizer that accepts Strings as source and delimiter. Only 1 delimiter is supported (either String or char[]). - - - - - Constructor for StringTokenizer Class. - - The Source String. - The Delimiter String. If a 0 length delimiter is given, " " (space) is used by default. - - - - Constructor for StringTokenizer Class. - - The Source String. - The Delimiter String as a char[]. Note that this is converted into a single String and - expects Unicode encoded chars. - - - - Constructor for StringTokenizer Class. The default delimiter of " " (space) is used. - - The Source String. - - - - Empty Constructor. Will create an empty StringTokenizer with no source, no delimiter, and no tokens. - If you want to use this StringTokenizer you will have to call the NewSource(string s) method. You may - optionally call the NewDelim(string d) or NewDelim(char[] d) methods if you don't with to use the default - delimiter of " " (space). - - - - - Method to add or change this Instance's Source string. The delimiter will - remain the same (either default of " " (space) or whatever you constructed - this StringTokenizer with or added with NewDelim(string d) or NewDelim(char[] d) ). - - The new Source String. - - - - Method to add or change this Instance's Delimiter string. The source string - will remain the same (either empty if you used Empty Constructor, or the - previous value of source from the call to a parameterized constructor or - NewSource(string s)). - - The new Delimiter String. - - - - Method to add or change this Instance's Delimiter string. The source string - will remain the same (either empty if you used Empty Constructor, or the - previous value of source from the call to a parameterized constructor or - NewSource(string s)). - - The new Delimiter as a char[]. Note that this is converted into a single String and - expects Unicode encoded chars. - - - - Method to get the number of tokens in this StringTokenizer. - - The number of Tokens in the internal ArrayList. - - - - Method to probe for more tokens. - - true if there are more tokens; false otherwise. - - - - Method to get the next (string)token of this StringTokenizer. - - A string representing the next token; null if no tokens or no more tokens. - - - - Gets the Source string of this Stringtokenizer. - - A string representing the current Source. - - - - Gets the Delimiter string of this StringTokenizer. - - A string representing the current Delimiter. - - - - The frame attribute for a table specifies which sides of the frame surrounding - the table will be visible. - - - - No sides. - - - The top side only. - - - The bottom side only. - - - The top and bottom sides only. - - - The left-hand side only. - - - The right-hand side only. - - - The right and left sides only. - - - All four sides. - - - All four sides - - - - Specifies the two possible text directions. Related to - Telerik RadGrid support for right-to-left languages. - - - - Left-To-Right direction - - - Right-To-Left direction - - - - Defines the possible modes for loading the child items when - RadGrid displays hierarchy. - - - - - All child GridTableViews will be bound immediately when DataBind occurs for a parent GridTableView or RadGrid. - - - - - - - - DataBind of a child GridTableView would only take place when an item is Expanded . - This is the default value of - - - - - This mode is similar to ServerBind, but items are expanded client-side, using - JavaScript manipulations, instead of postback to the server. - - In order to use client-side hierarchy expand, you will need to set also - to - true. - - - - - - Specifies where the grouping will be handled. There are two options: - - Server-side - GridTableView.GroupLoadMode.Server - Client-side - - GridTableView.GroupLoadMode.Client - - - - - This is the default behavior. Groups are expanded after postback to the server - for example: -
- - - -
- - <MasterTableView GroupLoadMode="Server"> -
-
-
- - - Groups will be expanded client-side and no postback will be performed.
-
- - - -
- - <MasterTableView GroupLoadMode="Client"> -
- and set the client setting AllowGroupExpandCollapse to - true:
-
- - - -
- - <ClientSettings AllowGroupExpandCollapse="True"> -
-
-
- - - To display the grid column editors inline when switching grid item in edit - mode (see the screenshot below), you simply need to change the - EditMode property to InPlace. -
- - - - - - -
-
-            							
-            <radg:RadGrid id="RadGrid1" runat="server">
<MasterTableView AutoGenerateColumns="True" EditMode="InPlace" />
</radg:RadGrid>
-
-
-
-
- A row in edit mode - To display the grid column editors in auto-generated form when switching grid - item in edit mode (see the screenshot below), you simply need to change the - MasterTableView EditMode property to - EditForms. -
- - - - - - -
-
-            							
-            <radg:RadGrid id="RadGrid1" runat="server">
<MasterTableView AutoGenerateColumns="True" EditMode="EditForms" />
</radg:RadGrid>
-
-
-
-
Edit in forms mode -
-
- - - Telerik RadGrid will display the column editors inline when switching - grid item in edit mode - - - - - Telerik RadGrid will display the grid column editors in - auto-generated form when switching grid item in edit mode - - - - - Indicate where RadGrid would store its data - - - - - DataSource (or generated html tables) data will not be stored. - RadGrid will fire NeedDataSource event and will bind after each postback - - - - - Default - RadGrid stores data in the view-state bag. - - - - - Discribe how RadGrid whould respond if the - is invalid when data-binding. See - - - - - - CurrentPageIndex would be set to 0 - - - - - CurrentPageIndex would be set to current page count - 1 - - - - - RadGrid would repord an InvalidOperationException. - - - - - InsertItem will be shown on first page - - - - - InsertItem will be shown on the last page - - - - - InsertItem will be shown on the current page - - - - - Specifies the position of the in - Telerik RadGrid. - - - - There will be no command item. - - - The command item will be above the Telerik RadGrid - - - The command item will be on the bottom of Telerik RadGrid - - - - The command item will be both on the top and bottom of - Telerik RadGrid. - - - - - Specifies the position of the in - Telerik RadGrid. - - - - The command item will be above the Telerik RadGrid - - - The command item will be on the bottom of Telerik RadGrid - - - Represents one table of data. - - In case of flat grid structure, i.e. no hierarchy levels, this object is the - MasterTableView itself. - In case of hierarchical structure, the topmost GridTableView is - the MasterTableView. All inner (child) tables are refered as - DetailTables. Each table that has children tables has a collection called - where you can access these tables. - - - - Gets the owner RadGrid object. - The owner RadGrid object. - OwnerID Property - - - Gets the rendering style of a FilterItem. - - - Gets the rendering style of a CommandItem. - - - - Constructs a new GridTableView and sets as its owner the RadGrid - object. - - GridTableView Method - GridTableView Method - - - - Constructs a new GridTableView and sets as its owner the - RadGrid object. Sets the IsTrackingViewState property - to the corresponding value of the boolean parameter. - - GridTableView Method - GridTableView Method - The owner RadGrid object - - Indicates whether RadGrid is saving changes to its view - state. - - - - - Default contructor for GridTableView - generally used by Page - serializer only. - - GridTableView Method - GridTableView Method - - - - Swaps columns appearance position using the unique names of the two - columns. - - SwapColumns Method - first column unique name - second column unique name - - - Swaps columns appearance position using order indexes of the two columns. - - You should have in mind that GridExpandColumn and - RowIndicatorColumn are always in front of data columns so that's why - you columns will start from index 2. - - SwapColumns Method - first column order index - second column order index - - - - Removes all selected items that belong to this GridTableView - instance. - - GridSelecting Class - ClearEditItems Method - - - - Removes all edit items that belong to the GridTableView - instance. - - GridEditFormItem Class - ClearSelectedItems Method - - - - Forces the Owner RadGrid to fire - event then calls - . - - GridNeedDataSourceEventHandler Delegate - DataBind Method - - The Rebind method should be called every time a change to the - RadGrid columns/items has been made. - - - - Binds the data source to the RadGrid instance. - - Call this member to bind partially RadGrid. Before calling this - method the property should be assigned or you can use - method instead. Use - or member to bind all - GridTableViews in RadGrid. - - DataSource Property - Rebind Method - - - For internal usage. - - - - - For internal usage. - - - - - - Returns a based on its - . - - - The GridColumn object related to the - columnUniqueName. - - GridColumn Class - UniqueName Property (Telerik.Web.UI.GridColumn) - - The following code snippet demonstrates how you to access a column at - PreRender RadGrid event and make set it as invisible: - [ASPX/ASCX] - <radg:radgrid id="RadGrid1" DataSourceID="AccessDataSource1" - runat="server" OnPreRender="RadGrid1_PreRender">
- </radg:radgrid>
- <asp:AccessDataSource ID="AccessDataSource1" - DataFile="~/Grid/Data/Access/Nwind.mdb"
- SelectCommand="SELECT CustomerID, CompanyName, ContactName FROM Customers"
- runat="server">
- </asp:AccessDataSource>
- - protected void RadGrid1_PreRender(object sender, System.EventArgs e) - { - RadGrid1.MasterTableView.GetColumn( "CustomerID" ).Visible = false; - } - -
- GetItems Method - The for the requested column. -
- - - Returns a based on its - . - - The for the requested column. - - - - Returns a collection of objects based on their - . - - - A s collection of objects based on their - . - - GetColumn Method - - The , which will be used as a criteria for - the collection. - - - - - Applies all view changes to control hierarchy before rendering - - - - - This method is used by RadGrid internally. Please do not use. - - - - - - For internal structure usage. - - - - Recreates all GridItems and chld controls, using the DataSource or the ViewState - - 'True' means that DataBind() is executing. 'False' means that Viewtate - has been just loaded after postback. - - - - Exports the grid data in CSV format using the properties set in the - ExportSettings. - - ExportToWord Method - ExportToExcel Method - MS Excel and MS Word online example - - - - Exports the grid data in PDF format using the properties set in the - ExportSettings. - - Exporting online example - - - - Exports the grid data in Microsoft Excel ® format using the properties set in the - ExportSettings. - - ExportToWord Method - ExportToExcel Method - MS Excel and MS Word online example - - - - Exports the grid data in Microsoft Word ® format based on the selected ExportSettings. - - GridExportSettings Class - ExportToExcel Method - ExportToExcel2007 Method - ExportToWord2007 Method - - - For internal usage. - - - - - - - For internal usage. - - - - The passed IDictionary object (like Hashtable for example) will be filled with the - names/values of the corresponding column data-fields and their values. Only - instances of type support extracting values. - - Using grid server-side API for extraction - the dictionary that will be filled - the item to extract values from - - - - Perform asynchronous update operation, using the DataSource control API and the - Rebind method. Please, make sure you have specified the correct - DataKeyNames for the . When the - asynchronous operation calls back, RadGrid will fire - event. - - - The following online example uses PerformUpdate method: - - - Edit on double-click - - DataKeyNames Property - PerformInsert Method - PerformDelete Method - - - - Perform asynchronous update operation, using the DataSource control API. Please - make sure you have specified the correct DataKeyNames for the - GridTableView. When the asynchronous operation calls back, RadGrid will fire - event. The boolean property defines if - RadGrid will after the update. - - PerformInsert Method - PerformDelete Method - the item that is in edit mode and should be updated - set to true to prevent grid from binding after the update operation completes - - - - Perform asynchronous insert of the new item, diplayed by RadGrid when in edit mode, - using the DataSourceControl API, then . When the - asynchronous operation calls back, RadGrid will fire - event. - - PerformUpdate Method - PerformDelete Method - - - - Get the item that appears when grid is in Insert Mode. - - PerformInsert Method - A reference to the newly inserted item for the respective GridTableView. - - There is scenarios in which you need to make some changes with/depending on - the inserted item. - If you want to predifine some controls values on item insertion, you should - use the ItemCommand server-side event to access it: -
-            [C#]
private void RadGrid1_ItemCommand(object source, Telerik.Web.UI.GridCommandEventArgs e)
{
if (e.CommandName == RadGrid.InitInsertCommandName)
- {
e.Canceled = true;
- e.Item.OwnerTableView.InsertItem();
GridEditableItem insertedItem = e.Item.OwnerTableView.GetInsertItem();
- GridEditFormItem editFormItem = insertedItem as GridEditFormItem;

TextBox box = editFormItem.FindControl("txtEmployeeID") as TextBox;
box.Text = "11";
}
} -
-
-            		
[VB.NET] -
-
-            Private Sub RadGrid1_ItemCommand(ByVal source As Object, ByVal e As Telerik.Web.UI.GridCommandEventArgs) Handles RadGrid1.ItemCommand
If (e.CommandName = RadGrid.InitInsertCommandName) Then
- e.Canceled = True
e.Item.OwnerTableView.InsertItem()
Dim insertedItem As GridEditableItem = e.Item.OwnerTableView.GetInsertItem()
- Dim editFormItem As GridEditFormItem = CType(insertedItem, GridEditFormItem)

Dim box As TextBox = CType(MyUserControl.FindControl("insertedItem"), TextBox)
box.Text = "11"
End If
End Sub -
- If you want to get access to - the newly added row and its values to update in a custom data source, you can use - the InsertCommand event: - [C#] -
-            		protected void RadGrid1_InsertCommand(object source, GridCommandEventArgs e)  
{
GridDataInsertItem gridDataInsertItem =
(GridDataInsertItem)(RadGrid1.MasterTableView.GetInsertItem());
- Hashtable ht = new Hashtable();
gridDataInsertItem.ExtractValues(ht);
//Loop through each "DictionaryEntry" in hash table and insert using key value
foreach (DictionaryEntry ent in ht)
- {
//get the key values and insert to custom datasource.
}
-
}
-
- [Visual Basic] -
-            Protected Sub RadGrid1_InsertCommand(ByVal source As Object, ByVal e As GridCommandEventArgs)
Dim gridDataInsertItem As GridDataInsertItem = CType(RadGrid1.MasterTableView.GetInsertItem,GridDataInsertItem)
- Dim ht As Hashtable = New Hashtable
gridDataInsertItem.ExtractValues(ht)
'Loop through each "DictionaryEntry" in hash table and insert using key value
For Each ent As DictionaryEntry In ht
- 'get the key values and insert to custom datasource.
Next
End Sub -
-
-
- - - Performs asynchronous insert operation, using the DataSourceControl API, then - Rebinds. When the asynchronous operation calls back, RadGrid will fire - event. - - PerformUpdate Method - PerformDelete Method - item to be inserted - - - - Perform asynchronous insert operation, using the DataSource control API. - When the asynchronous operation calls back, RadGrid will fire event. - - PerformUpdate Method - PerformDelete Method - the item to be inserted - True to prevent from binding after the insert operartion completes. - - - - Perform asynchronous delete operation, using the DataSourceControl API the Rebinds the grid. Please make sure you have specified the correct DataKeyNames for the GridTableView. - When the asynchronous operation calls back, RadGrid will fire event. - - DataKeyNames Property - PerformUpdate Method - PerformInsert Method - The item that should be deleted - - - - Perform delete operation, using the DataSourceControl API. Please make sure you have specified the correct DataKeyNames for the GridTableView. - - DataKeyNames Property - PerformUpdate Method - PerformInsert Method - The item that should be deleted - Set to true to stop error from binding - - - - Places the GridTableView in insert mode, allowing user to insert a new data-item - values. The will be set to display the last - page. You can use also the to place the - GridTableView in insert mode. - - - - - Places the GridTableView in insert mode, allowing the user to insert a new - data-item values. The GridInsertItem created will be bound to values of the - newDataItem object. The will be set to display - the last page. You can use also the property to - place the GridTableView in insert mode. - - - - - Places the GridTableView in insert mode, allowing the user to insert a new - data-item values. The GridInsertItem created will be bound to values found in - newValues dictionary; The will be set to - display the last page. You can use also the to - place the GridTableView in insert mode. - - - - Gets the ClientID of the RadGrid object that contains this instance. - - The string representation of the ClientID object that contains the - instance. - - OwnerGrid Property - - - - Gets or sets the ItemTemplate, which is rendered in the control in normal - (non-Edit) mode. - - A value of type System.Web.UI.CompiledBindableTemplateBuilder - - - - Gets or sets the EditItemTemplate, which is rendered in the control in edit - mode. - - A value of type System.Web.UI.CompiledBindableTemplateBuilder - - - - Gets or sets the ItemTemplate, which is rendered in the control in normal - (non-Edit) mode. - - A value of type System.Web.UI.CompiledBindableTemplateBuilder - - - - Gets or sets the collection of detail table views for this - GridTableView. - - - A collection of detail table views for this - GridTableView. - - DataKeyValues Property - DataKeyNames Property - - Adding or removing objects to the DetailTables collection changes - the hierarchical structure. - - Use after modifying the collection - programmatically. - - This collection can also be altered unsing the environment designer. - - - - - - Gets or sets a value that describes how RadGrid would respond - if the is invalid when data-binding. - - - - - This property is not persisted in the ViewState. By deafult the value is - . - - - GridResetPageIndexAction Enumeration - - A member of the GridResetPageIndexAction enumeration which - describes how RadGrid would respond if the - CurrentPageIndex is invalid when data-binding. By default its - value is - - - - - Gets or sets a value indicating whether the border lines for grid cells will be - displayed. - - - One of the - GridLines - values. The default is . - - - Use the GridLines property to specify the gridline style for - a GridTableView control. The following table lists the available - styles. - - - - Style - Description - - - GridLines.None - No gridlines are displayed. - - - GridLines.Horizontal - Displays the horizontal gridlines only. - - - GridLines.Vertical - Displays the vertical gridlines only. - - - GridLines.Both - Displays both the horizontal and vertical - gridlines. - - - - - CellPadding Property (Telerik.Web.UI.GridTableViewBase) - CellSpacing Property (Telerik.Web.UI.GridTableViewBase) - - The following code snippet demonstrates how to use the - GridLines property to hide the gridlines in a - GridTableView control. - [ASPX/ASCX] - <radG:RadGrid ID="RadGrid1" runat="server" - GridLines="None">
- </radGrid:RadGrid>
- - RadGrid1.GridLines = GridLines.None - - - RadGrid1.GridLines = GridLines.None; - -
- HorizontalAlign Property -
- - - Gets or sets a value indicating the horizontal alignment of the grid - table. - - - One of the - HorizontalAlign - values. The default is . - - - Use the HorizontalAlign property to specify the horizontal - alignment of a GridTableView control within the page. The - following table lists the different horizontal alignment styles. - - - - Alignment value - Description - - - HorizontalAlign.NotSet - The horizontal alignment of the GridTableView - control has not been set. - - - HorizontalAlign.Left - The GridTableView control is left-aligned on the - page. - - - HorizontalAlign.Center - The GridTableView control is centered on the - page. - - - HorizontalAlign.Right - The GridTableView control is right-aligned on the - page. - - - HorizontalAlign.Justify - The GridTableView control is aligned with both the - left and right margins of the page. - - - - - GridLines Property - - The following code snippet demonstrates how to use the - HorizontalAlign property to align a GridTableView - control on the right side of a page. - [ASPX/ASCX] - <radG:RadGrid ID="RadGrid1" runat="server" - HorizontalAlign="Right">
- </radG:RadGrid>
- - RadGrid1.HorizontalAlign = HorizontalAlign.Right - - - RadGrid1.HorizontalAlign = HorizontalAlign.Right; - -
-
- - - - Gets a collection of DataKeyValue objects that represent the - data key value of the corresponding item (specified with its - ) and the DataKeyName - (case-sensitive!). The DataKeyName should be one of the - specified in the array. - - - - - protected void RadGrid1_ItemUpdated(object source, Telerik.Web.UI.GridUpdatedEventArgs e) - { - if (e.Exception != null) - { - e.KeepInEditMode = true; - e.ExceptionHandled = true; - Response.Write("Employee " + e.Item.OwnerTableView.DataKeyValues[e.Item.ItemIndex]["EmployeeID"] + " cannot be updated. Reason: " + e.Exception.Message); - } - else - { - Response.Write("Employee " + e.Item.OwnerTableView.DataKeyValues[e.Item.ItemIndex]["EmployeeID"] + " updated"); - } - } - - - int eID = (int)tableView.DataKeyValues[editedItem.ItemIndex]["EmployeeID"]; - - - Dim eID as Integer = (CInt)tableView.DataKeyValues(editedItem.ItemIndex)("EmployeeID") - - - Protected Sub RadGrid1_ItemUpdated(ByVal source As Object, ByVal e As Telerik.Web.UI.GridUpdatedEventArgs) Handles RadGrid1.ItemUpdated - If Not e.Exception Is Nothing Then - e.KeepInEditMode = True - e.ExceptionHandled = True - Response.Write("Employee " + e.Item.OwnerTableView.DataKeyValues(e.Item.ItemIndex)("EmployeeID").ToString() + " cannot be updated. Reason: " + e.Exception.Message) - Else - Response.Write("Employee " + e.Item.OwnerTableView.DataKeyValues(e.Item.ItemIndex)("EmployeeID").ToString() + " updated") - End If - End Sub - - - data key name/value pair - - A - GridDataKeyArray that - contains the data key of each item in a GridTableView control. - - - When the - DataKeyNames - property is set, the GridTableView control automatically creates a - DataKeyValue object for each item in the control. The - DataKeyValue object contains the values of the field or fields - specified in the DataKeyNames property. The - DataKeyValue objects are then added to the control's - DataKeysValue collection. Use the DataKeysValue - property to retrieve the DataKeyValue object for a specific data item - in the GridTableView control. - - - - - - Gets or sets an array of data-field names that will be used to populate the - collection, when the - GridTableView - control is databinding. - - - - Use the DataKeyNames property to specify the field or fields - that represent the primary key of the data source. - Note: Values set to this property are case-sensitive! The - field names should be coma-separated. - - The data key names/values are stored in the ViewState so they - are available at any moment after grid have been data-bound, after postbacks, - etc. This collection is used when editing data, and for automatic relations - when binding an hiararchical grid (see - ). - - If the - Visible - property of a column field is set to false, the column is not displayed in the - GridTableView control and the data for the column does not make a - round trip to the client. If you want the data for a column that is not visible to - make a round trip, add the field name to the DataKeyNames - property. - - - An array that contains the names of the primary key fields for the items - displayed in a GridTableView control. - - - - - Gets or sets values indicating DataFieldNames that should be - sorted, grouped, etc and are not included as columns, in case the property - is false. - - DataKeyValues Property - DataKeyNames Property - - An array of DataFieldNames values that should be sorted, grouped, etc and are not - included as columns. - - RetrieveAllDataFields Property - - - - Gets or sets a value indicating whether RadGrid will show - instead of the corresponding - if there is no items to display. - - - true if usage is enabled; - otherwise, false. The default value is true. - - NoRecordsTemplate Property - NoMasterRecordsText Property - NoDetailRecordsText Property - - - - Gets or sets the template that will be displayed if a - GridTableView - control is bound to a data source that does not contain any records. - - - - You can set the text that will appear in the NoRecordsTemplate through - NoMasterRecordsText and - NoDetailRecordsText properties. - - By default if Items.Count equals 0, - GridTableView will render no records message. - If NoRecordsTemplate and - NoMasterRecordsText/NoDetailRecordsText are set, - the NoRecordsTemplate property has priority. - - - A - System.Web.UI.ITemplate - that contains the custom content for the empty data row. The default value is a - null reference (Nothing in Visual Basic), which indicates that - this property is not set. - - - The following example demonstrates how NoRecordsTemplate can - be implemented declaratively: - [ASPX/ASCX] - <radG:RadGrid ID="RadGrid1" runat="server">
- <MasterTableView>
- <NoRecordsTemplate>
- <div style="text-align: center; height: 300px">
- <asp:Label ForeColor="RoyalBlue" runat="server" ID="Label1">Currently there - are no items in this folder.</asp:Label>
- <br />
- </div>
- </NoRecordsTemplate>
- </MasterTableView>
- </radG:RadGrid>
- The following code snippet demonstrates how the NoRecordsTemplate can be - implemented dynamically: - - RadGrid1.MasterTableView.NoRecordsTemplate = New NoRecordsTemplate() - - Public Class NoRecordsTemplate - Implements ITemplate - - Public Sub New() - End Sub - - Public Sub InstantiateIn(ByVal container As System.Web.UI.Control) Implements System.Web.UI.ITemplate.InstantiateIn - Dim lbl As Label = New Label() - lbl.ID = "Label1" - lbl.Text = "Currently there are no items in this folder." - lbl.ForeColor = System.Drawing.Color.RoyalBlue - container.Controls.Add(lbl) - End Sub - End Class - - - RadGrid1.MasterTableView.NoRecordsTemplate = new NoRecordsTemplate(); - - class NoRecordsTemplate: ITemplate - { - public NoRecordsTemplate() - { - } - - public void InstantiateIn(Control container) - { - Label lbl = new Label(); - lbl.ID = "Label1"; - lbl.Text = "Currently there are no items in this folder."; - lbl.ForeColor = System.Drawing.Color.RoyalBlue; - container.Controls.Add(lbl); - } - } - -
- - The - - EnableNoRecordsTemplate Property should be set to true (its - default value) in order to be displayed the - NoRecordsTemplate. - - EnableNoRecordsTemplate Property - NoMasterRecordsText Property - NoDetailRecordsText Property -
- - - Gets or sets the text that will be displayed in there is no - defined and no records in the - MasterTableView. - - EnableNoRecordsTemplate Property - NoRecordsTemplate Property - NoDetailRecordsText Property - - The text to display in the empty data item. The default is an empty string ("") - which indicates that this property is not set. - - - The empty data row is displayed in a GridTableView control when - the data source that is bound to the control does not contain any records. Use the - NoMasterRecordsText and NoDetailRecordsText property - to specify the text to display in the empty data item. Alternatively, you can define - your own custom user interface (UI) for the empty data item by setting the - NoRecordsTemplate property instead of this property. - - - - - Gets or sets the text that will be displayed in there is no - defined and no records in the Detail tables. - - - The text to display in the empty data item. The default is an empty string (""), - which indicates that this property is not set. - - - The empty data row is displayed in a GridTableView control when - the data source that is bound to the control does not contain any records. Use the - NoMasterRecordsText and NoDetailRecordsText property - to specify the text to display in the empty data item. Alternatively, you can define - your own custom user interface (UI) for the empty data item by setting the - NoRecordsTemplate property instead of this property. - - EnableNoRecordsTemplate Property - NoRecordsTemplate Property - NoMasterRecordsText Property - - - - Gets or sets a value indicating whether the GridTableView - will extract all bindable properties from the DataSource when - binding, to perform operations like sorting, grouping, etc on DataFields that are - not included in the column declarations. - - - You can also use the array to indicate - RadGrid DataFieldNames that should be sorted, grouped, ect and are - not included as columns. - - - true, if the GridTableView will extract all - bindable properties from the DataSource when binding; otherwise, - false. The default value is true. - - AdditionalDataFieldNames Property - - - - Gets or sets a value indicating whether the GridTableView - should use all retieved properties from the DataSource when - binding, to perform operations like sorting, grouping, etc on DataFields that are - not included in the column declarations. - - - You can also use the array to indicate - RadGrid DataFieldNames that should be sorted, grouped, ect and are - not included as columns. - - - false, if the GridTableView will not use all - bindable properties from the DataSource when binding; otherwise, - true. The default value is false. - - AdditionalDataFieldNames Property - - - - Gets or sets a value indicating whether null values in the - database will be retrieved as dbnull values. - - - true if the null values in the database - will be retrieved as dbnull values; otherwise, - false. The default is false. - - - - - Gets or sets the collection of data-field pairs that describe the relations in a - hierarchical grid. - - - If you have specified the relations RadGrid will automatically - filter the child data-source when when binding detail-tables. The specified - in each - in this collection should be a Key that is - specified in the parent table's array. Each - DetailKeyField specfied should also be included in this - GridTableView's DataKeyNames array. - MasterTableView does not need any - ParentTableRelations. - - - A GridTableViewRelation collection of data-field pairs that - describe the relations in a hierarchical grid. - - GridTableViewRelation Class - DataKeyValues Property - DataKeyNames Property - Hierarchy online example - - - - Gets a set the options for GridTableView's self-hierarchy - behavior. - - GridSelfHierarchySettings Class - Options for GridTableView's self-hierarchy behavior. - Self-referencing hierarchy online example - - - Gets a set the options for GridTableView's command item. - The options for GridTableView's command item. - GridCommandItemSettings Class - CommandItemDisplay Property - - - - Gets or sets the object from which the data-bound control retrieves its list - of data items. - - - - Generally the DataSource object references - . Assign this property only if you need to - change the default behavior or . - - - RadGrid modifies this property when - is assigned. - - On postback the DataSource property settings are not - persisted due to performance reasons. Note, however, that you can save the grid - DataSource in a Session/Application/Cache - variable and then retrieve it from there after postback invocation. Respectively, - you can get the changes made in the data source in a dataset object and then - operate with them. - This property cannot be set by themes or style sheet themes. - - - An object that represents the data source from which the - GridTableView control retrieves its data. The default is a null - reference (Nothing in Visual Basic). - - DataSourceID Property - Simple data-binding online example - Various data sources online example - GridNeedDataSourceEventHandler Delegate - - - - Gets or sets the ID of the DataSource control used for - population of this GridTableView data items. - - - [ASPX/ASCX]
- <radG:RadGrid ID="RadGrid1" runat="server" - DataSourceID="SessionDataSource1">
- ............
- </radG:RadGrid>
-
- - The ID of a control that represents the data source from which the data-bound - control retrieves its data. The default is String.Empty (""). - - This property cannot be set by themes or style sheet themes. - DataSource Property - GridNeedDataSourceEventHandler Delegate -
- - - Gets a reference to a GridItem that is a parent of this - GridTableView, when this GridTableView represents a - child table in a hierarchical structure. - - A reference to the server control's parent control. - - Whenever a page is requested, a hierarchy of server controls on that page is - built. This property allows you to determine the parent control of the current server - control in that hierarchy, and to program against it. - - - Whenever a page is requested, a hierarchy of server controls on that page is - built. This property allows you to determine the parent control of the current server - control in that hierarchy, and to program against it. - - GridItem Class - - - Gets or sets the filtering options for grid columns. - - In the most common case, Telerik RadGrid checks all filtering options - for each column, then prepares a filter expression and sets this property internally. - Note: You should be careful when setting this property as it may - break the whole filtering functionality for your grid. - More info on the way, the expressions are created you can find - - here (external link to MSDN library). - - - - If (Not Page.IsPostBack) Then - RadGrid1.MasterTableView.FilterExpression = "([Country] LIKE '<see cref="Germany"/>') " - - Dim column As GridColumn = RadGrid1.MasterTableView.GetColumnSafe("Country") - column.CurrentFilterFunction = GridKnownFunction.Contains - column.CurrentFilterValue = "Germany" - End If - - - if (!Page.IsPostBack) - { - RadGrid1.MasterTableView.FilterExpression = "([Country] LIKE \'<see cref="Germany"/>\') "; - - GridColumn column = RadGrid1.MasterTableView.GetColumnSafe("Country"); - column.CurrentFilterFunction = GridKnownFunction.Contains; - column.CurrentFilterValue = "Germany"; - } - - - Applying default filter on initial load - - - - Gets or sets a value indicating whether the groups will be expanded on grid load - (true by default). - - - true, if the groups will be expanded on grid load; otherwise, - false. The default value is true. - - GroupLoadMode Property - GroupByExpressions Property - - - - Gets or sets a value indicating whether the hierarchy will be expanded by - default. - - - - - Gets a reference to the object, allowing - you to customize its settings. - - The property setter does nothing and should not be used. It works around a bug in the VS.NET designer. - - - - Gets a reference to the object, allowing - you to customize its settings. - - The property setter does nothing and should not be used. It works around a bug in the VS.NET designer. - - - - - Gets or sets a value indicating when the DataBind of the child - GridTableView will occur when working in hierarchy mode. - Accepts values from enumeration. See the - remars for details. - - - - Changing this propery value impacts the performance the following way: - - In ServerBind mode - Roundtrip to the database only when - grid is bound. ViewState holds all detail tables data. Only detail table-views - of the expanded items are rendered. Postback to the server to expand an - item - In ServerOnDemand mode - Roundtrip to the database when - grid is bound and when item is expanded. ViewState holds data for only visible - Items (smallest possible). Only detail table-views of the expanded items are - rendered. Postback to the server to expand an item. - In Client mode - Roundtrip to the database only when - grid is bound. ViewState holds all detail tables data. All items are rendered - - even is not visible (not expanded). NO postback to the server to expand an item - - expand/collapse of hierarchy items is managed client-side.
- Note: In order to use client-side hierarchy expand, you will - need to set also - - to true.
-
-
- The default value is ServerOnDemand. -
- - - Specifies where the grouping will be handled. There are two options: - - Server-side - GridTableView.GroupLoadMode.Server - Client-side - - GridTableView.GroupLoadMode.Client - - - GridTableView.GroupLoadMode.Server - This is the default behavior. Groups are expanded after postback to the server - for example: -
- - - -
-
-            							
-            <MasterTableView GroupLoadMode="Server">
-            							
-            						
-
- GridTableView.GroupLoadMode.Client
-
Groups will be - expanded client-side and no postback will be performed.
-
- - - -
-
-            								
-            <MasterTableView GroupLoadMode="Client">
-            								
-            							
- and set the client setting AllowGroupExpandCollapse to - true:
-
- - - -
-
-            								
-            <ClientSettings AllowGroupExpandCollapse="True">
-            								
-            							
-
-
- - - There are two possible values defined by the GridEditMode - enumeration: - - InPlace - EditForms - - To display the grid column editors inline when switching grid item in edit - mode (see the screenshot below), you simply need to change the - EditMode property to InPlace. -
- - - - - - -
-
-            							
-            <radg:RadGrid id="RadGrid1" runat="server">
<MasterTableView AutoGenerateColumns="True" EditMode="InPlace" />
</radg:RadGrid>
-
-
-
-
- A row in edit mode - To display the grid column editors in auto-generated form when switching grid - item in edit mode (see the screenshot below), you simply need to change the - MasterTableView EditMode property to - EditForms. -
- - - - - - -
-
-            							
-            <radg:RadGrid id="RadGrid1" runat="server">
<MasterTableView AutoGenerateColumns="True" EditMode="EditForms" />
</radg:RadGrid>
-
-
-
-
Edit in forms mode -
- - FormsGets or sets a value indicating how a GridItem will - look in edit mode. - - - A value indicating how a GridItem will look in edit mode. The - default is EditForms. - - GridEditMode Enumeration -
- - - Gets or sets the value indicating wheather more than one column can be sorted in a - single GridTableView. The order is the same as the sequence of - expressions in . - - - true, if more than one column can be sorted in a single - GridTableView; otherwise, false. The default value is - false. - - AllowSorting Property - SortExpressions Property - - - - Gets or sets the value indicated whether the no-sort state when changing sort - order will be allowed. - - - true, if the no-sort state when changing sort order will be - allowed; otherwise, false. The default value is - true. - - SortExpressions Property - AllowSorting Property - - - - Gets or sets a value indicating whether the sorting feature is - enabled. - - - - true if the sorting feature is enabled; otherwise, - false. The default is . - - - SortExpressions Property - AllowCustomSorting Property - AllowMultiColumnSorting Property - - When a data source control that supports sorting is bound to the - GridTableView - control, the GridTableView control can take advantage of the data - source control's capabilities and provide automatic sorting functionality. - To enable sorting, set the AllowSorting property to - true. When sorting is enabled, the heading text for each column - field with its - SortExpressions - property set is displayed as a link button. - Clicking the link button for a column causes the items in the - GridTableView control to be sorted based on the sort expression. - Typically, the sort expression is simply the name of the field displayed in the - column, which causes the GridTableView control to sort with - respect to that column. To sort by multiple fields, use a sort expression that - contains a comma-separated list of field names. You can determine the sort - expression that the GridTableView control is applying by using the - SortExpressions property. Clicking a column's link button repeatedly toggles the - sort direction between ascending and descending order. - Note that if you want to sort the grid by a column different - than a GridBoundColumn, you should set also its - SortExpression - property to the desired data field name you want the column to be sorted by. - - - Different data sources have different requirements for enabling their sorting - capabilities. To determine the requirements, see the documentation for the specific - data source. - The SortExpression property for an automatically generated - columns field is automatically populated. If you define your own columns through - the Columns - collection, you must set the SortExpression property for each - column; otherwise, the column will not display the link button in the - header. - - AllowNaturalSort Property - SortExpressions Property - - - - Gets or sets a value indicating whether the filtering by column feature is - enabled. - - - - true if the filtering by column feature is enabled; otherwise, - false. Default value is the value of - . - - - - - When the value is true, GridTableView will display the - filtering item, under the table's header item. The filtering can be controlled - based on a column through column properties: - , - , - . The column - method is used to determine if - a column can be used with filtering. Generally, this function returns the value - set to AllowFiltering for a specific column. For example - will return the values of - property. - - - GridFilteringItem Class - Basic filtering online example - - - - Gets or sets a value indicating whether the header context menu should be - enabled. - - - - true if the header context menu feature is enabled; otherwise, - false. Default value is the value of - . - - - - - - Gets or sets a value indicating whether Telerik RadGrid will - automatically generate columns at runtime based on its - DataSource. - - - - A value indicating whether Telerik RadGrid will automatically - generate columns at runtime based on its DataSource. The - default value is the value of RadGrid's property - . - - - AutoGeneratedColumns Property - - - For internal usage. - - - - - - - Gets all items among the hierarchy of - GridTableView - items that are selected. The selected items in a GridTableView - are cleared when collapses and the - ParentItem becomes selected. - - - - A GridItemCollection of items among the hierarchy of - GridTableView items that are selected. - - GridItemCollection Class - - - - - Gets all items among the hierarchy of - GridTableView - items that are in edit mode. The edit items in a GridTableView - are cleared when collapses. - - - A GridItemCollection of items that are in edit mode. - GridItemCollection Class - EditMode Property - EditFormSettings Property - - - - Gets or sets a value indicating whether all columns settings will be persisted in - the ViewState or not. - - - true if columns are kept in the view state; otherwise - false. The default value is true. - - - Set this property to false if you need to change dynamically the - structure of the RadGrid. - - - - Gets or sets if the custom sorting feature is enabled. - - With custom sorting turned on, RadGrid will display as Sorting Icons, will maintain - the SortExpressions collection and so on, but it will not actually sort the Data. - You should perform the custom sorting in the SortCommand event handler. You can - also use the method, - which will return the sort expressions string in the same format as it wold be used - by a DataView component. - - - true, if custom sorting feature is enabled; otherwise, - false. The default value is false. - - AllowSorting Property - SortExpressions Property - GridSortCommandEventHandler Delegate - - - Gets or sets if the custom paging feature is enabled. - - true, if the custom paging feature is enabled; otherwise, - false. Default value is the value of - . - - AllowPaging Property - Custom paging online example - - There are cases in which you may want to fetch only a fixed number of records and - perform operations over this specified set of data. Telerik RadGrid allows such - data manipulation through the custom paging mechanism integrated in the control. - The main steps you need to undertake are: - - Set AllowPaging = true and AllowCustomPaging = true for - your grid instance - Implement code logic which to extract merely a fixed number of records - from the grid source and present them in the grid structure - The total number of records in the grid source should be defined through - the VirtualItemCount property of the MasterTableView/GridTableView - instance. Thus the grid "understands" that the data source contains the - specified number of records and it should fetch merely part of them at a time - to execute requested operation. - Another available option for custom paging support is through the - ObjectDataSource control custom paging feature:
- - Custom paging with ObjectDataSource grid content generator -
-
- - Gets or sets a value indicating whether the paging feature is enabled. - - - true if the paging feature is enabled; otherwise, - false. The default is . - - - PageCount Property - PageSize Property - PagingManager Property - PagerStyle Property - RenderPagerStyle Property - PagerTemplate Property - CurrentPageIndex Property - CurrentResetPageIndexAction Property - - Instead of displaying all the records in the data source at the same time, - the GridTableView - control can automatically break the records up into pages. If the data source - supports the paging capability, the GridTableView control can take - advantage of that and provide built-in paging functionality. The paging feature can - be used with any data source object that supports the - System.Collections.ICollection interface or a data source that supports - paging capability. - To enable the paging feature, set the AllowPaging property - to true. By default, the GridTableView control - displays 10 records on a page at a time. You can change the number of records - displayed on a page by setting the - PageSize - property. To determine the total number of pages required to display the data - source contents, use the - PageCount - property. You can determine the index of the currently displayed page by using the - CurrentPageIndex - property. - When paging is enabled, an additional row called the pager item is - automatically displayed in the GridTableView control. The pager - row contains controls that allow the user to navigate to the other pages. You can - control the settings of the pager row (such as the pager display mode, the number - of page links to display at a time, and the pager control's text labels) by using - the - PagerStyle - properties. The pager row can be displayed at the top, bottom, or both the top and - bottom of the control by setting the - Position - property. You can also select from one of six built-in pager display modes by - setting the Mode - property. - The GridTableView control also allows you to define a custom - template for the pager row. For more information on creating a custom pager row - template, see - PagerTemplate. - The GridTableView control provides an event that you can use - to perform a custom action when paging occurs. - - - - Event - Description - - - - - - Occurs when one of the pager buttons is clicked, but after - the GridTableView control handles the paging operation. This - event is commonly used when you need to perform a task after the user - navigates to a different page in the control. - - - - - - - Gets or sets a value indicating whether Telerik RadGrid should retrieve all data and ignore server paging in case of filtering or grouping. - - - true (default) if the retrieve all data feature is enabled; otherwise, - false. - - - - - - - Specify the maximum number of items that would appear in a page, when paging is - enabled by or - property. Default value is the value of - . - - - The number of records to display on a single page. The default is 10. - The PageSize property is set to a value less than 1. - - When the paging feature is enabled (by setting the - AllowPaging - property to true), use the PageSize property to specify the number of - records to display on a single page. - - The number of records to display on a single page. The default is 10. - - - - Gets or sets a value indicating whether Telerik RadGrid will perform - automatic updates, i.e. using the DataSource controls - functionality. - - - true, if Telerik RadGrid will perform automatic - updates; otherwise, false. The default value is - false. - - Automatic operations online example - - - - Gets or sets a value indicating whether Telerik RadGrid will perform - automatic inserts, i.e. using the DataSource controls - functionality. - - - true, if the Telerik RadGrid will perform automatic - inserts; otherwise, false. The default value is - false. - - Automatic operations online example - - - - Gets or sets a value indicating whether Telerik RadGrid will perform - automatic deletes, i.e. using the DataSource controls - functionality. - - - true, if Telerik RadGrid will perform automatic - deletes; otherwise, false. The default value is - false. - - Automatic operations online example - - - - Gets a collection of - GridColumn objects - that represent the column fields in a - GridTableView - control. - - - A - GridColumnCollection - that contains all the column fields in the GridTableView - control. - - - A column field represents a column in a GridTableView - control. The Columns property (collection) is used to store all - the explicitly declared column fields that get rendered in the GridTableView - control. You can also use the Columns collection to - programmatically manage the collection of column fields. - The column fields are displayed in the GridTableView control - in the order that the column fields appear in the Columns - collection. - - To get a list of all columns rendered in the current instance use - - - Although you can programmatically add column fields to the - Columns collection, it is easier to list the column fields - declaratively in the GridTableView control and then use the - Visible - property of each column field to show or hide each column field. - If the Visible property of a column field is set to false, - the column is not displayed in the GridTableView control and the - data for the column does not make a round trip to the client. If you want the data - for a column that is not visible to make a round trip, add the field name to the - DataKeyNames - property. - This property can be managed programmatically or by Property Builder (IDE - designer). - - - Explicitly declared column fields can be used in combination with automatically - generated column fields. When both are used, explicitly declared column fields are - rendered first, followed by the automatically generated column fields. Automatically - generated column fields are not added to the Columns - collection. - - GridColumnCollection Class - GridColumn Class - Column types online example - - - - Gets the number of pages required to display the records of the data source - in a GridTableView - control. - - The number of pages in a GridTableView control. - - When the paging feature is enabled (by setting the - AllowPaging - Property to true), use the PageCount property to - determine the total number of pages required to display the records in the data source. - This value is calculated by dividing the total number of records in the data source by - the number of records displayed in a page (as specified by the - PageSize - property) and rounding up. - - AllowPaging Property - AllowCustomPaging Property - PageSize Property - PagingManager Property - PagerStyle Property - PagerTemplate Property - - - Gets the number of pages if paging is enabled. - The number of pages if paging is enabled. - AllowPaging Property - AllowCustomPaging Property - - - - Gets a DataView object that represents the data sent to the - to be displayed. - - A result DataView object of all grid operations. - - ResolvedDataSourceView is available only in event - handler i.e. when the grid is bound. - - - - - Gets a Paging object that is the result of paging settings and runtime paging - state of the grid. - - - A - GridPagingManager - object that corresponds to the Paging object. - - - Note that changes made to this object would not have - effect on the structure of the grid. - - AllowPaging Property - PageSize Property - PageCount Property - - - - Gets a collection of sort expressions for this table view instance, associated - with the column or columns being sorted. - - - - Modifying the SortExpressions collection will result in change - of the order of appearance of items in the table view. If - is set to false this collection can - only contain one item. Adding other in - the collection in this case will cause existing expression to be deleted or if - GridSortExpression with the same same - exist its - will be changed. - - This property's value is preserved in the ViewState. - - GridSortExpressionCollection Class - AllowSorting Property - AllowCustomSorting Property - AllowMultiColumnSorting Property - - The collection of sort expressions associated with the column or columns being - sorted. - - Advanced sorting online example - - - - Adding to this collection will cause the - current table-view to display items sorted and devided in groups separated by - s, that display common group and aggregate - field values. See on details of - expressions syntax. - - - Note that the correctness of the expressions in the collection is - checked when DataBind occures. Then if an expression in not correct or a - combination of expressions is erroneous a - would be thrown on . This property's value is preserved - in the ViewState. - - - A GroupByExpressionCollection of values that will cause the current table-view to - display items sorted and devided in groups separated by - GridGroupHeaderItems, that display common group and aggregate field - values. - - Group-By expressions online example - - - - - - - - Get an array of automatically generated columns. This array is available when - is set to true. Autogenerated - columns appear always after when rendering. - - An array of automatically generated columns. - - - - Gets a value defining the setting that will be applied when an Item is in edit - mode and the property is set to - EditForms. - - - [ASPX/ASCX] - <MasterTableView>
- <EditFormSettings - CaptionFormatString='<img src="img/editRowBg.gif" alt="" - />
'>
- <FormMainTableStyle GridLines="None" - CellSpacing="0" - CellPadding="3" - Width="100%" - CssClass="none"/>
- <FormTableStyle CssClass="EditRow" - CellSpacing="0" - BorderColor="#c4c0b5" - CellPadding="2" - Width="100%"/>
- <FormStyle Width="100%" - BackColor="#ffffe1"
></FormStyle>
- </EditFormSettings>
-
- GridEditFormSettings Class -
- - - Gets or sets a string that specifies a brief description of a - GridTableView. - Related to Telerik RadGrid accessibility compliance. - - - A string that represents the text to render in an HTML caption element in a - GridTableView control. The default value is an empty string - (""). - - - Use the Caption property to specify the text to render in an - HTML caption element in a GridTableView control. The text that you - specify provides assistive technology devices with a description of the table that - can be used to make the control more accessible. - - Summary Property - -
-            The following example demonstrates how to style the Caption of a MasterTableView and detail GridTableView.
-            
-
-            <head runat="server">
<title>Untitled Page</title>
<style type="text/css">
- .MasterTable_Default caption
{
color: red;
} -
-
-            		.DetailTable_Default caption
{
color: blue;
}
-
</style>
</head>
<body>
<form id="form1" runat="server">
<div>
<radG:RadGrid runat="server" ID="RadGrid1" DataSourceID="SqlDataSource1" AllowPaging="true"
AllowMultiRowEdit="true" OnItemCommand="RadGrid1_ItemCommand" >
<MasterTableView EditMode="EditForms" DataKeyNames="CustomerID" Caption="Master Caption" CommandItemDisplay="Top">
- <Columns>
<radG:GridEditCommandColumn>
</radG:GridEditCommandColumn>
</Columns>
<DetailTables>
<radG:GridTableView DataKeyNames="OrderID" DataSourceID="SqlDataSource2" Caption="Detail Caption" CssClass="DetailTable_Default">
<ParentTableRelation>
<radG:GridRelationFields DetailKeyField="CustomerID" MasterKeyField="CustomerID" />
</ParentTableRelation>
</radG:GridTableView>
</DetailTables>
</MasterTableView>
</radG:RadGrid>
<asp:SqlDataSource ID="SqlDataSource1" runat="server" ConnectionString="</%$ ConnectionStrings:NorthwindConnectionString2/%>"
SelectCommand="SELECT [CustomerID], [CompanyName], [ContactName], [ContactTitle] FROM [Customers]">
</asp:SqlDataSource>
<asp:SqlDataSource ID="SqlDataSource2" runat="server" ConnectionString="</%$ ConnectionStrings:NorthwindConnectionString2/%>"
SelectCommand="SELECT [OrderID], [CustomerID], [ShipCountry] FROM [Orders] WHERE ([CustomerID] = @CustomerID)">
<SelectParameters>
<asp:Parameter Name="CustomerID" Type="String" />
</SelectParameters>
</asp:SqlDataSource>
</div>
</form>
</body> -
-
-
- - Gets or sets the 'summary' attribute for the respective table. - - This attribute provides a summary of the table's purpose and structure for user - agents rendering to non-visual media such as speech and Braille. This property is a - part of Telerik RadGrid accessibility features. - - - A string representation of the 'summary' attribute for the respective - table. - - Caption Property - - - - Gets or sets the text direction. This property is related to Telerik RadGrid support - for Right-To-Left lanugages. It has two possible vales defined by - enumeration: - - LTR - left-to-right text - RTL - right-to-left text - - - - - The frame attribute for a table specifies which sides of the frame surrounding - the table will be visible. Possible values: - - void: No sides. This is the default - value. - above: The top side only. - below: The bottom side only. - hsides: The top and bottom sides only. - vsides: The right and left sides only. - lhs: The left-hand side only. - rhs: The right-hand side only. - box: All four sides. - border: All four sides - - Gets or sets a value specifying the frame table attribute. - - A - GridTableFrame value, - specifying the frame table attribute. - - GridTableFrame Enumeration - - - GridTableLayout Enumeration - - - A - GridTableLayout - value, indicating the table layout type. The default value is - . - - - Gets or sets a string that indicates whether the table layout is fixed. - - - The value of the TableLayout property is a string that - specifies or receives one of the following GridTableLayout - enumeration values: - - - Auto - Column width is set by the widest unbreakable content in - the column cells. - - - Fixed - - Default. Table and column widths are set either by the sum of the - widths on the objects or, if these are - not specified, by the width of the first row of cells. If no width - is specified for the table, it renders by default with width=100%. - - - - - - - - - Gets a reference to the - GridTableItemStyle - object that allows you to set the appearance of items in a - GridTableView - control. - - - A reference to the GridTableItemStyle that represents the style of - data items in a GridTableView control. If style is not altered (is - default) is used. - - AlternatingItemStyle Property - CommandItemStyle Property - FooterStyle Property - HeaderStyle Property - SelectedItemStyle Property - - - Gets the rendering style of an Item. - - A reference to the GridTableItemStyle that represents the - rendering style of the item. If is not specified the - return value is OwnerGrid.. - - GridTableItemStyle Class - - - Manage visual style of the group header items. - - A reference to the GridTableItemStyle that represents the style of - the group header items. If style is not altered (is default) - is used. - - GridTableItemStyle Class - - - Gets the rendering style of the group header items. - - A reference to the GridTableItemStyle that represents the - rendering style of the group header items. If - is not specified the return value is - OwnerGrid.. - - GridTableItemStyle Class - - - - Gets a reference to the - GridTableItemStyle - object that allows you to set the appearance of alternating items in a - GridTableView - control. - - - A reference to the GridTableItemStyle that represents the style of - alternating data items in a GridTableView control. If style is not - altered (is default) is used. - - - Use the AlternatingItemStyle property to control the - appearance of alternating items in a GridTableView control. When - this property is set, the items are displayed alternating between the - ItemStyle - settings and the AlternatingItemStyle settings. This property is - read-only; however, you can set the properties of the - GridTableItemStyle object it returns. The properties can be set - declaratively using one of the following methods: - - Place an attribute in the opening tag of the - GridTableView control in the form - Property-Subproperty, where Subproperty is a - property of the GridTableItemStyle object (for example, - AlternatingItemStyle-ForeColor). - Nest an <AlternatingItemStyle> element between the opening and - closing tags of the GridTableView control. - - The properties can also be set programmatically in the form - Property.Subproperty (for example, - AlternatingItemStyle.ForeColor). Common settings usually include a custom - background color, foreground color, and font properties. - - GridTableItemStyle Class - - - Gets the rendering style of the AlternatingItem. - GridTableItemStyle Class - - A reference to the GridTableItemStyle that represents the - rendering style of the AlternatingItem. If - is not specified the return value is - OwnerGrid.. - - - - - Gets a reference to the - GridTableItemStyle - object that allows you to set the appearance of the item selected for editing in a - GridTableView - control. - - - - A reference to the GridTableItemStyle that represents the - style of the row being edited in a GridTableView control. If style is not - altered (is default) is used. - - - - Use the EditItemStyle property to control the appearance of - the item in edit mode. This property is read-only; however, you can set the - properties of the GridTableItemStyle object it returns. The - properties can be set declaratively using one of the following methods: - - Place an attribute in the opening tag of the - GridTableView control in the form - Property-Subproperty, where Subproperty is a - property of the GridTableItemStyle object (for example, - EditItemStyle-ForeColor). - Nest an <EditItemStyle> element between the - opening and closing tags of the GridTableView control. - - The properties can also be set programmatically in the form - Property.Subproperty (for example, - EditItemStyle.ForeColor). Common settings usually include a custom - background color, foreground color, and font properties. - - ItemStyle Property - GroupHeaderItemStyle Property - AlternatingItemStyle Property - PagerStyle Property - HeaderStyle Property - FilterItemStyle Property - CommandItemStyle Property - FooterStyle Property - SelectedItemStyle Property - GridTableItemStyle Class - - - Gets the rendering style of an edit Item. - - A reference to the GridTableItemStyle that represents the - rendering style of an edit item. If is not - specified the return value is OwnerGrid.. - - GridTableItemStyle Class - - - - Gets a reference to the - GridPagerStyle object - that allows you to set the appearance of the pager item in a - GridTableView - control. - - - A reference to the GridPagerStyle that represents the style of the - pager item in a GridTableView control. If style is not altered (is - default) is used. - - - Use the PagerStyle property to control the appearance of the - pager item in a GridTableView control. The pager item is displayed - when the paging feature is enabled (by setting the AllowPaging - property to true) and contains the controls that allow the user to - navigate to the different pages in the control. This property is read-only; - however, you can set the properties of the GridPagerStyle object it returns. The - properties can be set declaratively using one of the following methods: - - Place an attribute in the opening tag of the - GridTableView control in the form - Property-Subproperty, where Subproperty is a - property of the GridPagerStyle object (for example, - PagerStyle-ForeColor). - Nest a <PagerStyle> element between the opening - and closing tags of the GridTableView control. - - The properties can also be set programmatically in the form - Property.Subproperty (for example, - PagerStyle.ForeColor). Common settings usually include a custom - background color, foreground color, and font properties. - - ItemStyle Property - AlternatingItemStyle Property - HeaderStyle Property - FooterStyle Property - SelectedItemStyle Property - GridTableItemStyle Class - Styling Header, Footer and Pager items online example - - - Gets the rendering style of the Pager item. - - A reference to the GridTableItemStyle that represents the rendering style of the - pager item. If is not specified the return value is - OwnerGrid.. - - GridTableItemStyle Class - - - - Gets a reference to the - GridTableItemStyle - object that allows you to set the appearance of the header item in a - GridTableView - control. - - - - A reference to the GridTableItemStyle that represents the - style of the header row in a GridTableView control. If style - is not altered (is default) is used. - - - - Use the HeaderStyle property to control the appearance of - the header item in a GridTableView control. This property is - read-only; however, you can set the properties of the - GridTableItemStyle object it returns. The properties can be set - declaratively using one of the following methods: - - Place an attribute in the opening tag of the - GridTableView control in the form - Property-Subproperty, where Subproperty is a - property of the GridTableItemStyle object (for example, - HeaderStyle-ForeColor). - Nest a <HeaderStyle> element between the opening - and closing tags of the GridTableView control. - - The properties can also be set programmatically in the form - Property.Subproperty (for example, - HeaderStyle.ForeColor). Common settings usually include a custom - background color, foreground color, and font properties. - - ItemStyle Property - AlternatingItemStyle Property - EditItemStyle Property - FooterStyle Property - SelectedItemStyle Property - GridTableItemStyle Class - Styling Header, Footer and Pager items online example - - - Gets the rendering style of a GridHeaderItem. - - A reference to the GridTableItemStyle that represents the rendering style of the - GridHeaderItem. If is not specified the return value - is OwnerGrid.. - - GridTableItemStyle Class - - - - Gets a reference to the - GridTableItemStyle - object that allows you to set the appearance of the filter item in a - GridTableView - control. - - - A reference to the GridTableItemStyle that represents the style - of the filter item. - - GridTableItemStyle Class - - - Gets the rendering style of a FilterItem. - - A reference to the GridTableItemStyle that represents the - rendering style of a FilterItem. If is not - specified the return value is OwnerGrid. - - GridTableItemStyle Class - - - - Gets a referenct to the - GridTableItemStyle - object that allows you to set the appearance of the command item in a - GridTableView - control. - - - A reference to the GridTableItemStyle that represents the style - of the command item. - - GridTableItemStyle Class - - - Gets the rendering style of a CommandItem. - - A reference to the GridTableItemStyle that represents the - rendering style of a CommandItem. If is not - specified the return value is - OwnerGrid.. - - GridTableItemStyle Class - - - Gets the rendering style of an ActiveItem. - - A reference to the GridTableItemStyle that represents the - rendering style of an ActiveItem. - - GridTableItemStyle Class - - - Manage visual style of the footer item. - - A reference to the GridTableItemStyle that represents the style of - the footer item. If style is not altered (is default) - is used. - - GridTableItemStyle Class - Styling Header, Footer and Pager items online example - - - Gets the rendering style of an FooterItem. - - A reference to the GridTableItemStyle that represents the - rendering style of an FooterItem. If is not - specified the return value is OwnerGrid.. - - GridTableItemStyle Class - - - - Gets a reference to the - Style object that allows you to set the appearance of the selected item - in a GridTableView - control. - - - - A reference to the Style object that represents the style of - the selected item in a GridTableView control. If style is not - altered (is default) is used. - - - - Use the SelectedItemStyle property to control the appearance - of the selected item in a GridTableView control. This property is read-only; - however, you can set the properties of the Style object it - returns. The properties can be set declaratively using one of the following - methods: - - Place an attribute in the opening tag of the - GridTableView control in the form - Property-Subproperty, where Subproperty is a - property of the Style object (for example, - SelectedItemStyle-ForeColor). - Nest a <SelectedRowStyle> element between the - opening and closing tags of the GridTableView control. - - The properties can also be set programmatically in the form - Property.Subproperty (for example, - SelectedItemStyle.ForeColor). Common settings usually include a - custom background color, foreground color, and font properties. - - - The following code example demonstrates how to use the - SelectedItemStyle property to define a custom style for the - selected item in a GridTableView control. - [ASPX/ASCX] - <radG:RadGrid ID="RadGrid1" runat="server">
- ..........
- <SelectedItemStyle BackColor="#FFE0C0" />
- </radG:RadGrid>
- - RadGrid1.SelectedItemStyle.BackColor = System.Drawing.Color.Azure - - - RadGrid1.SelectedItemStyle.BackColor = System.Drawing.Color.Azure; - -
- ItemStyle Property - AlternatingItemStyle Property -
- - - Gets or sets the name of the - GridTableView. - - - The string representation of the Name of the GridTableView it is - assigned to. The default is String.Empty (""). - - - The Name property can be used distinguish different - GridTableView instances. Often used to set different settings for - different views conditionally. - - - The following example demonstrates different action on - [ASPX/ASCX]<script type="text/javascript" >
- function OnRowDblClick(index)
- {
- if(this.Name == "MasterTableView")
- {
- alert("Cliecked row with index " + index + " of the MasterTableView");
- }
- if(this.Name == "DetailTableView1")
- {
- alert("Clicked row with index " + index + " of the first detail table");
- }
- if(this.Name == "DetailTableView2")
- {
- alert("Clicked row with index " + index + " of the second detail table");
- }
- }
- </script>
-
- <radG:RadGrid ID="RadGrid1" runat="server" >
- <MasterTableView Name="MasterTableView">
- <DetailTables>
- <radG:GridTableView Name="DetailTableView1" >
- </radG:GridTableView>
- <radG:GridTableView Name="DetailTableView2">
- </radG:GridTableView>
- </DetailTables>
- </MasterTableView>
- <ClientSettings>
- <ClientEvents OnRowDblClick="OnRowDblClick"></ClientEvents>
- </ClientSettings>
- </radG:RadGrid> -
-
- - - Gets or sets a value indicating if the will be - shown in the current GridTableView. - - - true, if the GridHeaderItem will be shown in - the current GridTableView; otherwise, false. The - default value is true. - - ShowFooter Property - - - - Gets or sets a value indicating if the will be - shown in the current GridTableView. - - - true, if the GridGroupFooterItem will be shown in - the current GridTableView; otherwise, false. The - default value is true. - - ShowFooter Property - - - - Gets or sets a value indicating if the will be - shown in the current GridTableView. - - - true, if the GridFooterItem will be shown in - the current GridTableView; otherwise, false. The - default value is false. - - ShowHeader Property - - - - Gets an array of all columns that are used when rendering the grid - instance. - - An array of all columns that are used when rendering the grid instance. - - Modifying the array would not affect rendering as it is regenerated before - each data-bind. To modify the list of columns available use - property. - - Columns Property - - - - - Gets a collection of all data items of a grid table view and items that belong - to child tables of the GridTableView if the hierarchy is - expanded. The items are collected depth-first. The property - actually referres to - ItemsHierarchy of
- . This property can be used to - traverse all
- DataItems items in the hiearchy of a GridTableView. -
-
- - A GridDataItemCollection of all data items of a grid table view - and items that belong to child tables of the GridTableView if the - hierarchy is expanded. - - GridDataItem Class -
- - - Gets a collection of GridDataItem objects that represent the data items in a - GridDataItem - control. - - - The Items property (collection) is used to store the data items - in a GridTableView control. The GridTableView control - automatically populates the Items collection by creating a - GridDataItem object for each record in the data source and then adding - each object to the collection. This property is commonly used to access a specific item - in the control or to iterate though the entire collection of items. - - - A GridDataItemCollection that contains all the data items in a - GridTableView control - - GridDataItem Class - - - AllowCustomPaging Property - - - - - Gets or sets a value indicating the index of the currently active page in case - paging is enabled ( is - true). - - The index of the currently active page in case paging is enabled. - AllowCustomPaging Property - AllowPaging Property - - - - If set to true (the default) - GridNoRecordsItem - is used to display no records template. This item is the only one displayed in the - GridTableView in this case. - - NoRecordsTemplate Property - - - - Gets a value indicating if the GridTableView instance has - children (Detail) tables. - - - true, if the GridTableView instance has - children (Detail) tables; otherwise, false. - - DetailTables Property - - - - Gets or sets the programmatic identifier assigned to the current - GridTableView. - - - This property is set automatically by RadGrid object that - owns this instance. - - The programmatic identifier assigned to the control. - - Only combinations of alphanumeric characters and the underscore character ( _ ) - are valid values for this property. Including spaces or other invalid characters will - cause an ASP.NET page parser error. - - OwnerID Property - - - - Gets or sets a value indicating whether RadGrid will be built on - PreRender unless it was built before that. This property is supposed for - Telerik RadGrid internal usage, yet you can set it with care. - - - true, if the RadGrid will be built on - PreRender; otherwise, false. - - - - - The unique hierarchy index of the current table view, generated when it is - binding. - - The hierarchy index of the current table view. - - - - Indicates whether the items have been created, generally by data-binding. - - - true, if the items have beed created; otherwise, - false. - - - - - This property is used internally by RadGrid and it is not - intended to be used directly from your code. - - - - - - - Gets or sets the custom content for the pager item in a - GridTableView - control. - - - A - System.Web.UI.ITemplate - that contains the custom content for the pager item. The default value is null, which - indicates that this property is not set. - - - If this template is set, RadGrid will not create the default - pager controls. - - AllowPaging Property - PagingManager Property - - - - Gets or sets the template that will be instantiated in the CommandItem. If - this template is set, RadGrid will not create the default - CommandItem controls. - - - A - System.Web.UI.ITemplate - object that contains the custom content for the pager item. The default value is null, - which indicates that this property is not set. - - GridCommandItem Class - CommandItemSettings Property - - - - Gets or sets a value indicating if the GridTableView is - currently in insert mode. - - - true, if the GridTableView is currently in - insert mode; otherwise, false. - - - The ItemInserted property indicates if the GridTableView is - currently in insert mode. After setting it you should call the - method. You can also use the - method, that will also reposition the grid to show - the last page, where the newly inserted item is generally displayed. - - - - - Gets or sets a value indicating if the GridTableView should override the - default DataSourceControl sorting with grid native sorting. - - - You can set this to true in case of ObjectDataSource with IEnumerable data without implemented sorting. - - - - - Gets or sets the default position of the GridCommandItem as defined by the - . The possible values are: - - None - this is the default value - the command item will not be rendered - Top - the command item will be rendered on the top of the grid - Bottom - the command item will be rendered on the bottom of the grid - TopAndBottom - the command item will be rendered both on top and bottom of the - grid. - - - A - GridCommandItemDisplay - proprty which define the default position of the - GridCommandItem. - - GridCommandItemDisplay Enumeration - - - - Stores a custom PageSize value if such is set when page mode is NextPrevAndNumeric - - - - - corresponding fields from a master-detail relation - - - - - - A collection that stores objects. - - - - - - - - Initializes a new instance of . - - - - - - - Initializes a new instance of based on another . - - - - A from which the contents are copied - - - - - - Initializes a new instance of containing any array of objects. - - - - A array of objects with which to intialize the collection - - - - - Adds a with the specified value to the - . - - The to add. - - The index at which the new element was inserted. - - - - - - Copies the elements of an array to the end of the . - - - An array of type containing the objects to add to the collection. - - - None. - - - - - - - Adds the contents of another to the end of the collection. - - - - A containing the objects to add to the collection. - - - None. - - - - - - Gets a value indicating whether the - contains the specified . - - The to locate. - - if the is contained in the collection; - otherwise, . - - - - - - Copies the values to a one-dimensional instance at the - specified index. - - The one-dimensional that is the destination of the values copied from . - The index in where copying begins. - - None. - - is multidimensional. -or- The number of elements in the is greater than the available space between and the end of . - is . - is less than 's lowbound. - - - - - Returns the index of a in - the . - - The to locate. - - The index of the of in the - , if found; otherwise, -1. - - - - - - Inserts a into the at the specified index. - - The zero-based index where should be inserted. - The to insert. - None. - - - - - Returns an enumerator that can iterate through - the . - - None. - - - - - Removes a specific from the - . - - The to remove from the . - None. - is not found in the Collection. - - - - Represents the entry at the specified index of the . - - The zero-based index of the entry to locate in the collection. - - The entry at the specified index of the collection. - - is outside the valid range of indexes for the collection. - - - - Container of misc. grouping settings of RadGrid control - - - - - Expression similar to SQL's "Select Group By" clause that is used by - GridTableView to group items - (. Expressions can be defined by - assigning Expression property and/or managing the - items in or - collections. - - - If you use property to assign - group by expression as string then the expression is parsed and - and - are created. If the - expression syntax is incorrect a would be - thrown. You can use 's properties to set - expression's fields appearance format strings, etc. See - property for details about the expression syntax. - - - - Constructs a new GroupByExpression from a grid GridColumn. - - If the column does not have a valid string assigned this - constructor will throw . Column should be - The following properties will be copied from the corresponding column's properties: - - - Column's data-format-string depending on the type of the column. For example - will be copied to - . - - Column's will be copied to - - - - - the column (and its DataField respectively) that will be used - for grouping Telerik RadGrid - - - - Calls GridGroupByExpression(expression) - - - The same as the property - the string representation of the expression. - - - - Compares the current expression against the expression set as parameter and check - if both expressions contain field with the same name. - - - true if both expressions contain field with the same name, - otherwise false. - - expression to check against this expression - - - Checks if the given expression contains same Group-By field as this one. - - true if the expression already contains this GroupByField, otherwise - false. - - - Use this function to determine if two expressions seem to produce the same set of results - - Expression to check - - - - Gets a collection of SelectField objects (field names, aggregates etc.) that form - the "Select" clause. Standing on the left side of the "Group By" clause. - - - - - Gets a collection of objects that form the grouping - clause. Standing on the right side of the "Group By" clause - - - - String representation of the GroupBy expression. - - Expression syntax: - fieldname[ alias]|aggregate(fieldname)[ alias][, ...] Group By fieldname[ - sort][, ...] - - - fieldname: the name of any field from the - - - alias: alas string. This cannot contain blanks or other - reserved symbols like ',', '.' etc. - - aggregate: any of - min, max, - sum, count, last, first etc (the same - as in enumeration ) - - sort: asc or desc - the sort order of - the grouped items - - - - - Country, City, count(Country) Items, ContactName Group By Country, City desc - - - Country, City, count(Country) Items, ContactName Group By Country, City desc - - - - - - Gets the index of the expression if added in a - - - - integer, representing the index of the collection ni - . - - - - - Collection that stores group by expressions - - - - - - Initializes a new instance of . - - - - - - - Initializes a new instance of based on another . - - - - A from which the contents are copied - - - - - - Initializes a new instance of containing any array of objects. - - - - An array of objects with which to intialize the collection - - - - - Adds a with the specified value to the - . - - The to add. - - The index at which the new element was inserted. - - - - - - Parses value and adds a to the - . - - The string representation to add. - - The index at which the new element was inserted. - - - - - - Copies the elements of an array to the end of the . - - - An array of type containing the objects to add to the collection. - - - None. - - - - - - - Adds the contents of another to the end of the collection. - - - - A containing the objects to add to the collection. - - - None. - - - - - - Gets a value indicating whether the - contains the specified . - - The to locate. - - if the is contained in the collection; - otherwise, . - - - - - - Copies the values to a one-dimensional instance at the - specified index. - - The one-dimensional that is the destination of the values copied from . - The index in where copying begins. - - None. - - is multidimensional. -or- The number of elements in the is greater than the available space between and the end of . - is . - is less than "s lowbound. - - - - - Returns the index of a in - the . - - The to locate. - - The index of the of in the - , if found; otherwise, -1. - - - - - - Inserts a into the at the specified index. - - The zero-based index where should be inserted. - The to insert. - None. - - - - - Returns an enumerator that can iterate through - the . - - None. - - - - - Removes a specific from the - . - - The to remove from the . - None. - is not found in the Collection. - - - - Represents the entry at the specified index of the . - - The zero-based index of the entry to locate in the collection. - - The entry at the specified index of the collection. - - is outside the valid range of indexes for the collection. - - - - GridGroupPanel appears on the top of Telerik RadGrid - when ShowGroupPanel of RadGrid is set to - true and if - is set to true, you can drag column to the panel to group data by - that column. - - Basic Grouping - Traversing items in group panel - - - protected void RadGrid1_PreRender(object sender, System.EventArgs e) - { - TableCell cell; - - foreach (cell in RadGrid1.GroupPanel.GroupPanelItems) - { - Control ctrl; - foreach (ctrl in cell.Controls) - { - if (ctrl is ImageButton) - { - ImageButton button = ctrl as ImageButton; - button.ImageUrl = "<my_img_url>"; - button.CausesValidation = false; - } - } - } - } - - - Protected Sub RadGrid1_PreRender(ByVal sender As Object, ByVal e As System.EventArgs) Handles RadGrid1.PreRender - Dim cell As TableCell - - For Each cell In RadGrid1.GroupPanel.GroupPanelItems - Dim ctrl As Control - For Each ctrl In cell.Controls - If (Typeof ctrl Is ImageButton) Then - Dim button As ImageButton = CType(ctrl, ImageButton) - button.ImageUrl = "<my_img_url>" - button.CausesValidation = False - End If - Next ctrl - Next cell - End Sub - - - - Group by fields (displayed in the GroupPanel) are defined through the - GridGroupByExpressions. - - - - For internal usage only. - - - - - - - - - - - - - - - - Gets a collection of items displayed in the group panel. These items represent - the GroupByFields used for Telerik RadGrid - grouping. - - - - protected void RadGrid1_PreRender(object sender, System.EventArgs e) - { - TableCell cell; - - foreach (cell in RadGrid1.GroupPanel.GroupPanelItems) - { - Control ctrl; - foreach (ctrl in cell.Controls) - { - if (ctrl is ImageButton) - { - ImageButton button = ctrl as ImageButton; - button.ImageUrl = "<my_img_url>"; - button.CausesValidation = false; - } - } - } - } - - - Protected Sub RadGrid1_PreRender(ByVal sender As Object, ByVal e As System.EventArgs) Handles RadGrid1.PreRender - Dim cell As TableCell - - For Each cell In RadGrid1.GroupPanel.GroupPanelItems - Dim ctrl As Control - For Each ctrl In cell.Controls - If (Typeof ctrl Is ImageButton) Then - Dim button As ImageButton = CType(ctrl, ImageButton) - button.ImageUrl = "<my_img_url>" - button.CausesValidation = False - End If - Next ctrl - Next cell - End Sub - - - Traversing items in group panel - - - - Gets or sets the text displayed in the group panel to urge the user dragging a - column to group by. - - -
-            <GroupPanel Text="Drag here the column you need to group by."></GroupPanel>
-            
-
- - Note that the GroupPanel Text has a default value, so you don't need to set it - generally. - -
- - Gets the style that will be used for the group panel. - -
-                <GroupPanel Text="Drag a column here.">
<PanelStyle BackColor="Aqua" BorderStyle="Dotted" />
</GroupPanel> -
-
-
- - Gets the style that will be used for the group panel items. - -
-                <GroupPanel Text="Drag a column here.">
<PanelStyle BackColor="Aqua" BorderStyle="Dotted" />
<PanelItemsStyle BackColor="Black" Font-Italic="true"/>
</GroupPanel> -
-
-
- - Gets or sets a value indicating whether the group panel will be displayed. - true, if group panel is visible, otherwise false (the default value). - - - - - - Summary description for GridGroupPanelStyle. - - - - A navigation control used to create context menus. - - - The RadContextMenu control is used to display context-aware options for various targets. Those targets - are specified through the property. RadContextMenu supports the following targets: - - - - - Used to associate a context menu with an ASP.NET Server control. - Accepts the control ID as an argument. - - - - Used to associate a context menu with an HTML element. Accepts - the HTML element id as an argument. - - - - Used to specify document-wide context menu. - - - - Used to associate a context menu with all elements with the specified - tag name (e.g. IMG, INPUT). - - - - - - A navigation control used to display a menu in a web page. - - - The RadMenu control is used to display a list of menu items in a Web Forms - page. The RadMenu control supports the following features: - - - - Databinding that allows the control to be populated from various - datasources. - - - Programmatic access to the RadMenu object model - which allows dynamic creation of menus, populating with items and customizing the behavior - by various properties. - - - Customizable appearance through built-in or user-defined skins. - - -

Items

- - The RadMenu control is made up of tree of items represented - by objects. Items at the top level (level 0) are - called root items. An item that has a parent item is called a child item. All root - items are stored in the property of the RadMenu control. Child items are - stored in the Items property of their parent . - - - Each menu item has a Text and a Value property. - The value of the Text property is displayed in the RadMenu control, - while the Value property is used to store any additional data about the item, - such as data passed to the postback event associated with the item. When clicked, an item can - navigate to another Web page indicated by the NavigateUrl property. - -
-
- - - - - - - Defines properties that menu item containers (RadMenu, - RadMenuItem) should implement - - - - Gets the parent IRadMenuItemContainer. - - - Gets the collection of child items. - - A RadMenuItemCollection that represents the child - items. - - - Use this property to retrieve the child items. You can also use it to - programmatically add or remove items. - - - - - Populates the RadMenu control from external XML file. - - - The newly added items will be appended after any existing ones. - - - The following example demonstrates how to populate RadMenu control - from XML file. - - private void Page_Load(object sender, EventArgs e) - { - if (!Page.IsPostBack) - { - RadMenu1.LoadContentFile("~/Menu/Examples/Menu.xml"); - } - } - - - Private Sub Page_Load(sender As Object, e As EventArgs) Handles MyBase.Load - If Not Page.IsPostBack Then - RadMenu1.LoadContentFile("~/Menu/Examples/Menu.xml") - End If - End Sub - - - The name of the XML file. - - - - Gets a linear list of all items in the RadMenu - control. - - - An IList<RadMenuItem> containing all items (from all hierarchy - levels). - - - Use the GetAllItems method to obtain a linear collection of all - items regardless their place in the hierarchy. - - - The following example demonstrates how to disable all items within a - RadMenu control. - - void Page_Load(object sender, EventArgs e) - { - foreach (RadMenuItem item in RadMenu1.GetAllItems()) - { - item.Enabled = false; - } - } - - - Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Load - For Each childItem As RadMenuItem In RadMenu1.GetAllItems - childItem.Enabled = False - Next - End Sub - - - - - - Searches the RadMenu control for the first - RadMenuItem with a Text property equal to - the specified value. - - - A RadMenuItem whose Text property is equal - to the specified value. - - - The method returns the first item matching the search criteria. If no item is - matching then null (Nothing in VB.NET) is - returned. - - The value to search for. - - - - Searches the RadMenu control for the first - RadMenuItem with a Text property equal to - the specified value. - - - A RadMenuItem whose Text property is equal - to the specified value. - - - The method returns the first item matching the search criteria. If no item is - matching then null (Nothing in VB.NET) is - returned. - - The value to search for. - A Boolean indicating a case-sensitive or insensitive comparison (true indicates a case-insensitive comparison). - - - - Searches the RadMenu control for the first - RadMenuItem with a Value property equal - to the specified value. - - - A RadMenuItem whose Value property is - equal to the specified value. - - - The method returns the first item matching the search criteria. If no item is - matching then null (Nothing in VB.NET) is - returned. - - The value to search for. - - - - Searches the RadMenu control for the first - RadMenuItem with a Value property equal - to the specified value. - - - A RadMenuItem whose Value property is - equal to the specified value. - - - The method returns the first item matching the search criteria. If no item is - matching then null (Nothing in VB.NET) is - returned. - - The value to search for. - A Boolean indicating a case-sensitive or insensitive comparison (true indicates a case-insensitive comparison). - - - - Searches the RadMenu control for the first - Item with a NavigateUrl - property equal to the specified value. - - - A Item whose NavigateUrl - property is equal to the specified value. - - - The method returns the first Item matching the search criteria. If no Item is - matching then null (Nothing in VB.NET) is - returned. - - The value to search for. - - - - Returns the first RadMenuItem - that matches the conditions defined by the specified predicate. - The predicate should returns a boolean value. - - - The following example demonstrates how to use the FindItem method. - - void Page_Load(object sender, EventArgs e) - { - RadMenu1.FindItem(ItemWithEqualsTextAndValue); - } - private static bool ItemWithEqualsTextAndValue(RadMenuItem item) - { - if (item.Text == item.Value) - { - return true; - } - else - { - return false; - } - } - - - Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs) - RadMenu1.FindItem(ItemWithEqualsTextAndValue) - End Sub - Private Shared Function ItemWithEqualsTextAndValue(ByVal item As RadMenuItem) As Boolean - If item.Text = item.Value Then - Return True - Else - Return False - End If - End Function - - - The Predicate <> that defines the conditions of the element to search for. - - - - Gets a list of all client-side changes (adding an item, removing an item, changing an item's property) which have occurred. - - - A list of objects which represent all client-side changes the user has performed. - By default the ClientChanges property returns empty list. Client-changes are recorded if and only if the client-side - methods trackChanges()/commitChanges() have been invoked. - - - You can use the ClientChanges property to respond to client-side modifications such as - - adding a new item - removing existing item - clearing the children of an item or the control itself - changing a property of the item - - The ClientChanges property is available in the first postback (ajax) request after the client-side modifications - have taken place. After this moment the property will return empty list. - - - The following example demonstrates how to use the ClientChanges property - - foreach (ClientOperation<RadMenuItem> operation in RadToolBar1.ClientChanges) - { - RadMenuItem item = operation.Item; - - switch (operation.Type) - { - case ClientOperationType.Insert: - //An item has been inserted - operation.Item contains the inserted item - break; - case ClientOperationType.Remove: - //An item has been inserted - operation.Item contains the removed item. - //Keep in mind the item has been removed from the menu. - break; - case ClientOperationType.Update: - UpdateClientOperation<RadMenuItem> update = operation as UpdateClientOperation<RadMenuItem> - //The "UpdateOperation" provides an additional property "PropertyName". This is the property whose value was changed from the client side. - break; - case ClientOperationType.Clear: - //All children of have been removed - operation.Item contains the parent item whose children have been removed. If operation.Item is null then the root items have been removed. - break; - } - } - - - For Each operation As ClientOperation(Of RadMenuItem) In RadToolBar1.ClientChanges - Dim item As RadMenuItem = operation.Item - Select Case operation.Type - Case ClientOperationType.Insert - 'An item has been inserted - operation.Item contains the inserted item - Exit Select - Case ClientOperationType.Remove - 'An item has been inserted - operation.Item contains the removed item. - 'Keep in mind the item has been removed from the menu. - Exit Select - Case ClientOperationType.Update - Dim update As UpdateClientOperation(Of RadMenuItem) = TryCast(operation, UpdateClientOperation(Of RadMenuItem)) - 'The "UpdateOperation" provides an additional property "PropertyName". This is the property whose value was changed from the client side. - Exit Select - Case ClientOperationType.Clear - 'All children of have been removed - operation.Item contains the parent item whose children have been removed. If operation.Item is Nothing then the root items have been removed. - Exist Select - End Select - Next - - - - - - Gets a object that contains the root items of the current RadMenu control. - - - A that contains the root items of the current RadMenu control. By default - the collection is empty (RadMenu has no children). - - - Use the Items property to access the root items of the RadMenu control. You can also use the Items property to - manage the root items - you can add, remove or modify items. - - - The following example demonstrates how to programmatically modify the properties of a root item. - - RadMenu1.Items[0].Text = "Example"; - RadMenu1.Items[0].NavigateUrl = "http://www.example.com"; - - - RadMenu1.Items(0).Text = "Example" - RadMenu1.Items(0).NavigateUrl = "http://www.example.com" - - - - - - Gets or sets the template for displaying the items in - RadMenu. - - - - An object which implements the ITemplate interface. - The default value is a null reference (Nothing in - Visual Basic), which indicates that this property is not set. - - The ItemTemplate property sets a template that will be used - for all menu items. - - To specify unique display for individual items use the - ItemTemplate property of the - RadMenuItem class. - - - - The following example demonstrates how to use the - ItemTemplate property to add a CheckBox for each item. - ASPX: - <telerik:RadMenu runat="server" ID="RadMenu1"> -
- <ItemTemplate> -
- <asp:CheckBox runat="server" - ID="CheckBox"></asp:CheckBox>
- <asp:Label runat="server" ID="Label1"
-
- Text='<%# DataBinder.Eval(Container, "Text") %>' - ></asp:Label> -
-
- </ItemTemplate> - <Items> -
- <telerik:RadMenuItem Text="News" /> - <telerik:RadMenuItem Text="Sports" /> - <telerik:RadMenuItem Text="Games" /> -
- </Items> -
- </telerik:RadMenu> -
-
- - - Gets or sets the template displayed when child items are being loaded. - - - The following example demonstrates how to use the LoadingStatusTemplate to display an image. - - <telerik:RadMenu runat="server" ID="RadMenu1"> - <LoadingStatusTemplate> - <asp:Image runat="server" ID="Image1" ImageUrl="~/Img/loading.gif" /> - </LoadingStatusTemplate> - </telerik:RadMenu> - - - - - Gets the settings for the animation played when an item opens. - - An AnnimationSettings that represents the - expand animation. - - - - Use the ExpandAnimation property to customize the expand - animation of RadMenu. You can specify the - Type and - the Duration of the expand animation. - To disable expand animation effects you should set the - Type to - AnimationType.None.
- To customize the collapse animation you can use the - CollapseAnimation property. -
-
- - The following example demonstrates how to set the ExpandAnimation - of RadMenu. - - ASPX: - - - <telerik:RadMenu ID="RadMenu1" runat="server"> - <ExpandAnimation Type="OutQuint" Duration="300" - /> - <Items> - <telerik:RadMenuItem Text="News" > - <Items> - <telerik:RadMenuItem Text="CNN" NavigateUrl="http://www.cnn.com" - /> - <telerik:RadMenuItem Text="Google News" NavigateUrl="http://news.google.com" - /> - </Items> - </telerik:RadMenuItem> - <telerik:RadMenuItem Text="Sport" > - <Items> - <telerik:RadMenuItem Text="ESPN" NavigateUrl="http://www.espn.com" - /> - <telerik:RadMenuItem Text="Eurosport" NavigateUrl="http://www.eurosport.com" - /> - </Items> - </telerik:RadMenuItem> - </Items> - - - </telerik:RadMenu> - - - void Page_Load(object sender, EventArgs e) - { - RadMenu1.ExpandAnimation.Type = AnimationType.Linear; - RadMenu1.ExpandAnimation.Duration = 300; - } - - - Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Load - RadMenu1.ExpandAnimation.Type = AnimationType.Linear - RadMenu1.ExpandAnimation.Duration = 300 - End Sub - - -
- - - Gets or sets a value indicating the timeout after which a menu item starts to - open. - - - An integer specifying the timeout measured in milliseconds. The default value is - 100 milliseconds. - - - Use the ExpandDelay property to delay item opening. - - To customize the timeout prior to item closing use the - CollapseDelay property. - - - - The following example demonstrates how to specify a half second (500 - milliseconds) timeout prior to item opening: - ASPX: - <telerik:RadMenu ID="RadMenu1" runat="server" - ExpandDelay="500" /> - - - - Gets the settings for the animation played when an item closes. - - An AnnimationSettings that represents the - collapse animation. - - - - Use the CollapseAnimation property to customize the expand - animation of RadMenu. You can specify the - Type, - Duration and the - items are collapsed.
- To disable expand animation effects you should set the - Type to - AnimationType.None. To customize the expand animation you can - use the ExpandAnimation property. -
-
- - The following example demonstrates how to set the - CollapseAnimation of RadMenu. - - ASPX: - - - <telerik:RadMenu ID="RadMenu1" runat="server"> - <CollapseAnimation Type="OutQuint" Duration="300" - /> - <Items> - <telerik:RadMenuItem Text="News" > - <Items> - <telerik:RadMenuItem Text="CNN" NavigateUrl="http://www.cnn.com" - /> - <telerik:RadMenuItem Text="Google News" NavigateUrl="http://news.google.com" - /> - </Items> - </telerik:RadMenuItem> - <telerik:RadMenuItem Text="Sport" > - <Items> - <telerik:RadMenuItem Text="ESPN" NavigateUrl="http://www.espn.com" - /> - <telerik:RadMenuItem Text="Eurosport" NavigateUrl="http://www.eurosport.com" - /> - </Items> - </telerik:RadMenuItem> - </Items> - - - </telerik:RadMenu> - - - - - - - void Page_Load(object sender, EventArgs e) - { - RadMenu1.CollapseAnimation.Type = AnimationType.Linear; - RadMenu1.CollapseAnimation.Duration = 300; - } - - - Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Load - RadMenu1.CollapseAnimation.Type = AnimationType.Linear - RadMenu1.CollapseAnimation.Duration = 300 - End Sub - - -
- - - Gets or sets a value indicating the timeout after which a menu item starts to - close. - - - An integer specifying the timeout measured in milliseconds. The default value is - 500 (half a second). - - - Use the CollapseDelay property to delay item closing. To - cause immediate item closing set this property to 0 (zero). - - To customize the timeout prior to item closing use the - ExpandDelay property. - - - - The following example demonstrates how to specify one second (1000 - milliseconds) timeout prior to item closing: - ASPX: - <telerik:RadMenu ID="RadMenu1" runat="server" - ClosingDelay="1000" /> - - - - Gets or sets a value indicating the way top level items will flow. - - One of the ItemFlow values. The default value for top - level items is Horizontal. - - - Use the Flow property to customize the way top level items are - displayed. If set to Horizontal items are positioned one after - another. Vertical causes the items to flow one below the other. - - - The following example demonstrates how to make a vertical menu. - ASPX: - <telerik:RadMenu ID="RadMenu1" runat="server" - Flow="Vertical" /> - - - - Specifies the default settings for child item behavior. - - An instance of the MenuItemGroupSettings - class. - - - You can customize the following settings - - item flow - expand direction - horizontal offset from the parent item - vertical offset from the parent item - width - height - - - For more information check - MenuItemGroupSettings. - - - - - - Gets or sets a value indicating if an automatic scroll is applied if the groups are larger then the screen height. - - - - - Gets or sets a value indicating if scroll is enabled for the root items. - Width must be set for horizontal root group, Height for vertical one. - - - - - The minimum available height that is needed to enable the auto-scroll. - - - Enabling the auto-scroll when there is very little available space can - lead to a situation where only the scroll arrows are visible. -
- If the available space is lower than the specified value, the menu will - attempt to screen boundary detection first (if enabled). -
-
- - - The minimum available width that is needed to enable the auto-scroll. - - - The minimum width measured in pixels. The default value is 50 pixels. - - - - Enabling the auto-scroll when there is very little available space can - lead to a situation where only the scroll arrows are visible. - - - If the available space is lower than the specified value, the menu will - attempt to screen boundary detection first (if enabled). - - - - - - Gets or sets a value indicating whether the screen boundary detection will be applied when menu items are expanded. - - - By default RadMenu will check if there is enough space to open a menu item. If there isn't the expand direction of the - item will be inverted - Left to Right, Bottom to Top and vice versa. - - - - - Gets or sets a value indicating whether root items should open on mouse - click. - - - True if the root items open on mouse click; otherwise - false. The default value is false. - - - Use the ClickToOpen property to customize the way root menu - items are opened. By default menu items are opened on mouse hovering. - - - - - Gets the settings for the web service used to populate items - ExpandMode set to - MenuItemExpandMode.WebService. - - - An WebServiceSettings that represents the - web service used for populating items. - - - - Use the WebServiceSettings property to configure the web - service used to populate items on demand. - You must specify both Path and - Method - to fully describe the service. - - - You can use the LoadingStatusTemplate - property to create a loading template. - - - In order to use the integrated support, the web service should have the following signature: - - - [ScriptService] - public class WebServiceName : WebService - { - [WebMethod] - public RadMenuItemData[] WebServiceMethodName(RadMenuItemData item, object context) - { - // We cannot use a dictionary as a parameter, because it is only supported by script services. - // The context object should be cast to a dictionary at runtime. - IDictionary<string, object> contextDictionary = (IDictionary<string, object>) context; - - //... - } - } - - - - - - - When set to true, the items populated through Load On Demand are persisted on the server. - - - - - Gets or sets a value indicating if an overlay should be rendered (only in Internet Explorer). - - - The overlay is an iframe element that is used to hide select and other elements from overlapping the menu. - - - - - Gets a collection of objects that define the relationship - between a data item and the menu item it is binding to. - - - A that represents the relationship between a data item and the menu item it is binding to. - - - - - Gets or sets the maximum number of levels to bind to the RadMenu control. - - - The maximum number of levels to bind to the RadMenu control. The default is -1, - which binds all the levels in the data source to the control. - - - When binding the RadMenu control to a data source, use the MaxDataBindDepth - property to limit the number of levels to bind to the control. For example, setting this property to 2 binds only - the root menu items and their immediate children. All remaining records in the data source are ignored. - - - - - Gets or sets the URL of the page to post to from the current page when a menu item is clicked. - - - The URL of the Web page to post to from the current page when a menu item is clicked. - The default value is an empty string (""), which causes the page to post back to itself. - - - - - Occurs on the server when an item in the RadMenu control is - created. - - - The ItemCreated event is raised every time a new item is - added. - The ItemCreated event is not related to data binding and you - cannot retrieve the DataItem of the item in the event - handler. - The ItemCreated event is often useful in scenarios where you want - to initialize all items - for example setting the ToolTip of each - RadMenuItem to be equal to the Text property. - - - The following example demonstrates how to use the ItemCreated - event to set the ToolTip property of each item. - - private void RadMenu1_ItemCreated(object sender, Telerik.WebControls.RadMenuItemEventArgs e) - { - e.Item.ToolTip = e.Item.Text; - } - - - Sub RadMenu1_ItemCreated(ByVal sender As Object, ByVal e As Telerik.WebControls.RadMenuItemEventArgs) Handles RadMenu1.ItemCreated - e.Item.ToolTip = e.Item.Text - End Sub - - - - - - Occurs on the server when a menu item in the RadMenu - control is clicked. - - - - The menu will also postback if you navigate to a menu item - using the [menu item] key and then press [enter] on the menu item that is focused. The - instance of the clicked menu item is passed to the MenuItemClick event - handler - you can obtain a reference to it using the eventArgs.RadMenuItem property. - - - - - Occurs after a menu item is data bound. - - - The ItemDataBound event is raised for each menu item upon - databinding. You can retrieve the item being bound using the event arguments. - The DataItem associated with the item can be retrieved using - the DataItem property. - - The ItemDataBound event is often used in scenarios when - you want to perform additional mapping of fields from the DataItem - to their respective properties in the RadMenuItem class. - - - The following example demonstrates how to map fields from the data item to - item properties using the ItemDataBound - event. - - private void RadMenu1_ItemDataBound(object sender, Telerik.WebControls.RadMenuEventArgs e) - { - RadMenuItem item = e.RadMenuItem; - DataRowView dataRow = (DataRowView) e.Item.DataItem; - - item.ImageUrl = "image" + dataRow["ID"].ToString() + ".gif"; - item.NavigateUrl = dataRow["URL"].ToString(); - } - - - Sub RadMenu1_ItemDataBound(ByVal sender As Object, ByVal e As RadMenuEventArgs) Handles RadMenu1.ItemDataBound - Dim item As RadMenuItem = e.RadMenuItem - Dim dataRow As DataRowView = CType(e.Item.DataItem, DataRowView) - - item.ImageUrl = "image" + dataRow("ID").ToString() + ".gif" - item.NavigateUrl = dataRow("URL").ToString() - End Sub - - - - - - Gets or sets a value indicating the client-side event handler that is called when - the mouse moves over a menu item in the RadMenu control. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - If specified, the OnClientMouseOver - client-side event handler is called when the mouse moves over a - menu item. Two parameters are passed to the handler: - - sender, the menu client object; - eventArgs with two properties, get_item() (the - instance of the menu item) and get_domEvent (a reference to the browser event). - - This event cannot be cancelled. - - - The following example demonstrates how to use the - OnClientMouseOver property. - -
- <script type="text/javascript">
- function onClientMouseOverHandler(sender, eventArgs)
- {
- alert(eventArgs.get_item().get_text());
- }
- </script> -
-
- <telerik:RadMenu ID="RadMenu1"
- runat= "server"
- OnClientMouseOver="onClientMouseOverHandler">
- ....
- </telerik:RadMenu> -
-
-
-
- - - If specified, the OnClientMouseOut client-side event handler - is called when the mouse moves out of a menu item. Two parameters are passed to the - handler: - - sender, the menu client object; - eventArgs with two properties, get_item() (the - instance of the menu item) and get_domEvent (a reference to the browser event). - - This event cannot be cancelled. - - - Gets or sets a value indicating the client-side event handler that is called when - the mouse moves out of a menu item in the RadMenu control. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - <script type="text/javascript">
- function onClientMouseOutHandler(sender, eventArgs)
- {
- alert(eventArgs.get_item().get_text());
- }
- </script>
- <telerik:RadMenu ID="RadMenu1"
- runat= "server"
- OnClientMouseOut="onClientMouseOutHandler">
- ....
- </telerik:RadMenu>
-
-
- - - Gets or sets a value indicating the client-side event handler that is called when - a menu item gets focus. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - <script type="text/javascript">
- function onClientItemFocusHandler(sender, eventArgs)
- {
- alert(eventArgs.get_item().get_text());
- }
- </script>
- <telerik:RadMenu ID="RadMenu1"
- runat="server"
- OnClientItemFocus="onClientItemFocusHandler">
- ....
- </telerik:RadMenu>
-
- - If specified, the OnClientItemFocus client-side event - handler is called when a menu item is selected using either the keyboard (the [TAB] - or arrow keys) or by clicking it. Two parameters are passed to the handler: - - sender, the menu client object; - eventArgs with two properties, get_item() (the - instance of the menu item) and get_domEvent (a reference to the browser event). - - This event cannot be cancelled. - -
- - - Gets or sets a value indicating the client-side event handler that is called - after an item loses focus. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - If specified, the OnClientItemBlur client-side event handler - is called when a menu item loses focus as a result of the user pressing a key or - clicking elsewhere on the page. Two parameters are passed to the handler: - - sender, the menu client object; - eventArgs with two properties, get_item() (the - instance of the menu item) and get_domEvent (a reference to the browser event). - - This event cannot be cancelled. - - - <script type="text/javascript">
- function onClientItemBlurHandler(sender, eventArgs)
- {
- alert(eventArgs.get_item().get_text());
- }
- </script>
- <telerik:RadMenu ID="RadMenu1"
- runat="server"
- OnClientItemBlur="onClientItemBlurHandler">
- ....
- </telerik:RadMenu>
-
-
- - - This event is similar to OnClientItemFocus but fires only on - mouse click. - If specified, the OnClientItemClicking client-side event - handler is called before a menu item is clicked upon. Two parameters are passed to - the handler: - - sender, the menu client object; - eventArgs with three properties, get_item() (the - instance of the menu item), get_cancel()/set_cancel() - indicating - if the event should be cancelled and get_domEvent (a reference to the browser event). - - The OnClientItemClicking event can be cancelled. To do so, - return False from the event handler. -
-
-
-
- - Gets or sets a value indicating the client-side event handler that is called when - a menu item is clicked. - - - <script type="text/javascript">
- function onClientItemClickingHandler(sender, eventArgs)
- {
- if (eventArgs.get_item().get_text() == "News")
- {
- return false; - }
- }
- </script>
- <telerik:RadMenu ID="RadMenu1"
- runat="server"
- OnClientItemClicking="onClientItemClickingHandler">
- ....
- </telerik:RadMenu>
-
- - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - -
- - - Gets or sets a value indicating the client-side event handler that is called - after a menu item is clicked. - - - This event is similar to OnClientItemFocus but fires only on - mouse click. - If specified, the OnClientItemClicked client-side event - handler is called after a menu item is clicked upon. Two parameters are passed to - the handler: - - sender, the menu client object; - eventArgs with two properties, get_item() (the - instance of the menu item) and get_domEvent (a reference to the browser event). - - This event cannot be cancelled. - - - <script type="text/javascript">
- function onClientItemClickedHandler(sender, eventArgs)
- {
- alert(eventArgs.get_item().get_text());
- }
- </script>
- <telerik:RadMenu ID="RadMenu1"
- runat="server"
- OnClientItemClicked="onClientItemClickedHandler">
- ....
- </telerik:RadMenu> -
- - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - -
- - - Gets or sets a value indicating the client-side event handler that is called when - a group of child items begin to open. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - If specified, the OnClientItemOpening client-side event handler - is called when a group of child items opens. Two parameters are passed to the - handler: - - sender, the menu client object; - eventArgs with three properties, get_item() (the - instance of the menu item), get_cancel()/set_cancel() - indicating - if the event should be cancelled and get_domEvent (a reference to the browser event). - - This event can be cancelled by calling eventArgs.set_cancel(true). - - - <script type="text/javascript">
- function onClientItemOpeningHandler(sender, eventArgs)
- {
- alert(eventArgs.get_item().get_text());
- }
- </script>
- <telerik:RadMenu ID="RadMenu1"
- runat="server"
- OnClientItemOpening="onClientItemOpeningHandler">
- ....
- </telerik:RadMenu>
-
-
- - - Gets or sets a value indicating the client-side event handler that is called when - a group of child items opens. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - If specified, the OnClientItemOpened client-side event handler - is called when a group of child items opens. Two parameters are passed to the - handler: - - sender, the menu client object; - eventArgs with two properties, get_item() (the - instance of the menu item) and get_domEvent (a reference to the browser event). - - This event cannot be cancelled. - - - <script type="text/javascript">
- function onClientItemOpenedHandler(sender, eventArgs)
- {
- alert(eventArgs.get_item().get_text());
- }
- </script>
- <telerik:RadMenu ID="RadMenu1"
- runat="server"
- OnClientItemOpen="onClientItemOpenedHandler">
- ....
- </telerik:RadMenu>
-
-
- - - Gets or sets a value indicating the client-side event handler that is called when - a group of child items is closing. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - <script type="text/javascript">
- function onClientItemClosingHandler(sender, eventArgs)
- {
- alert(eventArgs.get_item().get_text());
- }
- </script>
- <telerik:RadMenu ID="RadMenu1"
- runat="server"
- OnClientItemClose="onClientItemClosingHandler">
- ....
- </telerik:RadMenu>
-
- - If specified, the OnClientItemClosing client-side event - handler is called when a group of child items closes. Two parameters are passed to - the handler: - - sender, the menu client object; - eventArgs with three properties, get_item() (the - instance of the menu item), get_cancel()/set_cancel() - indicating - if the event should be cancelled and get_domEvent (a reference to the browser event). - - This event can be cancelled. - -
- - - Gets or sets a value indicating the client-side event handler that is called when - a group of child items closes. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - <script type="text/javascript">
- function onClientItemClosedHandler(sender, eventArgs)
- {
- alert(eventArgs.get_item().get_text());
- }
- </script>
- <telerik:RadMenu ID="RadMenu1"
- runat="server"
- OnClientItemClose="onClientItemClosedHandler">
- ....
- </telerik:RadMenu>
-
- - If specified, the OnClientItemClosed client-side event - handler is called when a group of child items closes. Two parameters are passed to - the handler: - - sender, the menu client object; - eventArgs with two properties, get_item() (the - instance of the menu item) and get_domEvent (a reference to the browser event). - - This event cannot be cancelled. - -
- - - Gets or sets a value indicating the client-side event handler that is called when - a menu item children are about to be populated (for example from web service). - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - <script type="text/javascript">
- function onClientItemPopulatingHandler(sender, eventArgs)
- {
- var item = eventArgs.get_item();
- var context = eventArgs.get_context();
- context["CategoryID"] = item.get_value();
- }
- </script>
- <telerik:RadMenu ID="RadMenu1"
- runat="server"
- OnClientItemPopulating="onClientItemPopulatingHandler">
- ....
- </telerik:RadMenu>
-
- - If specified, the OnClientItemPopulating client-side event - handler is called when a menu item children are about to be populated. - Two parameters are passed to the handler: - - sender, the menu client object; - eventArgs with three properties: - - get_item(), the instance of the menu item. - get_context(), an user object that will be passed to the web service. - set_cancel(), used to cancel the event. - - - - This event can be cancelled. - -
- - - Gets or sets a value indicating the client-side event handler that is called when - a menu item children were just populated (for example from web service). - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - <script type="text/javascript">
- function onClientItemPopulatedHandler(sender, eventArgs)
- {
- var item = eventArgs.get_item();
- alert("Loading finished for " + item.get_text());
- }
- </script>
- <telerik:RadMenu ID="RadMenu1"
- runat="server"
- OnClientItemPopulated="onClientItemPopulatedHandler">
- ....
- </telerik:RadMenu>
-
- - If specified, the OnClientItemPopulated client-side event - handler is called when a menu item children were just populated. - Two parameters are passed to the handler: - - sender, the menu client object; - eventArgs with one property: - - get_item(), the instance of the menu item. - - - - This event cannot be cancelled. - -
- - - Gets or sets a value indicating the client-side event handler that is called when - the operation for populating the children of a menu item has failed. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - <script type="text/javascript">
- function onClientItemPopulationFailedHandler(sender, eventArgs)
- {
- var item = eventArgs.get_item();
- var errorMessage = eventArgs.get_errorMessage();
-
- alert("Error: " + errorMessage);
- eventArgs.set_cancel(true);
- }
- </script>
- <telerik:RadMenu ID="RadMenu1"
- runat="server"
- OnClientItemPopulationFailed="onClientItemPopulationFailedHandler">
- ....
- </telerik:RadMenu>
-
- - If specified, the OnClientItemPopulationFailed client-side event - handler is called when the operation to populate the children of a menu item has failed. - Two parameters are passed to the handler: - - sender, the menu client object; - eventArgs with two properties: - - get_item(), the instance of the menu item. - set_cancel(), set to true to suppress the default action (alert message). - - - - This event can be cancelled. - -
- - - If specified, the OnClienLoad client-side event handler is - called after the menu is fully initialized on the client. - A single parameter - the menu client object - is passed to the - handler. - This event cannot be cancelled. - - - <script type="text/javascript">
- function onClientLoadHandler(sender)
- {
- alert(sender.get_id());
- }
- </script>
- <telerik:RadMenu ID="RadMenu1"
- runat= "server"
- OnClientLoad="onClientLoadHandler">
- ....
- </telerik:RadMenu>
-
- - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - Gets or sets a value indicating the client-side event handler that is called - after the RadMenu client-side object is initialized. - -
- - - - - - - - - - - - - - - - - - - - - - - - - - - Gets the collection containing the targets to which right-click - RadContextMenu will attach. - - A ContextMenuTargetCollection - containing the targets to which RadContextMenu will attach. - - RadContextMenu can attach to four target types: ASP.NET control, element on the page, - document, set of client-side elements, specified by tagName. - - - This example demonstrates how to specify that the RadContextMenu will be displayed - when a specific textbox and all images on the page clicked. - -
- <img src="http://www.telerik.com/images/Homepage/telerikLogo.gif" />
- <img src="http://www.telerik.com/demos/aspnet/Prometheus/Controls/Img/productLogo.gif" />
- <asp:TextBox ID="TextBox1" runat="server"/gt;
- <Telerik:RadContextMenu ID="RadContextMenu1"
- runat= "server">
- <Targets>
- <Telerik:RadContextMenuControlTarget ControlID="TextBox1"/>
- <Telerik:RadContextMenuTagNameTarget TagName="img"/>
- </Targets>
- </Telerik:RadContextMenu> -
-
-
-
- - - Gets or sets a value indicating the client-side event handler that is called when - the RadContextMenu is to be displayed. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - If specified, the OnClientShowing client-side event handler is - called before the context menu is shown on the client. Two parameters are passed to the - handler: - - sender, the menu client object; - eventArgs with two properties, - get_cancel()/set_cancel(cancel) and - get_domEvent (a reference to the browser event). - - The OnClientShowing event can be cancelled. To do so, - set the cancel property to false from the event handler (e.g. - eventArgs.set_cancel(true);). - - - The following example demonstrates how to use the - OnClientShowing property. - -
- <script type="text/javascript">
- var shouldDisplayContextMenu = confirm("Do you want to enable context menus on this page?"); - function onClientShowingHandler(sender, eventArgs)
- {
- eventArgs.set_cancel(!shouldDisplayContextMenu);
- }
- </script> -
-
- <Telerik:RadContextMenu ID="RadContextMenu1"
- runat= "server"
- OnClientShowing="onClientShowingHandler">
- ....
- </Telerik:RadContextMenu> -
-
-
-
- - - Gets or sets a value indicating the client-side event handler that is called when - the RadContextMenu is displayed. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - If specified, the OnClientShown client-side event handler is - called after the context menu is shown on the client. Two parameters are passed to the - handler: - - sender, the menu client object; - eventArgs with one property, get_domEvent - (a reference to the browser event). - - - - The following example demonstrates how to use the - OnClientShown property. - -
- <input type="text" id="txtContextMenuState" value="hidden" /> - <script type="text/javascript">
- function onClientShownHandler(sender, eventArgs)
- {
- document.getElementById("txtContextMenuState").value = "shown";
- }
- </script> -
-
- <Telerik:RadContextMenu ID="RadContextMenu1"
- runat= "server"
- OnClientShown="onClientShownHandler">
- ....
- </Telerik:RadContextMenu> -
-
-
-
- - - Gets or sets a value indicating the client-side event handler that is called when - the RadContextMenu is to be hidden. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - If specified, the OnClientHiding client-side event handler is - called before the context menu is hidden on the client. Two parameters are passed to the - handler: - - sender, the menu client object; - eventArgs with two properties, - get_cancel()/set_cancel(cancel) and - get_domEvent (a reference to the browser event). - - The OnClientHiding event can be cancelled. To do so, - set the cancel property to false from the event handler (e.g. - eventArgs.set_cancel(true);). - - - The following example demonstrates how to use the - OnClientHiding property. - -
- <script type="text/javascript">
- function onClientShowingHandler(sender, eventArgs)
- {
- var shouldHide = confirm("Do you want to hide the context menu?") - eventArgs.set_cancel(!shouldHide);
- }
- </script> -
-
- <Telerik:RadContextMenu ID="RadContextMenu1"
- runat= "server"
- OnClientHiding="onClientHidingHandler">
- ....
- </Telerik:RadContextMenu> -
-
-
-
- - - Gets or sets a value indicating the client-side event handler that is called when - the RadContextMenu is hidden. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - If specified, the OnClientHidden client-side event handler is - called after the context menu is hidden on the client. Two parameters are passed to the - handler: - - sender, the menu client object; - eventArgs with one property, get_domEvent - (a reference to the browser event). - - - - The following example demonstrates how to use the - OnClientHidden property. - -
- <input type="text" id="txtContextMenuState" /> - <script type="text/javascript">
- function onClientHiddenHandler(sender, eventArgs)
- {
- document.getElementById("txtContextMenuState").value = "hidden";
- }
- </script> -
-
- <Telerik:RadContextMenu ID="RadContextMenu1"
- runat= "server"
- OnClientHidden="onClientHiddenHandler">
- ....
- </Telerik:RadContextMenu> -
-
-
-
- - - - - - - - - - - Represents the filtering menu for Telerik RadGrid. - - - - Summary description for NeedDataSourceEvent. - - - - - RadGrid control class. - - - - Set properties of RadGrid as default for the corresponding properties of grid's - table views . - The best approach to bind RadGrid is to handle its event and set the DataSource property - there. This way RadGrid will handle automatically operations like paging, sorting, grouping, etc. - The main table-view can be accessed through property. - The group panel and its items can be accessed using GroupPanel property. Note that the group items can be modified only - through the properties of each GridTableView. - Hierarchical grid structure can be implemented adding GridTableView objects to and handling - event, where you should set the DataSource of each bound detail table filtered - according to the property key values. - The of RadGrid property is a reference to the columns of the MasterTableView and is present in RadGrid for - compatibility with the DataGrid server control. - - - - Represents the Cancel command name. This field is read-only. - - Use the CancelCommandName field to represent the "Cancel" command name. - This command cancels the edit operation and RadGrid returns to normal mode. - - - The example below demonstrates how to use the Cancel command within an - EditItemTemplate. -
-            <radG:GridTemplateColumn UniqueName="TemplateColumn">
-            
-
-                <EditItemTemplate>
-            
-
-                    <asp:LinkButton runat="server" ID="Cancel" Text="Cancel Edit" CommandName="Cancel">
-            
-
-                    </asp:LinkButton>
-            
-
-                </EditItemTemplate>
-            
-
-            </radG:GridTemplateColumn>
-            
-
-
- - Represents the "Delete" command name. This field is read-only. - - Use the DeleteCommandName field to represent the "Delete" command - name. - - - The example below demonstrates how to use the Delete command within an - ItemTemplate. -
-            <radG:GridTemplateColumn UniqueName="TemplateColumn">
-            
-
-                <ItemTemplate>
-            
-
-                    <asp:LinkButton runat="server" ID="Delete" Text="Delete" CommandName="Delete">
-            
-
-                    </asp:LinkButton>
-            
-
-                </ItemTemplate>
-            
-
-            </radG:GridTemplateColumn>
-            
-
-
- - Represents the "Edit" command name. This field is read-only. - - Use the EditCommandName field to represent the "Edit" command name. This - command enters RadGrid in edit mode. - - - The example below demonstrates how to use the "Edit" command within an - ItemTemplate. -
-            <radG:GridTemplateColumn UniqueName="TemplateColumn">
-            
-
-                <ItemTemplate>
-            
-
-                    <asp:LinkButton runat="server" ID="Edit" Text="Edit" CommandName="Edit">
-                
-
-                    </asp:LinkButton>
-            
-
-                </ItemTemplate>
-            
-
-            </radG:GridTemplateColumn>
-            
-
-
- - Represents the "InitInsert" command name. This field is read-only. - - The example below demonstrates how to use the InitInsert command within an - CommandItemTemplate. -
-                <CommandItemTemplate>
-            
-
-                    <asp:LinkButton runat="server" ID="AddNew" Text="Add new record" CommandName="InitInsert">
-            
-
-                    </asp:LinkButton>
-            
-
-                </CommandItemTemplate>
-            
-
- - Use the InitInsertCommandName field to represent the - "InitInsert" command name. This command enters RadGrid in edit mode and lets the user - enter the data for a new record. - -
- - Represents the "PerformInsert" command name. This field is read-only. - - Use the PerformInsertCommandName field to represent the - "PerformInsert" command name. This command enters the new record into the - database. - - - - - Represents the "RebindGrid" command name. This field is read-only. Forces - RadGrid.Rebind - - - Use the RebindGridCommandName field to force rebinding the - grid. - - - - - The example below demonstrates how to use the Update command within an - EditItemTemplate. -
-            <radG:GridTemplateColumn UniqueName="TemplateColumn">
-                
-
-                <EditItemTemplate>
-                
-
-                    <asp:LinkButton runat="server" ID="Update" Text="Update" CommandName="Update">
-                
-
-                    </asp:LinkButton>
-                
-
-                </EditItemTemplate>
-                
-
-            </radG:GridTemplateColumn>
-            
-
- Represents the "Update" command name. This field is read-only. - - Use the UpdateCommandName field to represent the "Update" command - name. - -
- - - Represents the "UpdateEdited" command name. Updates all items that are in edit - mode. This field is read-only. - - - The example below demonstrates how to use the UpdateEdited command within an - CommandItemTemplate. -
-                <CommandItemTemplate>
-            
-
-                    <asp:LinkButton runat="server" ID="UpdateEdited" Text="Update Edited" CommandName="UpdateEdited">
-            
-
-                    </asp:LinkButton>
-            
-
-                </CommandItemTemplate>
-            
-
- - Use the UpdateCommandName field to represent the "Update" command - name. - -
- - Represents the "DeleteSelected" command name. This field is read-only. - - Use the DeleteSelectedCommandName field to represent the - "DeleteSelected" command name. - - - The example below demonstrates how to use the DeleteSelected command within - an CommandItemTemplate. -
-                <CommandItemTemplate>
-            
-
-                    <asp:LinkButton runat="server" ID="DeleteSelected" Text="Delete Selected" CommandName="DeleteSelected">
-                
-
-                    </asp:LinkButton>
-            
-
-                </CommandItemTemplate>
-            
-
-
- - - Constructs a new instance of RadGrid - - - - - Data-bind %MasterTableView% and its detail - %GridTableView%s. Prior to calling DataBind, the - %DataSource% property should be assigned. - - Simple Data-binding - - You should have in mind, that in case you are using simple data binding (i.e. - when you are not using NeedDataSource event) the correct approach - is to call the DataBind() method on the first page load when - !Page.IsPostBack and after handling some event (sort event for - example). - You will need to assign DataSource and rebind the grid after - each operation (paging, sorting, editing, etc.) - this copies exactly MS - DataGrid behavior. - - We recommend using the method instead and handling - the event. - - - - - - - - - - This method is used by RadGrid internally. Please do not use. - - - - - Forces RadGrid to fire - NeedDataSource - event then calls - DataBind - - - - - - - - - - Occurs when the Cancel button is clicked for an item in the - Telerik RadGrid control. - - - The CancelCommand event is raised when the Cancel button is clicked for an - item in the Telerik RadGrid control. - - -
- The following code example demonstrates how to specify and code a handler for the - CancelCommand event to cancel edits made to an item in the - Telerik RadGrid control. - - <%@ Page Language="VB" @ Register Assembly="Telerik.Web.UI" Namespace="Telerik.Web.UI" TagPrefix="telerik" %> - - <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> - - <script runat="server"> - - Protected Sub RadGrid1_CancelCommand(ByVal source As Object, ByVal e As Telerik.Web.UI.GridCommandEventArgs) - Response.Write("Cancel") - End Sub - - </script> - - <html xmlns="http://www.w3.org/1999/xhtml" > - <head runat="server"> - <title>Untitled Page</title> - </head> - <body> - <form id="form1" runat="server"> - <div> - <radG:RadGrid - DataSourceID="SqlDataSource1" - ID="RadGrid1" - runat="server" OnCancelCommand="RadGrid1_CancelCommand" > - <MasterTableView> - <Columns> - <radG:GridEditCommandColumn> - </radG:GridEditCommandColumn> - </Columns> - </MasterTableView> - </radG:RadGrid> - <!-- This example uses Microsoft SQL Server and connects --> - <!-- to the Northwind sample database. Use an ASP.NET --> - <!-- expression to retrieve the connection string value --> - <!-- from the Web.config file. --> - <asp:SqlDataSource - ID="SqlDataSource1" - runat="server" - ConnectionString="<$ ConnectionStrings>" - SelectCommand="SELECT TOP 5 [CustomerID], [ContactName], [CompanyName] FROM [Customers]"> - </asp:SqlDataSource> - </div> - </form> - </body> - </html> - -
-
- - - Fires when each editable column creates its column editor, prior to initializing its controls in the cells of the grid - - - - - Fires when the grid is about to be bound and the data source must be assigned - (is null/Nothing). - - - - Using this event eliminates the need for calling - when the grid content should be refreshed, due to a structural change.
- For example if Edit command bubbles, grid will automatically rebind and display - the item in edit mode, with no additional code. -
- Note that when you use NeedDataSource you need to assign - manually the DataSource property only once in the event handler! - Important: You should never call Rebind() - method in NeedDataSource event handler or - DataBind() for the grid - at any stage of the page lifecycle! - For more information related to Advanced Data Binding (i.e. with - NeedDataSource) see the following Data - binding article. -
-
- - - Fires when various item events occur - for example, before Pager item is - initialized, before EditForm is initialized, etc. - - - - - Fires when a detail-table in the hierarchy is about to be bound. You should only assign the DataSource property of the detail table to a - data-source properly filtered to display ony child records related to the parent item. - - - You can find the instance of the detail table in the event argument (e). You can - find the parent item using e.DetailTable.ParentItem property. For more information see - Hierarchical Binding - - - - - Occurs when the Delete button is clicked for an item in the - Telerik RadGrid control. - - - The DeleteCommand event is raised when the Delete button is clicked for an - item in the Telerik RadGrid control. - A typical handler for the DeleteCommand event removes the selected item from - the data source. - - - The following code example demonstrates how to specify and code a handler for the - CancelCommand event to cancel a Telerik RadGrid control. - - <%@ Page Language="VB" @ Register Assembly="Telerik.Web.UI" Namespace="Telerik.Web.UI" TagPrefix="telerik" %> - - <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> - - <script runat="server"> - - Protected Sub RadGrid1_DeleteCommand(ByVal source As Object, ByVal e As Telerik.Web.UI.GridCommandEventArgs) - Response.Write("Delete") - End Sub - </script> - - <html xmlns="http://www.w3.org/1999/xhtml" > - <head runat="server"> - <title>Untitled Page</title> - </head> - <body> - <form id="form1" runat="server"> - <div> - <radG:RadGrid - DataSourceID="SqlDataSource1" - ID="RadGrid1" - runat="server" OnDeleteCommand="RadGrid1_DeleteCommand" > - <MasterTableView> - <Columns> - <radG:GridButtonColumn Text="Delete" CommandName="Delete" UniqueName="Delete"></radG:GridButtonColumn> - </Columns> - </MasterTableView> - </radG:RadGrid> - <!-- This example uses Microsoft SQL Server and connects --> - <!-- to the Northwind sample database. Use an ASP.NET --> - <!-- expression to retrieve the connection string value --> - <!-- from the Web.config file. --> - <asp:SqlDataSource - ID="SqlDataSource1" - runat="server" - ConnectionString="<$ ConnectionStrings>" - SelectCommand="SELECT TOP 5 [CustomerID], [ContactName], [CompanyName] FROM [Customers]"> - </asp:SqlDataSource> - </div> - </form> - </body> - </html> - - - - - - Occurs when the Edit button is clicked for an item in the - Telerik RadGrid control. - - - The EditCommand event is raised when the Edit button is clicked for an item - in the Telerik RadGrid control. - A typical handler for the EditCommand event edites the selected item from the - data source. - - - The following code example demonstrates how to specify and code a handler for the - EditCommand event to edit a Telerik RadGrid control. - - <%@ Page Language="VB" @ Register Assembly="Telerik.Web.UI" Namespace="Telerik.Web.UI" TagPrefix="telerik" %> - - <!DOCTYPE html Public "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> - - <script runat="server"> - - Protected Sub RadGrid1_EditCommand(ByVal source As Object, ByVal e As Telerik.Web.UI.GridCommandEventArgs) - Response.Write("Edit") - End Sub - </script> - - <html xmlns="http://www.w3.org/1999/xhtml" > - <head runat="server"> - <title>Untitled Page</title> - </head> - <body> - <form id="form1" runat="server"> - <div> - <radG:RadGrid - DataSourceID="SqlDataSource1" - ID="RadGrid1" - runat="server" OnEditCommand="RadGrid1_EditCommand" > - <MasterTableView> - <Columns> - <radG:GridEditCommandColumn> - </radG:GridEditCommandColumn> - </Columns> - </MasterTableView> - </radG:RadGrid> - <!-- This example uses Microsoft SQL Server And connects --> - <!-- To the Northwind sample database. Use an ASP.NET --> - <!-- expression To retrieve the connection String value --> - <!-- from the Web.config file. --> - <asp:SqlDataSource - ID="SqlDataSource1" - runat="server" - ConnectionString="<$ ConnectionStrings>" - SelectCommand="SELECT TOP 5 [CustomerID], [ContactName], [CompanyName] FROM [Customers]"> - </asp:SqlDataSource> - </div> - </form> - </body> - </html> - - - - - - Occurs when a button is clicked in a Telerik RadGrid - control. - - - The ItemCommand event is raised when a button is clicked in the - Telerik RadGrid control. This allows you to provide an event-handling - method that performs a custom routine whenever this event occurs. - Buttons within a Telerik RadGrid control can also invoke some of - the built-in functionality of the control. Fires if any control inside - Telerik RadGrid rises a bubble event. This can be a command button - (like Edit, Update button, Expand/Collapse of an items) The command arguemtn - carries a reference to the item which rised the event, the command name and - argument object. - A GridCommandEventArgs object is passed to the event-handling method, which - allows you to determine the command name and command argument of the button - clicked. - - - The following code example demonstrates how to use the ItemCommand event to add the - name of a customer from a Telerik RadGrid control to a ListBox control when a item's Add - button is clicked. - - <%@ Page Language="VB" <see cref="> <"/>@ Register Assembly="Telerik.Web.UI" Namespace="Telerik.Web.UI" TagPrefix="telerik" %> - - <!DOCTYPE html Public "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> - - <script runat="server"> - - - Protected Sub RadGrid1_ItemCreated(ByVal sender As Object, ByVal e As Telerik.Web.UI.GridItemEventArgs) - If e.Item.ItemType = GridItemType.AlternatingItem Or e.Item.ItemType = GridItemType.Item Then - Dim item As Telerik.Web.UI.GridDataItem - item = e.Item - Dim LinkButton1 As LinkButton - LinkButton1 = item("LinkColumn").FindControl("LinkButton1") - LinkButton1.CommandArgument = e.Item.ItemIndex.ToString() - End If - End Sub - - Protected Sub RadGrid1_ItemCommand(ByVal source As Object, ByVal e As Telerik.Web.UI.GridCommandEventArgs) - ' If multiple buttons are used in a Telerik RadGrid control, use the - ' CommandName property to determine which button was clicked. - If e.CommandName = "Add" Then - - ' Convert the row index stored in the CommandArgument - ' property to an Integer. - Dim index As Integer = Convert.ToInt32(e.CommandArgument) - - ' Retrieve the item that contains the button clicked - ' by the user from the Items collection. - Dim item As Telerik.Web.UI.GridDataItem = RadGrid1.Items(index) - - ' Create a new ListItem object for the customer in the item. - Dim nitem As New ListItem() - nitem.Text = Server.HtmlDecode(item("CustomerID").Text) - - ' If the customer is not already in the ListBox, add the ListItem - ' object to the Items collection of the ListBox control. - If Not CustomersListBox.Items.Contains(nitem) Then - - CustomersListBox.Items.Add(nitem) - - End If - - End If - End Sub - </script> - - <html xmlns="http://www.w3.org/1999/xhtml" > - <head runat="server"> - <title>Untitled Page</title> - </head> - <body> - <form id="form1" runat="server"> - <div> - <radG:RadGrid - DataSourceID="SqlDataSource1" - ID="RadGrid1" - runat="server" OnItemCreated="RadGrid1_ItemCreated" OnItemCommand="RadGrid1_ItemCommand"> - <MasterTableView> - <Columns> - <radG:GridTemplateColumn - UniqueName="LinkColumn" - HeaderText="LinkColumn"> - <ItemTemplate> - <asp:LinkButton CommandName="Add" Text="click" ID="LinkButton1" runat="server">LinkButton</asp:LinkButton> - </ItemTemplate> - </radG:GridTemplateColumn> - </Columns> - </MasterTableView> - </radG:RadGrid> - <asp:listbox id="CustomersListBox" runat="server"/> - <!-- This example uses Microsoft SQL Server And connects --> - <!-- To the Northwind sample database. Use an ASP.NET --> - <!-- expression To retrieve the connection String value --> - <!-- from the Web.config file. --> - <asp:SqlDataSource - ID="SqlDataSource1" - runat="server" - ConnectionString="<<see cref="NorthwindConnectionString">$ ConnectionStrings</see>>" - SelectCommand="SELECT TOP 5 [CustomerID], [ContactName], [CompanyName] FROM [Customers]"> - </asp:SqlDataSource> - </div> - </form> - </body> - </html> - - - - - - Occurs when an item is created in a Telerik RadGrid - control. - - - Before the Telerik RadGrid control can be rendered, a GridItem - object must be created for each row in the control. The ItemCreated event is raised - when each row in the Telerik RadGrid control is created. This allows - you to provide an event-handling method that performs a custom routine, such as - adding custom content to a item, whenever this event occurs. - A GridItemEventArgs object is passed to the event-handling method, which - allows you to access the properties of the row being created. You can determine - which item type (header item, data pager item, and so on) is being bound by using - the Item.ItemType property. - Note that the changes made to the item control and its - children at this stage does not persist into the ViewState. - - - The following code example demonstrates how to use the ItemCreated event to store - the index of the item being created in the CommandArgument property of a LinkButton - control contained in the item. This allows you to determine the index of the item - that contains the LinkButton control when the user clicked the button. - - <%@ Page Language="VB" @ Register Assembly="Telerik.Web.UI" Namespace="Telerik.Web.UI" TagPrefix="telerik" %> - - <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> - - <script runat="server"> - - - Protected Sub RadGrid1_ItemCreated(ByVal sender As Object, ByVal e As Telerik.Web.UI.GridItemEventArgs) - If e.Item.ItemType = GridItemType.AlternatingItem Or e.Item.ItemType = GridItemType.Item Then - Dim item As Telerik.Web.UI.GridDataItem - item = e.Item - Dim LinkButton1 As LinkButton - LinkButton1 = item("LinkColumn").FindControl("LinkButton1") - LinkButton1.CommandArgument = e.Item.ItemIndex.ToString() - End If - End Sub - - Protected Sub RadGrid1_ItemCommand(ByVal source As Object, ByVal e As Telerik.Web.UI.GridCommandEventArgs) - ' If multiple buttons are used in a Telerik RadGrid control, use the - ' CommandName property to determine which button was clicked. - If e.CommandName = "Add" Then - - ' Convert the row index stored in the CommandArgument - ' property to an Integer. - Dim index As Integer = Convert.ToInt32(e.CommandArgument) - - ' Retrieve the item that contains the button clicked - ' by the user from the Items collection. - Dim item As Telerik.Web.UI.GridDataItem = RadGrid1.Items(index) - - ' Create a new ListItem object for the customer in the item. - Dim nitem As New ListItem() - nitem.Text = Server.HtmlDecode(item("CustomerID").Text) - - ' If the customer is not already in the ListBox, add the ListItem - ' object to the Items collection of the ListBox control. - If Not CustomersListBox.Items.Contains(nitem) Then - - CustomersListBox.Items.Add(nitem) - - End If - - End If - End Sub - </script> - - <html xmlns="http://www.w3.org/1999/xhtml" > - <head runat="server"> - <title>Untitled Page</title> - </head> - <body> - <form id="form1" runat="server"> - <div> - <radG:RadGrid - DataSourceID="SqlDataSource1" - ID="RadGrid1" - runat="server" OnItemCreated="RadGrid1_ItemCreated" OnItemCommand="RadGrid1_ItemCommand"> - <MasterTableView> - <Columns> - <radG:GridTemplateColumn - UniqueName="LinkColumn" - HeaderText="LinkColumn"> - <ItemTemplate> - <asp:LinkButton CommandName="Add" Text="click" ID="LinkButton1" runat="server">LinkButton</asp:LinkButton> - </ItemTemplate> - </radG:GridTemplateColumn> - </Columns> - </MasterTableView> - </radG:RadGrid> - <asp:listbox id="CustomersListBox" runat="server"/> - <!-- This example uses Microsoft SQL Server and connects --> - <!-- to the Northwind sample database. Use an ASP.NET --> - <!-- expression to retrieve the connection string value --> - <!-- from the Web.config file. --> - <asp:SqlDataSource - ID="SqlDataSource1" - runat="server" - ConnectionString="<$ ConnectionStrings>" - SelectCommand="SELECT TOP 5 [CustomerID], [ContactName], [CompanyName] FROM [Customers]"> - </asp:SqlDataSource> - </div> - </form> - </body> - </html> - - - - - - Fires before a custom column is created. You can handle the - event to replace or modify the instance of the column that should be created and added - into the collection of column in the corresponding - GridTableView. - - - The ColumnCreating event of Telerik RadGrid is - fired only for custom grid columns. It is not designed to be used - to cancel the creation of auto-generated columns. Its purpose is to have place - where to define your custom columns (extending the default grid columns) - programmatically and add them to the grid Columns - collection. - See the manual part of Telerik RadGrid documentation for details - about Telerik RadGrid inheritance. - - - - - The ColumnCreated event of Telerik RadGrid is - designated to customize auto-generated columns at runtime (for example - DataFormatString, ReadOnly or other properties of - these auto-generated columns). - - - This event is fired after the creation of auto-generated - columns. - - - - - Occurs when a data item is bound to data in a Telerik RadGrid - control. - - - Before the Telerik RadGrid control can be rendered, each item in - the control must be bound to a record in the data source. The ItemDataBound event - is raised when a data item (represented by a GridItem object) is bound to data in - the Telerik RadGrid control. This allows you to provide an - event-handling method that performs a custom routine, such as modifying the values - of the data bound to the item, whenever this event occurs. - A GridItemEventArgs object is passed to the event-handling method, which - allows you to access the properties of the item being bound. You can determine - which item type (header item, data pager item, and so on) is being bound by using - the Item.ItemType property. - Note that the changes made to the item control and its children does persist - into the ViewState. This event is fired as a result of a data-binding of Telerik RadGrid - contorl. This event is fired for items of type: - - GridDataItem - GridEditFormItem - GridHeaderItem - GridPagerItem - GridFooterItem - - - - The following code example demonstrates how to use the ItemDataBound event to - modify the value of a field in the data source before it is displayed in a - Telerik RadGrid control. - - <%@ Page Language="VB" @ Register Assembly="Telerik.Web.UI" Namespace="Telerik.Web.UI" TagPrefix="telerik" %> - - <!DOCTYPE html Public "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> - - <script runat="server"> - - Protected Sub RadGrid1_ItemDataBound(ByVal sender As Object, ByVal e As Telerik.Web.UI.GridItemEventArgs) - If e.Item.ItemType = GridItemType.AlternatingItem Or e.Item.ItemType = GridItemType.Item Then - Dim item As Telerik.Web.UI.GridDataItem - item = e.Item - item("CustomerID").Text = "Telerik" - End If - End Sub - </script> - - <html xmlns="http://www.w3.org/1999/xhtml" > - <head runat="server"> - <title>Untitled Page</title> - </head> - <body> - <form id="form1" runat="server"> - <div> - <radG:RadGrid - DataSourceID="SqlDataSource1" - ID="RadGrid1" - runat="server" OnItemDataBound="RadGrid1_ItemDataBound"> - </radG:RadGrid> - <!-- This example uses Microsoft SQL Server And connects --> - <!-- To the Northwind sample database. Use an ASP.NET --> - <!-- expression To retrieve the connection String value --> - <!-- from the Web.config file. --> - <asp:SqlDataSource - ID="SqlDataSource1" - runat="server" - ConnectionString="<$ ConnectionStrings>" - SelectCommand="SELECT TOP 5 [CustomerID], [ContactName], [CompanyName] FROM [Customers]"> - </asp:SqlDataSource> - </form> - </body> - </html> - - - - - Fires when a paging action has been performed. - - - - Fires when - PageSize property - value has been changed. - - - The PageSizeChanged event is rised when the value of the property - PageSize is changed. You can cancel the event if the new PageSize value is - invalid and it will not be saved. For example: -
-            protected void RadGrid1_PageSizeChanged(object source, GridPageSizeChangedEventArgs e)
{
if(e.NewPageSize < 1)
- e.Canceled = true;
} -
-
-
- - Occurs when a column is sorted. - - The SortCommand event is raised when a column is sorted. - A typical handler for the SortCommand event sorts the list. - - - The following code example demonstrates how to specify and code a handler for the - SortCommand event to sort a Telerik RadGrid control. - - <%@ Page Language="VB" @ Register Assembly="Telerik.Web.UI" Namespace="Telerik.Web.UI" TagPrefix="telerik" %> - - <!DOCTYPE html Public "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> - - <script runat="server"> - - Protected Sub RadGrid1_SortCommand(ByVal source As Object, ByVal e As Telerik.Web.UI.GridSortCommandEventArgs) - Response.Write("Sort") - End Sub - </script> - - <html xmlns="http://www.w3.org/1999/xhtml" > - <head runat="server"> - <title>Untitled Page</title> - </head> - <body> - <form id="form1" runat="server"> - <div> - <radG:RadGrid - DataSourceID="SqlDataSource1" - ID="RadGrid1" AllowSorting="true" - runat="server" OnSortCommand="RadGrid1_SortCommand" > - </radG:RadGrid> - <!-- This example uses Microsoft SQL Server And connects --> - <!-- To the Northwind sample database. Use an ASP.NET --> - <!-- expression To retrieve the connection String value --> - <!-- from the Web.config file. --> - <asp:SqlDataSource - ID="SqlDataSource1" - runat="server" - ConnectionString="<$ ConnectionStrings>" - SelectCommand="SELECT TOP 5 [CustomerID], [ContactName], [CompanyName] FROM [Customers]"> - </asp:SqlDataSource> - </div> - </form> - </body> - </html> - - - - - - Occurs when the Update button is clicked for an item in the - Telerik RadGrid control. - - - The UpdateCommand event is raised when the Update button is clicked for an - item in the Telerik RadGrid control. - A typical handler for the UpdateCommand event updates the selected item from - the data source. - - - The following code example demonstrates how to specify and code a handler for the - UpdateCommand event to update a Telerik RadGrid control. - - <%@ Page Language="VB" @ Register Assembly="Telerik.Web.UI" Namespace="Telerik.Web.UI" TagPrefix="telerik" %> - - <!DOCTYPE html Public "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> - - <script runat="server"> - - Protected Sub RadGrid1_UpdateCommand(ByVal source As Object, ByVal e As Telerik.Web.UI.GridCommandEventArgs) - Response.Write("Update") - End Sub - </script> - - <html xmlns="http://www.w3.org/1999/xhtml" > - <head runat="server"> - <title>Untitled Page</title> - </head> - <body> - <form id="form1" runat="server"> - <div> - <radG:RadGrid - DataSourceID="SqlDataSource1" - ID="RadGrid1" - runat="server" OnUpdateCommand="RadGrid1_UpdateCommand" > - <MasterTableView> - <Columns> - <radG:GridEditCommandColumn> - </radG:GridEditCommandColumn> - </Columns> - </MasterTableView> - </radG:RadGrid> - <!-- This example uses Microsoft SQL Server And connects --> - <!-- To the Northwind sample database. Use an ASP.NET --> - <!-- expression To retrieve the connection String value --> - <!-- from the Web.config file. --> - <asp:SqlDataSource - ID="SqlDataSource1" - runat="server" - ConnectionString="<$ ConnectionStrings>" - SelectCommand="SELECT TOP 5 [CustomerID], [ContactName], [CompanyName] FROM [Customers]"> - </asp:SqlDataSource> - </div> - </form> - </body> - </html> - - - - - - Occurs when the Insert button is clicked for an item in the - Telerik RadGrid control. - - - The InsertCommand event is raised when the Insert button is clicked for an - item in the Telerik RadGrid control. - A typical handler for the InsertCommand event insert the item into the data - source. - - - The following code example demonstrates how to specify and code a handler for the - InsertCommand event to insert a Telerik RadGrid control. - - <%@ Page Language="VB" @ Register Assembly="Telerik.Web.UI" Namespace="Telerik.Web.UI" TagPrefix="telerik" %> - - <!DOCTYPE html Public "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> - - <script runat="server"> - - - Protected Sub RadGrid1_InsertCommand(ByVal source As Object, ByVal e As Telerik.Web.UI.GridCommandEventArgs) - Response.Write("Insert") - End Sub - </script> - - <html xmlns="http://www.w3.org/1999/xhtml" > - <head runat="server"> - <title>Untitled Page</title> - </head> - <body> - <form id="form1" runat="server"> - <div> - <radG:RadGrid - DataSourceID="SqlDataSource1" - ID="RadGrid1" - runat="server" OnInsertCommand="RadGrid1_InsertCommand" > - <MasterTableView CommandItemDisplay="TopAndBottom"> - </MasterTableView> - </radG:RadGrid> - <!-- This example uses Microsoft SQL Server And connects --> - <!-- To the Northwind sample database. Use an ASP.NET --> - <!-- expression To retrieve the connection String value --> - <!-- from the Web.config file. --> - <asp:SqlDataSource - ID="SqlDataSource1" - runat="server" - ConnectionString="<$ ConnectionStrings>" - SelectCommand="SELECT TOP 5 [CustomerID], [ContactName], [CompanyName] FROM [Customers]"> - </asp:SqlDataSource> - </div> - </form> - </body> - </html> - - - - - - Fires when a grouping action has been performed. For example when a column header - was dragged in the GroupPanel. - - - You can use this event to set your own - GridGroupByExpression - when the user tries to group the grid. - - - - protected void RadGrid1_GroupsChanging(object source, Telerik.Web.UI.GridGroupsChangingEventArgs e) - { - //Expression is added (by drag/grop on group panel) - - if (e.Action == GridGroupsChangingAction.Group) - { - if (e.Expression.GroupByFields[0].FieldName != "CustomerID") - { - GridGroupByField countryGroupField = new GridGroupByField(); - countryGroupField.FieldName = "Country"; - GridGroupByField cityGroupField = new GridGroupByField(); - cityGroupField.FieldName = "City"; - - e.Expression.SelectFields.Clear(); - e.Expression.SelectFields.Add(countryGroupField); - e.Expression.SelectFields.Add(cityGroupField); - - e.Expression.GroupByFields.Clear(); - e.Expression.GroupByFields.Add(countryGroupField); - e.Expression.GroupByFields.Add(cityGroupField); - } - - } - } - - - Protected Sub RadGrid1_GroupsChanging(ByVal source As Object, ByVal e As Telerik.Web.UI.GridGroupsChangingEventArgs) - 'Expression is added (by drag/grop on group panel) - If (e.Action = GridGroupsChangingAction.Group) Then - If (e.Expression.GroupByFields(0).FieldName <> "CustomerID") Then - Dim countryGroupField As GridGroupByField = New GridGroupByField - countryGroupField.FieldName = "Country" - Dim cityGroupField As GridGroupByField = New GridGroupByField - cityGroupField.FieldName = "City" - e.Expression.SelectFields.Clear - e.Expression.SelectFields.Add(countryGroupField) - e.Expression.SelectFields.Add(cityGroupField) - e.Expression.GroupByFields.Clear - e.Expression.GroupByFields.Add(countryGroupField) - e.Expression.GroupByFields.Add(cityGroupField) - End If - End If - End Sub - - - - - Fires when a grid item has been updated. - - - Fires when a grid item has been inserted. - - - Fires when a grid item has been deleted. - - - Fires when a grid is exported to excelML and styles collections is created. - - - Fires when a grid is exported to excelML and row is created. - - - Fires when a grid is exporting. - - - Fires when a grid is exporting. - - - - - - - - Fires when a columns reorder action has been performed. - - - - Gets or sets the object from which the Telerik RadGrid control - retrieves its list of data items. - - - You should have in mind, that in case you are using simple data binding (i.e. - when you are not using NeedDataSource event) the correct approach - is to call the DataBind() method on the first page load when - !Page.IsPostBack and after handling some event (sort event for - example). - You will need to assign DataSource and rebind the grid after - each operation (paging, sorting, editing, etc.) - this copies exactly MS - DataGrid behavior. - - - An object that represents the data source from which the - Telerik RadGrid control retrieves its data. The default is a null reference - (Nothing in Visual Basic). - - - The following code example demonstrates how the DataSource property of a - Telerik RadGrid control is used. In this example, the - Telerik RadGrid control is bound to a DataSet object. After the DataSource - property is set, the DataBind method is called explicitly. - - - - - Gets or sets the name of the list of data that the Telerik RadGrid - control binds to, in cases where the data source contains more than one distinct list - of data items. - - - The name of the specific list of data that the Telerik RadGrid - control binds to, if more than one list is supplied by a data source control. The - default value is String.Empty. - - - - Use the DataMember property to specify a member from a multimember data - source to bind to the list control. For example, if you have a data source with - more than one table specified in the DataSource - property, use the DataMember property to specify which table to bind to - a data listing control. - - The value of the DataMember property is stored in view state. - This property cannot be set by themes or style sheet themes. For more - information, see ThemeableAttribute and Themes and Skins - Overview in MSDN. - - - - - - Gets a reference to the object that - allows you to set the properties of the grouping operation in a - Telerik RadGrid control. - - - - The following code example demonstrates how to set the GroupingSettings property - declaratively. It sets the tooltips of the group expand control of the - Telerik RadGrid. - - <%@ Page Language="VB" %> - - <%@ Register Assembly="Telerik.Web.UI" Namespace="Telerik.Web.UI" TagPrefix="telerik" %> - - <!DOCTYPE html Public "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> - - <html xmlns="http://www.w3.org/1999/xhtml" > - <head runat="server"> - <title>Untitled Page</title> - </head> - <body> - <form id="form1" runat="server"> - <div> - <radG:RadGrid - DataSourceID="SqlDataSource1" - ID="RadGrid1" - runat="server"> - <GroupingSettings ExpandTooltip="ExpandTooltip" /> - <MasterTableView> - <GroupByExpressions> - <radG:GridGroupByExpression> - <SelectFields> - <radG:GridGroupByField FieldAlias="CompanyName" FieldName="CompanyName" ></radG:GridGroupByField> - </SelectFields> - <GroupByFields> - <radG:GridGroupByField FieldName="CompanyName" SortOrder="Descending"></radG:GridGroupByField> - </GroupByFields> - </radG:GridGroupByExpression> - </GroupByExpressions> - </MasterTableView> - </radG:RadGrid> - <!-- This example uses Microsoft SQL Server And connects --> - <!-- To the Northwind sample database. Use an ASP.NET --> - <!-- expression To retrieve the connection String value --> - <!-- from the Web.config file. --> - <asp:SqlDataSource - ID="SqlDataSource1" - runat="server" - ConnectionString="<<see cref="NorthwindConnectionString">$ ConnectionStrings</see>>" - SelectCommand="SELECT [CustomerID], [ContactName], [CompanyName] FROM [Customers]"> - </asp:SqlDataSource> - </div> - </form> - </body> - </html> - - - - A reference to the that allows you to set - the properties of the grouping operation in a Telerik RadGrid control. - - - Use the GroupingSettings property to control the settings of - the grouping operations in a Telerik RadGrid control. This property is - read-only; however, you can set the properties of the - GridGroupingSettings object it returns. The properties can be set - declaratively using one of the following methods: - - Place an attribute in the opening tag of the Telerik RadGrid - control in the form Property-Subproperty, where Subproperty is a property of - the GridGroupingSettings object (for example, - GroupingSettings-ExpandTooltip). - Nest a <GroupingSettings> element between the opening and closing - tags of the Telerik RadGrid control. - - The properties can also be set programmatically in the form - Property.Subproperty (for example, GroupingSettings.ExpandTooltip). Common settings - usually include the tool tips for the sorting controls. - - - - - - Gets a reference to the object that - allows you to set the properties of the sorting operation in a - Telerik RadGrid control. - - - - A reference to the that allows you to set - the properties of the sorting operation in a Telerik RadGrid control. - - - Use the SortingSettings property to control the settings of the sorting - operations in a Telerik RadGrid control. This property is read-only; - however, you can set the properties of the GridSortingSettings object it returns. - The properties can be set declaratively using one of the following methods: - - Place an attribute in the opening tag of the Telerik RadGrid - control in the form Property-Subproperty, where Subproperty is a property of - the GridSortingSettings object (for example, - SortingSettings-SortedAscToolTip). - Nest a <SortingSettings> element between the opening and closing - tags of the Telerik RadGrid control. - - The properties can also be set programmatically in the form - Property.Subproperty (for example, SortingSettings.SortedAscToolTip). Common - settings usually include the tool tips for the sorting controls. - - - The following code example demonstrates how to set the SortingSettings property - declaratively. It sets the tooltips of the sorting control of the - Telerik RadGrid control. - - <%@ Page Language="VB" %> - - <%@ Register Assembly="Telerik.Web.UI" Namespace="Telerik.Web.UI" TagPrefix="telerik" %> - - <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> - - <html xmlns="http://www.w3.org/1999/xhtml" > - <head runat="server"> - <title>Untitled Page</title> - </head> - <body> - <form id="form1" runat="server"> - <div> - <radG:RadGrid - DataSourceID="SqlDataSource1" - ID="RadGrid1" - runat="server" - AllowSorting="true"> - <SortingSettings SortToolTip="SortToolTip" SortedAscToolTip="SortedAscToolTip" SortedDescToolTip="SortedDescToolTip" /> - </radG:RadGrid> - <!-- This example uses Microsoft SQL Server and connects --> - <!-- to the Northwind sample database. Use an ASP.NET --> - <!-- expression to retrieve the connection string value --> - <!-- from the Web.config file. --> - <asp:SqlDataSource - ID="SqlDataSource1" - runat="server" - ConnectionString="<<see cref="NorthwindConnectionString">$ ConnectionStrings</see>>" - SelectCommand="SELECT [CustomerID], [ContactName], [CompanyName] FROM [Customers]"> - </asp:SqlDataSource> - </div> - </form> - </body> - </html> - - - - - - - Gets a reference to the object that - allows you to set the properties of the hierarchical - Telerik RadGrid control. - - - - A reference to the GridHierarchySettings that allows you to set the properties of - the hierarchical Telerik RadGrid control. - - - Use the HierarchySettings property to control the settings of the - hierarchical Telerik RadGrid control. This property is read-only; - however, you can set the properties of the GridHierarchySettings object it returns. - The properties can be set declaratively using one of the following methods: - - Place an attribute in the opening tag of the Telerik RadGrid - control in the form Property-Subproperty, where Subproperty is a property of - the GridHierarchySettings object (for example, - HierarchySettings-CollapseTooltip). - Nest a <HierarchySettings> element between the opening and closing - tags of the Telerik RadGrid control. - - The properties can also be set programmatically in the form - Property.Subproperty (for example, HierarchySettings.CollapseTooltip). Common - settings usually include the tool tips for the hierarchical - Telerik RadGrid control. - - - - - - - - - - Gets a reference to the object that - allows you to set the properties of the grouping operation in a - Telerik RadGrid control. - - - - A reference to the GridExportSettings that allows you to set the properties of - the grouping operation in a Telerik RadGrid control. - - - Use the ExportSettings property to control the settings of the grouping - operations in a Telerik RadGrid control. This property is read-only; - however, you can set the properties of the GridGroupingSettings object it returns. - The properties can be set declaratively using one of the following methods: - - Place an attribute in the opening tag of the Telerik RadGrid - control in the form Property-Subproperty, where Subproperty is a property of - the GridExportSettings object (for example, - GroupingSettings-ExpandTooltip). - Nest a <GroupingSettings> element between the opening and closing - tags of the Telerik RadGrid control. - - The properties can also be set programmatically in the form - Property.Subproperty (for example, GroupingSettings.ExpandTooltip). Common settings - usually include the tool tips for the sorting controls. - - - - - - Gets a reference to the object that - allows you to set the properties of the validate operation in a - Telerik RadGrid control. - - - - A reference to the that allows you to set - the properties of the validate operation in a Telerik RadGrid control. - - - The following code example demonstrates how to set the - ValidationSettings property declaratively. It sets the validation - for the PerformInsert command event of the TextBox1 control. - - <%@ Page Language="VB" %> - - <%@ Register Assembly="Telerik.Web.UI" Namespace="Telerik.Web.UI" TagPrefix="telerik" %> - - <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> - - <html xmlns="http://www.w3.org/1999/xhtml" > - <head runat="server"> - <title>Untitled Page</title> - </head> - <body> - <form id="form1" runat="server"> - <div> - <radG:RadGrid - DataSourceID="SqlDataSource1" - ID="RadGrid1" - AutoGenerateColumns="false" - runat="server"> - <ValidationSettings - EnableValidation="true" - CommandsToValidate="PefrormInsert" /> - <MasterTableView CommandItemDisplay="TopAndBottom"> - <Columns> - <radG:GridEditCommandColumn> - </radG:GridEditCommandColumn> - <radG:GridTemplateColumn HeaderText="ContactName" UniqueName="ContactName" DataField="ContactName"> - <ItemTemplate> - <%# Eval("ContactName") <see cref="TextBox Text='<">> - </ItemTemplate> - <EditItemTemplate> - <asp</see># Bind("ContactName") %>' ID="TextBox1" runat="server"></asp:TextBox> - <asp:RequiredFieldValidator ControlToValidate="TextBox1" ID="RequiredFieldValidator1" runat="server" ErrorMessage="RequiredFieldValidator"></asp:RequiredFieldValidator> - </EditItemTemplate> - </radG:GridTemplateColumn> - </Columns> - </MasterTableView> - </radG:RadGrid> - <!-- This example uses Microsoft SQL Server and connects --> - <!-- to the Northwind sample database. Use an ASP.NET --> - <!-- expression to retrieve the connection string value --> - <!-- from the Web.config file. --> - <asp:SqlDataSource - ID="SqlDataSource1" - runat="server" - ConnectionString="<<see cref="NorthwindConnectionString">$ ConnectionStrings</see>>" - SelectCommand="SELECT TOP 3 [CustomerID], [ContactName], [CompanyName] FROM [Customers]"> - </asp:SqlDataSource> - </div> - </form> - </body> - </html> - - - - Use the ValidationSettings property to control the settings of the validate - operations in a Telerik RadGrid control. This property is read-only; - however, you can set the properties of the GridValidationSettings object it - returns. The properties can be set declaratively using one of the following - methods: - - Place an attribute in the opening tag of the Telerik RadGrid - control in the form Property-Subproperty, where Subproperty is a property of - the GridValidationSettings object (for example, - ValidationSettings-EnableValidation). - Nest a <ValidationSettings> element between the opening and closing - tags of the Telerik RadGrid control. - - The properties can also be set programmatically in the form - Property.Subproperty (for example, ValidationSettings.EnableValidation). Common - settings usually include the propeties for the validation logic in - Telerik RadGrid control. - - - - - - - - - Gets or sets a value indicating whether custom paging should be performed instead - of the integrated automatic paging. - - - - - This online example demonstrates an approach to implementing custom paging with - Telerik RadGrid. The simulated "DataLayer" wraps the logic of extracting records - for only the specified page and deleting records. Telerik RadGrid - maintains the pager buttons, changing of pager and other presentation specific - features. - Another available option for custom paging support is represented in the - how-to - section. - Note: There is no universal mechanism for grouping when - custom paging is allowed. The reason for this is that with the custom paging - mechanism you fetch only part of the whole information from the grid datasource. - Thus, when you trigger the grouping event the grid is restricted from operating - with the whole available source data and is not able to group the items accurately. - Furthermore, the aggregate functions as Count, Sum, etc. (covering operations with - the whole set of grid items) will return incorrect results. - A workaround solution for you could be to use hierarchy in the grid instead - of grouping to single out the grid items logically and visually according to custom - criteria. Thus you will be able to use custom paging without further - limitations. - Another approach is to build your own complex SQL statements which to get the - whole available data from the grid datasource and then group the items in the grid - with custom code logic.
-
- Finally, you can use standard paging instead of custom paging to ensure the - consistency of the data on grouping.
-
- - true, if custom paging is allowed; otherwise - false. The default is false. - -
- - - Gets or sets a value indicating whether the automatic paging feature is - enabled. - - - true if the paging feature is enabled; otherwise, - false. The default is false - - - Instead of displaying all the records in the data source at the same time, - the Telerik RadGrid control can automatically break the records up into - pages. If the data source supports the paging capability, the - Telerik RadGrid control can take advantage of that and provide built-in - paging functionality. The paging feature can be used with any data source object - that supports the System.Collections.ICollection interface or a data source that - supports paging capability. - To enable the paging feature, set the AllowPaging property - to true. By default, the Telerik RadGrid control - displays 10 records on a page at a time. You can change the number of records - displayed on a page by setting the PageSize property. To determine the total number - of pages required to display the data source contents, use the PageCount property. - You can determine the index of the currently displayed page by using the - CurrentPageIndex property. - When paging is enabled, an additional item called the pager item is - automatically displayed in the Telerik RadGrid control. The pager item contains controls - that allow the user to navigate to the other pages. You can control the settings of - the pager item by using the PagerItemStyle property. The pager - item can be displayed at the top, bottom, or both the top and bottom of the control - by setting the Position property. You can also select from one of four built-in - pager display modes by setting the Mode property. - The Telerik RadGrid control also allows you to define a custom - template for the pager item. - - - The following code example demonstrates how to use the AllowPaging - property to declaratively enable the paging feature in the - Telerik RadGrid control. - - <%@ Page Language="VB" %> - - <%@ Register Assembly="Telerik.Web.UI" Namespace="Telerik.Web.UI" TagPrefix="telerik" %> - - <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> - - <html xmlns="http://www.w3.org/1999/xhtml" > - <head runat="server"> - <title>Untitled Page</title> - </head> - <body> - <form id="form1" runat="server"> - <div> - <radG:RadGrid - DataSourceID="SqlDataSource1" - ID="RadGrid1" - runat="server" - AllowPaging="true" > - </radG:RadGrid> - <!-- This example uses Microsoft SQL Server and connects --> - <!-- to the Northwind sample database. Use an ASP.NET --> - <!-- expression to retrieve the connection string value --> - <!-- from the Web.config file. --> - <asp:SqlDataSource - ID="SqlDataSource1" - runat="server" - ConnectionString="<<see cref="NorthwindConnectionString">$ ConnectionStrings</see>>" - SelectCommand="SELECT [CustomerID], [ContactName], [CompanyName] FROM [Customers]"> - </asp:SqlDataSource> - </div> - </form> - </body> - </html> - - - Supported in: 3.0, 2.0, 1.1, 1.0 .NET Framework - AllowCustomPaging Property - Basic Paging - Pager Item - - - Gets or sets a value indicating whether the sorting feature is enabled. - - true if the sorting feature is enabled; otherwise, - false. The default is false. - - - When a data source control that supports sorting is bound to the - Telerik RadGrid control, the Telerik RadGrid control can - take advantage of the data source control's capabilities and provide automatic - sorting functionality. - To enable sorting, set the AllowSorting property to - true. When sorting is enabled, the heading text for each column - field with its SortExpression property set is displayed as a link button. - Clicking the link button for a column causes the items in the - Telerik RadGrid control to be sorted based on the sort expression. - Typically, the sort expression is simply the name of the field displayed in the - column, which causes the Telerik RadGrid control to sort with respect - to that column. To sort by multiple fields, use a sort expression that contains a - comma-separated list of field names. You can determine the sort expression that the - Telerik RadGrid control is applying by using the SortExpression - property. Clicking a column's link button repeatedly toggles the sort direction - between ascending and descending order. - - Supported in: 3.0, 2.0, 1.1, 1.0 .NET Framework - - The following code example demonstrates how to use the AllowSorting property to - enable sorting in a Telerik RadGrid control when automatically - generated columns are used. - - <%@ Page Language="VB" %> - - <%@ Register Assembly="Telerik.Web.UI" Namespace="Telerik.Web.UI" TagPrefix="telerik" %> - - <!DOCTYPE html Public "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> - - <html xmlns="http://www.w3.org/1999/xhtml" > - <head runat="server"> - <title>Untitled Page</title> - </head> - <body> - <form id="form1" runat="server"> - <div> - <radG:RadGrid - DataSourceID="SqlDataSource1" - ID="RadGrid1" - runat="server" - AllowSorting="true"> - </radG:RadGrid> - <!-- This example uses Microsoft SQL Server And connects --> - <!-- To the Northwind sample database. Use an ASP.NET --> - <!-- expression To retrieve the connection String value --> - <!-- from the Web.config file. --> - <asp:SqlDataSource - ID="SqlDataSource1" - runat="server" - ConnectionString="<$ ConnectionStrings>" - SelectCommand="SELECT [CustomerID], [ContactName], [CompanyName] FROM [Customers]"> - </asp:SqlDataSource> - </div> - </form> - </body> - </html> - - - Sorting Expressions - - - - - Gets a reference to the object that - allows you to set the properties of the client-side behavior and appearance in - a Telerik RadGrid control. - - - - A reference to the that allows you to set the - properties of the the client-side behavior and appearance in a - Telerik RadGrid control. - - - Use the ClientSettings property to control the settings of the client-side - behavior and appearance in a Telerik RadGrid control. This property is - read-only; however, you can set the properties of the GridClientSettings object it - returns. The properties can be set declaratively using one of the following - methods: - - Place an attribute in the opening tag of the Telerik RadGrid - control in the form Property-Subproperty, where Subproperty is a property of - the GridClientSettings object (for example, - ClientSettings-AllowDragToGroup). - Nest a <ClientSettings> element between the opening and closing - tags of the Telerik RadGrid control. - - The properties can also be set programmatically in the form - Property.Subproperty (for example, SortingSettings.AllowDragToGroup). Common - settings usually include the behavior and appearance on the client-side. - - - - - Gets a reference to the GridTableItemStyle object that allows you to set the - appearance of alternating data items in a Telerik RadGrid control. - - - A reference to the GridTableItemStyle that represents the style of alternating - data items in a Telerik RadGrid control. - - - Use the AlternatingItemStyle property to control the appearance of - alternating data items in a Telerik RadGrid control. When this property - is set, the data items are displayed alternating between the ItemStyle settings and - the AlternatingItemStyle settings. This property is read-only; however, you can set - the properties of the GridTableItemStyle object it returns. The properties can be - set declaratively using one of the following methods: - - Place an attribute in the opening tag of the Telerik RadGrid - control in the form Property-Subproperty, where Subproperty is a property of - the GridTableItemStyle object (for example, - AlternatingItemStyle-ForeColor). - Nest an <AlternatingItemStyle> element between the opening and - closing tags of the Telerik RadGrid control. - - The properties can also be set programmatically in the form - Property.Subproperty (for example, AlternatingItemStyle.ForeColor). Common settings - usually include a custom background color, foreground color, and font - properties. - - - The following code example demonstrates how to use the AlternatingItemStyle - property to declaratively define the style for alternating data items in a - Telerik RadGrid control. - - <%@ Page language="VB" %> - - <%@ Register Assembly="Telerik.Web.UI" Namespace="Telerik.Web.UI" TagPrefix="telerik" %> - - <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" - "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> - <html > - <head id="Head1" runat="server"> - <title>GridView ItemStyle and AlternatingItemStyle Example</title> - </head> - <body> - <form id="form1" runat="server"> - <h3>GridView ItemStyle and AlternatingItemStyle Example</h3> - - <radG:RadGrid id="CustomersGridView" - datasourceid="CustomersSource" - autogeneratecolumns="true" - Skin="" - runat="server"> - - <itemstyle backcolor="LightCyan" - forecolor="DarkBlue" - font-italic="true"/> - - <alternatingitemstyle backcolor="PaleTurquoise" - forecolor="DarkBlue" - font-italic="true"/> - - </radG:RadGrid> - - <!-- This example uses Microsoft SQL Server and connects --> - <!-- to the Northwind sample database. Use an ASP.NET --> - <!-- expression to retrieve the connection string value --> - <!-- from the Web.config file. --> - <asp:sqldatasource id="CustomersSource" - selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]" - connectionstring="<<see cref="NorthWindConnectionString">$ ConnectionStrings</see>>" - runat="server"/> - - </form> - </body> - </html> - - - Supported in: 3.0, 2.0, 1.1, 1.0 .NET Framework - - - - Gets a reference to the GridTableItemStyle object that allows you to set the - appearance of the group-header item in a Telerik RadGrid control. - - - A reference to the GridTableItemStyle that represents the style of the - group-header item in a Telerik RadGrid control. - - - Use the GroupHeaderItemStyle property to control the appearance of the - group-header item in a Telerik RadGrid control. This property is - read-only; however, you can set the properties of the GridTableItemStyle object it - returns. The properties can be set declaratively using one of the following - methods: - - Place an attribute in the opening tag of the Telerik RadGrid - control in the form Property-Subproperty, where Subproperty is a property of - the GridTableItemStyle object (for example, - GroupHeaderItemStyle-ForeColor). - Nest a <GroupHeaderItemStyle> element between the opening and - closing tags of the Telerik RadGrid control. - - The properties can also be set programmatically in the form - Property.Subproperty (for example, GroupHeaderItemStyle.ForeColor). Common settings - usually include a custom background color, foreground color, and font - properties. - - - The following code example demonstrates how to use the SelectedItemStyle property - to define a custom style for the group-header item in a Telerik RadGrid - control. - - <%@ Page Language="VB" %> - - <%@ Register Assembly="Telerik.Web.UI" Namespace="Telerik.Web.UI" TagPrefix="telerik" %> - - <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> - - <html xmlns="http://www.w3.org/1999/xhtml" > - <head runat="server"> - <title>Untitled Page</title> - </head> - <body> - <form id="form1" runat="server"> - <div> - <radG:RadGrid - DataSourceID="SqlDataSource1" - ID="RadGrid1" - runat="server" - Skin="None" > - <GroupHeaderItemStyle BackColor="red" /> - <MasterTableView> - <GroupByExpressions> - <radG:GridGroupByExpression> - <SelectFields> - <radG:GridGroupByField FieldAlias="CompanyName" FieldName="CompanyName" ></radG:GridGroupByField> - </SelectFields> - <GroupByFields> - <radG:GridGroupByField FieldName="CompanyName" SortOrder="Descending"></radG:GridGroupByField> - </GroupByFields> - </radG:GridGroupByExpression> - </GroupByExpressions> - </MasterTableView> - </radG:RadGrid> - <!-- This example uses Microsoft SQL Server and connects --> - <!-- to the Northwind sample database. Use an ASP.NET --> - <!-- expression to retrieve the connection string value --> - <!-- from the Web.config file. --> - <asp:SqlDataSource - ID="SqlDataSource1" - runat="server" - ConnectionString="<$ ConnectionStrings>" - SelectCommand="SELECT TOP 5 [CustomerID], [ContactName], [CompanyName] FROM [Customers]"> - </asp:SqlDataSource> - </div> - </form> - </body> - </html> - - - Supported in: 3.0, 2.0, 1.1, 1.0 .NET Framework - - - - Gets or sets a value indicating whether bound fields are automatically created - for each field in the data source. - - - When the AutoGenerateColumns property is set to true, an - GridBoundColumn object is automatically created for each field in - the data source. Each field is then displayed as a column in the - Telerik RadGrid control in the order that the fields appear in the data - source. This option provides a convenient way to display every field in the data - source; however, you have limited control of how an automatically generated column - field is displayed or behaves. - This set of columns can be accessed using the - AutoGeneratedColumns - collection. -
- - - - Runtime auto-generated columns will always appear after - the user-specified columns, unless the columns are ordered - programmatically. - - -
- Instead of letting the Telerik RadGrid control automatically - generate the column fields, you can manually define the column fields by setting - the AutoGenerateColumns property to false and - then creating a custom Columns collection. In addition to bound column fields, you - can also display a button column, a check box column, a button column, a hyperlink - column, an image column, or a column based on your own custom-defined template - etc. -
- - true to automatically create bound fields for each field in the - data source; otherwise, false. The default is - true. - - - The following code example demonstrates how to use the AutoGenerateColumns property - to automatically create bound columns in a Telerik RadGrid control for - each field in the data source. - - <%@ Page Language="VB" %> - - <%@ Register Assembly="Telerik.Web.UI" Namespace="Telerik.Web.UI" TagPrefix="telerik" %> - - <!DOCTYPE html Public "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> - - <html xmlns="http://www.w3.org/1999/xhtml" > - <head runat="server"> - <title>Untitled Page</title> - </head> - <body> - <form id="form1" runat="server"> - <div> - <radG:RadGrid - DataSourceID="SqlDataSource1" - ID="RadGrid1" - runat="server" - AutoGenerateColumns="true" - AllowSorting="true"> - </radG:RadGrid> - <!-- This example uses Microsoft SQL Server And connects --> - <!-- To the Northwind sample database. Use an ASP.NET --> - <!-- expression To retrieve the connection String value --> - <!-- from the Web.config file. --> - <asp:SqlDataSource - ID="SqlDataSource1" - runat="server" - ConnectionString="<<see cref="NorthwindConnectionString">$ ConnectionStrings</see>>" - SelectCommand="SELECT [CustomerID], [ContactName], [CompanyName] FROM [Customers]"> - </asp:SqlDataSource> - </div> - </form> - </body> - </html> - - - Supported in: 3.0, 2.0, 1.1, 1.0 .NET Framework -
- - - Gets or sets the URL to an image to display in the background of a - Telerik RadGrid control. - - - The URL of an image to display in the background of the - Telerik RadGrid control. The default is an empty string (""), which - indicates that this property is not set. - - - Use the BackImageUrl property to specify the URL to an image - to display in the background of a Telerik RadGrid control. - If the specified image is smaller than the Telerik RadGrid - control, the image is tiled to fill in the background. If the image is larger than - the control, the image is cropped. - - Supported in: 3.0, 2.0, 1.1, 1.0 .NET Framework - - - - Gets group panel control instance - visible only if grouping is enabled in grid - (). Each 's - Group-By-Expression is visualized in this panel. - - - - If grouping is enabled grid allows grouping by column(s) by drag-and-drop of - columns from it's detail tables in this panel For this purpose set - AllowDragToGroup - property to true. You can modify panel's appearance using - and - . - - - - - - - Gets or sets a value indicating whether the - would be shown in Telerik RadGrid. - - - - true, when Telerik RadGrid will display the panel; otherwise - false. The default is false. - - - - GroupPanel - Gets or sets a value indicating whether the grouping is enabled. - - Most often this property is used in conjunction with - property set to true. The - easiest way to turn the grouping on is by using the grid's SmartTag option for - enabling the grouping. - - Basic Grouping - - true, when the automatic grouping is enabled; otherwise - false. The default is false. - - - - - Gets or sets a value indicating whether Telerik RadGrid will perform - automatic updates to the data source. - - - true, when the automatic updates are allowed; otherwise - false. The default is false. - - - See Automatic Data Source - Operations for details. - - - - - Gets or sets a value indicating whether Telerik RadGrid will perform - automatic insert of records to the data source. - - - See Automatic Data Source - Operations for details. - - - true, when automatic insert into the database would be - performed; otherwise false. The default is - false. - - - - - Gets or sets a value indicating whether Telerik RadGrid will - automatically delete records from the specified data source. - - - See Automatic Data Source - Operations for details. - - - true, when automatic delete from the database would be - performed; otherwise false. The default is - false. - - - - - The instance of that represents the main - grid-table view in RadGrid. - - - - Telerik RadGrid introduces a new approach to hierarchical data - structures. The innovative in Telerik RadGrid is having a so called - MasterTableView. This is the topmost table of the hierarchical - structure. It is a with - . The collection holds the so called - DetailTables - tables related to the fields of the MasterTable. Each - DetailTable can have its own GridTableViewCollection with - other Detail Tables, thus forming the hierarchical structure. - -
- - - Note: There is only one Master Table for - a single Telerik RadGrid. This is the topmost table. All - inner tables are referred as a Detail Tables regardless of whether they - have related (inner) tables or not. - - -
-
- - A reference to the topmost , i.e the - MasterTableView. - - RadGrid and MasterTableView difference - -
-            <radg:radgrid id="RadGrid1" runat="server"
- CssClass= "RadGrid" Width="100%" AutoGenerateColumns="False" PageSize="3" AllowSorting="True"
- AllowMultiRowSelection= "False" AllowPaging="True" GridLines="None" AllowFilteringByColumn="true">
- <PagerStyle Mode="NumericPages" CssClass="Pager"></PagerStyle>
- <HeaderStyle CssClass="Header"></HeaderStyle>
- <ItemStyle CssClass="Row"></ItemStyle>
- <AlternatingItemStyle CssClass="AltRow"></AlternatingItemStyle>
- <MasterTableView DataKeyNames="CustomerID" AllowMultiColumnSorting="True">
- <DetailTables>
- <radG:GridTableView DataKeyNames="OrderID" DataMember="Orders">
- <ParentTableRelation>
- <radG:GridRelationFields DetailKeyField="CustomerID" MasterKeyField="CustomerID" />
- </ParentTableRelation>
<DetailTables>
- <radG:GridTableView DataKeyNames="OrderID" DataMember="OrderDetails">
- <ParentTableRelation>
- <radG:GridRelationFields DetailKeyField="OrderID" MasterKeyField="OrderID" />
- </ParentTableRelation>
- <Columns>
- <radG:GridBoundColumn SortExpression="UnitPrice" HeaderText="Unit Price" HeaderButtonType="TextButton"
- DataField= "UnitPrice">
- </radG:GridBoundColumn>
- <radG:GridBoundColumn SortExpression="Quantity" HeaderText="Quantity" HeaderButtonType="TextButton"
- DataField= "Quantity">
</radG:GridBoundColumn>
- <radG:GridBoundColumn SortExpression="Discount" HeaderText="Discount" HeaderButtonType="TextButton"
- DataField= "Discount">
</radG:GridBoundColumn>
- </Columns>
<SortExpressions>
- <radG:GridSortExpression FieldName="Quantity" SortOrder="Descending"></radG:GridSortExpression>
- </SortExpressions>
<ItemStyle BackColor="#A7B986"></ItemStyle>
- <HeaderStyle CssClass="Header1"></HeaderStyle>
- <AlternatingItemStyle BackColor="#D9E8C4"></AlternatingItemStyle>
- </radG:GridTableView>
- </DetailTables>
- <Columns>
- <radG:GridBoundColumn SortExpression="OrderID" HeaderText="OrderID" HeaderButtonType="TextButton"
- DataField= "OrderID">
</radG:GridBoundColumn>
- <radG:GridBoundColumn SortExpression="OrderDate" HeaderText="Date Ordered" HeaderButtonType="TextButton"
- DataField= "OrderDate">
</radG:GridBoundColumn>
- <radG:GridBoundColumn SortExpression="EmployeeID" HeaderText="EmployeeID" HeaderButtonType="TextButton"
- DataField= "EmployeeID">
</radG:GridBoundColumn>
- </Columns>
<SortExpressions>
- <radG:GridSortExpression FieldName="OrderDate"></radG:GridSortExpression>
- </SortExpressions>
<ItemStyle Height="19px" BackColor="#FCEDB0"></ItemStyle>
- <HeaderStyle CssClass="Header2" ForeColor="#ffffff"></HeaderStyle>
- <AlternatingItemStyle Height="19px" BackColor="#D5B96A"></AlternatingItemStyle>
- </radG:GridTableView>
</DetailTables>
- <Columns>
- <radG:GridBoundColumn SortExpression="CustomerID" HeaderText="CustomerID" HeaderButtonType="TextButton"
- DataField= "CustomerID">
- </radG:GridBoundColumn>
- <radG:GridBoundColumn SortExpression="ContactName" HeaderText="Contact Name" HeaderButtonType="TextButton"
- DataField= "ContactName">
- </radG:GridBoundColumn>
- <radG:GridBoundColumn SortExpression="CompanyName" HeaderText="Company" HeaderButtonType="TextButton"
- DataField= "CompanyName">
- </radG:GridBoundColumn>
</Columns>
- <SortExpressions>
- <radG:GridSortExpression FieldName="CompanyName"></radG:GridSortExpression>
- </SortExpressions>
</MasterTableView>
- <SelectedItemStyle ForeColor="White" BackColor="DarkBlue" CssClass=""></SelectedItemStyle>
- </radg:radgrid> -
-
-
- - Gets or sets an integer value representing the current page index. - - Note that the Paging must be enabled ( must - be true) in order to use this property. - - zero-based int representing the index of the current page. - - - - Gets a reference to the GridTableItemStyle object that allows you to set the - appearance of the item selected for editing in a Telerik RadGrid - control. - - - A reference to the GridTableItemStyle that represents the style of the item being - edited in a Telerik RadGrid control. - - Supported in: 3.0, 2.0, 1.1, 1.0 .NET Framework - - Use the EditItemStyle property to control the appearance of the item being - edited in a Telerik RadGrid control. This property is read-only; - however, you can set the properties of the GridTableItemStyle object it returns. - The properties can be set declaratively using one of the following methods: - - Place an attribute in the opening tag of the Telerik RadGrid - control in the form Property-Subproperty, where Subproperty is a property of - the GridTableItemStyle object (for example, EditItemStyle-ForeColor). - Nest a <EditItemStyle> element between the opening and closing tags - of the Telerik RadGrid control. - - The properties can also be set programmatically in the form - Property.Subproperty (for example, EditItemStyle.ForeColor). Common settings - usually include a custom background color, foreground color, and font - properties. - - - The following code example demonstrates how to use the EditItemStyle property to - define a custom style for the item being edited in a Telerik RadGrid - control. - - <%@ Page Language="VB" %> - - <%@ Register Assembly="Telerik.Web.UI" Namespace="Telerik.Web.UI" TagPrefix="telerik" %> - - <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> - - <html xmlns="http://www.w3.org/1999/xhtml" > - <head runat="server"> - <title>Untitled Page</title> - </head> - <body> - <form id="form1" runat="server"> - <div> - <radG:RadGrid - DataSourceID="SqlDataSource1" - ID="RadGrid1" - runat="server" - Skin="" > - <EditItemStyle BackColor="red" /> - <MasterTableView> - <Columns> - <radG:GridEditCommandColumn> - </radG:GridEditCommandColumn> - </Columns> - </MasterTableView> - </radG:RadGrid> - <!-- This example uses Microsoft SQL Server and connects --> - <!-- to the Northwind sample database. Use an ASP.NET --> - <!-- expression to retrieve the connection string value --> - <!-- from the Web.config file. --> - <asp:SqlDataSource - ID="SqlDataSource1" - runat="server" - ConnectionString="<$ ConnectionStrings>" - SelectCommand="SELECT TOP 5 [CustomerID], [ContactName], [CompanyName] FROM [Customers]"> - </asp:SqlDataSource> - </div> - </form> - </body> - </html> - - - - - - Gets a reference to the GridTableItemStyle object that allows you to set the - appearance of the footer item in a Telerik RadGrid control. - - - A reference to the GridTableItemStyle that represents the style of the footer - item in a Telerik RadGrid control. - - - Use the FooterItemStyle property to control the appearance of the footer item - in a Telerik RadGrid control. This property is read-only; however, you - can set the properties of the GridTableItemStyle object it returns. The properties - can be set declaratively using one of the following methods: - - Place an attribute in the opening tag of the Telerik RadGrid - control in the form Property-Subproperty, where Subproperty is a property of - the GridTableItemStyle object (for example, FooterItemStyle-ForeColor). - Nest a <FooterItemStyle> element between the opening and closing - tags of the Telerik RadGrid control. - - The properties can also be set programmatically in the form - Property.Subproperty (for example, FooterItemStyle.ForeColor). Common settings - usually include a custom background color, foreground color, and font - properties. - - - The following code example demonstrates how to use the SelectedItemStyle property - to define a custom style for the footer item in a Telerik RadGrid - control. - - <%@ Page Language="VB" %> - - <%@ Register Assembly="Telerik.Web.UI" Namespace="Telerik.Web.UI" TagPrefix="telerik" %> - - <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> - - <html xmlns="http://www.w3.org/1999/xhtml" > - <head runat="server"> - <title>Untitled Page</title> - </head> - <body> - <form id="form1" runat="server"> - <div> - <radG:RadGrid - DataSourceID="SqlDataSource1" - ID="RadGrid1" - runat="server" - Skin="" - ShowFooter="true" > - <FooterStyle BackColor="red" /> - </radG:RadGrid> - <!-- This example uses Microsoft SQL Server and connects --> - <!-- to the Northwind sample database. Use an ASP.NET --> - <!-- expression to retrieve the connection string value --> - <!-- from the Web.config file. --> - <asp:SqlDataSource - ID="SqlDataSource1" - runat="server" - ConnectionString="<$ ConnectionStrings>" - SelectCommand="SELECT TOP 5 [CustomerID], [ContactName], [CompanyName] FROM [Customers]"> - </asp:SqlDataSource> - </div> - </form> - </body> - </html> - - - Supported in: 3.0, 2.0, 1.1, 1.0 .NET Framework - - - Gets the style properties of the heading section in the RadGrid control. - - A reference to the that represents the style - of the header item in a Telerik RadGrid control. - - - Use the HeaderItemStyle property to control the appearance of the header item - in a Telerik RadGrid control. This property is read-only; however, you - can set the properties of the GridTableItemStyle object it returns. The properties - can be set declaratively using one of the following methods: - - Place an attribute in the opening tag of the Telerik RadGrid - control in the form Property-Subproperty, where Subproperty is a property of - the GridTableItemStyle object (for example, HeaderItemStyle-ForeColor). - Nest a <HeaderItemStyle> element between the opening and closing - tags of the Telerik RadGrid control. - - The properties can also be set programmatically in the form - Property.Subproperty (for example, HeaderItemStyle.ForeColor). Common settings - usually include a custom background color, foreground color, and font - properties. - - - The ShowHeader property must be set to true for this property to - be visible. - - - The following code example demonstrates how to use the SelectedItemStyle property - to define a custom style for the header item in a Telerik RadGrid - control. - - <%@ Page Language="VB" %> - - <%@ Register Assembly="Telerik.Web.UI" Namespace="Telerik.Web.UI" TagPrefix="telerik" %> - - <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> - - <html xmlns="http://www.w3.org/1999/xhtml" > - <head runat="server"> - <title>Untitled Page</title> - </head> - <body> - <form id="form1" runat="server"> - <div> - <radG:RadGrid - DataSourceID="SqlDataSource1" - ID="RadGrid1" - runat="server" - Skin="" > - <HeaderStyle BackColor="red" /> - </radG:RadGrid> - <!-- This example uses Microsoft SQL Server and connects --> - <!-- to the Northwind sample database. Use an ASP.NET --> - <!-- expression to retrieve the connection string value --> - <!-- from the Web.config file. --> - <asp:SqlDataSource - ID="SqlDataSource1" - runat="server" - ConnectionString="<$ ConnectionStrings>" - SelectCommand="SELECT TOP 5 [CustomerID], [ContactName], [CompanyName] FROM [Customers]"> - </asp:SqlDataSource> - </div> - </form> - </body> - </html> - - - Supported in: 3.0, 2.0, 1.1, 1.0 .NET Framework - - - - Gets a reference to the GridTableItemStyle object that allows you to set the - appearance of the filter item in a Telerik RadGrid control. - - - A reference to the GridTableItemStyle that represents the style of the filter - item in a Telerik RadGrid control. - - - Use the FilterItemStyle property to control the appearance of the filter item - in a Telerik RadGrid control. This property is read-only; however, you - can set the properties of the GridTableItemStyle object it returns. The properties - can be set declaratively using one of the following methods: - - Place an attribute in the opening tag of the Telerik RadGrid - control in the form Property-Subproperty, where Subproperty is a property of - the GridTableItemStyle object (for example, FilterItemStyle-ForeColor). - Nest a <FilterItemStyle> element between the opening and closing - tags of the Telerik RadGrid control. - - The properties can also be set programmatically in the form - Property.Subproperty (for example, FilterItemStyle.ForeColor). Common settings - usually include a custom background color, foreground color, and font - properties. - - - The following code example demonstrates how to use the SelectedItemStyle property - to define a custom style for the filter item in a Telerik RadGrid - control. - - <%@ Page Language="VB" %> - - <%@ Register Assembly="Telerik.Web.UI" Namespace="Telerik.Web.UI" TagPrefix="telerik" %> - - <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> - - <html xmlns="http://www.w3.org/1999/xhtml" > - <head runat="server"> - <title>Untitled Page</title> - </head> - <body> - <form id="form1" runat="server"> - <div> - <radG:RadGrid - DataSourceID="SqlDataSource1" - ID="RadGrid1" - runat="server" - Skin="" - AllowFilteringByColumn="true"> - <FilterItemStyle BackColor="red" /> - </radG:RadGrid> - <!-- This example uses Microsoft SQL Server and connects --> - <!-- to the Northwind sample database. Use an ASP.NET --> - <!-- expression to retrieve the connection string value --> - <!-- from the Web.config file. --> - <asp:SqlDataSource - ID="SqlDataSource1" - runat="server" - ConnectionString="<$ ConnectionStrings>" - SelectCommand="SELECT TOP 5 [CustomerID], [ContactName], [CompanyName] FROM [Customers]"> - </asp:SqlDataSource> - </div> - </form> - </body> - </html> - - - Supported in: 3.0, 2.0, 1.1, 1.0 .NET Framework - - - - Gets a reference to the GridTableItemStyle object that allows you to set the - appearance of the command item in a Telerik RadGrid control. - - - A reference to the GridTableItemStyle that represents the style of the command - item in a Telerik RadGrid control. - - - Use the CommandItemStyle property to control the appearance of the command - item in a Telerik RadGrid control. This property is read-only; however, - you can set the properties of the GridTableItemStyle object it returns. The - properties can be set declaratively using one of the following methods: - - Place an attribute in the opening tag of the Telerik RadGrid - control in the form Property-Subproperty, where Subproperty is a property of - the GridTableItemStyle object (for example, CommandItemStyle-ForeColor). - Nest a <CommandItemStyle> element between the opening and closing - tags of the Telerik RadGrid control. - - The properties can also be set programmatically in the form - Property.Subproperty (for example, CommandItemStyle.ForeColor). Common settings - usually include a custom background color, foreground color, and font - properties. - - - The following code example demonstrates how to use the SelectedItemStyle property - to define a custom style for the command item in a Telerik RadGrid - control. - - <%@ Page Language="VB" %> - - <%@ Register Assembly="Telerik.Web.UI" Namespace="Telerik.Web.UI" TagPrefix="telerik" %> - - <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> - - <html xmlns="http://www.w3.org/1999/xhtml" > - <head runat="server"> - <title>Untitled Page</title> - </head> - <body> - <form id="form1" runat="server"> - <div> - <radG:RadGrid - DataSourceID="SqlDataSource1" - ID="RadGrid1" - runat="server" - Skin=""> - <CommandItemStyle BackColor="red" /> - <MasterTableView CommandItemDisplay="TopAndBottom"> - </MasterTableView> - </radG:RadGrid> - <!-- This example uses Microsoft SQL Server and connects --> - <!-- to the Northwind sample database. Use an ASP.NET --> - <!-- expression to retrieve the connection string value --> - <!-- from the Web.config file. --> - <asp:SqlDataSource - ID="SqlDataSource1" - runat="server" - ConnectionString="<$ ConnectionStrings>" - SelectCommand="SELECT TOP 5 [CustomerID], [ContactName], [CompanyName] FROM [Customers]"> - </asp:SqlDataSource> - </div> - </form> - </body> - </html> - - - Supported in: 3.0, 2.0, 1.1, 1.0 .NET Framework - - - - Gets a reference to the GridTableItemStyle object that allows you to set the - appearance of the active item in a Telerik RadGrid control. - - - A reference to the GridTableItemStyle that represents the style of the actibe - item in a Telerik RadGrid control. - - - Use the ActiveItemStyle property to control the appearance of the active item - in a Telerik RadGrid control. This property is read-only; however, you - can set the properties of the GridTableItemStyle object it returns. The properties - can be set declaratively using one of the following methods: - - Place an attribute in the opening tag of the Telerik RadGrid - control in the form Property-Subproperty, where Subproperty is a property of - the GridTableItemStyle object (for example, ActiveItemStyle-ForeColor). - Nest a <ActiveItemStyle> element between the opening and closing - tags of the Telerik RadGrid control. - - The properties can also be set programmatically in the form - Property.Subproperty (for example, ActiveItemStyle.ForeColor). Common settings - usually include a custom background color, foreground color, and font - properties. - - - The following code example demonstrates how to use the SelectedItemStyle property - to define a custom style for the active item in a Telerik RadGrid - control. - - Supported in: 3.0, 2.0, 1.1, 1.0 .NET Framework - - - Gets a collection of all GridDataItems. - - The RadGrid control automatically populates the Items collection by creating - a GridDataItem object for each record in the data source and then adding each - object to the collection. This property is commonly used to access a specific item - in the control or to iterate though the entire collection of items. - - You cannot use this collection to get special Items like Header, Pager, Footer, - etc. Handle event and use the event arguments to - get a reference to such items. - - - all grid data items as - - - - Gets a reference to the GridTableItemStyle object that allows you to set the - appearance of the data items in a RadGrid control. - - - A reference to the GridTableItemStyle that represents the style of the data items - in a Telerik RadGrid control. - - Supported in: 3.0, 2.0, 1.1, 1.0 .NET Framework - - - <%@ Page language="VB" %> - - <%@ Register Assembly="Telerik.Web.UI" Namespace="Telerik.Web.UI" TagPrefix="telerik" %> - - <!DOCTYPE html Public "-//W3C//DTD XHTML 1.0 Transitional//EN" - "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> - <html > - <head id="Head1" runat="server"> - <title>GridView ItemStyle And AlternatingItemStyle Example</title> - </head> - <body> - <form id="form1" runat="server"> - <h3>GridView ItemStyle And AlternatingItemStyle Example</h3> - - <radG:RadGrid id="CustomersGridView" - datasourceid="CustomersSource" - autogeneratecolumns="true" - Skin="" - runat="server"> - - <itemstyle backcolor="LightCyan" - forecolor="DarkBlue" - font-italic="true"/> - - <alternatingitemstyle backcolor="PaleTurquoise" - forecolor="DarkBlue" - font-italic="true"/> - - </radG:RadGrid> - - <!-- This example uses Microsoft SQL Server And connects --> - <!-- To the Northwind sample database. Use an ASP.NET --> - <!-- expression To retrieve the connection String value --> - <!-- from the Web.config file. --> - <asp:sqldatasource id="CustomersSource" - selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]" - connectionstring="<<see cref="NorthWindConnectionString">$ ConnectionStrings</see>>" - runat="server"/> - - </form> - </body> - </html> - - - - Use the ItemStyle property to control the appearance of the data items in a - Telerik RadGrid control. When the AlternatingItemStyle property is also set, the data - items are displayed alternating between the ItemStyle settings and the - AlternatingItemStyle settings. This property is read-only; however, you can set the - properties of the GridTableItemStyle object it returns. - - - - - Gets the number of pages required to display the records of the data source - in a Telerik RadGrid control. - - - When the paging feature is enabled (by setting the AllowPaging property to true), - use the PageCount property to determine the total number of pages required to display - the records in the data source. This value is calculated by dividing the total number - of records in the data source by the number of records displayed in a page (as - specified by the PageSize property) and rounding up. - - The number of pages in a Telerik RadGrid control. - - The following code example demonstrates how to use the PageCount property to - determine the total number of pages displayed in the Telerik RadGrid - control. - - <%@ Page Language="C#" %> - - <%@ Register Assembly="Telerik.Web.UI" Namespace="Telerik.Web.UI" TagPrefix="telerik" %> - - <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> - - <script runat="server"> - protected void RadGrid1_PreRender(object sender, EventArgs e) - { - Label1.Text = RadGrid1.PageCount.ToString(); - } - </script> - - <html xmlns="http://www.w3.org/1999/xhtml" > - <head runat="server"> - <title>Untitled Page</title> - </head> - <body> - <form id="form1" runat="server"> - <div> - <radG:RadGrid - DataSourceID="SqlDataSource1" - ID="RadGrid1" - AllowPaging="true" - runat="server" OnPreRender="RadGrid1_PreRender"> - </radG:RadGrid> - <!-- This example uses Microsoft SQL Server and connects --> - <!-- to the Northwind sample database. Use an ASP.NET --> - <!-- expression to retrieve the connection string value --> - <!-- from the Web.config file. --> - <asp:SqlDataSource - ID="SqlDataSource1" - runat="server" - ConnectionString="<$ ConnectionStrings>" - SelectCommand="SELECT [CustomerID], [ContactName], [CompanyName] FROM [Customers]"> - </asp:SqlDataSource> - <asp:Label ID="Label1" runat="server" Text="Label"></asp:Label></div> - </form> - </body> - </html> - - - <%@ Page Language="VB" @ Register Assembly="Telerik.Web.UI" Namespace="Telerik.Web.UI" TagPrefix="telerik" %> - - <!DOCTYPE html Public "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> - - <script runat="server"> - - Protected Sub RadGrid1_PreRender(ByVal sender As Object, ByVal e As System.EventArgs) - Label1.Text = RadGrid1.PageCount.ToString() - End Sub - </script> - - <html xmlns="http://www.w3.org/1999/xhtml" > - <head runat="server"> - <title>Untitled Page</title> - </head> - <body> - <form id="form1" runat="server"> - <div> - <radG:RadGrid - DataSourceID="SqlDataSource1" - ID="RadGrid1" - AllowPaging="true" - runat="server" OnPreRender="RadGrid1_PreRender" > - </radG:RadGrid> - <!-- This example uses Microsoft SQL Server And connects --> - <!-- To the Northwind sample database. Use an ASP.NET --> - <!-- expression To retrieve the connection String value --> - <!-- from the Web.config file. --> - <asp:SqlDataSource - ID="SqlDataSource1" - runat="server" - ConnectionString="<$ ConnectionStrings>" - SelectCommand="SELECT [CustomerID], [ContactName], [CompanyName] FROM [Customers]"> - </asp:SqlDataSource> - <asp:Label ID="Label1" runat="server" Text="Label"></asp:Label></div> - </form> - </body> - </html> - - - - - - Gets a reference to the GridPagerStyle object that allows you to - set the appearance of the page item in a Telerik RadGrid control. - - - A GridPagerStyle object that contains the style properties of - the paging section of the RadGrid control. The default value is an - empty GridPagerStyle object. - - - Use this property to provide a custom style for the paging section of the - RadGrid control. Common style attributes that can be adjusted - include forecolor, backcolor, font, and content alignment within the cell. - Providing a different style enhances the appearance of the RadGrid - control. - To specify a custom style for the paging section, place the - <PagerStyle> tags between the opening and closing tags of - the RadGrid control. You can then list the style attributes within - the opening <PagerStyle> tag. - - - The following code example demonstrates how to use the PagerStyle - property to specify a custom style for the page selection elements of the - RadGrid control. - - <%@ Page Language="VB" %> - - <%@ Import Namespace="System.Data" <see cref="> <"/>@ Register TagPrefix="telerik" Namespace="Telerik.Web.UI" Assembly="Telerik.Web.UI" %> - <!DOCTYPE html Public "-//W3C//DTD XHTML 1.0 Transitional//EN" - "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> - <html xmlns="http://www.w3.org/1999/xhtml"> - - <script runat="server"> - - Function CreateDataSource() As ICollection - Dim dt As New DataTable() - Dim dr As DataRow - - dt.Columns.Add(New DataColumn("IntegerValue", GetType(Int32))) - dt.Columns.Add(New DataColumn("StringValue", GetType(String))) - dt.Columns.Add(New DataColumn("DateTimeValue", GetType(String))) - dt.Columns.Add(New DataColumn("BoolValue", GetType(Boolean))) - - Dim i As Integer - For i = 0 To 99 - dr = dt.NewRow() - - dr(0) = i - dr(1) = "Item " & i.ToString() - dr(2) = DateTime.Now.ToShortDateString() - If i Mod 2 <> 0 Then - dr(3) = True - Else - dr(3) = False - End If - - dt.Rows.Add(dr) - Next i - - Dim dv As New DataView(dt) - Return dv - End Function 'CreateDataSource - - Sub ShowStats() - lblEnabled.Text = "AllowPaging is " & RadGrid1.AllowPaging - lblCurrentIndex.Text = "CurrentPageIndex is " & RadGrid1.CurrentPageIndex - lblPageCount.Text = "PageCount is " & RadGrid1.PageCount - lblPageSize.Text = "PageSize is " & RadGrid1.PageSize - End Sub 'ShowStats - - - Protected Sub RadGrid1_NeedDataSource(ByVal source As Object, ByVal e As Telerik.Web.UI.GridNeedDataSourceEventArgs) Handles RadGrid1.NeedDataSource - RadGrid1.DataSource = CreateDataSource() - ShowStats() - End Sub - - Protected Sub CheckBox1_CheckedChanged(ByVal sender As Object, ByVal e As System.EventArgs) Handles CheckBox1.CheckedChanged - If CheckBox1.Checked Then - RadGrid1.PagerStyle.Mode = GridPagerMode.NumericPages - Else - RadGrid1.PagerStyle.Mode = GridPagerMode.NextPrev - End If - - RadGrid1.Rebind() - End Sub - </script> - - <head id="Head1" runat="server"> - <title>RadGrid Paging Example</title> - </head> - <body> - <h3> - RadGrid Paging Example</h3> - <form id="form1" runat="server"> - <radG:RadGrid ID="RadGrid1" runat="server" AllowPaging="True"> - <PagerStyle Mode="NumericPages" HorizontalAlign="Right"></PagerStyle> - <HeaderStyle BackColor="#aaaadd"></HeaderStyle> - <AlternatingItemStyle BackColor="#eeeeee"></AlternatingItemStyle> - </radG:RadGrid> - <br /> - <asp:CheckBox ID="CheckBox1" runat="server" Text="Show numeric page navigation buttons" - AutoPostBack="true" /> - <br /> - <table style="background-color: #eeeeee; padding: 6"> - <tr> - <td style="display: inline"> - <asp:Label ID="lblEnabled" runat="server" /><br /> - <asp:Label ID="lblCurrentIndex" runat="server" /><br /> - <asp:Label ID="lblPageCount" runat="server" /><br /> - <asp:Label ID="lblPageSize" runat="server" /><br /> - </td> - </tr> - </table> - </form> - </body> - </html> - - - <%@ Page Language="C#" %> - - <%@ Import Namespace="System.Data" <see cref="> <"/>@ Register TagPrefix="telerik" Namespace="Telerik.Web.UI" Assembly="Telerik.Web.UI" %> - <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" - "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> - <html xmlns="http://www.w3.org/1999/xhtml"> - - <script runat="server"> - ICollection CreateDataSource() - { - DataTable dt = new DataTable(); - DataRow dr; - dt.Columns.Add(new DataColumn("IntegerValue", typeof(Int32))); - dt.Columns.Add(new DataColumn("StringValue", typeof(string))); - dt.Columns.Add(new DataColumn("DateTimeValue", typeof(string))); - dt.Columns.Add(new DataColumn("BoolValue", typeof(bool))); - int i; - for (i = 0; (i <= 99); i++) - { - dr = dt.NewRow(); - dr[0] = i; - dr[1] = ("Item " + i.ToString()); - dr[2] = DateTime.Now.ToShortDateString(); - if (((i % 2) - != 0)) - { - dr[3] = true; - } - else - { - dr[3] = false; - } - dt.Rows.Add(dr); - } - DataView dv = new DataView(dt); - return dv; - } - - // CreateDataSource - void ShowStats() - { - lblEnabled.Text = ("AllowPaging is " + RadGrid1.AllowPaging); - lblCurrentIndex.Text = ("CurrentPageIndex is " + RadGrid1.CurrentPageIndex); - lblPageCount.Text = ("PageCount is " + RadGrid1.PageCount); - lblPageSize.Text = ("PageSize is " + RadGrid1.PageSize); - } - - // ShowStats - protected void RadGrid1_NeedDataSource(object source, Telerik.Web.UI.GridNeedDataSourceEventArgs e) - { - RadGrid1.DataSource = CreateDataSource(); - ShowStats(); - } - - protected void CheckBox1_CheckedChanged(object sender, System.EventArgs e) - { - if (CheckBox1.Checked) - { - RadGrid1.PagerStyle.Mode = GridPagerMode.NumericPages; - } - else - { - RadGrid1.PagerStyle.Mode = GridPagerMode.NextPrev; - } - RadGrid1.Rebind(); - } - </script> - - <head id="Head1" runat="server"> - <title>RadGrid Paging Example</title> - </head> - <body> - <h3> - RadGrid Paging Example</h3> - <form id="form1" runat="server"> - <radG:RadGrid ID="RadGrid1" runat="server" AllowPaging="True" OnNeedDataSource="RadGrid1_NeedDataSource"> - <PagerStyle Mode="NumericPages" HorizontalAlign="Right"></PagerStyle> - <HeaderStyle BackColor="#aaaadd"></HeaderStyle> - <AlternatingItemStyle BackColor="#eeeeee"></AlternatingItemStyle> - </radG:RadGrid> - <br /> - <asp:CheckBox ID="CheckBox1" runat="server" Text="Show numeric page navigation buttons" - AutoPostBack="true" OnCheckedChanged="CheckBox1_CheckedChanged" /> - <br /> - <table style="background-color: #eeeeee; padding: 6"> - <tr> - <td style="display: inline"> - <asp:Label ID="lblEnabled" runat="server" /><br /> - <asp:Label ID="lblCurrentIndex" runat="server" /><br /> - <asp:Label ID="lblPageCount" runat="server" /><br /> - <asp:Label ID="lblPageSize" runat="server" /><br /> - </td> - </tr> - </table> - </form> - </body> - </html> - - - Supported in: 3.0, 2.0, 1.1, 1.0 .NET Framework - - - - Gets or sets an integer value indicating the number of Items that a single page - in Telerik RadGrid will contain. - - - Note that the Paging must be enabled ( must - be true) in order to use this property. - - - integer, indicating the number of the Items that a single grid page would - contain. - - - - - Gets or sets a value indicating whether you will be able to select multiple rows - in Telerik RadGrid. By default this property is set to - false. - - - true if you can have multiple rows selected at once. Otherwise, - false. The default is false. - - - Note: You will not be able to select the Header, Footer or Pager - rows. - - - - - Gets or sets a value indicating whether Telerik RadGrid will allow - you to have multiple rows in edit mode. The default value is - false. - - - true if you can have more than one row in edit mode. Otherwise, - false. The default value is false. - - - - - You can see an example usage of this property in the following online example: - - - http://www.telerik.com/r.a.d.controls/Grid/Examples/Hierarchy/ThreeLevel/DefaultCS.aspx - - private void Page_Load(object sender, EventArgs e) - { - if (!IsPostBack) - { - RadGrid1.SelectedIndexes.Add(1, 0, 1, 0, 1); - //Index of 1, 0, 1, 0, 1 means: - //1 - item with index 1 in the MasterTabelView - //0 - detail table with index 0 - //1 - item with index 1 (the second item) in the first detail table - //0 - 0 the third-level detail table - //1 - the item with index 1 in the third-level table - } - } - - - Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Load - If Not IsPostBack Then - RadGrid1.SelectedIndexes.Add(1, 0, 1, 0, 1) - 'Index of 1, 0, 1, 0, 1 means: - '1 - item With index 1 In the MasterTabelView - '0 - detail table With index 0 - '1 - item With index 1 (the second item) In the first detail table - '0 - 0 the third-level detail table - '1 - the item With index 1 In the third-level table - End If - End Sub - - - Gets a collection of indexes of the selected items. - - returns of the indexes of all selected - Items. - - - - Gets a collection of the indexes of the Items that are in edit mode. - - - The following example demonstrates how to hide "Add New" button in the - CommandItemTemplate when Telerik RadGrid is in - edit/insert mode. The easiest way to check if Telerik RadGrid is in - edit mode is to check whether the - (EditIndexes gives a reference to this) is empty. - -
-            <CommandItemTemplate>
-                
-
-                <asp:LinkButton ID="LinkButton1" Visible="<%# (!(RadGrid1.MasterTableView.IsItemInserted || RadGrid1.EditIndexes.Count >0 )) %>"
-                
-
-            runat="server" CommandName="InitInsert">Add New</asp:LinkButton>
-                
-
-            </CommandItemTemplate>
-                
-
- - returns of all data items that are in edit - mode. - -
- - Gets a collection of the currently selected GridDataItems - Returns a of all selected data items. - - - Gets the data key value of the selected row in a RadGrid control. - The data key value of the selected row in a RadGrid control. - - The following code example demonstrates how to use the - SelectedValue property to determine the data key value of the - selected row in a RadGrid control. - - <%@ Page Language="VB" %> - - <%@ Register Assembly="Telerik.Web.UI" Namespace="Telerik.Web.UI" TagPrefix="telerik" %> - <!DOCTYPE html Public "-//W3C//DTD XHTML 1.0 Transitional//EN" - "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> - - <script runat="server"> - - Sub RadGrid1_SelectedIndexChanged(ByVal sender As Object, ByVal e As EventArgs) - - ' Display the primary key value of the selected row. - Label1.Text = "The primary key value of the selected row is " & _ - RadGrid1.SelectedValue.ToString() & "." - - End Sub - - </script> - - <html xmlns="http://www.w3.org/1999/xhtml"> - <head runat="server"> - <title>RadGrid SelectedValue Example</title> - </head> - <body> - <form id="form1" runat="server"> - <h3> - RadGrid SelectedValue Example</h3> - <asp:Label ID="Label1" ForeColor="Red" runat="server" /> - <radG:RadGrid ID="RadGrid1" DataSourceID="SqlDataSource1" - OnSelectedIndexChanged="RadGrid1_SelectedIndexChanged" - runat="server"> - <MasterTableView DataKeyNames="CustomerID"> - <Columns> - <radG:GridButtonColumn CommandName="Select" Text="Select" /> - </Columns> - </MasterTableView> - </radG:RadGrid> - <!-- This example uses Microsoft SQL Server And connects --> - <!-- To the Northwind sample database. Use an ASP.NET --> - <!-- expression To retrieve the connection String value --> - <!-- from the Web.config file. --> - <asp:SqlDataSource ID="SqlDataSource1" SelectCommand="SELECT * FROM [Customers]" - runat="server" ConnectionString="<<see cref="NorthwindConnectionString">$ ConnectionStrings</see>>" /> - </form> - </body> - </html> - - - - - <%@ Page Language="C#" %> - - <%@ Register Assembly="Telerik.Web.UI" Namespace="Telerik.Web.UI" TagPrefix="telerik" %> - <!DOCTYPE html Public "-//W3C//DTD XHTML 1.0 Transitional//EN" - "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> - - <script runat="server"> - protected void RadGrid1_SelectedIndexChanged(object sender, EventArgs e) - { - // Display the primary key value of the selected row. - Label1.Text = "The primary key value of the selected row is " + - RadGrid1.SelectedValue.ToString() + "."; - } - </script> - - <html xmlns="http://www.w3.org/1999/xhtml"> - <head runat="server"> - <title>RadGrid SelectedValue Example</title> - </head> - <body> - <form id="form1" runat="server"> - <h3> - RadGrid SelectedValue Example</h3> - <asp:Label ID="Label1" ForeColor="Red" runat="server" /> - <radG:RadGrid ID="RadGrid1" DataSourceID="SqlDataSource1" OnSelectedIndexChanged="RadGrid1_SelectedIndexChanged" - runat="server"> - <MasterTableView DataKeyNames="CustomerID"> - <Columns> - <radG:GridButtonColumn CommandName="Select" Text="Select" /> - </Columns> - </MasterTableView> - </radG:RadGrid> - <!-- This example uses Microsoft SQL Server And connects --> - <!-- To the Northwind sample database. Use an ASP.NET --> - <!-- expression To retrieve the connection String value --> - <!-- from the Web.config file. --> - <asp:SqlDataSource ID="SqlDataSource1" SelectCommand="SELECT * FROM [Customers]" - runat="server" ConnectionString="<<see cref="NorthwindConnectionString">$ ConnectionStrings</see>>" /> - </form> - </body> - </html> - - - - - - The EditItems collection contains InPlace - edit mode items. When you switch the edit type to EditForms, the - EditItems collection holds the currently edited items but not - their EditFormItems (which in this case hold the new values). See - this help article for more - details. - - You should not use this property to check whether there are items in edit mode. - The better approach is to use property instead. - - - - Gets a collection of all GridItems in edit mode. See the Remarks - for more info. - - of all items that are in edit mode. - - - - Gets a reference to the object that allows - you to set the appearance of the selected item in a Telerik RadGrid - control. - - - A reference to the GridTableItemStyle that represents the style of the selected - item in a Telerik RadGrid control. - - Supported in: 3.0, 2.0, 1.1, 1.0 .NET Framework - - The following code example demonstrates how to use the SelectedItemStyle property - to define a custom style for the selected item in a Telerik RadGrid - control. - - <%@ Page Language="VB" %> - - <%@ Register Assembly="Telerik.Web.UI" Namespace="Telerik.Web.UI" TagPrefix="telerik" %> - - <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> - - <html xmlns="http://www.w3.org/1999/xhtml" > - <head runat="server"> - <title>Untitled Page</title> - </head> - <body> - <form id="form1" runat="server"> - <div> - <radG:RadGrid - DataSourceID="SqlDataSource1" - ID="RadGrid1" - runat="server" - Skin=""> - <SelectedItemStyle BackColor="red" /> - <MasterTableView> - <Columns> - <radG:GridButtonColumn - Text="Select" - UniqueName="Select" - CommandName="Select"> - </radG:GridButtonColumn> - </Columns> - </MasterTableView> - </radG:RadGrid> - <!-- This example uses Microsoft SQL Server and connects --> - <!-- to the Northwind sample database. Use an ASP.NET --> - <!-- expression to retrieve the connection string value --> - <!-- from the Web.config file. --> - <asp:SqlDataSource - ID="SqlDataSource1" - runat="server" - ConnectionString="<$ ConnectionStrings>" - SelectCommand="SELECT TOP 5 [CustomerID], [ContactName], [CompanyName] FROM [Customers]"> - </asp:SqlDataSource> - </div> - </form> - </body> - </html> - - - - Use the SelectedItemStyle property to control the appearance of the selected - item in a Telerik RadGrid control. This property is read-only; however, - you can set the properties of the GridTableItemStyle object it returns. The - properties can be set declaratively using one of the following methods: - - Place an attribute in the opening tag of the Telerik RadGrid - control in the form Property-Subproperty, where Subproperty is a property of - the GridTableItemStyle object (for example, - SelectedItemStyle-ForeColor). - Nest a <SelectedItemStyle> element between the opening and closing - tags of the Telerik RadGrid control. - - The properties can also be set programmatically in the form - Property.Subproperty (for example, SelectedItemStyle.ForeColor). Common settings - usually include a custom background color, foreground color, and font - properties. - - - - - Gets or set a value indicating whether the footer item of the grid will be - shown. - - - Setting this property will affect all grid tables, unless they specify otherwise - explicitly. - - The default value of this property is false. - - - - Gets or set a value indicating whether the statusbar item of the grid will be - shown. - - - - This property is meaningful when the grid is in AJAX mode, i.e. when - is set to true. - - See this help topic for more - details. - - - true if the status bar item would be shown, otherwise - false. The default value of this property is - false. - - Status bar item - - - - Gets a object that contains variable - settings related to the status bar. - - -
-            <radG:RadGrid ID="RadGrid1" runat="server" DataSourceID="SqlDataSource1" ShowStatusBar="true" EnableAjax="true">
<StatusBarSettings LoadingText="Loading... Please wait!" ReadyText="Online" />
</radG:RadGrid> -
-
- returns a reference to object. -
- - - Gets or set a value indicating whether the header item of the grid will be - shown. - - This default value for this property is true. - - Setting this property will affect all grid tables, unless they specify otherwise - explicitly. - - - - - Gets or sets a value, indicating the total number of items in the data source - when custom paging is used. Thus the grid "understands" that the data source contains - the specified number of records and it should fetch merely part of them at a time to - execute requested operation. - - - int, representing the total number of items in the datasource. - The default value is 0. - - - If you set a value that is greater than the actual number of items, RadGrid - will show all available items plus empty pages (or whatever other content you set) - for the items that exceed the actual number. - For example you have a data source with 9'000 items and you set - VirtualItemCount to 10'000. If your page size is 1000, the grid will render 10 - pages and the last page will be empty (or with NoRecordsTemplate if you're using - such). - - - - - Gets a reference to object. The filtering menu - appears when the filter button on the is clicked. - - returns a reference to object. - - This property is meaningful only when you have filtering enabled (by setting - AllowFilteringByColumn="true"). - - - The following example demonstrates how to customize the filtering - menu: - [ASPX/ASCX]
<head - runat="server">
- <title>Filter menu change</title>
- <style type="text/css">
- .FilterMenuClass1 td
- {
- background-color: white;
- color: green;
- font-size: 10px;
- }
- .FilterMenuClass2 td
- {
- background-color: blue;
- color: white;
- font-size: 15px;
- }
- </style>
- </head>
- <body>
- <form id="form1" - runat="server">
- <div>
- <script type="text/javascript">
- function GridCreated()
- {
- window.setTimeout(SetFilterMenuClass(this), 500);
- }
- function - SetFilterMenuClass(gridObject)
- {
- gridObject.FilterMenu.SelectColumnBackColor = "";
- gridObject.FilterMenu.TextColumnBackColor = "";
-
- }
- </script>
- <radG:RadGrid ID="RadGrid1" - AllowFilteringByColumn="true" - DataSourceID=
- "AccessDataSource1"
- AllowSorting= "True" - runat="server">
- <FilterMenu - CssClass="FilterMenuClass1"></FilterMenu>
- <ClientSettings>
- <ClientEvents OnGridCreated="GridCreated" - />
- </ClientSettings>
- </radG:RadGrid>
- <br />
- <asp:AccessDataSource ID="AccessDataSource1" - DataFile="~/Grid/Data/Access/Nwind.mdb"
- SelectCommand= "SELECT TOP 10 CustomerID, CompanyName, - ContactName, ContactTitle, Address, PostalCode FROM Customers"
- runat= "server"></asp:AccessDataSource>
- <radG:RadGrid ID="RadGrid2" - DataSourceID="AccessDataSource1" - AllowSorting="True"
- AllowFilteringByColumn= "true" - Skin="Windows" - runat="server">
- <ClientSettings>
- <ClientEvents OnGridCreated="GridCreated" - />
- </ClientSettings>
- <FilterMenu - CssClass="FilterMenuClass2"></FilterMenu>
- </radG:RadGrid>
- </div>
- </form>
- </body>
- </html>
-
-
- - - Represents a HeaderContextMenu - - - - - Gets a collection () of all columns in - Telerik RadGrid. - - - This is one of the three columns collections in Telerik RadGrid. The - other two are AutoGeneratedColumns and - RenderColumns. - - returns a of all grid columns. - - The example below demonstrates how to use the - columns collection to define columns declaratively (in the ASPX) -
-            		<
-            		radG:RadGrid ID="RadGrid1" DataSourceID="AccessDataSource1" AllowPaging="True" ShowFooter="True"
runat="server" AutoGenerateColumns="False" AllowSorting="True" PageSize="3" Width="925px"
GridLines="None" CellPadding="0" Skin="Default" AllowMultiRowSelection="true">
<MasterTableView ShowFooter="True">
<RowIndicatorColumn Visible="False" UniqueName="RowIndicator">
<HeaderStyle Width="20px"></ - HeaderStyle>
</RowIndicatorColumn - >
<Columns - >
<radG:GridEditCommandColumn FooterText="EditCommand footer" UniqueName="EditCommandColumn"
HeaderText="Edit&#160;Command Column">
</radG:GridEditCommandColumn - >
<radG:GridClientSelectColumn UniqueName="CheckboxSelectColumn" HeaderText="CheckboxSelect column <br - />" />
<radG:GridBoundColumn FooterText="BoundColumn footer" UniqueName="CustomerID" SortExpression="CustomerID"
HeaderText="Bound<br/ - >Column" DataField="CustomerID">
</radG:GridBoundColumn - >
<radG:GridCheckBoxColumn FooterText="CheckBoxColumn footer" UniqueName="Bool" HeaderText="CheckBox< - br/>Column"
DataField="Bool">
</radG:GridCheckBoxColumn - >
<radG:GridDropDownColumn FooterText="DropDownColumn footer" UniqueName="DropDownListColumn"
ListTextField="ContactName" ListValueField="CustomerID" DataSourceID="AccessDataSource2"
HeaderText="DropDown< - br/>Column" DataField="CustomerID">
</radG:GridDropDownColumn - >
<radG:GridButtonColumn FooterText="PushButtonColumn< - br/>footer" DataTextFormatString="Select {0}"
ButtonType="PushButton" UniqueName="column" HeaderText="PushButton< - br/>Column"
CommandName="Select" DataTextField="CustomerID">
</radG:GridButtonColumn - >
<radG:GridButtonColumn FooterText="LinkButtonColumn footer" DataTextFormatString="Remove selection"
UniqueName="column1" HeaderText="LinkButton< - br/>Column" CommandName="Deselect"
DataTextField="CustomerID">
</radG:GridButtonColumn - >
<radG:GridHyperLinkColumn FooterText="HyperLinkColumn footer" DataTextFormatString="Search Google for '{0}'"
DataNavigateUrlField="CompanyName" UniqueName="CompanyName" DataNavigateUrlFormatString="http://www.google.com/search?hl=en&amp;q={0}&amp;btnG=Google+Search"
HeaderText="HyperLink< - br/>Column" DataTextField="CompanyName">
</radG:GridHyperLinkColumn - >
<radG:GridTemplateColumn UniqueName="TemplateColumn" SortExpression="CompanyName">
<FooterTemplate - >
<img src="Img/image.gif" alt="" style="vertical-align: middle" />
Template footer
</FooterTemplate - >
<HeaderTemplate - >
<table id="Table1" cellspacing="0" cellpadding="0" width="300" border="1">
<tr - >
<td colspan="2" align="center">
<b - >Contact details</b - ></td - >
</tr - >
<tr - >
<td style="width: 50%" align="center">
<asp:LinkButton CssClass="Button" Width="140" ID="btnContName" Text="Contact name"
Tooltip="Sort by ContactName" CommandName='Sort' CommandArgument='ContactName' runat="server" /></td>

<td style="width: 50%" align="center">
<asp:LinkButton CssClass="Button" Width="140" ID="btnContTitle" Text="Contact title"
Tooltip="Sort by ContactTitle" CommandName='Sort' CommandArgument='ContactTitle'
runat="server" /></td>

</tr - >
</table - >
</HeaderTemplate - >
<ItemTemplate - >
<table cellpadding="1" cellspacing="1" class="customTable">
<tr - >
<td style="width: 50%">
<%#Eval("ContactName") %>
</td - >
<td style="width: 50%">
<%#Eval("ContactTitle") %>
</td - >
</tr - >
<tr - >
<td colspan="2" align="center">
<a href='<%#"http://www.google.com/search?hl=en&amp;q=" + DataBinder.Eval(Container.DataItem, "ContactName") + "&amp;btnG=Google+Search"%>' >
<em - >Search Google for
<%#Eval("ContactName") %>
</em - ></a - >
</td - >
</tr - >
<tr - >
<td colspan="2" align="center">
<img src="Img/image.gif" alt="" />
</td - >
</tr - >
</table - >
</ItemTemplate - >
</radG:GridTemplateColumn - >
</Columns - >
</MasterTableView - >
<ClientSettings - >
<Selecting AllowRowSelect="true" />
</ClientSettings - >
</radG:RadGrid - > -
- - this.RadGrid1 = new RadGrid(); - - this.RadGrid1.NeedDataSource += new GridNeedDataSourceEventHandler(this.RadGrid1_NeedDataSource); - - this.RadGrid1.AutoGenerateColumns = false; - this.RadGrid1.MasterTableView.DataMember = "Customers"; - - GridBoundColumn boundColumn; - boundColumn = new GridBoundColumn(); - boundColumn.DataField = "CustomerID"; - boundColumn.HeaderText = "CustomerID"; - this.RadGrid1.MasterTableView.Columns.Add(boundColumn); - - .... - //Add to page controls collection - this.PlaceHolder1.Controls.Add( RadGrid1 ); - - - Me.RadGrid1 = New RadGrid - - AddHandler RadGrid1.NeedDataSource, AddressOf Me.RadGrid1_NeedDataSource - AddHandler RadGrid1.DetailTableDataBind, AddressOf Me.RadGrid1_DetailTableDataBind - - Me.RadGrid1.AutoGenerateColumns = False - Me.RadGrid1.MasterTableView.DataMember = "Customers" - - Dim boundColumn As GridBoundColumn - boundColumn = New GridBoundColumn - boundColumn.DataField = "CustomerID" - boundColumn.HeaderText = "CustomerID" - Me.RadGrid1.MasterTableView.Columns.Add(boundColumn) - - - ....'Add to page controls collection - Me.PlaceHolder1.Controls.Add(RadGrid1) - -
-
- - - - Gets a value indicating whether a detail table is currently binding. - - - - - - - - Gets or sets the ID of the control from which the Telerik RadGrid - control retrieves its list of data items. - - - The ID of a control that represents the data source from which the - Telerik RadGrid control retrieves its data. The default is - String.Empty. - - - If the Telerik RadGrid control has already been initialized when - you set the DataSourceID property. - This property cannot be set by themes or style sheet themes. - - - The following code example demonstrates how the DataSourceID property of a - Telerik RadGrid control is used. The Telerik RadGrid - control is associated to the SqlDataSource control by setting its DataSourceID - property to "SqlDataSource1", the ID of the SqlDataSource control. When the - DataSourceID property is set (instead of the DataSource property), the - Telerik RadGrid control automatically binds to the data source control - at run time. - - <%@ Page Language="VB" <see cref="> <"/>@ Register Assembly="Telerik.Web.UI" Namespace="Telerik.Web.UI" TagPrefix="telerik" %> - - <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> - - - <html xmlns="http://www.w3.org/1999/xhtml" > - <head runat="server"> - <title>Untitled Page</title> - </head> - <body> - <form id="form1" runat="server"> - <div> - <radG:RadGrid - DataSourceID="SqlDataSource1" - ID="RadGrid1" - runat="server"> - </radG:RadGrid> - <!-- This example uses Microsoft SQL Server and connects --> - <!-- to the Northwind sample database. Use an ASP.NET --> - <!-- expression to retrieve the connection string value --> - <!-- from the Web.config file. --> - <asp:SqlDataSource - ID="SqlDataSource1" - runat="server" - ConnectionString="<<see cref="NorthwindConnectionString">$ ConnectionStrings</see>>" - SelectCommand="SELECT [CustomerID], [ContactName], [CompanyName] FROM [Customers]"> - </asp:SqlDataSource> - <asp:Label ID="Label1" runat="server" Text="Label"></asp:Label></div> - </form> - </body> - </html> - - - - - - - - - - - Gets or sets a value indicating whether the filtering of all tables in the - hierarchy will be enabled, unless specified other by - GridTableView.AllowFilteringByColumn. - - - true, enables filtering for the whole grid. Otherwise, - false. Default is false. - - - - - Gets or sets a value indicating whether the header context menu should be - enabled. - - - - true if the header context menu feature is enabled; otherwise, - false. Default is false. - - - - - Gets or sets default path for the grid images when EnableEmbeddedSkins is set to false. - A string containing the path for the grid images. The default is string.Empty. - - - If this property is not set and EnableEmbeddedSkins is set to false the control will raise exception. - - - - - - - Gets or sets the value to increment or decrement the spin box when the up or down buttons are clicked. - - - - - Gets or sets a value indicating whether the user can use the UP ARROW and DOWN ARROW keys to increment/decrement values. - - - - - Gets or sets a value indicating whether the user can use the MOUSEWHEEL to increment/decrement values. - - - - This enumeration determines the direction in which child items will open. - - When set to Auto the direction is determined by the - following rules - - If the item is top level and the parent item flow is - Horizontal the direction will be Down. - If the item is top level and the parent item flow is - Vertical the direction will be Right. - If the item is subitem (a child of another menu item rather than the - RadMenu itself) the direction is - Right. - - Note: - If there is not enough room for the child items to - open the expand direction is inverted. For example Right becomes - Left, Down becomes Up and vice - versa. - - - - - The direction is determined by parent's ItemFlow and - level. - - - - Child items open above their parent. - - - Child items open below their parent. - - - Child items open from the left side of their parent. - - - Child items open from the right side of their parent. - - - Represents the different ways menu items can flow. - - The ItemFlow enumeration is used to specify the flow of submenu - items. - - - - - Items will flow one below the other - - - - - Items will flow one after another - - - - - - - - - - - - - Provides data for the events of the control. - - - - - Initializes a new instance of the - RadMenuEventArgs class. - - - A RadMenuItem which represents an item in the - RadMenu control. - - - - - Gets the referenced RadMenuItem in the - RadMenu control when the event is raised. - - - The referenced item in the RadMenu control when - the event is raised. - - - Use this property to programmatically access the item referenced in the - RadMenu when the event is raised. - - - - - Represents the method that handles the events provided by the control. - - - - Represents an item in the control. - - - The control is made up of items. Items which are immediate children - of the menu are root items. Items which are children of root items are child items. - - - An item usually stores data in two properties, the property and - the property. The value of the property is displayed - in the control, and the - property is used to store additional data. - - To create items, use one of the following methods: - - - Use declarative syntax to define items inline in your page or user control. - - - Use one of the constructors to dynamically create new instances of the - class. These items can then be added to the - Items collection of another item or menu. - - - Data bind the control to a data source. - - - - When the user clicks an item, the control can navigate - to a linked Web page, post back to the server or select that item. If the - property of an item is set, the - RadMenu control navigates to the linked page. By default, a linked page - is displayed in the same window or frame. To display the linked content in a different - window or frame, use the property. - - - Represents a single item in the RadMenu class. - - - The RadMenu control is made up of a hierarchy of menu items - represented by RadMenuItem objects. Menu items at the top level (level 0) - that do not have a parent menu item are called root or top-level menu items. A - menu item that has a parent menu item is called a submenu item. All root menu - items are stored in the Items collection of the - menu. Submenu items are stored in a parent menu item's - Items collection. You can access a menu item's parent - menu item by using the Owner property. - - To create the menu items for a RadMenu control, use one of the - following methods: - - Use declarative syntax to create static menu items. - Use a constructor to dynamically create new instances of the - RadMenuItem class. These RadMenuItem objects can then be added to the - Items collection of their owner. - Bind the Menu control to a data source. - - - When the user clicks a menu item, the Menu control can either navigate - to a linked Web page or simply post back to the server. If the - NavigateUrl property of a menu item is set, the - RadMenu control navigates to the linked page. By default, a linked page - is displayed in the same window or frame as the RadMenu - control. To display the linked content in a different window or frame, use the - Target property. - - - Each menu item has a Text and a - Value property. The value of the Text property - is displayed in the RadMenu control, while the Value property is - used to store any additional data about the menu item. - - - - - - Highlights the path from the item to the top of the menu. - - - The HighlightPath method applies the "rmFocused" CSS class to the item and - his ancestor items. As a results the "path" from the top level to that specific item - is highlighted. - - - - Creates a copy of the current RadMenuItem object. - A RadMenuItem which is a copy of the current one. - - Use the Clone method to create a copy of the current item. All - properties of the clone are set to the same values as the current ones. Child items are - not cloned. - - - - Initializes a new instance of the RadMenuItem class. - - Use this constructor to create and initialize a new instance of the - RadMenuItem class using default values. - - - The following example demonstrates how to add items to - RadMenu controls. - - RadMenuItem item = new RadMenuItem(); - item.Text = "News"; - item.NavigateUrl = "~/News.aspx"; - - RadMenu1.Items.Add(item); - - - Dim item As New RadMenuItem() - item.Text = "News" - item.NavigateUrl = "~/News.aspx" - - RadMenu1.Items.Add(item) - - - - - - Initializes a new instance of the RadMenuItem class with the - specified text data. - - - - Use this constructor to create and initialize a new instance of the - RadMenuItem class using the specified text. - - - - The following example demonstrates how to add items to - RadMenu controls. - - RadMenuItem item = new RadMenuItem("News"); - - RadMenu1.Items.Add(item); - - - Dim item As New RadMenuItem("News") - - RadMenu1.Items.Add(item) - - - - The text of the item. The Text property is set to the value - of this parameter. - - - - - Initializes a new instance of the RadMenuItem class with the - specified text and URL to navigate to. - - - - Use this constructor to create and initialize a new instance of the - RadMenuItem class using the specified text and URL. - - - - This example demonstrates how to add items to RadMenu - controls. - - RadMenuItem item = new RadMenuItem("News", "~/News.aspx"); - - RadMenu1.Items.Add(item); - - - Dim item As New RadMenuItem("News", "~/News.aspx") - - RadMenu1.Items.Add(item) - - - - The text of the item. The Text property is set to the value - of this parameter. - - - The url which the item will navigate to. The - NavigateUrl property is set to the value of this - parameter. - - - - - Gets a object that contains the child items of the current RadMenuItem. - - - A that contains the child items of the current RadMenuItem. By default - the collection is empty (the item has no children). - - - Use the Items property to access the child items of the RadMenuItem. You can also use the Items property to - manage the child items - you can add, remove or modify items. - - - The following example demonstrates how to programmatically modify the properties of a child item. - - RadMenuItem item = RadMenu1.FindItemByText("Test"); - item.Items[0].Text = "Example"; - item.Items[0].NavigateUrl = "http://www.example.com"; - - - Dim item As RadMenuItem = RadMenu1.FindItemByText("Test") - item.Items(0).Text = "Example" - item.Items(0).NavigateUrl = "http://www.example.com" - - - - - - Gets the object which contains the current menu item. - - - The object which contains the menu item. It might be an instance of the - class or the - class depending on the hierarchy level. - - - The value is of the type which is - implemented by the and the - classes. Use the Owner property when - recursively traversing items in the RadMenu control. - - - - Gets or sets the data item represented by the item. - - An object representing the data item to which the Item is bound to. The - DataItem property will always return null when - accessed outside of MenuItemDataBound - event handler. - - - This property is applicable only during data binding. Use it along with the - MenuItemDataBound event to perform - additional mapping of fields from the data item to - RadMenuItem properties. - - - The following example demonstrates how to map fields from the data item to - - RadMenuItem properties. It assumes the user has subscribed to the - MenuItemDataBound:RadMenu.MenuItemDataBound - event. - - - private void RadMenu1_MenuItemDataBound(object sender, Telerik.WebControls.ItemStripEventArgs e) - { - RadMenuItem item = e.Item; - DataRowView dataRow = (DataRowView) e.Item.DataItem; - - item.ImageUrl = "image" + dataRow["ID"].ToString() + ".gif"; - item.NavigateUrl = dataRow["URL"].ToString(); - } - - - Sub RadMenu1_MenuItemDataBound(ByVal sender As Object, ByVal e As ItemStripEventArgs) Handles RadMenu1.MenuItemDataBound - Dim item As RadMenuItem = e.Item - Dim dataRow As DataRowView = CType(e.Item.DataItem, DataRowView) - - item.ImageUrl = "image" + dataRow("ID").ToString() + ".gif" - item.NavigateUrl = dataRow("URL").ToString() - End Sub - - - - - Gets or sets the text caption for the menu item. - The text of the item. The default value is empty string. - - This example demonstrates how to set the text of the item using the - Text property. - - <telerik:RadMenu ID="RadMenu1" - runat="server">
- <Items>
- <telerik:RadMenuItem Text="News" />
- <telerik:RadMenuItem Text="News" />
- </Items>
- </telerik:RadMenu>
-
-
- - Use the Text property to specify the text to display for the - item. - -
- - Gets or sets the value associated with the menu item. - The value associated with the item. The default value is empty string. - - Use the Value property to specify or determine the value associated - with the item. - - - - Gets or sets the template for displaying the item. - - A ITemplate implemented object that contains the template - for displaying the item. The default value is a null reference (Nothing in - Visual Basic), which indicates that this property is not set. - - To specify common display for all menu items use the - ItemTemplate property of the - RadMenu class. - - - - The following template demonstrates how to add a Calendar control in certain - menu item. - ASPX: - <telerik:RadMenu runat="server" ID="RadMenu1"> -
- <Items> -
- <telerik:RadMenuItem Text="Date"> -
- <Items> -
- <telerik:RadMenuItem Text="SelectDate"> -
- <ItemTemplate> -
- <asp:Calendar runat="server" ID="Calendar1" - /> -
- </ItemTemplate> -
- </telerik:RadMenuItem> -
- </Items> -
- </telerik:RadMenuItem> -
- </Items> -
- </telerik:RadMenu> -
-
- - Specifies the settings for child item behavior. - - An instance of the MenuItemGroupSettings - class. - - - You can customize the following settings - - item flow - expand direction - horizontal offset from the parent item - vertical offset from the parent item - width - height - - - For more information check - MenuItemGroupSettings. - - - - - - Gets or sets the expand behavior of the menu item. - - When set to ExpandMode.WebService the RadMenuItem will populate its children from the web service specified by the RadMenu.WebService and RadMenu.WebServiceMethod properties. - - - On of the MenuItemExpandMode values. The default value is ClientSide. - - - - Gets or sets the URL to link to when the item is clicked. - - The URL to link to when the item is clicked. The default value is empty - string. - - - The following example demonstrates how to use the NavigateUrl - property - - <telerik:RadMenu id="RadMenu1" - runat="server">
- <Items>
- <telerik:RadMenuItem Text="News" NavigateUrl="~/News.aspx" - />
- <telerik:RadMenuItem Text="External URL" - NavigateUrl="http://www.example.com" />
- </Items>
- </telerik:RadMenu>
-
-
- - Use the NavigateUrl property to specify the URL to link to when - the item is clicked. Use "~" (tilde) in front of an URL within the same ASP.NET - application. When specifying external URL do not forget the protocol (e.g. - "http://"). - -
- - - Gets or sets a value indicating whether clicking on the item will - postback. - - - True if the menu item should postback; otherwise - false. By default all the items will postback provided the user - has subscribed to the ItemClick event. - - - If you subscribe to the ItemClick all menu - items will postback. To turn off that behavior you should set the - PostBack property to false. This property cannot - be set in design time. - - - - Gets the RadMenu instance which contains the item. - - Use this property to obtain an instance to the - RadMenu object containing the item. - - - - - Sets or gets whether the item is separator. It also represents a logical state of - the item. Might be used in some applications for keyboard navigation to omit processing - items that are marked as separators. - - - - - Gets or sets the Cascading Style Sheet (CSS) class applied when the menu item is - disabled. - - - The CSS class applied when the menu item is disabled. The default value is - "disabled". - - - By default the visual appearance of disabled menu items is defined in the skin CSS - file. You can use the DisabledCssClass property to specify unique - appearance for the menu item when it is disabled. - - - - - Gets or sets the Cascading Style Sheet (CSS) class applied when the menu item is - opened (its child items are visible). - - - The CSS class applied when the menu item is opened. The default value is - "expanded". - - - By default the visual appearance of opened menu items is defined in the skin CSS - file. You can use the ExpandedCssClass property to specify unique - appearance for the menu item when it is opened. - - - - - Gets or sets the Cascading Style Sheet (CSS) class applied when the menu item is - focused. - - - The CSS class applied when the menu item is focused. The default value is - "focused". - - - By default the visual appearance of focused menu items is defined in the skin CSS - file. You can use the FocusedCssClass property to specify unique - appearance for the menu item when it is focused. - - - - - Gets or sets the Cascading Style Sheet (CSS) class applied when the menu item is - clicked. - - - The CSS class applied when the menu item is clicked. The default value is - "clicked". - - - By default the visual appearance of clicked menu items is defined in the skin CSS - file. You can use the ClickedCssClass property to specify unique - appearance for the menu item when it is clicked. - - - - - Gets or sets the target window or frame to display the Web page content linked to - when the menu item is clicked. - - - The target window or frame to load the Web page linked to when the Item is - selected. Values must begin with a letter in the range of a through z (case - insensitive), except for the following special values, which begin with an - underscore: - - - - _blank - Renders the content in a new window without - frames. - - - _parent - Renders the content in the immediate frameset - parent. - - - _self - Renders the content in the frame with focus. - - - _top - Renders the content in the full window without - frames. - - - The default value is empty string. - - - - Use the Target property to specify the frame or window that displays the - Web page linked to when the menu item is clicked. The Web page is specified by - setting the NavigateUrl property. - - If this property is not set, the Web page specified by the - NavigateUrl property is loaded in the current window. - - - The following example demonstrates how to use the Target - property - ASPX: - <telerik:RadMenu runat="server" ID="RadMenu1"> - <Items> - <telerik:RadMenuItem Target="_blank" - NavigateUrl="http://www.google.com" /> - </Items> - </telerik:RadMenu> - - - - - Manages the item level of a particular Item instance. This property allows easy - implementation/separation of the menu items in levels. - - - - Gets or sets the path to an image to display for the item. - - The path to the image to display for the item. The default value is empty - string. - - - Use the ImageUrl property to specify the image for the item. If - the ImageUrl property is set to empty string no image will be - rendered. Use "~" (tilde) when referring to images within the current ASP.NET - application. - - - The following example demonstrates how to specify the image to display for - the item using the ImageUrl property. - - <telerik:RadMenu id="RadMenu1" - runat="server">
- <Items>
- <telerik:RadMenuItem ImageUrl="~/Img/inbox.gif" Text="Index" - />
- <telerik:RadMenuItem ImageUrl="~/Img/outbox.gif" Text="Outbox" - />
- </Items>
- </telerik:RadMenu>
-
-
-
- - - Gets or sets the path to an image to display for the item when the user moves the - mouse over the item. - - - The path to the image to display when the user moves the mouse over the item. The - default value is empty string. - - - <telerik:RadMenu id="RadMenu1" runat="server">
- <Items>
- <telerik:RadMenuItem ImageUrl="~/Img/inbox.gif" - HoveredImageUrl="~/Img/inboxOver.gif" Text="Index" />
- <telerik:RadMenuItem ImageUrl="~/Img/outbox.gif" - HoveredImageUrl="~/Img/outboxOver.gif" Text="Outbox" />
- </Items>
- </telerik:RadMenu>
-
- - Use the HoveredImageUrl property to specify the image that will be - used when the user moves the mouse over the item. If the HoveredImageUrl - property is set to empty string the image specified by the ImageUrl - property will be used. Use "~" (tilde) when referring to images within the current - ASP.NET application. - -
- - - Gets or sets the path to an image to display for the item when the user clicks the - item. - - - The path to the image to display when the user clicks the item. The default value - is empty string. - - - <telerik:RadMenu id="RadMenu1" runat="server">
- <Items>
- <telerik:RadMenuItem ImageUrl="~/Img/inbox.gif" - ClickedImageUrl="~/Img/inboxClicked.gif" Text="Index" />
- <telerik:RadMenuItem ImageUrl="~/Img/outbox.gif" - ClickedImageUrl="~/Img/outboxClicked.gif" Text="Outbox" - />
- </Items>
- </telerik:RadMenu>
-
- - Use the ClickedImageUrl property to specify the image that will be - used when the user clicks the item. If the ClickedImageUrl - property is set to empty string the image specified by the ImageUrl - property will be used. Use "~" (tilde) when referring to images within the current - ASP.NET application. - -
- - Gets or sets the path to an image to display when the items is disabled. - - The path to the image to display when the item is disabled. The default value is - empty string. - - - Use the DisabledImageUrl property to specify the image that will - be used when the item is disabled. If the DisabledImageUrl property is - set to empty string the image specified by the ImageUrl property will - be used. Use "~" (tilde) when referring to images within the current ASP.NET - application. - - - <telerik:RadMenu id="RadMenu1" runat="server">
- <Items>
- <telerik:RadMenuItem ImageUrl="~/Img/inbox.gif" - DisabledImageUrl="~/Img/inboxDisabled.gif" Text="Index" - />
- <telerik:RadMenuItem ImageUrl="~/Img/outbox.gif" - DisabledImageUrl="~/Img/outboxDisabled.gif" Text="Outbox" - />
- </Items>
- </telerik:RadMenu>
-
-
- - Gets or sets the path to an image to display when the items is expanded. - - The path to the image to display when the item is expanded. The default value is - empty string. - - - <telerik:RadMenu id="RadMenu1" runat="server">
- <Items>
- <telerik:RadMenuItem ImageUrl="~/Img/inbox.gif" - ExpandedImageUrl="~/Img/inboxExpanded.gif" Text="Index" - />
- <telerik:RadMenuItem ImageUrl="~/Img/outbox.gif" - ExpandedImageUrl="~/Img/outboxExpanded.gif" Text="Outbox" - />
- </Items>
- </telerik:RadMenu>
-
- - Use the ExpandedImageUrl property to specify the image that will - be used when the item is expanded. If the ExpandedImageUrl property is - set to empty string the image specified by the ImageUrl property will - be used. Use "~" (tilde) when referring to images within the current ASP.NET - application. - -
- - - A collection of RadMenuItem objects in a - RadMenu control. - - - The RadMenuItemCollection class represents a collection of - RadMenuItem objects. The RadMenuItem objects in turn represent - menu items within a RadMenu control. - - - Use the indexer to programmatically retrieve a - single RadMenuItem from the collection, using array notation. - - - Use the Count property to determine the total - number of menu items in the collection. - - - Use the Add method to add menu items in the collection. - - - Use the Remove method to remove menu items from the - collection. - - - - - - - - Initializes a new instance of the class. - - The owner of the collection. - - - - Appends the specified object to the end of the current . - - - The to append to the end of the current . - - - The following example demonstrates how to programmatically add items in a - RadMenu control. - - RadMenuItem newsItem = new RadMenuItem("News"); - RadMenu1.Items.Add(newsItem); - - - Dim newsItem As RadMenuItem = New RadMenuItem("News") - RadMenu1.Items.Add(newsItem) - - - - - - Searches the RadMenuItemCollection control for the first - RadMenuItem with a Text property equal to - the specified value. - - - A RadMenuItem whose Text property is equal - to the specified value. - - - The method returns the first item matching the search criteria. This method is not recursive. If no item is - matching then null (Nothing in VB.NET) is - returned. - - The value to search for. - - - - Searches the RadMenu control for the first - RadMenuItem with a Text property equal to - the specified value. - - - A RadMenuItem whose Text property is equal - to the specified value. - - - The method returns the first item matching the search criteria. If no item is - matching then null (Nothing in VB.NET) is - returned. - - The value to search for. - A Boolean indicating a case-sensitive or insensitive comparison (true indicates a case-insensitive comparison). - - - - Searches the RadMenuItemCollection control for the first - RadMenuItem with a Value property equal - to the specified value. - - - A RadMenuItem whose Value property is - equal to the specified value. - - - The method returns the first item matching the search criteria. This method is not recursive. If no item is - matching then null (Nothing in VB.NET) is - returned. - - The value to search for. - - - - Searches the RadMenu control for the first - RadMenuItem with a Value property equal - to the specified value. - - - A RadMenuItem whose Value property is - equal to the specified value. - - - The method returns the first item matching the search criteria. If no item is - matching then null (Nothing in VB.NET) is - returned. - - The value to search for. - A Boolean indicating a case-sensitive or insensitive comparison (true indicates a case-insensitive comparison). - - - - Searches the items in the collection for a RadMenuItem which contains the specified attribute and attribute value. - - The name of the target attribute. - The value of the target attribute - The RadMenuItem that matches the specified arguments. Null (Nothing) is returned if no node is found. - This method is not recursive. - - - - Returns the first RadMenuItem - that matches the conditions defined by the specified predicate. - The predicate should returns a boolean value. - - - The following example demonstrates how to use the FindItem method. - - void Page_Load(object sender, EventArgs e) - { - RadMenu1.FindItem(ItemWithEqualsTextAndValue); - } - private static bool ItemWithEqualsTextAndValue(RadMenuItem item) - { - if (item.Text == item.Value) - { - return true; - } - else - { - return false; - } - } - - - Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs) - RadMenu1.FindItem(ItemWithEqualsTextAndValue) - End Sub - Private Shared Function ItemWithEqualsTextAndValue(ByVal item As RadMenuItem) As Boolean - If item.Text = item.Value Then - Return True - Else - Return False - End If - End Function - - - The Predicate <> that defines the conditions of the element to search for. - - - - Determines whether the specified object is in the current - . - - - The object to find. - - - true if the current collection contains the specified object; - otherwise, false. - - - - - Copies the contents of the current into the - specified array of objects. - - The target array. - The index to start copying from. - - - Appends the specified array of objects to the end of the - current . - - - The following example demonstrates how to use the AddRange method - to add multiple items in a single step. - - RadMenuItem[] items = new RadMenuItem[] { new RadMenuItem("First"), new RadMenuItem("Second"), new RadMenuItem("Third") }; - RadMenu1.Items.AddRange(items); - - - Dim items() As RadMenuItem = {New RadMenuItem("First"), New RadMenuItem("Second"), New RadMenuItem("Third")} - RadMenu1.Items.AddRange(items) - - - - The array of to append to the end of the current . - - - - - Determines the index of the specified object in the collection. - - - The to locate. - - - The zero-based index of item within the current , - if found; otherwise, -1. - - - - - Inserts the specified object in the current - at the specified index location. - - - The zero-based index location at which to insert the . - - - The to insert. - - - - - Removes the specified object from the current - . - - - The RadMenuItem object to remove. - - - - - Removes the object at the specified index - from the current . - - - The zero-based index of the index to remove. - - - - - Gets the object at the specified index in - the current . - - - The zero-based index of the to retrieve. - - - The at the specified index in the - current . - - - - Represents settings controlling child item behavior. - - - - - - - - - - - - - - - - - - - Gets or sets the flow of child items. - - One of the ItemFlow enumeration values. The default - value is Vertical. - - - Use the Flow property to customize the flow of child menu items. - By default RadMenu mimics the behavior of Windows and child items - (apart from top level ones) flow vertically. - - - - Gets or sets the direction in which child items will open. - - One of the ExpandDirection enumeration values. - The default value is Auto. - - - Use the ExpandDirection property to specify different expand - direction than the automatically determined one. See the - ExpandDirection description for more information. - - - - - Gets or sets a value indicating the horizontal offset of child menu items - considering their parent. - - - An integer specifying the horizontal offset of child menu items (measured in - pixels). The default value is 0 (no offset). - - - Use the OffsetX property to change the position where child - items will appear. - - To customize the vertical offset use the OffsetY - property. - - - - - - Gets or sets a value indicating the vertical offset of child menu items - considering their parent. - - - An integer specifying the vertical offset of child menu items (measured in - pixels). The default value is 0 (no offset). - - - Use the OffsetY property to change the position where child - items will appear. - - To customize the horizontal offset use the OffsetX - property. - - - - - - Gets or sets a value indicating the width of child menu items (the whole item - group). - - - A Unit that represents the width of the child item group. The - default value is Unit.Empty. - - - If the total width of menu items exceeds the Width property - scrolling will be applied. - - - - - Gets or sets a value indicating the height of child menu items (the whole item - group). - - - A Unit that represents the height of the child item group. The - default value is Unit.Empty. - - - If the total height of menu items exceeds the Height property - scrolling will be applied. - - - - - The localization strings to be used in RadScheduler. - - - - Specifies the view mode of a RadScheduler control. - - - - A view that spans a single day. All day-events are displayed in a separate row on - top. - - - - - A view that spans seven days. Each day is displayed as in DayView mode and the - current date is highlighted. - - - - A view that spans a whole month. The current date is highlighted. - - - A view that spans a single day with appointments grouped by resource - - - - The Timeline view spans an arbitrary time period. It is divided in slots with - user selectable duration. - - - - - ScriptManager derived class to add the ability to combine multiple - smaller scripts into a larger one as a way to reduce the number - of files the client must download - - - - - Gets or sets a value indicating if RadScriptManager should check the Telerik.Web.UI.WebResource - handler existence in the application configuration file. - - - When EnableHandlerDetection set to true, RadScriptManager automatically checks if the - HttpHandler it uses is registered to the application configuration file and throws - an exception if the HttpHandler registration missing. Set this property to false - if your scenario uses a file to output the combined scripts, or when running in Medium trust. - - - - - Specifies whether or not multiple script references should be combined into a single file - - - When EnableScriptCombine set to true, the script references of the controls - on the page are combined to a single file, so that only one <script> - tag is output to the page HTML - - - - - Specifies whether or not the combined output will be compressed. - - - In some cases the browsers do not recognize compressed streams (e.g. if IE 6 lacks - an update installed). In some cases the Telerik.Web.UI.WebResource handler - cannot determine if to compress the stream. Set this property - to Disabled - if you encounter that problem. - The OutputCompression property works only when - EnableScriptCombine is set to true. - - - - - Specifies the URL of the HTTPHandler that combines and serves the scripts. - - - - The HTTPHandler should either be registered in the application configuration - file, or a file with the specified name should exist at the location, which - HttpHandlerUrl points to. - - - If a file is to serve the files, it should inherit the class Telerik.Web.UI.WebResource - - - - - - Summary description for DictionarySorter. - - - - - Saves the dictionary to a file. - - The output file name. - - - - Load a word list from a file. - - The import file name. - - - - Load a word list from a StreamReader. - - The import reader. - - - "Vowels" to test for - - - Prefixes when present which are not pronounced - - - Maximum length of an encoding, default is 4 - - - Encode a value with Double Metaphone - - @param value string to encode - @return an encoded string - - - Encode a value with Double Metaphone, optionally using the alternate - encoding. - - @param value string to encode - @param alternate use alternate encode - @return an encoded string - - - Check if the Double Metaphone values of two string values - are equal. - - @param value1 The left-hand side of the encoded {@link string#equals(Object)}. - @param value2 The right-hand side of the encoded {@link string#equals(Object)}. - @return true if the encoded strings are equal; - false otherwise. - @see #isDoubleMetaphoneEqual(string,string,bool) - - - Check if the Double Metaphone values of two string values - are equal, optionally using the alternate value. - - @param value1 The left-hand side of the encoded {@link string#equals(Object)}. - @param value2 The right-hand side of the encoded {@link string#equals(Object)}. - @param alternate use the alternate value if true. - @return true if the encoded strings are equal; - false otherwise. - - - Returns the maxCodeLen. - @return int - - - Sets the maxCodeLen. - @param maxCodeLen The maxCodeLen to set - - - Handles 'A', 'E', 'I', 'O', 'U', and 'Y' cases - - - Handles 'C' cases - - - Handles 'CC' cases - - - Handles 'CH' cases - - - Handles 'D' cases - - - Handles 'G' cases - - - Handles 'GH' cases - - - Handles 'H' cases - - - Handles 'J' cases - - - Handles 'L' cases - - - Handles 'P' cases - - - Handles 'R' cases - - - Handles 'S' cases - - - Handles 'SC' cases - - - Handles 'T' cases - - - Handles 'W' cases - - - Handles 'X' cases - - - Handles 'Z' cases - - - Complex condition 0 for 'C' - - - Complex condition 0 for 'CH' - - - Complex condition 1 for 'CH' - - - Complex condition 0 for 'L' - - - Complex condition 0 for 'M' - - - Determines whether or not a value is of slavo-germanic orgin. A value is - of slavo-germanic origin if it contians any of 'W', 'K', 'CZ', or 'WITZ'. - - - Determines whether or not a character is a vowel or not - - - Determines whether or not the value starts with a silent letter. It will - return true if the value starts with any of 'GN', 'KN', - 'PN', 'WR' or 'PS'. - - - Cleans the input - - - Gets the character at index index if available, otherwise - it returns Character.MIN_VALUE so that there is some sort - of a default - - - Shortcut method with 1 criteria - - - Shortcut method with 2 criteria - - - Shortcut method with 3 criteria - - - Shortcut method with 4 criteria - - - Shortcut method with 5 criteria - - - Shortcut method with 6 criteria - - - * Determines whether value contains any of the criteria - starting - * at index start and matching up to length length - - - Inner class for storing results, since there is the optional alternate - encoding. - - - - Initializes the length and offset arrays as well as the distance matrix. - - - - - Finds possible suggestions for a misspelled word. - - the misspelled word string - array of suggestion replacement strings - - - - Calculates Levenshtein distance for two given strings. - - String 1. - String 2. - Edit Distance. - - - - A custom interface that defines the access to the custom dictionary. - It can be used to replace the custom dictionary storage mechanism and store the words in a database or on a remote computer. - - - - - Reads a word from the storage. It should return null if no more words are present. - - - - - - Adds a new custom word. - - the new word - - - - The directory that contains the custom dictionary file. - Necessary only for file based storage -- it is set to the physical directory corresponding to RadSpell's DictPath property setting. - - - - - The language for the custom dictionary. It is usually a culture name like en-US or de-DE. - - - - - A custom appendix string that can be used to distinguish different custom dictionaries. It is passed the CustomAppendix of the RadSpell object. This way one can create different dictionaries for John and Mary. - - - - - This is the .NET 1.x implementation. - The .NET 2.0 one gets into an infinite loop when using the WordComparer. - - - - - Summary description for WordComparer. - - - - - ISpellCheckProvider interface -- defines the behavior that we need - from a component to do spell checking. - - - - - Summary description for TelerikSpellCheckProvider. - - - - - Create a new RadSpellChecker object. You need to pass a correct path to the folder that contains the dictionary files (*.TDF) - - - The method expects local paths. E.g. "C:\SomeFolder\RadControls\Spell\TDF". Transform URL's to local paths with the method. - C# - - SpellChecker checker = new SpellChecker(Server.MapPath("~/RadControls/Spell/TDF")); - - VB.NET - - - Dim checker As SpellChecker - checker = New SpellChecker(Server.MapPath("~/RadControls/Spell/TDF")) - - - - - - Cleans up any resources held by the SpellChecker object. It is an alias of the Dispose method. - - - - - Performs the actual spellchecking. It will be automatically called by the Errors property accessor. - - -- a collection with all the errors found. - - - - Adds a new word to the custom dictionary. It first checks if the word is already present in the current base or custom dictionaries. - - The new custom word. - - - - Clean up used resources. - - - - - Sets the text to be spellchecked. It can be plain text or HTML. - - - This property can be used to pass the text to the spellchecker engine programmatically. The engine can deal with plaintext or any HTML-like format. - It ignores text inside angle brackets (<>) and transforms HTML entities to their character values. E.g. &amp; becomes & - C#: - - using (SpellChecker checker = new SpellChecker(Server.MapPath("~/RadControls/Spell/TDF"))) - { - checker.Text = text; - return checker.Errors; - } - - VB.NET - - Dim checker As SpellChecker - Try - checker = New SpellChecker(Server.MapPath("~/RadControls/Spell/TDF")) - checker.Text = text - Return checker.Errors - Finally - checker.Dispose() - End Try - - - - - - The language of the dictionary to be used for spellchecking. It usually is the same as the corresponding TDF file (without the extension). - - - To spellcheck in German you have to have de-DE.tdf inside your dictionary folder, and set DictionaryLanguage to "de-DE" - C#: - - spellChecker.DictionaryLanguage = "de-DE"; - - VB.NET - - spellChecker.DictionaryLanguage = "de-DE" - - - The default is en-US - - - - The folder path that contains the TDF files. - - - The method expects local paths. E.g. "C:\SomeFolder\RadControls\Spell\TDF". Transform URL's to local paths with the method. - C# - - SpellChecker checker = new SpellChecker(Server.MapPath("~/RadControls/Spell/TDF")); - - VB.NET - - - Dim checker As SpellChecker - checker = New SpellChecker(Server.MapPath("~/RadControls/Spell/TDF")) - - - - - The suffix that gets appended to the custom dictionary file name. It is usually a user specific string that allows to distinguish dictionaries for different users. - Default filenames are Language + CustomAppendix + ".txt". - The default is -Custom - - - - - Specifies the edit distance. If you increase the value, the checking speed decreases but more suggestions are presented. It does not do anything for the phonetic spellchecking. - - The default is 1 - - - - Specifies whether or not to check words in CAPITALS (e.g. "UNESCO") - - The default is false - - - - Specifies whether or not to count repeating words as errors (e.g. "very very") - - The default is false - - - - Specifies whether or not to check words in Capitals (e.g. "Washington") - - The default is true - - - - Specifies whether or not to check words containing numbers (e.g. "l8r") - - The default is false - - - - Specifies the type name for the custom spell check provider - - - - - Specifies whether RadSpell should use the internal spellchecking algorithm or try to use Microsoft Word. The possible values are defined in the enum. - - The default is PhoneticProvider - - - - Configures the spellchecker engine, so that it knows whether to skip URL's, email addresses, and filenames and not flag them as erros. - - - - - - Manipulate the custom dictionary source. The new value must implement ICustomDictionarySource. - - - - - The fully qualified name of the type that will be used for the custom dictionary storage. The type name must include the assembly, culture and public key token. - A new instance will be created internally unless you set CustomDictionarySource directly. - - - - - The errors after the last spellcheck. The getter method will call automatically that. - - - - - - Contains the information about a spellcheck error. The most important properties are the mistaken word and its offset in the source text. - - - - - The offset in the source text. It is useful for locating the original word and replacing it with one of the suggestions. - - - - - The original word that the spellchecker has determined to be wrong. - - - - - Suggestions for replacing the mistaken word. - - - - - - A collection that stores objects. - - - - - - - - Initializes a new instance of . - - - - - - - Initializes a new instance of . - - - - - - Adds a with the specified value to the - . - - The to add. - - The index at which the new element was inserted. - - - - - - Copies the elements of an array to the end of the . - - - An array of type containing the objects to add to the collection. - - - None. - - - - - - - Adds the contents of another to the end of the collection. - - - - A containing the objects to add to the collection. - - - None. - - - - - - Gets a value indicating whether the - contains the specified . - - The to locate. - - if the is contained in the collection; - otherwise, . - - - - - - Copies the values to a one-dimensional instance at the - specified index. - - The one-dimensional that is the destination of the values copied from . - The index in where copying begins. - - None. - - is multidimensional. -or- The number of elements in the is greater than the available space between and the end of . - is . - is less than 's lowbound. - - - - - Returns the index of a in - the . - - The to locate. - - The index of the of in the - , if found; otherwise, -1. - - - - - - Inserts a into the at the specified index. - - The zero-based index where should be inserted. - The to insert. - None. - - - - - Returns an enumerator that can iterate through - the . - - None. - - - - - Removes a specific from the - . - - The to remove from the . - None. - is not found in the Collection. - - - - Represents the entry at the specified index of the . - - The zero-based index of the entry to locate in the collection. - - The entry at the specified index of the collection. - - is outside the valid range of indexes for the collection. - - - - The spellcheck provider enumeration. - - - - - The default provider. The same as PhoneticProvider - - - - - This provider uses the edit distance algorithm. It will work for non-western - languages. - - - - - This provider uses phonetic codes to provide "sounds like" word suggestions. Really effective for English, and less so for other languages. - - - - - This provider automates Microsoft Word via its COM Interop interface. - - - - - Specifies whether or not to check words in CAPITALS (e.g. 'UNESCO') - - - - - Specifies whether or not to check words in Capitals (e.g. 'Washington') - - - - - Specifies whether or not to count repeating words as errors (e.g. 'very very') - - - - - Specifies whether or not to check words containing numbers (e.g. 'l8r') - - - - - A control allowing the ability to combine multiple embedded stylesheet references - into a larger one as a way to reduce the number of files the client must download - - - - - Gets or sets a value indicating if RadStyleSheetManager should check the Telerik.Web.UI.WebResource - handler existence in the application configuration file. - - - When EnableHandlerDetection set to true, RadStyleSheetManager automatically checks if the - HttpHandler it uses is registered to the application configuration file and throws - an exception if the HttpHandler registration missing. Set this property to false - if your scenario uses a file to output the combined skins, or when running in Medium trust. - - - - - Specifies whether or not multiple embedded stylesheet references should be combined into a single file - - - When EnableStyleSheetCombine set to true, the stylesheet references of the controls - on the page are combined to a single file, so that only one <link> - tag is output to the page HTML - - - - - Specifies whether or not the combined output will be compressed. - - - In some cases the browsers do not recognize compressed streams (e.g. if IE 6 lacks - an update installed). In some cases the Telerik.Web.UI.WebResource handler - cannot determine if to compress the stream. Set this property - to Disabled - if you encounter that problem. - The OutputCompression property works only when - EnableStyleSheetCombine is set to true. - - - - - Specifies the URL of the HTTPHandler that combines and serves the stylesheets. - - - - The HTTPHandler should either be registered in the application configuration - file, or a file with the specified name should exist at the location, which - HttpHandlerUrl points to. - - - If a file is to serve the files, it should inherit the class Telerik.Web.UI.WebResource - - - - - - Defines properties that menu item containers (RadTreeView, - RadTreeNode) should implement - - - - Gets the parent IMenuItemContainer. - - - Gets the collection of child items. - - A RadTreeNodeCollection that represents the child - items. - - - Use this property to retrieve the child items. You can also use it to - programmatically add or remove items. - - - - Represents a node in the RadTreeView control. - - - The RadTreeView control is made up of nodes. Nodes which are immediate children - of the treeview are root nodes. Nodes which are children of root nodes are child nodes. - - - A node usually stores data in two properties, the Text property and - the Value property. The value of the Text property is displayed - in the RadTreeView control, and the Value property is used to store additional data. - - To create tree nodes, use one of the following methods: - - - Use declarative syntax to define nodes inline in your page or user control. - - - Use one of the constructors to dynamically create new instances of the - RadTreeNode class. These nodes can then be added to the - Nodes collection of another node or treeview. - - - Data bind the RadTreeView control to a data source. - - - - When the user clicks a tree node, the RadTreeView control can navigate - to a linked Web page, post back to the server or select that node. If the - NavigateUrl property of a node is set, the - RadTreeView control navigates to the linked page. By default, a linked page - is displayed in the same window or frame. To display the linked content in a different - window or frame, use the Target property. - - - - - Initializes a new instance of the RadTreeNode class. - - Use this constructor to create and initialize a new instance of the - RadTreeNode class using default values. - - - The following example demonstrates how to add node to - RadTreeView controls. - - RadTreeNode node = new RadTreeNode(); - node.Text = "News"; - node.NavigateUrl = "~/News.aspx"; - - RadTreeView1.Nodes.Add(node); - - - Dim node As New RadTreeNode() - node.Text = "News" - node.NavigateUrl = "~/News.aspx" - - RadTreeView1.Nodes.Add(node) - - - - - - Initializes a new instance of the RadTreeNode class with the - specified text data. - - - Use this constructor to create and initialize a new instance of the - RadTreeNode class using the specified text. - - - The following example demonstrates how to add nodes to - RadTreeView controls. - - RadTreeNode node = new RadTreeNode("News"); - - RadTreeView1.Nodes.Add(node); - - - Dim node As New RadTreeNode("News") - - RadTreeView1.Nodes.Add(node) - - - - The text of the node. The Text property is set to the value - of this parameter. - - - - - Initializes a new instance of the RadTreeNode class with the - specified text and value. - - - Use this constructor to create and initialize a new instance of the - RadTreeNode class using the specified text and value. - - - This example demonstrates how to add nodes to RadTreeView - controls. - - RadTreeNode node = new RadTreeNode("News", "NewsValue"); - - RadTreeView1.Nodes.Add(node); - - - Dim node As New RadTreeNode("News", "NewsValue") - - RadTreeView1.Nodes.Add(node) - - - - The text of the node. The Text property is set to the value - of this parameter. - - - The value of the node. The Value property is set to the value of this - parameter. - - - - - Initializes a new instance of the RadTreeNode class with the - specified text, value and URL. - - - Use this constructor to create and initialize a new instance of the - RadTreeNode class using the specified text, value and URL. - - - This example demonstrates how to add nodes to RadTreeView - controls. - - RadTreeNode node = new RadTreeNode("News", "NewsValue", "~/News.aspx"); - - RadTreeView1.Nodes.Add(node); - - - Dim node As New RadTreeNode("News", "NewsValue", "~/News.aspx") - - RadTreeView1.Nodes.Add(node) - - - - The text of the node. The Text property is set to the value - of this parameter. - - - The value of the node. The Value property is set to the value of this - parameter. - - - The url which the node will navigate to. The - NavigateUrl property is set to the value of this - parameter. - - - - - Returns the full path (location) of the node delimited by the specified character. - - The character to use as a delimiter - Returns the full path of the node delimited by the specified character. - - - - Collapses recursively all child nodes of the node. - - - - - Expands all parent nodes of the node. - - - - - Inserts a node before the current node. - - The node to be inserted. - - - - Inserts a node after the current node. - - The node to be inserted. - - - - Checks if the current node is ancestor of another node. - - The node to check for. - - True if the current node is ancestor of the other node; otherwise false. - - - - - Checks if the current node is descendant of another node node. - - The node to check for. - - True if the current node is descendant of the other node; otherwise false. - - - - - Toggles Expand/Collapse state of the node. - - - - - Expands all child nodes of the node. - - - - - Expands all parent nodes of the node. - - - - - Removes the node from the Nodes collection of its parent - - - The following example demonstrates how to remove a node. - - RadTreeNode node = RadTreeView1.Nodes[0]; - node.Remove(); - - - Dim node As RadTreeNode = RadTreeView1.Nodes(0) - node.Remove() - - - - - - Creates a copy of the current object. - - A which is a copy of the current one. - - Use the Clone method to create a copy of the current node. All - properties of the clone are set to the same values as the current ones. Child nodes are - copied as well. - - - - - Checks all child nodes of the current node. - - - - - Unchecks all child nodes of the current node. - - - - - Gets or sets the Cascading Style Sheet (CSS) class applied by default to the node. - - - By default the visual appearance of hovered nodes is defined in the skin CSS - file. You can use the CssClass property to specify unique - appearance for the node. - - - - - Gets or sets the tooltip shown for the node when the user hovers it with the mouse - - - A string representing the tooltip. The default value is empty string. - - - The ToolTip property is also used as the alt attribute of the node image (in case is set) - - - - - Gets or sets a value indicating whether the node is enabled. - - - true if the node is enabled; otherwise false. The default value is true. - - - Disabled nodes cannot be clicked, or expanded. - - - - - Gets a object that contains the child nodes of the current RadTreeNode. - - - A that contains the child nodes of the current RadTreeNode. By default - the collection is empty (the node has no children). - - - Use the Nodes property to access the child nodes of the RadTreeNode. You can also use the Nodes property to - manage the child nodes - you can add, remove or modify nodes. - - - The following example demonstrates how to programmatically modify the properties of a child node. - - RadTreeNode node = RadTreeView1.FindNodeByText("Test"); - node.Nodes[0].Text = "Example"; - node.Nodes[0].NavigateUrl = "http://www.example.com"; - - - Dim node As RadTreeNode = RadTreeView1.FindNodeByText("Test") - node.Nodes(0).Text = "Example" - node.Nodes(0).NavigateUrl = "http://www.example.com" - - - - - Gets the data item that is bound to the node - - An Object that represents the data item that is bound to the node. The default value is null (Nothing in Visual Basic), - which indicates that the node is not bound to any data item. The return value will always be null unless accessed within - a NodeDataBound event handler. - - - This property is applicable only during data binding. Use it along with the - NodeDataBound event to perform additional - mapping of fields from the data item to RadTreeNode properties. - - - The following example demonstrates how to map fields from the data item to - RadTreeNode properties. It assumes the user has subscribed to the - NodeDataBound event. - - private void RadTreeView1_NodeDataBound(object sender, Telerik.Web.UI.RadTreeNodeEventArgs e) - { - e.Node.ImageUrl = "image" + (string)DataBinder.Eval(e.Node.DataItem, "ID") + ".gif"; - e.Node.NavigateUrl = (string)DataBinder.Eval(e.Node.DataItem, "URL"); - } - - - Sub RadTreeView1_NodeDataBound(ByVal sender As Object, ByVal e As Telerik.Web.UI.RadTreeNodeEventArgs ) Handles RadTreeView1.NodeDataBound - e.Node.ImageUrl = "image" & DataBinder.Eval(e.Node.DataItem, "ID") & ".gif" - e.Node.NavigateUrl = CStr(DataBinder.Eval(e.Node.DataItem, "URL")) - End Sub - - - - - - Gets or sets the text displayed for the current node. - - - The text displayed for the node in the RadTreeView control. The default is empty string. - - - Use the Text property to specify or determine the text that is displayed for the node - in the RadTreeView control. - - - - - Gets or sets custom (user-defined) data associated with the current node. - - - A string representing the user-defined data. The default value is emptry string. - - - Use the Value property to associate custom data with a RadTreeNode object. - - - - - Gets or sets the URL to navigate to when the current node is clicked. - - - The URL to navigate to when the node is clicked. The default value is empty string which means that - clicking the current node will not navigate. - - - - Setting the NavigateUrl property will disable node selection and as a result the - NodeClick event won't be raised for the current node. - - - - - - Gets or sets the target window or frame in which to display the Web page content associated with the current node. - - - The target window or frame to load the Web page linked to when the node is - clicked. Values must begin with a letter in the range of a through z (case - insensitive), except for the following special values, which begin with an - underscore: - - - - _blank - Renders the content in a new window without frames. - - - _parent - Renders the content in the immediate frameset parent. - - - _self - Renders the content in the frame with focus. - - - _top - Renders the content in the full window without frames. - - - - The default value is empty string which means the linked resource will be loaded in the current window. - - - - Use the Target property to target window or frame in which to display the - Web page content associated with the current node. The Web page is specified by - the NavigateUrl property. - - - If this property is not set, the Web page specified by the - NavigateUrl property is loaded in the current window. - - - The Target property is taken into consideration only when the NavigateUrl - property is set. - - - - The following example demonstrates how to use the Target property - - - <telerik:RadTreeView id="RadTreeView1" runat="server">
- <Nodes>
- <telerik:RadTreeNode Text="News" NavigateUrl="~/News.aspx" - Target="_self" />
- <telerik:RadTreeNode Text="External URL" NavigateUrl="http://www.example.com" - Target="_blank" />
- </Nodes>
- </telerik:RadTreeView>
-
-
-
- - - Gets or sets the URL to an image which is displayed next to the text of a node. - - - The URL to the image to display for the node. The default value is empty - string which means by default no image is displayed. - - - Use the ImageUrl property to specify a custom image that will be - displayed before the text of the current node. - - - - The following example demonstrates how to specify the image to display for - the node using the ImageUrl property. - - - <telerik:RadTreeView id="RadTreeView1" runat="server">
- <Nodes>
- <telerik:RadTreeNodeImageUrl="~/Img/inbox.gif" - Text="Index"></telerik:RadTreeNode>
- <telerik:RadTreeNodeImageUrl="~/Img/outbox.gif" - Text="Outbox"></telerik:RadTreeNode>
- <telerik:RadTreeNodeImageUrl="~/Img/trash.gif" - Text="Trash"></telerik:RadTreeNode>
- <telerik:RadTreeNodeImageUrl="~/Img/meetings.gif" - Text="Meetings"></telerik:RadTreeNode>
- </Nodes>
- </telerik:RadTreeView> -
-
-
- - - Gets or sets the category of the node. - - - The Category property is similar to the Value property. You - can use it to associate custom data with the node. - - - This example illustrates how to use the Category property during the NodeDataBound event. - - - protected void RadTreeView1_NodeDataBound(object sender, RadTreeNodeEventArgs e) - { - //"NodeCategory" is the database column which provides data for the Category property. - e.Node.Category = DataBinder.Eval(e.Node.DataItem, "NodeCategory").ToString(); - } - - - Protected Sub RadTreeView1_NodeDataBound(ByVal sender As Object, ByVal e As RadTreeNodeEventArgs) Handles RadTreeView1.NodeDataBound - ' "NodeCategory" is the database column which provides data for the Category property. - e.Node.Category = DataBinder.Eval(e.Node.DataItem, "NodeCategory") - End Sub - - - - - Gets or sets the Cascading Style Sheet (CSS) class applied to the node when the mouse hovers it. - - - By default the visual appearance of hovered nodes is defined in the skin CSS - file. You can use the HoveredCssClass property to specify unique - appearance for a node when it is hoevered. - - - - - Gets or sets the Cascading Style Sheet (CSS) class applied to the node when it is disabled. - - - By default the visual appearance of disabled nodes is defined in the skin CSS - file. You can use the DisabledCssClass property to specify unique - appearance for a node when it is disabled. - - - - - Gets or sets the Cascading Style Sheet (CSS) class applied to the content - wrapper of the node. - - - You can use the ContentCssClass property to specify unique - appearance for a node content area and its children. Useful when using - CSS sprites. - - - - - Gets or sets the Cascading Style Sheet (CSS) class applied when node is - selected. - - - By default the visual appearance of selected nodes is defined in the skin CSS - file. You can use the SelectedCssClass property to specify unique - appearance for a node when it is selected. - - - - - Gets or sets a value specifying the URL of the image rendered when the node is expanded. - - - If the ExpandedImageUrl property is not set the ImageUrl property will be - used when the node is expanded. - - - - - Gets or sets a value specifying the URL of the image rendered when the node is selected. - - - If the SelectedImageUrl property is not set the ImageUrl property will be - used when the node is selected. - - - - - Gets or sets a value specifying the URL of the image rendered when the node is hovered with the mouse. - - - If the HoveredImageUrl property is not set the ImageUrl property will be - used when the node is hovered. - - - - - Gets or sets a value specifying the URL of the image rendered when the node is disabled. - - - If the DisabledImageUrl property is not set the ImageUrl property will be - used when the node is disabled. - - - - - Gets the level of the node. - - - An integer representing the level of the node. Root nodes are level 0 (zero). - - - - - Gets the RadTreeView which the node is part of. - - - - - Gets or sets a value indicating whether clicking on the node will - postback. - - - True if the node should postback; otherwise - false. - - - If you subscribe to the NodeClick all nodes - will postback. To turn off that behavior you can set the - PostBack property to false. - - - - Gets or sets a value indicating whether the node is expanded. - - true if the node is expanded; otherwise, - false. The default is false. - - - - - Gets or sets a value indicating whether the node is checked or not. - - - True if the node is checked; otherwise false. The default value - is false - - - - - Gets the checked state of the tree node - - - One of the TreeNodeExpandMode values. - - - - - Gets or sets a value indicating whether the node is checkable. A checkbox control is rendered - for checkable nodes. - - - If the CheckBoxes property set to true, RadTreeView automatically displays a checkbox next to each node. - You can set the Checkable property to false for nodes that do not need to display a checkbox. - - - - - Gets or sets a value indicating whether the node is selected. - If the current node is selected. - - - True if the node is selected; otherwise false. The default value is - false. - - - By default, only one node can be selected. You can enable multiple node selection by setting the - MultipleSelect property of the - parent RadTreeView to true - - - - - Gets or sets a value indicating whether the node can be dragged and dropped. - - - True if the user is able drag and drop the node; otherwise false. - The default value is true. - - - - - Gets or sets a value indicating whether the use can drag and drop nodes over this - node. - - - True if the user is able to drag and drop nodes over this node; otherwise - false. The default value is true. - - - - - Gets or sets a value indicating whether the use can edit the text of the node. - - - True if the node is editable; otherwise false. The default value - is true. - - - - - Gets or sets the expand behavior of the tree node. - - When set to ExpandMode.ServerSide the RadTreeView will fire a server event (NodeExpand) so you can populate the node on demand. - - - On of the TreeNodeExpandMode values. The default value is - ClientSide. - - - - - A Section 508 element - - - - - Gets the previous sibling of the node. - Gets the previous node sibling in the tree structure or returns null if this is the first node in the respective node group. - - - The previous sibling of the node or null (Nothing) if the node is first in its - parent RadTreeNodeCollection. - - - - - Gets the next sibling of the node. - - - The next sibling of the node or null (Nothing) if the node is last in its - parent RadTreeNodeCollection. - - - - Gets or sets the template for displaying the node. - - - An object implementing the ITemplate interface. The default value is a null reference - (Nothing in Visual Basic), which indicates that this property is not set. - - - To specify common display for all nodes use the property of - the control. - - - - The following template demonstrates how to add a Calendar control in certain - node. - ASPX: - - <telerik: RadTreeView runat="server" ID="RadTreeView1"> - <Nodes> - <telerik:RadTreeNode Text="Root Node" Expanded="True" > - <Nodes> - <telerik:RadTreeNode> - <NodeTemplate> - <asp:Calendar ID="Calendar1" runat="server"></asp:Calendar> - </NodeTemplate> - </telerik:RadTreeNode> - </Nodes> - </telerik:RadTreeNode> - </Nodes> - </telerik:RadTreeView> - - - - - - Gets the full path (location) of the node. - - - A slash delimited path of the node. The path is constructed based on the Text property - of the node and its parents. For example if the Text of the node it "Houston", its parent node is "Texas" and its parent (root) - is "U.S.A", FullPath will return "U.S.A/Texas/Houston" - - - - - Gets the parent node of the current node. - - - The parent node. If the the node is a root node null (Nothing) is returned. - - - - - Gets or sets a value indicating the ID of the displayed for the current node. - - - A string representing the ID of the context menu associated with the current node. The default value is empty string. - - - If the ContextMenuID property is not set the first context menu from the collection - will be used. - - - - - Gets or sets a value indicating whether a context menu should be displayed for the current node. - - - True if a context menu should be displayed for the current node; otherwise false. The default - value is false. - - - Use the EnableContextMenu property to disable the context menu for particular nodes. - - - - - A collection of RadTreeNode objects in a - control. - - - The RadTreeNodeCollection class represents a collection of - RadTreeNode objects. - - - Use the indexer to programmatically retrieve a - single RadTreeNode from the collection, using array notation. - - - Use the Count property to determine the total - number of menu items in the collection. - - - Use the Add method to add nodes in the collection. - - - Use the Remove method to remove nodes from the - collection. - - - - - - - - Initializes a new instance of the class. - - The owner of the collection. - - - - Appends the specified object to the end of the current - . - - - The to append to the end of the current - . - - - The following example demonstrates how to programmatically add nodes in a control. - - RadTreeNode newsNode = new RadTreeNode("News"); - RadTreeView1.Nodes.Add(newsNode); - - - Dim newsNode As RadTreeNode = New RadTreeNode("News") - RadTreeView1.Nodes.Add(newsNode) - - - - - - Removes the specified object from the current - . - - - The object to remove. - - - - - Removes the object at the specified index - from the current . - - - The zero-based index of the node to remove. - - - - - Determines whether the specified object is in the current - . - - - The object to find. - - - true if the current collection contains the specified object; - otherwise, false. - - - - - Copies the instances stored in the current - object to an System.Array object, beginning at the specified - index location in the System.Array. - - The System.Array to copy the instances to. - The zero-based relative index in array where copying begins. - - - Appends the specified array of objects to the end of the - current . - - - The following example demonstrates how to use the AddRange method - to add multiple nodes in a single step. - - RadTreeNode[] nodes = new RadTreeNode[] { new RadTreeNode("First"), new RadTreeNode("Second"), new RadTreeNode("Third") }; - RadTreeView1.Nodes.AddRange(nodes); - - - Dim nodes() As RadTreeNode = {New RadTreeNode("First"), New RadTreeNode("Second"), New RadTreeNode("Third")} - RadTreeView1.Nodes.AddRange(nodes) - - - - The array of to append to the end of the current - . - - - - - Determines the index of the specified object in the collection. - - - The to locate. - - - The zero-based index of tab within the current , - if found; otherwise, -1. - - - - - Inserts the specified object in the current - at the specified index location. - - The zero-based index location at which to insert the . - The to insert. - - - - Searches all nodes for a RadTreeNode with a Text property - equal to the specified text. - - The text to search for - A RadTreeNode whose Text property equals to the specified argument. Null (Nothing) is returned when no matching node is found. - This method is not recursive. - - - - Searches all nodes for a RadTreeNode with a Text property - equal to the specified text. - - The text to search for - A RadTreeNode whose Text property equals to the specified argument. Null (Nothing) is returned when no matching node is found. - This method is not recursive. - A Boolean indicating a case-sensitive or insensitive comparison (true indicates a case-insensitive comparison). - - - - Searches all nodes for a RadTreeNode with a Value property - equal to the specified value. - - The value to search for - A RadTreeNode whose Value property equals to the specified argument. Null (Nothing) is returned when no matching node is found. - This method is not recursive. - - - - Searches all nodes for a RadTreeNode with a Value property - equal to the specified value. - - The value to search for - A RadTreeNode whose Value property equals to the specified argument. Null (Nothing) is returned when no matching node is found. - This method is not recursive. - A Boolean indicating a case-sensitive or insensitive comparison (true indicates a case-insensitive comparison). - - - - Searches the nodes in the collection for a RadTreeNode which contains the specified attribute and attribute value. - - The name of the target attribute. - The value of the target attribute - The RadTreeNode that matches the specified arguments. Null (Nothing) is returned if no node is found. - This method is not recursive. - - - - Returns the first RadTreeNode - that matches the conditions defined by the specified predicate. - The predicate should returns a boolean value. - - - The following example demonstrates how to use the FindNode method. - - void Page_Load(object sender, EventArgs e) - { - RadTreeView1.FindNode(NodeWithEqualsTextAndValue); - } - private static bool NodeWithEqualsTextAndValue(RadTreeNode node) - { - if (node.Text == node.Value) - { - return true; - } - else - { - return false; - } - } - - - Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs) - RadTreeView1.FindNode(NodeWithEqualsTextAndValue) - End Sub - Private Shared Function NodeWithEqualsTextAndValue(ByVal node As RadTreeNode) As Boolean - If node.Text = node.Value Then - Return True - Else - Return False - End If - End Function - - - The Predicate <> that defines the conditions of the element to search for. - - - - - - - - - - - - Gets the object at the specified index in - the current . - - - The zero-based index of the to retrieve. - - - The at the specified index in the - current . - - - - A hierarchical control used to display a tree of nodes in a web page. - - - The RadTreeView control is used to display a list of nodes in a Web Forms - page. The RadTreeView control supports the following features: - - - - Danodeinding that allows the control to be populated from various - datasources. - - - Programmatic access to the RadTreeView object model - which allows dynamic creation of treeviews, populating with nodes and customizing the behavior - by various properties. - - - Customizable appearance through built-in or user-defined skins. - - -

nodes

- - The RadTreeView control is made up of tree of nodes represented - by objects. Nodes at the top level (level 0) are - called root nodes. An node that has a parent node is called a child node. All root - nodes are stored in the property of the RadTreeView control. Child nodes are - stored in the property of their parent . - - - Each node has a and a property. - The value of the property is displayed in the RadTreeView control, - while the property is used to store any additional data about the node, - such as data passed to the postback event associated with the node. When clicked, a node can - navigate to another Web page indicated by the property. - -
-
- - - Initializes a new instance of the RadTreeView class. - - - Use this constructor to create and initialize a new instance of the RadTreeView - control. - - - The following example demonstrates how to programmatically create a RadTreeView - control. - - void Page_Load(object sender, EventArgs e) - { - RadTreeView RadTreeView1 = new RadTreeView(); - RadTreeView1.ID = "RadTreeView1"; - - if (!Page.IsPostBack) - { - //RadTreeView persist its nodes in ViewState (if EnableViewState is true). - //Hence nodes should be created only on initial load. - - RadTreeNode sportNode = new RadTreeNode("Sport"); - RadTreeView1.Nodes.Add(sportNode); - - RadTreeNode newsNode = new RadTreeNode("News"); - RadTreeView1.Nodes.Add(newsNode); - } - - PlaceHolder1.Controls.Add(RadTreeView1); - } - - - Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Load - Dim RadTreeView1 As RadTreeView = New RadTreeView() - RadTreeView1.ID = "RadTreeView1" - - If Not Page.IsPostBack Then - 'RadTreeView persist its nodes in ViewState (if EnableViewState is true). - 'Hence nodes should be created only on initial load. - - Dim sportNode As RadTreeNode = New RadTreeNode("Sport") - RadTreeView1.Nodes.Add(sportNode) - - Dim newsNode As RadTreeNode = New RadTreeNode("News") - RadTreeView1.Nodes.Add(newsNode) - End If - - PlaceHolder1.Controls.Add(RadTreeView1) - End Sub - - - - - - Gets or sets the template displayed when child nodes are being loaded. - - - The following example demonstrates how to use the LoadingStatusTemplate to display an image. - - <telerik:RadTreeView runat="server" ID="RadTreeView1"> - <LoadingStatusTemplate> - <asp:Image runat="server" ID="Image1" ImageUrl="~/Img/loading.gif" /> - </LoadingStatusTemplate> - </telerik:RadTreeView> - - - - - - Gets a linear list of all nodes in the RadTreeView control. - - An IList<RadTreeNode> containing all nodes (from all hierarchy levels). - - - - Searches all nodes for a RadTreeNode with a Text property - equal to the specified text. - - The text to search for - A RadTreeNode whose Text property equals to the specified argument. Null (Nothing) is returned when no matching node is found. - - - - Searches all nodes for a RadTreeNode with a Text property - equal to the specified text. - - The text to search for - A Boolean indicating a case-sensitive or insensitive comparison (true indicates a case-insensitive comparison). - A RadTreeNode whose Text property equals to the specified argument. Null (Nothing) is returned when no matching node is found. - - - - Searches all nodes for a RadTreeNode with a Value property - equal to the specified value. - - The value to search for - A RadTreeNode whose Value property equals to the specified argument. Null (Nothing) is returned when no matching node is found. - - - - Searches all nodes for a RadTreeNode with a Value property - equal to the specified value. - - The value to search for - A Boolean indicating a case-sensitive or insensitive comparison (true indicates a case-insensitive comparison). - A RadTreeNode whose Value property equals to the specified argument. Null (Nothing) is returned when no matching node is found. - - - - Searches all nodes for a RadTreeNode with a NavigateUrl property - equal to the specified URL. - - The URL to search for - A RadTreeNode whose NavigateUrl property equals to the specified argument. Null (Nothing) is returned when no matching node is found. - - The ResolveUrl method is used to resolve NavigateUrl property before comparing it to the specified URL. - - - - - Returns the first RadTreeNode - that matches the conditions defined by the specified predicate. - The predicate should returns a boolean value. - - - The following example demonstrates how to use the FindNode method. - - void Page_Load(object sender, EventArgs e) - { - RadTreeView1.FindNode(NodeWithEqualsTextAndValue); - } - private static bool NodeWithEqualsTextAndValue(RadTreeNode node) - { - if (node.Text == node.Value) - { - return true; - } - else - { - return false; - } - } - - - Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs) - RadTreeView1.FindNode(NodeWithEqualsTextAndValue) - End Sub - Private Shared Function NodeWithEqualsTextAndValue(ByVal node As RadTreeNode) As Boolean - If node.Text = node.Value Then - Return True - Else - Return False - End If - End Function - - - The Predicate <> that defines the conditions of the element to search for. - - - - Populates the control from the specified XML string. - - The XML string to populate from. - - - - Populates the control from the specified XML file. - - The name of the XML file. - - - - Searches all nodes for a RadTreeNode which contains the specified attribute and attribute value. - - The name of the target attribute. - The value of the target attribute - The RadTreeNode that matches the specified arguments. Null (Nothing) is returned if no node is found. - - - - This methods clears the selected nodes of the current RadTreeView instance. Useful when you need to clear node selection after postback. - - - - - This methods clears the checked nodes of the current RadTreeView instance. Useful when you need to clear check selection after postback. - - - - - Checks all nodes of the current RadTreeView object. - - - - - Expands all nodes in the tree. - - - - - Collapses all nodes in the tree. - - - - - Gets a list of all client-side changes (adding a node, removing a node, changing a node's property) which have occurred. - - - A list of objects which represent all client-side changes the user has performed. - By default the ClientChanges property returns empty list. Client-changes are recorded if and only if the client-side - methods trackChanges()/commitChanges() have been invoked. - - - You can use the ClientChanges property to respond to client-side modifications such as - - adding a new item - removing existing item - clearing the children of an item or the control itself - changing a property of the item - - The ClientChanges property is available in the first postback (ajax) request after the client-side modifications - have taken place. After this moment the property will return empty list. - - - The following example demonstrates how to use the ClientChanges property - - foreach (ClientOperation<RadTreeNode> operation in RadTreeView1.ClientChanges) - { - RadTreeNode node = operation.Item; - - switch (operation.Type) - { - case ClientOperationType.Insert: - //A node has been inserted - operation.Item contains the inserted node - break; - case ClientOperationType.Remove: - //A node has been inserted - operation.Item contains the removed node. - //Keep in mind the node has been removed from the treeview. - break; - case ClientOperationType.Update: - UpdateClientOperation<RadTreeNode> update = operation as UpdateClientOperation<RadTreeNode> - //The "UpdateOperation" provides an additional property "PropertyName". This is the property whose value was changed from the client side. - break; - case ClientOperationType.Clear: - //All children of have been removed - operation.Item contains the parent node whose children have been removed. If operation.Item is null then the root nodes have been removed. - break; - } - } - - - For Each operation As ClientOperation(Of RadTreeNode) In RadTreeView1.ClientChanges - Dim node As RadTreeNode = operation.Item - Select Case operation.Type - Case ClientOperationType.Insert - 'A node has been inserted - operation.Item contains the inserted node - Exit Select - Case ClientOperationType.Remove - 'A node has been inserted - operation.Item contains the removed node. - 'Keep in mind the node has been removed from the treeview. - Exit Select - Case ClientOperationType.Update - Dim update As UpdateClientOperation(Of RadTreeNode) = TryCast(operation, UpdateClientOperation(Of RadTreeNode)) - 'The "UpdateOperation" provides an additional property "PropertyName". This is the property whose value was changed from the client side. - Exit Select - Case ClientOperationType.Clear - 'All children of have been removed - operation.Item contains the parent node whose children have been removed. If operation.Item is Nothing then the root nodes have been removed. - Exist Select - End Select - Next - - - - - - Gets a collection of RadTreeNode objects that represent the nodes in the control - that display a selected check box. - - An IList<RadTreeNode> containing the checked nodes. - - - When check boxes are displayed in the RadTreeView control (by setting the - CheckBoxes property to true), use the CheckedNodes - property to determine which nodes display a selected check box. This collection - is commonly used to iterate through all the nodes that have a selected check - box in the tree. - - - The CheckedNodes collection is populated using a depth-first traversal of the tree - structure: each parent node is processed down to its child nodes before the next - parent node is populated. - - - - Protected Sub ShowCheckedNodes(ByVal sender As Object, ByVal e As System.EventArgs) - Dim message As String = String.Empty - Dim node As RadTreeNode - For Each node In RadTree1.CheckedNodes - message += node.FullPath - Next node - nodes.Text = message - End Sub - - - protected void ShowCheckedNodes(object sender, System.EventArgs e) - { - string message = string.Empty; - foreach (RadTreeNode node in RadTree1.CheckedNodes) - { - message += node.FullPath + "<br/>"; - } - nodes.Text = message; - } - - - - - - Gets the Value of the selected node. - - - The Value of the selected node. If there is no selected node returns empty string. - - - - - Gets a collection of RadTreeNode objects that represent the nodes in the control - that are currently selected. - - An IList<RadTreeNode> containing the selected nodes. - - This collection is commonly used to iterate through all the nodes that have - been selected in the tree. - The SelectedNodes collection is populated using a - depth-first traversal of the tree structure: each parent node is processed down to - its child nodes before the next parent node is populated. - - - - - Gets a RadTreeNode object that represents the selected node in the RadTreeView - control. - - - When a node is in selection mode, the user can select a node by clicking on - the text in the node. Use the SelectedNode property to determine which node is - selected in the TreeView control. - - A node cannot be selected when the TreeView control displays hyperlinks. When - hyperlinks are displayed, the SelectedNode property always returns a null reference - (Nothing in Visual Basic). - - When the user selects a different node in the RadTreeView control by clicking - the text in the new node, the NodeClick event is - raised, by default. If you set the - MultipleSelect property of the treeview to - true, end-users can select multiple nodes by holding the Ctrl / Shift keys - while selecting. - - - - - <radT:RadTreeView - ID="RadTree1" - runat="server" - OnNodeClick="NodeClick" - /> - - Protected Sub NodeClick(ByVal sender As Object, ByVal NodeEventArgs As RadTreeNodeEventArgs) - info.Text = String.Empty - Dim NodeClicked As RadTreeNode = NodeEventArgs.NodeClicked - info.Text = NodeClicked.Text - End Sub - - - <radT:RadTreeView - ID="RadTree1" - runat="server" - OnNodeClick="NodeClick" - /> - - protected void NodeClick(object sender, RadTreeNodeEventArgs NodeEventArgs) - { - info.Text = string.Empty; - RadTreeNode NodeClicked = NodeEventArgs.NodeClicked; - info.Text = NodeClicked.Text; - } - - - - - Gets a value indicating whether the RadTreeView control has no nodes. - - - Gets or sets the template for displaying all node in the current RadTreeView. - - - An object implementing the ITemplate interface. The default value is a null reference - (Nothing in Visual Basic), which indicates that this property is not set. - - - - - - Gets or sets the loading message that is displayed when child nodes are retrieved - on AJAX calls. - - - This property can be used for localization purposes (e.g. "Loading..." in - different languages). - - - - Protected Sub LoadingMessagePositionChanged(ByVal sender As Object, ByVal e As System.EventArgs) - Select Case LoadingMessagePos.SelectedItem.Value - Case "Before" - RadTree1.LoadingStatusPosition = TreeViewLoadingStatusPosition.BeforeNodeText - RadTree1.LoadingMessage = "(loading ..)" - Case "After" - RadTree1.LoadingStatusPosition = TreeViewLoadingStatusPosition.AfterNodeText - RadTree1.LoadingMessage = "(loading ...)" - Case "Below" - RadTree1.LoadingStatusPosition = TreeViewLoadingStatusPosition.BelowNodeText - RadTree1.LoadingMessage = "(loading ...)" - Case "None" - RadTree1.LoadingStatusPosition = TreeViewLoadingStatusPosition.None - End Select - End Sub - - - protected void LoadingMessagePositionChanged(object sender, System.EventArgs e) - { - switch (LoadingMessagePos.SelectedItem.Value) - { - case "Before" : - RadTree1.LoadingStatusPosition = TreeViewLoadingStatusPosition.BeforeNodeText; - RadTree1.LoadingMessage = "(loading ..)"; - break; - case "After" : - RadTree1.LoadingStatusPosition = TreeViewLoadingStatusPosition.AfterNodeText; - RadTree1.LoadingMessage = "(loading ...)"; - break; - case "Below" : - RadTree1.LoadingStatusPosition = TreeViewLoadingStatusPosition.BelowNodeText; - RadTree1.LoadingMessage = "(loading ...)"; - break; - case "None" : - RadTree1.LoadingStatusPosition = TreeViewLoadingStatusPosition.None; - break; - } - } - - - - - - Gets a object that contains the root nodes of the current RadTreeView control. - - - A that contains the root nodes of the current RadTreeView control. By default - the collection is empty (RadTreeView has no children). - - - Use the nodes property to access the root nodes of the RadTreeView control. You can also use the nodes property to - manage the root nodes - you can add, remove or modify nodes. - - - The following example demonstrates how to programmatically modify the properties of a root node. - - RadTreeView1.Nodes[0].Text = "Example"; - RadTreeView1.Nodes[0].NavigateUrl = "http://www.example.com"; - - - RadTreeView1.Nodes(0).Text = "Example" - RadTreeView1.Nodes(0).NavigateUrl = "http://www.example.com" - - - - - - Gets or sets the position of the loading message when child nodes are retrieved - on AJAX calls. - - - - Protected Sub LoadingMessagePositionChanged(ByVal sender As Object, ByVal e As System.EventArgs) - Select Case LoadingMessagePos.SelectedItem.Value - Case "Before" - RadTree1.LoadingStatusPosition = TreeViewLoadingStatusPosition.BeforeNodeText - RadTree1.LoadingMessage = "(loading ..)" - Case "After" - RadTree1.LoadingStatusPosition = TreeViewLoadingStatusPosition.AfterNodeText - RadTree1.LoadingMessage = "(loading ...)" - Case "Below" - RadTree1.LoadingStatusPosition = TreeViewLoadingStatusPosition.BelowNodeText - RadTree1.LoadingMessage = "(loading ...)" - Case "None" - RadTree1.LoadingStatusPosition = TreeViewLoadingStatusPosition.None - End Select - End Sub - - - protected void LoadingMessagePositionChanged(object sender, System.EventArgs e) - { - switch (LoadingMessagePos.SelectedItem.Value) - { - case "Before" : - RadTree1.LoadingStatusPosition = TreeViewLoadingStatusPosition.BeforeNodeText; - RadTree1.LoadingMessage = "(loading ...)"; - break; - case "After" : - RadTree1.LoadingStatusPosition = TreeViewLoadingStatusPosition.AfterNodeText; - RadTree1.LoadingMessage = "(loading ...)"; - break; - case "Below" : - RadTree1.LoadingStatusPosition = TreeViewLoadingStatusPosition.BelowNodeText; - RadTree1.LoadingMessage = "(loading ...)"; - break; - case "None" : - RadTree1.LoadingStatusPosition = TreeViewLoadingStatusPosition.None; - break; - } - } - - - - - - Gets a value indicating whether the text of the tree nodes are edinodele in the - browser. - - - End-users can edit the text of tree-nodes by pressing F2 when the node is - selected or by clicking on a node that is already selected (slow double - click). - - You can disable / enable node editing for specific tree nodes by setting the - AllowEdit property of the specific - RadTreeNode. - - -
- After node editing, RadTreeView fires the NodeEdit - event and you can change the text of the node - the RadTreeNode instance is - contained in the NodeEdited property of the event arguments and the new text is - in the NewText property of the event arguments. -
-
- - - <radT:RadTreeView - ID="RadTree1" - Runat="server" - AllowNodeEditing="True" - OnNodeEdit="HandleNodeEdit" - /> - - Protected Sub HandleNodeEdit(ByVal sender As Object, ByVal NodeEvents As RadTreeNodeEventArgs) - Dim nodeEdited As RadTreeNode = NodeEvents.NodeEdited - Dim newText As String = NodeEvents.NewText - - nodeEdited.Text = newText - End Sub - - - <radT:RadTreeView - ID="RadTree1" - Runat="server" - AllowNodeEditing="True" - OnNodeEdit="HandleNodeEdit" - /> - - protected void HandleNodeEdit(object sender, RadTreeNodeEventArgs NodeEvents) - { - RadTreeNode nodeEdited = NodeEvents.NodeEdited; - string newText = NodeEvents.NewText; - - nodeEdited.Text = newText; - } - - -
- - - Gets a value indicating whether the dotted lines indenting the nodes should be - displayed or not. - - - - - Gets a value indicating whether only the current branch of the treeview is - expanded. - - - The property closes all nodes that are not parents of the last expanded node. - This property is only effective on the client browser - in postback modes you need to - handle the logic yourself. - - - - - When set to true displays a checkbox next to each treenode. - - - - - Gets or sets a value indicating whether checking (unchecking) a node will check (uncheck) its child nodes. - - true if child nodes will be checked (checked) when the user checks (unchecks) their parent node; - otherwise, false. The default value is false - - - - - Gets or sets a value indicating whether RadTreeView should display tri-state checkboxes. - - - true if tri-state checkboxes should be displayed; otherwise, false. The default value is - false. - - - Enabling three state checkbox support requires the property to be set to true. - - - - - When set to true the treeview allows multiple node selection (by holding down ctrl key while selecting nodes) - - - - - When set to true enables drag-and-drop functionality - - - - - When set to true enables drag-and-drop visual clue (underline) between nodes while draggin - - - - - Gets a collection of RadTreeViewContextMenu objects - that represent the context menus of a RadTreeView control. - - A RadTreeViewContextMenuCollection that - contains all the context menus of the RadTreeView control. - - - By default, if the ContextMenus collection contains RadTreeViewContextMenus, - the first one is displayed on the right-click of each RadTreeNode. To disable a context menu for a - RadTreeNode, set its EnableContextMenu - property to false. To specify a different context menu for a RadTreeNode, use its - ContextMenuID property. - - - The following code example demonstrates how to populate the ContextMenus - collection declaratively. - - <%@ Page Language="C#" AutoEventWireup="true" %> - <%@ Register TagPrefix="Telerik" Namespace="Telerik.Web.UI" Assembly="Telerik.Web.UI" %> - - <html> - <body> - <form id="form1" runat="server"> - <Telerik:RadScriptManager ID="RadScriptManager1" runat="server"></Telerik:RadScriptManager> - <br /> - <Telerik:RadTreeView ID="RadTreeView1" runat="server"> - <ContextMenus> - <Telerik:RadTreeViewContextMenu ID="ContextMenu1"> - <nodes> - <Telerik:RadTreeNode Text="Menu1Item1"></Telerik:RadTreeNode> - <Telerik:RadTreeNode Text="Menu1Item2"></Telerik:RadTreeNode> - </nodes> - </Telerik:RadTreeViewContextMenu> - <Telerik:RadTreeViewContextMenu Skin="Outlook" ID="ContextMenu2"> - <nodes> - <Telerik:RadTreeNode Text="Menu2Item1"></Telerik:RadTreeNode> - <Telerik:RadTreeNode Text="Menu2Item2"></Telerik:RadTreeNode> - </nodes> - </Telerik:RadTreeViewContextMenu> - </ContextMenus> - <Nodes> - <Telerik:RadTreeNode Text="Node1" ContextMenuID="ContextMenu2"> - <Nodes> - <Telerik:RadTreeNode Text="Node11" ContextMenuID="ContextMenu2"></Telerik:RadTreeNode> - <Telerik:RadTreeNode Text="Node12" ContextMenuID="ContextMenu2"></Telerik:RadTreeNode> - </Nodes> - </Telerik:RadTreeNode> - <Telerik:RadTreeNode Text="Node2" ContextMenuID="ContextMenu2"> - <Nodes> - <Telerik:RadTreeNode Text="Node21" ContextMenuID="ContextMenu2"></Telerik:RadTreeNode> - <Telerik:RadTreeNode Text="Node22" ContextMenuID="ContextMenu2"></Telerik:RadTreeNode> - </Nodes> - </Telerik:RadTreeNode> - </Nodes> - </Telerik:RadTreeView> - - </form> - </body> - </html> - - - - - - Gets the settings for the web service used to populate nodes when - ExpandMode set to - TreeNodeExpandMode.WebService. - - - An WebServiceSettings that represents the - web service used for populating nodes. - - - - Use the WebServiceSettings property to configure the web - service used to populate nodes on demand. - You must specify both - Path and - Method - to fully describe the service. - - - You can use the LoadingStatusTemplate - property to create a loading template. - - - In order to use the integrated support, the web service should have the following signature: - - - [ScriptService] - public class WebServiceName : WebService - { - [WebMethod] - public RadTreeNodeData[] WebServiceMethodName(RadTreeNodeData item, object context) - { - // We cannot use a dictionary as a parameter, because it is only supported by script services. - // The context object should be cast to a dictionary at runtime. - IDictionary<string, object> contextDictionary = (IDictionary<string, object>) context; - - //... - } - } - - - - - - - When set to true, the nodes populated through Load On Demand are persisted on the server. - - - - Gets the settings for the animation played when a node opens. - - An AnnimationSettings that represents the - expand animation. - - - - Use the ExpandAnimation property to customize the expand - animation of RadTreeView. You can specify the - Type and - Duration. - To disable expand animation effects you should set the - Type to - AnimationType.None.
- To customize the collapse animation you can use the - CollapseAnimation property. -
-
- - The following example demonstrates how to set the ExpandAnimation - of RadTreeView. - - ASPX: - - - <telerik:RadTreeView ID="RadTreeView1" runat="server"> - <ExpandAnimation Type="OutQuint" Duration="300" - /> - <Nodes> - <telerik:RadTreeViewNode Text="News" > - <Nodes> - <telerik:RadTreeViewNode Text="CNN" NavigateUrl="http://www.cnn.com" - /> - <telerik:RadTreeViewNode Text="Google News" NavigateUrl="http://news.google.com" - /> - </Nodes> - </telerik:RadTreeViewNode> - <telerik:RadTreeViewNode Text="Sport" > - <Nodes> - <telerik:RadTreeViewNode Text="ESPN" NavigateUrl="http://www.espn.com" - /> - <telerik:RadTreeViewNode Text="Eurosport" NavigateUrl="http://www.eurosport.com" - /> - </Nodes> - </telerik:RadTreeViewNode> - </Nodes> - - - </telerik:RadTreeView> - - - void Page_Load(object sender, EventArgs e) - { - RadTreeView1.ExpandAnimation.Type = AnimationType.Linear; - RadTreeView1.ExpandAnimation.Duration = 300; - } - - - Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Load - RadTreeView1.ExpandAnimation.Type = AnimationType.Linear - RadTreeView1.ExpandAnimation.Duration = 300 - End Sub - - -
- - Gets the settings for the animation played when a node closes. - - An AnnimationSettings that represents the - collapse animation. - - - - Use the CollapseAnimation property to customize the expand - animation of RadTreeView. You can specify the - Type and - Duration. -
- To disable expand animation effects you should set the - Type to - AnimationType.None. To customize the expand animation you can - use the ExpandAnimation property. -
-
- - The following example demonstrates how to set the - CollapseAnimation of RadTreeView. - - ASPX: - - - <telerik:RadTreeView ID="RadTreeView1" runat="server"> - <CollapseAnimation Type="OutQuint" Duration="300" - /> - <Nodes> - <telerik:RadTreeViewNode Text="News" > - <Nodes> - <telerik:RadTreeViewNode Text="CNN" NavigateUrl="http://www.cnn.com" - /> - <telerik:RadTreeViewNode Text="Google News" NavigateUrl="http://news.google.com" - /> - </Nodes> - </telerik:RadTreeViewNode> - <telerik:RadTreeViewNode Text="Sport" > - <Nodes> - <telerik:RadTreeViewNode Text="ESPN" NavigateUrl="http://www.espn.com" - /> - <telerik:RadTreeViewNode Text="Eurosport" NavigateUrl="http://www.eurosport.com" - /> - </Nodes> - </telerik:RadTreeViewNode> - </Nodes> - - - </telerik:RadTreeView> - - - - - - - void Page_Load(object sender, EventArgs e) - { - RadTreeView1.CollapseAnimation.Type = AnimationType.Linear; - RadTreeView1.CollapseAnimation.Duration = 300; - } - - - Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Load - RadTreeView1.CollapseAnimation.Type = AnimationType.Linear - RadTreeView1.CollapseAnimation.Duration = 300 - End Sub - - -
- - - Gets a collection of objects that define the relationship - between a data item and the tree node it is binding to. - - - A that represents the relationship between a data item and the tree node it is binding to. - - - - - Gets or sets the maximum number of levels to bind to the RadTreeView control. - - - The maximum number of levels to bind to the RadTreeView control. The default is -1, which binds all the levels in the data source to the control. - - - When binding the RadTreeView control to a data source, use the MaxDanodeindDepth - property to limit the number of levels to bind to the control. For example, setting this property to 2 binds only - the root nodes and their immediate children. All remaining records in the data source are ignored. - - - - - Gets or sets the URL of the page to post to from the current page when a tree node is clicked. - - - The URL of the Web page to post to from the current page when a tree node is clicked. - The default value is an empty string (""), which causes the page to post back to itself. - - - - - Gets or sets the name of the JavaScript function called when a node starts being edited - - - - - Gets or sets the name of the JavaScript function called when a node is databound during load on demand - - - - - Gets or sets the name of the JavaScript function called when the control is fully - initialized on the client side. - - - - - The name of the JavaScript function that will be called upon click on a treenode. The function must accept a single parameter which is the instance of the node clicked. - For example if you define OnClientClick="ProcessClientClick", you must define a javascript function defined in the following way (example):

- function ProcessClientClick(node) - { - alert("You clicked on: " + node.Text); - } -
-
- - - The name of the JavaScript function that will be called after click on a treenode. Used for AJAX/callback hooks. - - - - - The name of the JavaScript function that will be called when the user highlights a treenode. - - - - - The name of the JavaScript function that will be called when the user double clicks on a node. - - - - - The name of the JavaScript function that will be called when the mouse hovers away from the TreeView. - - - - - The name of the JavaScript function that will be called before the user edits a node - - - - - The name of the JavaScript function that will be called after the user edits a node - - - - - The name of the JavaScript function that will be called before a node is expanded. - - - - - The name of the JavaScript function that will be called after a node is expanded. - - - - - The name of the JavaScript function that will be called before a node is collapsed. - - - - - The name of the JavaScript function that will be called after a node is collapsed. - - - - - The name of the JavaScript function that will be called when the user drops a node onto another node. - - - - - The name of the JavaScript function that will be called after the user drops a node onto another node. - - - - - The name of the JavaScript function that will be called when the user checks (checkbox) a treenode. - - - - - The name of the JavaScript function that will be called after the user checks (checkbox) a treenode. - - - - - The name of the JavaScript function that will be called when the user starts dragging a node. - - - - - The name of the JavaScript function that will be called when the user moves the mouse while dragging a node. - - - - - The name of the JavaScript function that will be called when the user clicks on a context menu item. - - - - - The name of the JavaScript function that will be called after the user clicks on a context menu item. - - - - - The name of the JavaScript function that will be called when a context menu is to be displayed. - - - - - The name of the JavaScript function that will be called after context menu is displayed. - - - - - Gets or sets a value indicating the client-side event handler that is called when - the children of a tree node are about to be populated (for example from web service). - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - <script type="text/javascript">
- function onClientNodePopulatingHandler(sender, eventArgs)
- {
- var node = eventArgs.get_node();
- var context = eventArgs.get_context();
- context["CategoryID"] = node.get_value();
- }
- </script>
- <telerik:RadTreeView ID="RadTreeView1"
- runat="server"
- OnClientNodePopulating="onClientNodePopulatingHandler">
- ....
- </telerik:RadTreeView>
-
- - If specified, the OnClientNodePopulating client-side event - handler is called when the children of a tree node are about to be populated. - Two parameters are passed to the handler: - - sender, the menu client object; - eventArgs with three properties: - - get_node(), the instance of the node. - get_context(), an user object that will be passed to the web service. - set_cancel(), used to cancel the event. - - - - This event can be cancelled. - -
- - - Gets or sets a value indicating the client-side event handler that is called when - the children of a tree node were just populated (for example from web service). - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - <script type="text/javascript">
- function onClientNodePopulatedHandler(sender, eventArgs)
- {
- var node = eventArgs.get_node();
- alert("Loading finished for " + node.get_text());
- }
- </script>
- <telerik:RadTreeView ID="RadTreeView1"
- runat="server"
- OnClientNodePopulated="onClientNodePopulatedHandler">
- ....
- </telerik:RadTreeView>
-
- - If specified, the OnClientNodePopulated client-side event - handler is called when the children of a tree node were just populated. - Two parameters are passed to the handler: - - sender, the menu client object; - eventArgs with one property: - - get_node(), the instance of the tree node. - - - - This event cannot be cancelled. - -
- - - Gets or sets a value indicating the client-side event handler that is called when - the operation for populating the children of a tree node has failed. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - <script type="text/javascript">
- function onClientNodePopulationFailedHandler(sender, eventArgs)
- {
- var node = eventArgs.get_node();
- var errorMessage = eventArgs.get_errorMessage();
-
- alert("Error: " + errorMessage);
- eventArgs.set_cancel(true);
- }
- </script>
- <telerik:RadTreeView ID="RadTreeView1"
- runat="server"
- OnClientNodePopulationFailed="onClientNodePopulationFailedHandler">
- ....
- </telerik:RadTreeView>
-
- - If specified, the OnClientNodePopulationFailed client-side event - handler is called when the operation to populate the children of a tree node has failed. - Two parameters are passed to the handler: - - sender, the menu client object; - eventArgs with three properties: - - get_node(), the instance of the tree node. - set_cancel(), set to true to suppress the default action (alert message). - - - - This event cannot be cancelled. - -
- - - The name of the JavaScript function that will be called when a key is pressed. - - - - - Occurs on the server when a node in the - control is clicked. - - - The following example demonstrates how to use the NodeClick event to determine the clicked node. - - protected void RadTreeView1_NodeClick(object sender, Telerik.Web.UI.RadTreeNodeEventArgs e) - { - Response.Write("Clicked node is " + e.Node.Text); - } - - - Sub RadTreeView1_NodeClick(ByVal sender As Object, ByVal e As Telerik.Web.UI.RadTreeNodeEventArgs) Handles RadTreeView1.NodeClick - Response.Write("Clicked node is " & e.Node.Text) - End Sub - - - - - Occurs when a node is data bound. - - - The NodeDataBound event is raised for each node upon - danodeinding. You can retrieve the node being bound using the event arguments. - The DataItem associated with the node can be retrieved using - the property. - - The NodeDataBound event is often used in scenarios when you - want to perform additional mapping of fields from the DataItem to their respective - properties in the class. - - - - The following example demonstrates how to map fields from the data item to - properties using the NodeDataBound event. - - protected void RadTreeView1_NodeDataBound(object sender, Telerik.Web.UI.RadTreeNodeEventArgs e) - { - e.Node.ImageUrl = "image" + (string)DataBinder.Eval(e.Node.DataItem, "ID") + ".gif"; - e.Node.NavigateUrl = (string)DataBinder.Eval(e.Node.DataItem, "URL"); - } - - - Sub RadTreeView1_NodeDataBound(ByVal sender As Object, ByVal e As Telerik.Web.UI.RadTreeNodeEventArgs) Handles RadTreeView1.NodeDataBound - e.Node.ImageUrl = "image" & DataBinder.Eval(e.Node.DataItem, "ID") & ".gif" - e.Node.NavigateUrl = CStr(DataBinder.Eval(e.Node.DataItem, "URL")) - End Sub - - - - - Occurs when a node is created. - - The NodeCreated event is raised when an node in the control is created, - both during round-trips and at the time data is bound to the control. The NodeCreated event is not raised for nodes - which are defined inline in the page or user control. - The NodeCreated event is commonly used to initialize node properties. - - - The following example demonstrates how to use the NodeCreated event - to set the ToolTip property of each node. - - protected void RadTreeView1_NodeCreated(object sender, Telerik.Web.UI.RadTreeNodeEventArgs e) - { - e.Node.ToolTip = e.Node.Text; - } - - - Sub RadTreeView1_NodeCreated(ByVal sender As Object, ByVal e As Telerik.Web.UI.RadTreeNodeEventArgs) Handles RadTreeView1.NodeCreated - e.Node.ToolTip = e.Node.Text - End Sub - - - - - - Occurs when a node is expanded. - - - - The NodeExpand event will be raised for nodes whose property is set to - ServerSide or ServerSideCallback. - - - The NodeExpand event is commonly used to populate nodes on demand. - - - - The following example demonstrates how to use the NodeExpand event to populate nodes on demand. - - protected void RadTreeView1_NodeExpanded(object sender, Telerik.Web.UI.RadTreeNodeEventArgs e) - { - RadTreeNode nodeCreatedOnDemand = new RadTreeNode("Node created on demand"); - e.Node.Nodes.Add(nodeCreatedOnDemand); - } - - - Sub RadTreeView1_NodeExpanded(ByVal sender As Object, ByVal e As Telerik.Web.UI.RadTreeNodeEventArgs) Handles RadTreeView1.NodeExpanded - Dim nodeCreatedOnDemand As RadTreeNode = New RadTreeNode("Node created on demand") - e.Node.Nodes.Add(nodeCreatedOnDemand) - End Sub - - - - - - Occurs when a node is collapsed. - - - The NodeCollapse event is raised only for nodes whose property - is set to ServerSide. - - - - - Occurs when a node is checked. - - - - - Occurs when a node (or nodes) is dragged and dropped. - - - The NodeDrop event is commonly used to move nodes from one location into other. - - - The following example demonstrates how to move the dragged nodes in the destination node. - - protected void RadTreeView1_NodeDrop(object sender, RadTreeNodeDragDropEventArgs e) - { - foreach (RadTreeNode sourceNode in e.DraggedNodes) - { - if (!sourceNode.IsAncestorOf(e.DestDragNode)) - { - sourceNode.Remove(); - e.DestDragNode.Nodes.Add(sourceNode); - } - } - } - - - Protected Sub RadTreeView1_NodeDrop(ByVal sender As Object, ByVal e As RadTreeNodeDragDropEventArgs) Handles RadTreeView1.NodeDrop - For Each sourceNode As RadTreeNode In e.DraggedNodes - If Not sourceNode.IsAncestorOf(e.DestDragNode) Then - sourceNode.Remove() - e.DestDragNode.Nodes.Add(sourceNode) - End If - Next - End Sub - - - - - - Occurs when a node's text is edited. - - - The NodeEdit event is commonly used to update the property after editing. - - - The following example demonstrates how to update the property after editing - - protected void RadTreeView1_NodeEdit(object sender, RadTreeNodeEditEventArgs e) - { - RadTreeNode nodeEdited = e.Node; - string newText = e.Text; - nodeEdited.Text = newText; - } - - - Protected Sub HandleNodeEdit(ByVal sender As Object, ByVal e As RadTreeNodeEditEventArgs) Handles RadTreeView1.NodeEdit - Dim nodeEdited As RadTreeNode = e.Node - Dim newText As String = e.Text - nodeEdited.Text = newText - End Sub - - - - - - Occurs on the server when a item in the is clicked. - - - The context menu will also postback if you navigate to a menu item - using the [menu item] key and then press [enter] on the menu item that is focused. The - instance of the clicked menu item is passed to the ContextMenuItemClick event - handler - you can obtain a reference to it using the eventArgs.Item property. - - - - - Telerik RadEditor - - - - - - - - - - - - - - - - - - - - - - - - - Adds HTML attributes and styles that need to be rendered to the specified . This method is used primarily by control developers. - - A that represents the output stream to render HTML content on the client. - - - - The Enabled property is reset in AddAttributesToRender in order - to avoid setting disabled attribute in the control tag (this is - the default behavior). This property has the real value of the - Enabled property in that moment. - - - - - Registers the control with the ScriptManager - - - - - Registers the CSS styles for the control - - - - - Registers the script descriptors. - - - - - - - - - - - - - - - - - Outputs the content of a server control's children to a provided object, which writes the content to be rendered on the client. - - The object that receives the rendered content. - - - - - - - - - - - - - - - - Finds the tool with the given name. - - The name of the tool to find. - - - - - - - - Executed when post data is loaded from the request - - - - - Raises the event. - - An object that contains the event data. - - - - Removes a specific filter from the ContentFilters. - - An EditorFilters value - - - - Add a specific filter to the ContentFilters. - - An EditorFilters value - - - - Restores view-state information from a previous request that was saved with the System.Web.UI.WebControls.WebControl.SaveViewState() method. - - An object that represents the control state to restore. - - - - Saves any state that was modified after the System.Web.UI.WebControls.Style.TrackViewState() method was invoked. - - An object that contains the current view state of the control; otherwise, if there is no view state associated with the control, null. - - - - Causes the control to track changes to its view state so they can be stored in the object's System.Web.UI.Control.ViewState property. - - - - - Raises the TextChanged event. - - - - - Gets the value that corresponds to this Web server control. This property is used primarily by control developers. - - - One of the enumeration values. - - - - - - - - - Gets a reference to the object that - allows you to set the export file properties - - - - A reference to the EditorExportSettings that allows you to set the export file properties - - - Use the ExportSettings property to control the export file settings - This property is read-only; - however, you can set the properties of the EditorExportSettings object it returns. - The properties can be set declaratively using one of the following methods: - - Place an attribute in the opening tag of the Telerik RadEditor - control in the form Property-Subproperty, where Subproperty is a property of - the EditorExportSettings object (for example, - ExportSettings-FileName). - Nest a <ExportSettings> element between the opening and closing - tags of the Telerik RadEditor control. - - The properties can also be set programmatically in the form - Property.Subproperty (for example, ExportSettings.FileName). - - - - - Gets or sets a string containing the ID (will search for both server or client ID) of a client object that should be used as a tool provider. - - - - This property helps significantly reduce the HTML markup and JSON sent from server to the - client when multiple RadEditor objects with the same tools are used on the same page. - - The ToolProviderID can be set to the ID of another RadEditor, or to a custom - control that implements two clientside methods get_toolHTML and get_toolJSON. - - - - - - Gets or sets the list of external CSS files that should be made available in the - editor's content area. - - - By default, RadEditor uses the CSS classes available in the current page. - However, it can be configured to load external CSS files instead. This scenario is - very common for editors integrated in back-end administration areas, which have one - set of CSS classes, while the content is being saved in a database and displayed on - the public area, which has a different set of CSS classes. - If this property is set the RadEditor loads only the styles - defined in these files. The styles defined in the current page are not loaded in - the dropdown. - - If you want to load only a subset of the defined classes you can use the - CssClasses property. - - - - This example demonstrates how to set the CssFiles property from the - code-behind. - If you want to set it in the ASPX/ASCX use the following syntax - <rade:RadEditor - cssfiles="~/styles/1.css,~/styles/2.css" ... ><rade:RadEditor> - - RadEditor1.CssFiles = New String(2) {"~/styles/1.css", "~/styles/2.css"} - - - RadEditor1.CssFiles = new string[2] {"~/styles/1.css", "~/styles/2.css"}; - - - RadEditor 5.0 and above. - - A string array containing the names of the external CSS files that should be - available in the editor's content area. - - - - - Gets the collection containing the colors to put in the Foreground and Background color dropdowns. - - - A StringCollection containing the colors to put in the Foreground and Background - color dropdowns. Default is an empty StringCollection. - - - The contents of this collection will override the default colors available in - the Foreground and Background color dropdowns. In order to extend the default set - you should add the default colors and the new colors. - Note: Setting this property will affect all color pickers of - the RadEditor, including those in the table proprties dialogs. - - - This example demonstrates how to put only Red, Green and Blue into the Foreground - and Background dropdowns. - - Private Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs) Handles MyBase.Load - RadEditor1.Colors.Add("Red") - RadEditor1.Colors.Add("Green") - RadEditor1.Colors.Add("Blue") - End Sub - - - private void Page_Load(object sender, EventArgs e) - { - RadEditor1.Colors.Add("Red"); - RadEditor1.Colors.Add("Green"); - RadEditor1.Colors.Add("Blue"); - } - - - - - Gets the collection containing the symbols to put in the Symbols dropdown. - - A SymbolCollection containing the symbols to put in the Symbols dropdown. Default - is an empty SymbolCollection. - - - The contents of this collection will override the default symbols available - in the Symbols dropdown. - Note: multiple symbols can be added at once by using the - SymbolCollection.Add() method. - - - This example demonstrates how to put only the english alphabet symbols to the - Symbols dropdown. - - Private Sub Page_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load - For i As Integer = 65 To 90 - RadEditor1.Symbols.Add(Convert.ToChar(i)) - Next - End Sub - - - private void Page_Load(object sender, EventArgs e) - { - for (int i=65; i<=90; i++) - { - RadEditor1.Symbols.Add(Convert.ToChar(i)); - } - } - - - - - - Gets the collection containing the links to put in the Custom Links dropdown. - - A Link object containing the links to put in the Custom Links dropdown. - - The Custom Links dropdown of the RadEditor is a very convenient tool for - inserting predefined hyperlinks. - Note: the links can be organized in a tree like - structure. - - - This example demonstrates how to create a tree like structure of custom links. - - Private Sub Page_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load - 'Add the root - RadEditor1.Links.Add("Telerik", "http://www.telerik.com") - 'Add the Products node And its children - RadEditor1.Links("Telerik").Add("Products", "http://www.telerik.com/products") - RadEditor1.Links("Telerik")("Products").Add("RadControls", "http://www.telerik.com/radcontrols") - RadEditor1.Links("Telerik")("Products").Add("RadEditor", "http://www.telerik.com/RadEditor") - RadEditor1.Links("Telerik")("Products")("RadEditor").Add("QSF", "http://www.telerik.com/demos/aspnet/Editor/Examples/Default/DefaultCS.aspx") - 'Add Purchase, Support And Client.Net nodes - RadEditor1.Links("Telerik").Add("Purchase", "http://www.telerik.com/purchase") - RadEditor1.Links("Telerik").Add("Support", "http://www.telerik.com/support") - RadEditor1.Links("Telerik").Add("Client.Net", "http://www.telerik.com/clientnet") - End Sub - - - private void Page_Load(object sender, EventArgs e) - { - //Add the root - RadEditor1.Links.Add("Telerik", "http://www.telerik.com"); - //Add the Products node and its children - RadEditor1.Links["Telerik"].Add("Products", "http://www.telerik.com/products"); - RadEditor1.Links["Telerik"]["Products"].Add("RadControls", "http://www.telerik.com/radcontrols"); - RadEditor1.Links["Telerik"]["Products"].Add("RadEditor", "http://www.telerik.com/RadEditor"); - RadEditor1.Links["Telerik"]["Products"]["RadEditor"].Add("QSF", "http://www.telerik.com/demos/aspnet/Editor/Examples/Default/DefaultCS.aspx"); - //Add Purchase, Support and Client.Net nodes - RadEditor1.Links["Telerik"].Add("Purchase", "http://www.telerik.com/purchase"); - RadEditor1.Links["Telerik"].Add("Support", "http://www.telerik.com/support"); - RadEditor1.Links["Telerik"].Add("Client.Net", "http://www.telerik.com/clientnet"); - } - - - - - - Gets the collection containing the custom font sizes to put in the [Size] dropdown. - - - A string collection containing the custom font sizes to put in the Size dropdown. - Default is an empty StringCollection. - - - The contents of this collection will override the default font sizes - available in the [Size] dropdown. In order to extend the default set you should add - the default font sizes and the new font sizes. The default font sizes are: 1, 2, 3, - 4, 5, 6 and 7. - Note: the minimum font size is 1, the maximum is 7. - - - This example demonstrates how to remove the font size 1 from the Size dropdown. - - Private Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs) Handles MyBase.Load - RadEditor1.FontSizes.Add(2) - RadEditor1.FontSizes.Add(3) - RadEditor1.FontSizes.Add(4) - RadEditor1.FontSizes.Add(5) - RadEditor1.FontSizes.Add(6) - RadEditor1.FontSizes.Add(7) - End Sub - - - private void Page_Load(object sender, EventArgs e) - { - RadEditor1.FontSizes.Add(2); - RadEditor1.FontSizes.Add(3); - RadEditor1.FontSizes.Add(4); - RadEditor1.FontSizes.Add(5); - RadEditor1.FontSizes.Add(6); - RadEditor1.FontSizes.Add(7); - } - - - - - - Gets the collection containing the custom font names to put in the Font dropdown. - - - A string collection containing the custom font names to put in the Font dropdown. - Default is an empty StringCollection. - - - The contents of this collection will override the default fonts available in - the Font dropdown. In order to extend the default set you should add the default - font names and the new font names. The default font names are: Arial, Comic Sans - MS, Courier New, Tahoma, Times New Roman, Verdana. - Note: the fonts must exist on the client computer. - - - This example demonstrates how to add Arial Narrow font to the Font dropdown. - - Private Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs) Handles MyBase.Load - RadEditor1.FontNames.Add("Arial") - RadEditor1.FontNames.Add("Arial Narrow") - RadEditor1.FontNames.Add("Comic Sans MS") - RadEditor1.FontNames.Add("Courier New") - RadEditor1.FontNames.Add("Tahoma") - RadEditor1.FontNames.Add("Times New Roman") - RadEditor1.FontNames.Add("Verdana") - End Sub - - - private void Page_Load(object sender, EventArgs e) - { - RadEditor1.FontNames.Add("Arial"); - RadEditor1.FontNames.Add("Arial Narrow"); - RadEditor1.FontNames.Add("Comic Sans MS"); - RadEditor1.FontNames.Add("Courier New"); - RadEditor1.FontNames.Add("Tahoma"); - RadEditor1.FontNames.Add("Times New Roman"); - RadEditor1.FontNames.Add("Verdana"); - } - - - - - - Gets the collection containing the paragraph styles to put in the Paragraph Style - dropdown. - - - A NameValueCollection containing the paragraph styles to put in the Paragraph - Style dropdown. Default is an empty NameValueCollection. - - - The contents of this collection will override the default paragraph styles - available in the Paragraph Style dropdown. - Note: RadEditor also supports block format with css class - set. See the example below. - - - This example demonstrates how to put several paragraph styles in the Paragraph - Style dropdown. - - Private Sub Page_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load - 'Add clear formatting - RadEditor1.Paragraphs.Add("Clear Formatting", "body") - 'Add the standard paragraph styles - RadEditor1.Paragraphs.Add("Heading 1", "<h1>") - RadEditor1.Paragraphs.Add("Heading 2", "<h2>") - RadEditor1.Paragraphs.Add("Heading 3", "<h3>") - 'Add paragraph style With block Format And css Class - RadEditor1.Paragraphs.Add("Heading 2 Bordered", "<h2 class=\"bordered\">") - End Sub - - - private void Page_Load(object sender, EventArgs e) - { - //Add clear formatting - RadEditor1.Paragraphs.Add("Clear Formatting", "body"); - //Add the standard paragraph styles - RadEditor1.Paragraphs.Add("Heading 1", "<h1>"); - RadEditor1.Paragraphs.Add("Heading 2", "<h2>"); - RadEditor1.Paragraphs.Add("Heading 3", "<h3>"); - //Add paragraph style with block format and css class - RadEditor1.Paragraphs.Add("Heading 2 Bordered", "<h2 class=\"bordered\">"); - } - - - - - - Gets the collection containing the custom real font sizes to put in the RealFontSize dropdown. - - - A string collection containing the custom real font sizes to put in the RealFontSize dropdown. - Default is an empty StringCollection. - - - The contents of this collection will override the default real font sizes available in - the RealFontSize dropdown. - - - This example demonstrates how to add custom font sizes to the RealFontSize dropdown. - - Private Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs) Handles MyBase.Load - RadEditor1.RealFontSizes.Add("8pt") - RadEditor1.RealFontSizes.Add("9pt") - RadEditor1.RealFontSizes.Add("11pt") - RadEditor1.RealFontSizes.Add("13pt") - End Sub - - - private void Page_Load(object sender, EventArgs e) - { - RadEditor1.RealFontSizes.Add("8pt") - RadEditor1.RealFontSizes.Add("9pt") - RadEditor1.RealFontSizes.Add("11pt") - RadEditor1.RealFontSizes.Add("13pt") - } - - - - - - Gets the collection containing the CSS classes to put in the [Apply CSS Class] dropdown. - - - A NameValueCollection containing the CSS classes to put in the [Apply CSS Class] - dropdown. Default is an empty NameValueCollection . - - - The contents of this collection will override the default CSS classes - available in the Apply CSS Class dropdown. - - - - - Gets the collection containing the snippets to put in the Code Snippet - dropdown. - - - A NameValueCollection containing the snippets to put in the Code Snippet dropdown. - Default is an empty NameValueCollection. - - - The Code Snippet dropdown is a very convenient tool for inserting predefined - chunks of HTML content like signatures, product description templates, custom - tables, etc. - The contents of this collection will override the default snippets available - in the Code Snippet dropdown. - - - - Gets the collection containing the available languages for spellchecking. - - RadEditor has integrated support for the multi-language mode of RadSpell. When - working with content in different languages you can select the proper spellchecking - dictionary from a dropdown button on the RadEditor toolbar. - - - A NameValueCollection containing the available languages for spellchecking. - Default value is empty NameValueCollection. - - - This example demonstrates how to enable spellchecking for English, French and German languages - in RadEditor spellchecker. - - Private Sub Page_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load - RadEditor1.Languages.Add("en-US", "English"); - RadEditor1.Languages.Add("fr-FR", "French"); - RadEditor1.Languages.Add("de-DE", "German"); - End Sub - - - private void Page_Load(object sender, EventArgs e) - { - RadEditor1.Languages.Add("en-US", "English"); - RadEditor1.Languages.Add("fr-FR", "French"); - RadEditor1.Languages.Add("de-DE", "German"); - } - - /// - - - - Gets or sets a string containing the path to the XML toolbar configuration file. - - - This property is provided for backwards compatibility. Please, use either - inline toolbar declaration or code-behind to configure the toolbars. To configure - multiple RadEditor controls with the same settings you could use either Theme, - UserControl with inline declaration, or CustomControl. - - Use "~" (tilde) as a substitution of the web-application's root - directory. - You can also provide this property with an URL which returns a valid XML - toolbar configuration file, e.g. /MyApplication/Tools/MyToolsFile.aspx - - - - - Gets or sets a string containing the localization language for the RadEditor UI - - - - - Gets or sets a string, containing the location of the content area CSS styles. - You need to set this property only if you are using a custom skin. - - The content area CSS file. - - - - Gets or sets a value indicating where the editor will look for its .resx localization files. - By default these files should be in the App_GlobalResources folder. However, if you cannot put - the resource files in the default location or .resx files compilation is disabled for some reason - (e.g. in a DotNetNuke environment), this property should be set to the location of the resource files. - - - A relative path to the dialogs location. For example: "~/controls/RadEditorResources/". - - - If specified, the LocalizationPath - property will allow you to load the editor localization files from any location in the - web application. - - - - - Gets or sets the value indicating whether script tags will be allowed in the editor content. - This property is now obsolete. Please use the ContentFilters property or the EnableFilter and DisableFilter methods - - - The default value is false. This means that script tags will be removed from the content. - - - - - Gets or sets the value indicating whether the RadEditor will auto-resize its height to match content height - - - The default value is false. - - - - - Gets or sets the value indicating whether the users will be able to resize the RadEditor control on the client - - - The default value is true. - - - - - Gets or sets the value indicating whether the RadEditor will insert a new line or - a paragraph when the [Enter] key is pressed. - - - true when the RadEditor will insert <br> tag when the - [Enter] key is pressed; otherwise false. The default - value is true. - - - Note: this property is intended for use only in Internet Explorer. - The gecko-based browsers always insert <BR> tags. - - - - - Gets or sets the value indicating how the editor toolbar will be rendered and will act on the client - - - Default Toolbars are rendered around the editor content area.
- Floating Toolbars are rendered in a moveable window.
- PageTop Toolbars appear on top of page when editor gets focus.
- ShowOnFocus Toolbars appear right above the editor when it focus. -
- - - Several editors can simulate usage of the same toolbar if this property has the same value everywhere - - -
- - - Gets or sets a value indicating the client-side event handler that is called when editor is loaded on the client. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - If specified, the OnClientLoad - client-side event handler is called when editor is loaded on the client. - Two parameters are passed to the handler: - - sender, the RadEditor object. - args. - - - - The following example demonstrates how to use the - OnClientLoad property. - -
- <script type="text/javascript">
- function OnClientLoad(sender, args)
- {
- var editor = sender;
- }
- </script> -
-
- <radsld:RadEditor ID="RadEditor1"
- runat= "server"
- OnClientLoad="OnClientLoad">
- ....
- </radsld:RadEditor> -
-
-
-
- - - Gets or sets a value indicating the client-side event handler that is called when editor starts to load on the client. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - If specified, the OnClientInit - client-side event handler is called when editor starts to load on the client. - Two parameters are passed to the handler: - - sender, the RadEditor object. - args. - - - - The following example demonstrates how to use the - OnClientInit property. - -
- <script type="text/javascript">
- function OnClientInit(sender, args)
- {
- var editor = sender;
- }
- </script> -
-
- <radsld:RadEditor ID="RadEditor1"
- runat= "server"
- OnClientInit="OnClientInit">
- ....
- </radsld:RadEditor> -
-
-
-
- - - Gets or sets a value indicating the client-side event handler that is called when a dialog is closed, but before its value returned would be pasted into the editor. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - If specified, the OnClientPasteHtml - client-side event handler is called when a dialog is closed, but before its value returned would be pasted into the editor. - Two parameters are passed to the handler: - - sender, the RadEditor object. - args. - - - - The following example demonstrates how to use the - OnClientPasteHtml property. - -
- <script type="text/javascript">
- function OnClientPasteHtml(sender, args)
- {
- var editor = sender;
- }
- </script> -
-
- <radsld:RadEditor ID="RadEditor1"
- runat= "server"
- OnClientPasteHtml="OnClientPasteHtml">
- ....
- </radsld:RadEditor> -
-
-
-
- - - Gets or sets a value indicating the client-side event handler that is called when the content is submitted. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - If specified, the OnClientPasteHtml - client-side event handler is called when a dialog is closed, but before its value returned would be pasted into the editor. - Two parameters are passed to the handler: - - sender, the RadEditor object. - args. - - - - The following example demonstrates how to use the - OnClientSubmit property. - -
- <script type="text/javascript">
- function OnClientSubmit(sender, args)
- {
- var editor = sender;
- }
- </script> -
-
- <radsld:RadEditor ID="RadEditor1"
- runat= "server"
- OnClientSubmit="OnClientSubmit">
- ....
- </radsld:RadEditor> -
-
-
-
- - - Gets or sets a value indicating the client-side event handler that is called when the content is submitted. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - If specified, the OnClientModeChange - client-side event handler is called when the mode of the editor is changing.. - Two parameters are passed to the handler: - - sender, the RadEditor object. - args. - - - - The following example demonstrates how to use the - OnClientModeChange property. - -
- <script type="text/javascript">
- function OnClientModeChange(sender, args)
- {
- var editor = sender;
- }
- </script> -
-
- <radsld:RadEditor ID="RadEditor1"
- runat= "server"
- OnClientModeChange="OnClientModeChange">
- ....
- </radsld:RadEditor> -
-
-
-
- - - Gets or sets a value indicating the client-side event handler that is called when selection inside editor content area changes - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - If specified, the OnClientSelectionChange - client-side event handler is called when selection inside editor content area changes. - Two parameters are passed to the handler: - - sender, the RadEditor object. - args. - - - - The following example demonstrates how to use the - OnClientSelectionChange property. - -
- <script type="text/javascript">
- function OnClientSelectionChange(sender, args)
- {
- var editor = sender;
- }
- </script> -
-
- <radsld:RadEditor ID="RadEditor1"
- runat= "server"
- OnClientSelectionChange="OnClientSelectionChange">
- ....
- </radsld:RadEditor> -
-
-
-
- - - Gets or sets a value indicating the client-side event handler that is called before - an editor command starts executing. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - If specified, the OnClientCommandExecuting - client-side event handler is called before a command starts executing. - Two parameters are passed to the handler: - - sender, the RadEditor object. - args. - - This event can be cancelled. - - - The following example demonstrates how to use the - OnClientCommandExecuting property. - -
- <script type="text/javascript">
- function OnClientCommandExecuting(sender, args)
- {
- var editor = sender;
- }
- </script> -
-
- <radsld:RadEditor ID="RadEditor1"
- runat= "server"
- OnClientCommandExecuting="OnClientCommandExecuting">
- ....
- </radsld:RadEditor> -
-
-
-
- - - Gets or sets a value indicating the client-side event handler that is called - after an editor command was executed. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - If specified, the OnClientCommandExecuted - client-side event handler that is called - when after an editor command was executed. Two parameters are passed to the handler: - - sender, the RadEditor object. - args. - - - - The following example demonstrates how to use the - OnClientCommandExecuted property. - -
- <script type="text/javascript">
- function OnClientCommandExecuted(sender, args)
- {
- var editor = sender;
- }
- </script> -
-
- <radsld:RadEditor ID="RadWindow1"
- runat= "server"
- OnClientCommandExecuted="OnClientCommandExecuted">
- ....
- </radsld:RadEditor> -
-
-
-
- - - Gets or sets the height of the Web server control. The default height is 400 pixels. - - - - - Gets or sets the width of the Web server control. The default width is 680 pixels. - - - - - Gets or sets the width of the editor's toolbar (should be used when ToolbarMode != Default). - - - - Gets or sets the skin name for the control user interface. - A string containing the skin name for the control user interface. The default is string.Empty. - - - If this property is not set, the control will render using the skin named "Default". - If EnableEmbeddedSkins is set to false, the control will not render skin. - - - - - Gets or sets the value, indicating whether to render the skin CSS files during Ajax requests - - - If EnableAjaxSkinRendering is set to false you will have to register the needed control base CSS file by hand when adding/showing the control with Ajax. - - - - - Gets or sets the value, indicating whether to render links to the embedded client scripts or not. - - - If EnableEmbeddedScripts is set to false you will have to register the needed script files by hand. - - - - - Gets or sets the value, indicating whether to render links to the embedded skins or not. - - - If EnableEmbeddedSkins is set to false you will have to register the needed CSS files by hand. - - - - - Gets or sets the value, indicating whether to render the link to the embedded base stylesheet of the control or not. - - - If EnableEmbeddedBaseStylesheet is set to false you will have to register the needed control base CSS file by hand. - - - - - Gets the text content of the RadEditor control without the HTML markup. - - The text displayed in the RadEditor without the HTML markup. The default is - string.Empty. - - - - The text returned by this property contains no HTML markup. If only the HTML - markup in the text is needed use the Html property. - - - You can set the text content of the RadEditor by using the - Html property or inline between its opening and closing - tags. In this case setting the Html property in the code - behind will override the inline content. - - - - For an example see the Html property. - - - - - Gets or sets the value indicating which will be the available EditModes. - - - - - Gets or sets the text content of the RadEditor control inlcuding the HTML - markup. The Html property is deprecated in RadEditor. - Use Content instead. - - - The text content of the RadEditor control including the HTML markup. The default is - string.Empty. - - - - - Gets or sets the text content of the RadEditor control inlcuding the HTML - markup. - - - The text content of the RadEditor control including the HTML markup. The default is - string.Empty. - - - - The text returned by this property contains HTML markup. If only the text is - needed use the Text property. - - You can also set the text content of the RadEditor inline between the - <Content></Content> tags. In this case setting this property - in the code behind will override the inline content. - - - This example demonstrates how to set the content of the RadEditor inline and the - differences between the Content and Text - <rade:RadEditor id="RadEditor1" runat="server" - >
- <Content>
- Telerik RadEditor<br>
- the best <span style="COLOR: red">html editor</span> in the - world
- </Content>
- </rade:RadEditor>
- <asp:button id="btnSave" runat="server" text="Submit" - onclick="btnSave_Click" /><br />
- Content:<asp:label runat="server" id="LabelContent"></asp:label><br - />
- Text:<asp:label runat="server" id="LabelText"></asp:label><br - />
-
- - Private Sub btnSave_Click(sender As Object, e As System.EventArgs) - 'HtmlEncode the content of the editor to display the HTML tags - LabelContent.Text = Server.HtmlEncode(RadEditor1.Content); - LabelText.Text = Server.HtmlEncode(RadEditor1.Text); - End Sub - - - private void btnSave_Click(object sender, System.EventArgs e) - { - //HtmlEncode the content of the editor to display the HTML tags - LabelContent.Text = Server.HtmlEncode(RadEditor1.Content); - LabelText.Text = Server.HtmlEncode(RadEditor1.Text); - } - -
-
- - - Contains the configuration of the ImageManager dialog. - - - An ImageManagerDialogConfiguration - instance, containing the configuration of the ImageManager dialog - - - - - Contains the configuration of the DocumentManager dialog. - - - An FileManagerDialogConfiguration - instance, containing the configuration of the DocumentManager dialog - - - - - Contains the configuration of the FlashManager dialog. - - - An FileManagerDialogConfiguration - instance, containing the configuration of the FlashManager dialog - - - - - Contains the configuration of the SilverlightManager dialog. - - - An FileManagerDialogConfiguration - instance, containing the configuration of the SilverlightManager dialog - - - - - Contains the configuration of the MediaManager dialog. - - - An FileManagerDialogConfiguration - instance, containing the configuration of the MediaManager dialog - - - - - Contains the configuration of the TemplateManager dialog. - - - An FileManagerDialogConfiguration - instance, containing the configuration of the TemplateManager dialog - - - - - Contains the configuration of the spell checker. - - - - - Gets the collection of the dialog definitions (configurations) of the editor. - - - A DialogDefinitionDictionary, specifying the definitions of the dialogs of the editor. - - - - - This property is obsolete. Please, use the StripFormattingOptions property instead. - - - The default value is EditorStripFormattingOptions.None. - - - - - Gets or sets the value indicating how the editor should clear the HTML formatting - when the user pastes data into the content area. - - - The default value is EditorStripFormattingOptions.None. - - - - EditorStripFormattingOptions - enum members - - - Member - Description - - - None - Doesn't strip anything, asks a question when MS Word - formatting was detected. - - - NoneSupressCleanMessage - Doesn't strip anything and does not ask a - question. - - - MSWord - Strips only MSWord related attributes and - tags. - - - MSWordNoFonts - Strips the MSWord related attributes and tags and font - tags. - - - MSWordRemoveAll - Strips MSWord related attributes and tags, font tags and - font size attributes. - - - Css - Removes style attributes. - - - Font - Removes Font tags. - - - Span - Clears Span tags. - - - AllExceptNewLines - Clears all tags except "br" and new lines (\n) on paste. - - - All - Remove all HTML formatting. - - - - Note: In Gecko-based browsers you will see the mandatory - dialog box where you need to paste the content. - - - - - Gets or sets the URL which the AJAX call will be made to. Check the help for more information. - - - - - Gets or sets the location of a CSS file, that will be added in the dialog window. If you need to include - more than one file, use the CSS @import url(); rule to add the other files from the first. - This property is needed if you are using a custom skin. It allows you to include your custom skin - CSS in the dialogs, which are separate from the main page. - - - - - Gets or sets the location of a JavaScript file, that will be added in the dialog window. If you need to include - more than one file, you will need to combine the scripts into one first. - This property is needed if want to override some of the default functionality without loading the dialog - from an external ascx file. - - - - - A read-only property that returns the DialogOpener instance used in the editor control. - - - - - Gets or sets a value indicating which content filters will be active when the editor is loaded in the browser. - - - The default value is EditorFilters.DefaultFilters. - - - EditorFilters enum members - - - Member - Description - - - RemoveScripts - This filter removes script tags from the editor content. Disable the filter if you want to insert script tags in the content. - - - MakeUrlsAbsolute - This filter makes all URLs in the editor content absolute (e.g. "http://server/page.html" instead of "page.html"). This filter is DISABLED by default. - - - FixUlBoldItalic - This filter changes the deprecated u tag to a span with CSS style. - - - IECleanAnchors - Internet Explorer only - This filter removes the current page url from all anchor(#) links to the same page. - - - FixEnclosingP - This filter removes a parent paragraph tag if the whole content is inside it. - - - MozEmStrong - This filter changes b to strong and i to em in Mozilla browsers. - - - ConvertFontToSpan - This filter changes deprecated font tags to compliant span tags. - - - ConvertToXhtml - This filter converts the HTML from the editor content area to XHTML. - - - IndentHTMLContent - This filter indents the HTML content so it is more readable when you view the code. - - - OptimizeSpans - This filter tries to decrease the number of nested spans in the editor content. - - - DefaultFilters - The default editor behavior. All content filters except MakeUrlsAbsolute are activated. - - - - - - - - Gets or sets a value indicating where the editor will look for its dialogs. - - - A relative path to the dialogs location. For example: "~/controls/RadEditorDialogs/". - - - If specified, the ExternalDialogsPath - property will allow you to customize and load the editor dialogs from normal ASCX files. - - - - - This event is raised before a file is deleted using the current content provider. - The file delete will be canceled if you return false from the event handler. - - - - - This event is raised before the file is stored using the current content provider. - The file upload will be canceled if you return false from the event handler. - - - - - Occurs when the content of the RadEditor changes between posts to the server. - - - - - A tool which will be rendered as a button - - - - - A tool which will be rendered as a dropdown - - - - - A tool which will be rendered as a split button - - - - - A tool which will be rendered as a separator - - - - - A tool which will be rendered as a toolstrip - - - - - Represents logical group of EditorTool objects. The default ToolAdapter will - render the EditorToolGroup object as a toolbar. - - - - - - - - - - - - - Gets all tools inside the group. - - - - - Finds the tool with the given name. - - - - - Determines whether the group a tool with the specified name. - - - - - - - - - - - - - - - - - - - - - Gets the custom attributes which will be serialized on the client. - - - - - Gets or sets a string which will be used by the ToolAdapter to associate - the group with the adapter's virtual structure. In the default adapter this - is the name of the docking zone where the toolbar should be placed. - - - - - Gets the children of the EditorToolGroup. - - - - - State managed collection of EditorToolGroup objects - - - - - Represents a single RadEditor tool. - - - - - Initializes a new instance of the class. - - - - - Initializes a new instance of the class. - - The name of the tool. - - - - Initializes a new instance of the class. - - The name of the tool. - The shortcut for the tool. - - - - Throws an exception if the EditorTool has no name. - - - - - Gets or sets a value indicating whether this is enabled. - - true if enabled; otherwise, false. - - - - Gets or sets the name. It will be used by RadEditor to find - the command which should be executed when the user clicks this tool. - - The tool name. - - - - Gets or sets the title of the . The default ToolAdapter will - render the value of this property as a tooltip or static text near the - tool icon. - - The text. - - - - Gets or sets the keyboard shortcut which will invoke the associated - RadEditor command. - - - - - Gets or sets a value indicating whether the tool icon should be displayed. - - true if the tool icon should be displayed; otherwise, false. - - - - Gets or sets a value indicating whether the tool text should be displayed. - - true if the tool text should be displayed; otherwise, false. - - - - Gets or sets the type of the tool - by default it is a button - - The type of the tool on the client. - - - - Summary description for DisplayFormatPosition. - - - - - Fired whenever the value of any enumeration mask part has changed. - - - Note this event is effective only for the RadMaskedTextBox control. - - - - - Fired whenever the user increases the value of any enumeration or numeric range mask part of RadMaskedTextBox - (with either keyboard arrow keys or mouse wheel). - - - Note this event is effective only for the RadMaskedTextBox control. - - - - - Fired whenever the user decreases the value of any enumeration or numeric range mask part of RadMaskedTextBox - (with either keyboard arrow keys or mouse wheel). - - - Note this event is effective only for the RadMaskedTextBox control. - - - - Represents a single character, digit only mask part. - - This example demonstrates how to add a DigitMaskPart object in the - MaskParts property of RadMaskedTextBox. - - private void Page_Load(object sender, System.EventArgs e) - { - DigitMaskPart digitPart = new DigitMaskPart(); - RadMaskedTextBox1.MaskParts.Add(digitPart); - } - - - Private Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles MyBase.Load - Dim digitPart As New DigitMaskPart() - RadMaskedTextBox1.MaskParts.Add(digitPart) - End Sub - - - - - The abstract base class of all mask parts. - This class is not intended to be used directly. - - - - - - - - Returns the friendly name of the part. - - - - - - - - - Represents a MaskPart object which accepts only a predefined set of - options. - - - This example demonstrates how to add an EnumerationMaskPart object - in the MaskParts property of RadMaskedTextBox. - - private void Page_Load(object sender, System.EventArgs e) - { - EnumerationMaskPart enumPart = new EnumerationMaskPart(); - enumPart.Items.Add("Mon"); - enumPart.Items.Add("Two"); - enumPart.Items.Add("Wed"); - enumPart.Items.Add("Thu"); - enumPart.Items.Add("Fri"); - enumPart.Items.Add("Sat"); - enumPart.Items.Add("Sun"); - - RadMaskedTextBox1.MaskParts.Add(enumPart); - } - - - Private Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles MyBase.Load - Dim enumPart As New EnumerationMaskPart - enumPart.Items.Add("Mon") - enumPart.Items.Add("Two") - enumPart.Items.Add("Wed") - enumPart.Items.Add("Thu") - enumPart.Items.Add("Fri") - enumPart.Items.Add("Sat") - enumPart.Items.Add("Sun") - - RadMaskedTextBox1.MaskParts.Add(enumPart) - End Sub - - - - - Returns the friendly name of the part. - - - - Gets the options collection of the part. - - - - - - - - - Represents a single character MaskPart object which accepting any - character. - - - This example demonstrates how to add a FreeMaskPart object in the - MaskParts property of RadMaskedTextBox. - - private void Page_Load(object sender, System.EventArgs e) - { - FreeMaskPart freePart = new FreeMaskPart(); - RadMaskedTextBox1.MaskParts.Add(freePart); - } - - - Private Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles MyBase.Load - Dim fixedPart As New FreeMaskPart() - RadMaskedTextBox1.MaskParts.Add(fixedPart) - End Sub - - - - - - Returns the friendly name of the part. - - - - Represents a multi character MaskPart whose content cannot be modified. - - This example demonstrates how to add a LiteralMaskPart object in - the MaskParts property of RadMaskedTextBox. - - private void Page_Load(object sender, System.EventArgs e) - { - LiteralMaskPart literalPart = new LiteralMaskPart(); - literalPart.Text = "("; - RadMaskedTextBox1.MaskParts.Add(literalPart); - } - - - Private Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles MyBase.Load - Dim literalPart As New LiteralMaskPart() - RadMaskedTextBox1.MaskParts.Add(literalPart) - End Sub - - - - - - Returns the friendly name of the part. - - - - - - - - Gets or sets the string that the LiteralMaskPart will render. - - - - Represents a single character MaskPart. The character is converted to lower upon - input. - - - This example demonstrates how to add a LowerMaskPart object in the - MaskParts property of RadMaskedTextBox. - - private void Page_Load(object sender, System.EventArgs e) - { - LowerMaskPart lowerPart = new LowerMaskPart(); - RadMaskedTextBox1.MaskParts.Add(lowerPart); - } - - - Private Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles MyBase.Load - Dim lowerPart As New LowerMaskPart() - RadMaskedTextBox1.MaskParts.Add(lowerPart) - End Sub - - - - - - Returns the friendly name of the part. - - - - - - - - Represents the collection of mask parts in a RadMaskedTextBox. - - - - Appends the specified MaskPart to - the end of the collection. - - - The MaskPart to append to the - collection. - - - - - Inserts the specified MaskPart in - the collection at the specified index location. - - - The location in the collection to insert the - MaskPart. - - - The MaskPart to add to the - collection. - - - - Determines whether the collection contains the specified item - - true if the collection contains the specified - MaskPart; otherwise - false. - - - The MaskPart to search for in the - collection. - - - - - - Removes the specified MaskPart - from the collection. - - - - The MaskPart to remove from the - collection. - - - - - Determines the index value that represents the position of the specified - MaskPart in the collection. - - - The zero-based index position of the specified - MaskPart in the collection. - - - A MaskPart to search for in the - collection. - - - - - Gets or sets the RadMaskedInputControl, which uses the - collection. - - - - - Gets a MaskPart at the specified - index in the collection. - - - Use this indexer to get a MaskPart - from the - MaskPartCollection at the - specified index, using array notation. - - - The zero-based index of the MaskPart - to retrieve from the collection. - - - - Represents a MaskPart which accepts numbers in a specified range. - - This example demonstrates how to add a NumericRangeMaskPart object - in the MaskParts collection of RadMaskedTextBox. - - private void Page_Load(object sender, System.EventArgs e) - { - NumericRangeMaskPart rangePart = new NumericRangeMaskPart(); - rangePart.LowerLimit = 0; - rangePart.UpperLimit = 255; - RadMaskedTextBox1.MaskParts.Add(rangePart); - } - - - Private Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles MyBase.Load - Dim rangePart As New NumericRangeMaskPart() - rangePart.LowerLimit = 0 - rangePart.UpperLimit = 255 - RadMaskedTextBox1.MaskParts.Add(rangePart) - End Sub - - - - - Returns the friendly name of the part. - - - - - - - Gets or sets the smallest possible value the part can accept. - - An integer representing the smallest acceptable number that the - NumericRangeMaskPart can accept. The default value is 0. - - - - Gets or sets the largest possible value the part can accept. - - An integer representing the largest acceptable number that the - NumericRangeMaskPart can accept. The default value is 0. - - - - - Represents a single character MaskPart. The character is converted to upper upon - input. . - - - This example demonstrates how to add an UpperMaskPart object in - the MaskParts collection of RadMaskedTextBox. - - private void Page_Load(object sender, System.EventArgs e) - { - UpperMaskPart upperPart = new UpperMaskPart(); - RadMaskedTextBox1.MaskParts.Add(upperPart); - } - - - Private Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles MyBase.Load - Dim upperPart As New UpperMaskPart() - RadMaskedTextBox1.MaskParts.Add(upperPart) - End Sub - - - - - Returns the friendly name of the part. - - - - Numeric range alignment options - - - - - The numbers are aligned left - - - - - The numbers are aligned right - - - - - Telerik RadInput - - - - Gets or sets the string to use as the decimal separator in values. - The string to use as the decimal separator in values. - The property is being set to an empty string. - The property is being set to null. - - - Gets the native decimal separator of the control's culture. - - - Gets or sets the number of decimal places to use in numeric values - The number of decimal places to use in values. - The property is being set to a value that is less than 0 or greater than 99. - - - - Gets or sets the number of digits in each group to the left of the decimal in - values. - - The number of digits in each group to the left of the decimal in values. - The property is being set to null. - - - - Gets or sets the string that separates groups of digits to the left of the - decimal in values. - - - The string that separates groups of digits to the left of the decimal in - values. - - The property is being set to null. - - - Gets or sets the format pattern for negative values. - The format pattern for negative percent values. - The property is being set to a value that is less than 0 or greater than 11. - - - Gets or sets the format pattern for positive values. - The format pattern for positive percent values. The - The property is being set to a value that is less than 0 or greater than 3. - - - - Telerik RadNumericTextBox - - - - - Gets the style properties for RadInput when when the text is - negative. - - - A Telerik.WebControls.TextBoxStyle object that represents the style properties - for RadInput control. The default value is an empty TextBoxStyle object. - - - The following code example demonstrates how to set NegativeStyle - property: - [C#] -
-            </%@ Page Language="C#" /%>
</%@ Register Assembly="RadInput.Net2" Namespace="Telerik.WebControls" TagPrefix="radI" /%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>Untitled Page</title>
</head>
<body>
<form id="form1" runat="server">
<radI:RadTextBox Text="-1" EmptyMessage="EmptyMessage" ID="RadNumericTextBox1" runat="server">
<NegativeStyle BackColor="red" />
</radI:RadTextBox>
</form>
</body>
</html> -
-
- - Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media - Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP - Starter Edition - The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft - Windows XP SP2, and Windows Server 2003 SP1. - .NET Framework
- Supported in: 3.0, 2.0, 1.1, 1.0
-
- - Use this property to provide a custom style for the negative state of - RadInput control. Common style attributes that can be adjusted include - foreground color, background color, font, and alignment within the RadInput. - Providing a different style enhances the appearance of the RadInput - control. - Negative style properties in the RadInput control are inherited from one - style property to another through a hierarchy. For example, if you specify a red - font for the EnabledStyle property, all other style properties in the RadInput - control will also have a red font. This allows you to provide a common appearance - for the control by setting a single style property. You can override the inherited - style settings for an item style property that is higher in the hierarchy by - setting its style properties. For example, you can specify a blue font for the - NegativeStyle property, overriding the red font specified in the EnabledStyle - property. - To specify a custom style, place the <NegativeStyle> tags between the - opening and closing tags of the RadInput control. You can then list the style - attributes within the opening <NegativeStyle> tag. - -
- - Gets or sets the value of the RadInput control. - - Use the Text property to specify or determine the text displayed in the - RadInput control. To limit the number of characters accepted by the control, set - the MaxLength property. If you want to prevent the text from being modified, set - the ReadOnly property. - The value of this property, when set, can be saved automatically to a - resource file by using a designer tool. - - - Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media - Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP - Starter Edition - The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft - Windows XP SP2, and Windows Server 2003 SP1. - .NET Framework
- Supported in: 3.0, 2.0, 1.1, 1.0
-
- - null if the Text property is Empty.The Value property are Nullable Double type. A - nullable type can represent the normal range of values for its underlying value type, - plus an additional null value. For example, a Nullable<Double>, pronounced - "Nullable of Double," can be assigned any value from -2^46 (-70368744177664) to - 2^46 (70368744177664), or it can be assigned the null value. - -
- - - Gets or sets the date content of RadNumericTextBox in a database friendly - way. - - An object that represents the Text property. The default value is null. - - This property behaves exactly like the Value property. The only difference is - that it will not throw an exception if the new value is not double object (or null). If - you assign null to the control you will see blank RadInput. - - - The following example demonstrates how to bind the RadNumericTextBox: - [C#] -
-            </%@ Page Language="C#" /%>
</%@ Register Assembly="RadInput.Net2" Namespace="Telerik.WebControls" TagPrefix="radI" /%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>Untitled Page</title>
<script runat="server">
protected void Page_Load(object sender, EventArgs e)
{
System.Data.DataTable table = new System.Data.DataTable();
table.Columns.Add("num");
-
System.Data.DataRow row = table.NewRow();
row["num"] = (double)12.56;
table.Rows.Add(row);
-
row = table.NewRow();
row["num"] = (int)12;
table.Rows.Add(row);
-
row = table.NewRow();
row["num"] = DBNull.Value;
table.Rows.Add(row);
-
row = table.NewRow();
row["num"] = "33";
table.Rows.Add(row);
-
row = table.NewRow();
table.Rows.Add(row);
-
Repeater1.DataSource = table;
Repeater1.DataBind();
}
</script>
</head>
<body>
<form id="form1" runat="server">
<asp:Repeater runat="server" ID="Repeater1">
<ItemTemplate>
<radI:RadNumericTextBox DbValue='</%# Bind("num") /%>'
ID="RadNumericTextBox1" runat="server">
</radI:RadNumericTextBox>
</ItemTemplate>
</asp:Repeater>
</form>
</body>
</html> -
- [VisualBasic] -
-            </%@ Page Language="VB" /%>

</%@ Register Assembly="RadInput.Net2" Namespace="Telerik.WebControls" TagPrefix="radI" /%>

<!DOCTYPE html Public "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>Untitled Page</title>
<script runat="server">
Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Load
Dim table As System.Data.DataTable = New System.Data.DataTable
table.Columns.Add("num")
Dim row As System.Data.DataRow = table.NewRow
row("num") = CType(12.56,Double)
table.Rows.Add(row)
row = table.NewRow
row("num") = CType(12,Integer)
table.Rows.Add(row)
row = table.NewRow
row("num") = DBNull.Value
table.Rows.Add(row)
row = table.NewRow
row("num") = "33"
table.Rows.Add(row)
row = table.NewRow
table.Rows.Add(row)
Repeater1.DataSource = table
Repeater1.DataBind
End Sub
</script>
</head>
<body>
<form id="form1" runat="server">
<asp:Repeater runat="server" ID="Repeater1">
<ItemTemplate>
<radI:RadNumericTextBox DbValue='</%# Bind("num") /%>'
ID="RadNumericTextBox1" runat="server">
</radI:RadNumericTextBox>
</ItemTemplate>
</asp:Repeater>
</form>
</body>
</html> -
-
- - Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media - Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP - Starter Edition - The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft - Windows XP SP2, and Windows Server 2003 SP1. - .NET Framework
- Supported in: 3.0, 2.0, 1.1, 1.0
-
-
- - - Gets or sets a value indicating whether the button is displayed in the - RadInput control. - - - true if the button is displayed; otherwise, false. The default value is true, - however this property is only examined when the ButtonTemplate property is not a null - reference (Nothing in Visual Basic). - - - Use the ShowButton property to specify whether the button is displayed in the - RadInput control. - The contents of the button are controlled by the ButtonTemplate - property. - - - The following code example demonstrates how to use the ShowButton property to - display the button in the RadInput control. - [C#] -
-            </%@ Page Language="C#" /%>
</%@ Register Assembly="RadInput.Net2" Namespace="Telerik.WebControls" TagPrefix="radI" /%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd" >
-
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>Untitled Page</title>
<script language="javascript" type="text/javascript">
function Click(sender)
{
alert("click");
}
</script>
</head>
<body>
<form id="form1" runat="server">
<radI:RadTextBox ShowButton="true" ID="RadNumericTextBox1" runat="server">
<ClientEvents OnButtonClick="Click" />
<ButtonTemplate>
<input type="button" value="click here" />
</ButtonTemplate>
</radI:RadTextBox>
</form>
</body>
</html> -
-
- - Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media - Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP - Starter Edition - The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft - Windows XP SP2, and Windows Server 2003 SP1. - .NET Framework
- Supported in: 3.0, 2.0, 1.1, 1.0
-
-
- - Type of object that is used to wrap the DbValue property. - -
- That property is designed to be used when this control is - embedded into grid or other data-bound control. - Default value is set to the Double. -
-
- Default value is set to the Double. -
- - Gets or sets the culture used by RadNumericTextBox to format the numburs. - - A CultureInfo object that represents the current culture used. The default value - is System.Threading.Thread.CurrentThread.CurrentUICulture. - - - The following example demonstrates how to use the Culture property. - - private void Page_Load(object sender, System.EventArgs e) - { - RadNumericTextBox.Culture = new CultureInfo("en-US"); - } - - - Private Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles MyBase.Load - RadNumericTextBox1.Culture = New CultureInfo("en-US") - End Sub - - - - Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media - Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP - Starter Edition - The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft - Windows XP SP2, and Windows Server 2003 SP1. - .NET Framework
- Supported in: 3.0, 2.0, 1.1, 1.0
-
-
- - Gets or sets the largest possible value of a RadNumericTextBox. - The default value is positive 2^46. - - Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media - Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP - Starter Edition - The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft - Windows XP SP2, and Windows Server 2003 SP1. - .NET Framework
- Supported in: 3.0, 2.0, 1.1, 1.0
-
-
- - - Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media - Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP - Starter Edition - The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft - Windows XP SP2, and Windows Server 2003 SP1. - .NET Framework
- Supported in: 3.0, 2.0, 1.1, 1.0
-
- -
- Gets or sets the smallest possible value of a RadNumericTextBox. -
- The default value is negative -2^46. -
- - Gets or sets the numeric type of the RadNumericTextBox. - One of the NumericType enumeration values. The default is Number. - - Use the Type property to determine the numeric type that the RadNumericTextBox - represents. The Type property is represented by one of the NumericType enumeration - values. - - - Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media - Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP - Starter Edition - The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft - Windows XP SP2, and Windows Server 2003 SP1. - .NET Framework
- Supported in: 3.0, 2.0, 1.1, 1.0
-
-
- - Gets control that contains the up button of RadInput control - The ShowButton or ShowSpinButton properties must be set to true - - Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media - Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP - Starter Edition - The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft - Windows XP SP2, and Windows Server 2003 SP1. - .NET Framework
- Supported in: 3.0, 2.0, 1.1, 1.0
-
-
- - Gets control that contains the up button of RadInput control - The ShowButton or ShowSpinButton properties must be set to true - - Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media - Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP - Starter Edition - The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft - Windows XP SP2, and Windows Server 2003 SP1. - .NET Framework
- Supported in: 3.0, 2.0, 1.1, 1.0
-
-
- - - Summary description for AutoPostBackControl. - - - - - Telerik RadTextBox - - - - - Gets or sets the behavior mode (single-line, multiline, or password) of the - RadTextBox control. - - - One of the RadInputTextBoxMode enumeration values. The default value is - SingleLine. - - - Use the TextMode property to specify whether a RadTextBox control is - displayed as a single-line, multiline, or password text box. - When the RadTextBox control is in multiline mode, you can control the number - of rows displayed by setting the Rows property. You can also specify whether the - text should wrap by setting the Wrap property. - If the RadTextBox control is in password mode, all characters entered in the - control are masked. - This property cannot be set by themes or style sheet themes - - The specified mode is not one of the TextBoxMode enumeration values. - - The following code example demonstrates how to use the RadTextMode property to - specify a multiline text box. This example has a text box that accepts user input, - which is a potential security threat. By default, ASP.NET Web pages validate that - user input does not include script or HTML elements. - - <%@ Page Language="VB" AutoEventWireup="True" %> - - <%@ Register Assembly="RadInput.Net2" Namespace="Telerik.WebControls" TagPrefix="radI" %> - - <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" - "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> - <html> - <head> - <title>MultiLine RadTextBox Example </title> - - <script runat="server"> - - Protected Sub SubmitButton_Click(sender As Object, e As EventArgs ) - - Message.Text = "Thank you for your comment: <br />" + Comment.Text - - End Sub - - Protected Sub Check_Change(sender As Object, e As EventArgs ) - - Comment.Wrap = WrapCheckBox.Checked - Comment.ReadOnly = ReadOnlyCheckBox.Checked - - End Sub - - </script> - - </head> - <body> - <form id="form1" runat="server"> - <h3> - MultiLine RadTextBox Example - </h3> - Please enter a comment and click the submit button. - <br /> - <br /> - <radI:RadTextBox ID="Comment" TextMode="MultiLine" Columns="50" Rows="5" runat="server" /> - <br /> - <asp:RequiredFieldValidator ID="Value1RequiredValidator" ControlToValidate="Comment" - ErrorMessage="Please enter a comment.<br />" Display="Dynamic" runat="server" /> - <asp:CheckBox ID="WrapCheckBox" Text="Wrap Text" Checked="True" AutoPostBack="True" - OnCheckedChanged="Check_Change" runat="server" /> - - <asp:CheckBox ID="ReadOnlyCheckBox" Text="ReadOnly" Checked="False" AutoPostBack="True" - OnCheckedChanged="Check_Change" runat="server" /> - - <asp:Button ID="SubmitButton" Text="Submit" OnClick="SubmitButton_Click" runat="server" /> - <hr /> - <asp:Label ID="Message" runat="server" /> - </form> - </body> - </html> - - - <%@ Page Language="C#" AutoEventWireup="True" %> - - <%@ Register Assembly="RadInput.Net2" Namespace="Telerik.WebControls" TagPrefix="radI" %> - - <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" - "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> - <html> - <head> - <title>MultiLine RadTextBox Example </title> - - <script runat="server"> - - protected void SubmitButton_Click(Object sender, EventArgs e) - { - - Message.Text = "Thank you for your comment: <br />" + Comment.Text; - - } - - protected void Check_Change(Object sender, EventArgs e) - { - - Comment.Wrap = WrapCheckBox.Checked; - Comment.ReadOnly = ReadOnlyCheckBox.Checked; - - } - - </script> - - </head> - <body> - <form id="form1" runat="server"> - <h3> - MultiLine RadTextBox Example - </h3> - Please enter a comment and click the submit button. - <br /> - <br /> - <radI:RadTextBox ID="Comment" TextMode="MultiLine" Columns="50" Rows="5" runat="server" /> - <br /> - <asp:RequiredFieldValidator ID="Value1RequiredValidator" ControlToValidate="Comment" - ErrorMessage="Please enter a comment.<br />" Display="Dynamic" runat="server" /> - <asp:CheckBox ID="WrapCheckBox" Text="Wrap Text" Checked="True" AutoPostBack="True" - OnCheckedChanged="Check_Change" runat="server" /> - - <asp:CheckBox ID="ReadOnlyCheckBox" Text="ReadOnly" Checked="False" AutoPostBack="True" - OnCheckedChanged="Check_Change" runat="server" /> - - <asp:Button ID="SubmitButton" Text="Submit" OnClick="SubmitButton_Click" runat="server" /> - <hr /> - <asp:Label ID="Message" runat="server" /> - </form> - </body> - </html> - - - - Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media - Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP - Starter Edition - The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft - Windows XP SP2, and Windows Server 2003 SP1. - .NET Framework
- Supported in: 3.0, 2.0, 1.1, 1.0
-
-
- - - Gets or sets a value that indicates the AutoComplete behavior of the RadTextBox - control - - - One of the System.Web.UI.WebControls.AutoCompleteType enumeration values, - indicating the AutoComplete behavior for the RadTextBox control. The default value is - None. - - The selected value is not one of the System.Web.UI.WebControls.AutoCompleteType enumeration values. - - To assist with data entry, Microsoft Internet Explorer 5 and later and - Netscape support a feature called AutoComplete. AutoComplete monitors a RadTextBox - and creates a list of values entered by the user. When the user returns to the - RadTextBox at a later time, the list is displayed. Instead of retyping a previously - entered value, the user can simply select the value from this list. Use the - AutoCompleteType property to control the behavior of the AutoComplete feature for a - RadTextBox control. The System.Web.UI.WebControls.AutoCompleteType enumeration is - used to represent the values that you can apply to the AutoCompleteType property. - Not all browsers support the AutoComplete feature. Check with your browser to - determine compatibility. - By default, the AutoCompleteType property for a RadTextBox control is set to - AutoCompleteType.None. With this setting, the RadTextBox control shares the list - with other RadTextBox controls with the same ID property across different pages. - You can also share a list between RadTextBox controls based on a category, instead - of an ID property. When you set the AutoCompleteType property to one of the - category values (such as AutoCompleteType.FirstName, AutoCompleteType.LastName, and - so on), all RadTextBox controls with the same category share the same list. You can - disable the AutoComplete feature for a RadTextBox control by setting the - AutoCompleteType property to AutoCompleteType.Disabled. - Refer to your browser documentation for details on configuring and enabling - the AutoComplete feature. For example, to enable the AutoComplete feature in - Internet Explorer version 5 or later, select Internet Options from the Tools menu, - and then select the Content tab. Click the AutoComplete button to view and modify - the various browser options for the AutoComplete feature. - This property cannot be set by themes or style sheet themes. - - - The following code example demonstrates how to use the AutoCompleteType - enumeration to specify the AutoComplete category for a RadTextBox control. This - example has a text box that accepts user input, which is a potential security - threat. By default, ASP.NET Web pages validate that user input does not include - script or HTML elements. - [C#] -
-            </%@ Page Language="C#" /%>
-
</%@ Register Assembly="RadInput.Net2" Namespace="Telerik.WebControls" TagPrefix="radI" /%>
-
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
- <html>
<head id="Head1" runat="server">
<title>AutoCompleteType example</title>
</head>
<body>
- <form id="form1" runat="server">
<!-- You need to enable the AutoComplete feature on -->
- <!-- a browser that supports it (such as Internet -->
<!-- Explorer 5.0 and later) for this sample to -->
- <!-- work. The AutoComplete lists are created after -->
<!-- the Submit button is clicked. -->
- <h3>
AutoCompleteType example</h3>
Enter values in the text boxes and click the Submit
<br />
- button.
<br />
<br />
<!-- The following TextBox controls have different -->
- <!-- categories assigned to their AutoCompleteType -->
<!-- properties. -->
- First Name:<br />
<radI:RadTextBox ID="FirstNameTextBox" AutoCompleteType="FirstName" runat="server" />
<br />
- Last Name:<br />
<radI:RadTextBox ID="LastNameTextBox" AutoCompleteType="LastName" runat="server" />
<br />
- Email:<br />
<radI:RadTextBox ID="EmailTextBox" AutoCompleteType="Email" runat="server" />
<br />
- <!-- The following TextBox controls have the same -->
<!-- categories assigned to their AutoCompleteType -->
- <!-- properties. They share the same AutoComplete -->
<!-- list. -->
Phone Line #1:<br />
- <radI:RadTextBox ID="Phone1TextBox" AutoCompleteType="HomePhone" runat="server" />
<br />
Phone Line #2:<br />
- <radI:RadTextBox ID="Phone2TextBox" AutoCompleteType="HomePhone" runat="server" />
<br />
- <!-- The following TextBox control has its -->
<!-- AutoCompleteType property set to -->
- <!-- AutoCompleteType.None. All TextBox controls -->
- <!-- with the same ID across different pages share -->
<!-- the same AutoComplete list. -->
Category:<br />
- <radI:RadTextBox ID="CategoryTextBox" AutoCompleteType="None" runat="server" />
<br />
<!-- The following TextBox control has the -->
- <!-- AutoComplete feature disabled. -->
Comments:<br />
<radI:RadTextBox ID="CommentsTextBox" AutoCompleteType="Disabled" runat="server" />
- <br />
<br />
<br />
<asp:Button ID="SubmitButton" Text="Submit" runat="Server" />
</form>
</body>
</html>
-
- [Visual Basic] -
-            </%@ Page Language="VB" /%>

</%@ Register Assembly="RadInput.Net2" Namespace="Telerik.WebControls" TagPrefix="radI" /%>

- <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head id="Head1" runat="server">
- <title>AutoCompleteType example</title>
</head>
<body>
<form id="form1" runat="server">
<!-- You need to enable the AutoComplete feature on -->
- <!-- a browser that supports it (such as Internet -->
<!-- Explorer 5.0 and later) for this sample to -->
<!-- work. The AutoComplete lists are created after -->
- <!-- the Submit button is clicked. -->
<h3>
AutoCompleteType example</h3>
Enter values in the text boxes and click the Submit
<br />
- button.
<br />
<br />
<!-- The following TextBox controls have different -->
<!-- categories assigned to their AutoCompleteType -->
- <!-- properties. -->
First Name:<br />
<radI:RadTextBox ID="FirstNameTextBox" AutoCompleteType="FirstName" runat="server" />
<br />
- Last Name:<br />
<radI:RadTextBox ID="LastNameTextBox" AutoCompleteType="LastName" runat="server" />
<br />
Email:<br />
- <radI:RadTextBox ID="EmailTextBox" AutoCompleteType="Email" runat="server" />
<br />
<!-- The following TextBox controls have the same -->
- <!-- categories assigned to their AutoCompleteType -->
<!-- properties. They share the same AutoComplete -->
<!-- list. -->
Phone Line #1:<br />
- <radI:RadTextBox ID="Phone1TextBox" AutoCompleteType="HomePhone" runat="server" />
<br />
Phone Line #2:<br />
<radI:RadTextBox ID="Phone2TextBox" AutoCompleteType="HomePhone" runat="server" />
- <br />
<!-- The following TextBox control has its -->
<!-- AutoCompleteType property set to -->
<!-- AutoCompleteType.None. All TextBox controls -->
<!-- with the same ID across different pages share -->
- <!-- the same AutoComplete list. -->
Category:<br />
<radI:RadTextBox ID="CategoryTextBox" AutoCompleteType="None" runat="server" />
<br />
<!-- The following TextBox control has the -->
- <!-- AutoComplete feature disabled. -->
Comments:<br />
<radI:RadTextBox ID="CommentsTextBox" AutoCompleteType="Disabled" runat="server" />
<br />
<br />
<br />
<asp:Button ID="SubmitButton" Text="Submit" runat="Server" />
</form>
</body>
</html> -
-
- - Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media - Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP - Starter Edition - The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft - Windows XP SP2, and Windows Server 2003 SP1. - .NET Framework
- Supported in: 3.0, 2.0
-
-
- - Gets or sets the number of rows displayed in a multiline RadTextBox. - - The number of rows in a multiline RadTextBox. The default is 0, which displays a - two-line text box. - - - Use the Rows property to specify the number of rows displayed in a multiline - RadTextBox. This property is applicable only when the TextMode property is set to - MultiLine. This property cannot be set by themes or style sheet themes. This example - has a text box that accepts user input, which is a potential security threat. By - default, ASP.NET Web pages validate that user input does not include script or HTML - elements. - - - The following code example demonstrates how to use the Rows property to - specify a height of 5 rows for a multiline RadTextBox control. - [C#] -
-            </%@ Page Language="C#" AutoEventWireup="True" /%>
-
</%@ Register Assembly="RadInput.Net2" Namespace="Telerik.WebControls" TagPrefix="radI" /%>
-
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
<title>MultiLine TextBox Example </title>
-
<script runat="server">
protected void SubmitButton_Click(Object sender, EventArgs e)
{
Message.Text = "Thank you for your comment: <br />" + Comment.Text;
}
-
protected void Check_Change(Object sender, EventArgs e)
{
Comment.Wrap = WrapCheckBox.Checked;
Comment.ReadOnly = ReadOnlyCheckBox.Checked;
}
-
</script>
-
</head>
<body>
<form id="form1" runat="server">
<h3>
MultiLine TextBox Example
</h3>
Please enter a comment and click the submit button.
<br />
<br />
- <radI:RadTextBox ID="Comment" TextMode="MultiLine" Columns="50" Rows="5" runat="server" />
<br />
<asp:RequiredFieldValidator ID="Value1RequiredValidator" ControlToValidate="Comment"
ErrorMessage="Please enter a comment.<br />" Display="Dynamic" runat="server" />
- <asp:CheckBox ID="WrapCheckBox" Text="Wrap Text" Checked="True" AutoPostBack="True"
OnCheckedChanged="Check_Change" runat="server" />
-
<asp:CheckBox ID="ReadOnlyCheckBox" Text="ReadOnly" Checked="False" AutoPostBack="True"
OnCheckedChanged="Check_Change" runat="server" />
-
<asp:Button ID="SubmitButton" Text="Submit" OnClick="SubmitButton_Click" runat="server" />
<hr />
<asp:Label ID="Message" runat="server" />
</form>
</body>
</html> -
- [Visual Basic] -
-            </%@ Page Language="VB" AutoEventWireup="True" /%>

</%@ Register Assembly="RadInput.Net2" Namespace="Telerik.WebControls" TagPrefix="radI" /%>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
<title>MultiLine RadTextBox Example </title>

<script runat="server">

Protected Sub SubmitButton_Click(sender As Object, e As EventArgs )

- Message.Text = "Thank you for your comment: <br />" + Comment.Text

End Sub

Protected Sub Check_Change(sender As Object, e As EventArgs )

Comment.Wrap = WrapCheckBox.Checked
Comment.ReadOnly = ReadOnlyCheckBox.Checked

End Sub

</script>

</head>
<body>
- <form id="form1" runat="server">
<h3>
MultiLine RadTextBox Example
</h3>
Please enter a comment and click the submit button.
<br />
<br />
<radI:RadTextBox ID="Comment" TextMode="MultiLine" Columns="50" Rows="5" runat="server" />
- <br />
<asp:RequiredFieldValidator ID="Value1RequiredValidator" ControlToValidate="Comment"
ErrorMessage="Please enter a comment.<br />" Display="Dynamic" runat="server" />
<asp:CheckBox ID="WrapCheckBox" Text="Wrap Text" Checked="True" AutoPostBack="True"
OnCheckedChanged="Check_Change" runat="server" />

- <asp:CheckBox ID="ReadOnlyCheckBox" Text="ReadOnly" Checked="False" AutoPostBack="True"
OnCheckedChanged="Check_Change" runat="server" />

<asp:Button ID="SubmitButton" Text="Submit" OnClick="SubmitButton_Click" runat="server" />
<hr />
<asp:Label ID="Message" runat="server" />
- </form>
</body>
</html> -
-
- - Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media - Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP - Starter Edition - The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft - Windows XP SP2, and Windows Server 2003 SP1. - .NET Framework
- Supported in: 3.0, 2.0, 1.1, 1.0
-
-
- - Gets or sets the display width of the RadTextBox in characters. - - The display width, in characters, of the RadTextBox. The default is 0, which - indicates that the property is not set. - - The specified width is less than 0. - - The following code example demonstrates how to use the Columns property to - specify a width of 2 characters for the RadTextBox control. This example has a text - box that accepts user input, which is a potential security threat. By default, - ASP.NET Web pages validate that user input does not include script or HTML - elements. - [C#] -
-            </%@ Page Language="C#" AutoEventWireup="True" /%>
-
</%@ Register Assembly="RadInput.Net2" Namespace="Telerik.WebControls" TagPrefix="radI" /%>
-
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
<title>RadTextBox Example </title>
-
<script runat="server">
-
protected void AddButton_Click(Object sender, EventArgs e)
{
int Answer;
-
Answer = Convert.ToInt32(Value1.Text) + Convert.ToInt32(Value2.Text);
-
AnswerMessage.Text = Answer.ToString();
-
}
-
</script>
-
</head>
<body>
<form id="form1" runat="server">
<h3>
RadTextBox Example
</h3>
-
<table>
<tr>
<td colspan="5">
Enter integer values into the text boxes.
<br />
- Click the Add button to add the two values.
<br />
Click the Reset button to reset the text boxes.
</td>
</tr>
<tr>
<td colspan="5">
-
</td>
</tr>
<tr align="center">
<td>
<radI:RadTextBox ID="Value1" Columns="2" MaxLength="3" Text="1" runat="server" />
</td>
- <td>
+
</td>
<td>
<radI:RadTextBox ID="Value2" Columns="2" MaxLength="3" Text="1" runat="server" />
</td>
<td>
=
</td>
- <td>
<asp:Label ID="AnswerMessage" runat="server" />
</td>
</tr>
<tr>
<td colspan="2">
<asp:RequiredFieldValidator ID="Value1RequiredValidator" ControlToValidate="Value1"
- ErrorMessage="Please enter a value.<br />" Display="Dynamic" runat="server" />
<asp:RangeValidator ID="Value1RangeValidator" ControlToValidate="Value1" Type="Integer"
MinimumValue="1" MaximumValue="100" ErrorMessage="Please enter an integer <br /> between than 1 and 100.<br />"
- Display="Dynamic" runat="server" />
</td>
<td colspan="2">
<asp:RequiredFieldValidator ID="Value2RequiredValidator" ControlToValidate="Value2"
ErrorMessage="Please enter a value.<br />" Display="Dynamic" runat="server" />
- <asp:RangeValidator ID="Value2RangeValidator" ControlToValidate="Value2" Type="Integer"
MinimumValue="1" MaximumValue="100" ErrorMessage="Please enter an integer <br /> between than 1 and 100.<br />"
Display="Dynamic" runat="server" />
</td>
- <td>
&nbsp
</td>
</tr>
<tr align="center">
<td colspan="4">
<asp:Button ID="AddButton" Text="Add" OnClick="AddButton_Click" runat="server" />
</td>
<td>
-
</td>
</tr>
</table>
</form>
</body>
</html>
-
- [Visual Basic] -
-            </%@ Page Language="VB" AutoEventWireup="True" /%>

</%@ Register Assembly="RadInput.Net2" Namespace="Telerik.WebControls" TagPrefix="radI" /%>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
- <title>TextBox Example </title>

<script runat="server">

Protected Sub AddButton_Click(sender As Object, e As EventArgs)

Dim Answer As Integer

Answer = Convert.ToInt32(Value1.Text) + Convert.ToInt32(Value2.Text)

AnswerMessage.Text = Answer.ToString()

End Sub

- </script>

</head>
<body>
<form id="form1" runat="server">
<h3>
RadTextBox Example
</h3>
<table>
<tr>
<td colspan="5">
Enter integer values into the text boxes.
- <br />
Click the Add button to add the two values.
<br />
Click the Reset button to reset the text boxes.
</td>
</tr>
<tr>
<td colspan="5">

</td>
- </tr>
<tr align="center">
<td>
<radI:RadTextBox ID="Value1" Columns="2" MaxLength="3" Text="1" runat="server" />
</td>
<td>
+
</td>
<td>
- <radI:RadTextBox ID="Value2" Columns="2" MaxLength="3" Text="1" runat="server" />
</td>
<td>
=
</td>
<td>
<asp:Label ID="AnswerMessage" runat="server" />
</td>
- </tr>
<tr>
<td colspan="2">
<asp:RequiredFieldValidator ID="Value1RequiredValidator" ControlToValidate="Value1"
ErrorMessage="Please enter a value.<br />" Display="Dynamic" runat="server" />
- <asp:RangeValidator ID="Value1RangeValidator" ControlToValidate="Value1" Type="Integer"
MinimumValue="1" MaximumValue="100" ErrorMessage="Please enter an integer <br /> between than 1 and 100.<br />"
Display="Dynamic" runat="server" />
</td>
- <td colspan="2">
<asp:RequiredFieldValidator ID="Value2RequiredValidator" ControlToValidate="Value2"
ErrorMessage="Please enter a value.<br />" Display="Dynamic" runat="server" />
<asp:RangeValidator ID="Value2RangeValidator" ControlToValidate="Value2" Type="Integer"
- MinimumValue="1" MaximumValue="100" ErrorMessage="Please enter an integer <br /> between than 1 and 100.<br />"
Display="Dynamic" runat="server" />
</td>
<td>
&nbsp
</td>
</tr>
- <tr align="center">
<td colspan="4">
<asp:Button ID="AddButton" Text="Add" OnClick="AddButton_Click" runat="server" />
</td>
<td>

</td>
</tr>
</table>
</form>
</body>
</html> -
-
- - Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media - Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP - Starter Edition - The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft - Windows XP SP2, and Windows Server 2003 SP1. - - - .NET Framework
- Supported in: 3.0, 2.0, 1.1, 1.0 -
-
- - - Gets or sets a value indicating whether the text content wraps within a multiline - RadTextBox. - - - true if the text content wraps within a multiline RadTextBox; otherwise, false. - The default is true. - - - Use the Wrap property to specify whether the text displayed in a multiline - RadTextBox control automatically continues on the next line when the text reaches the - end of the control. This property is applicable only when the RadTextMode property is - set to MultiLine - - - The following code example demonstrates how to use the Wrap property to wrap - text entered in the RadTextBox control. This example has a text box that accepts - user input, which is a potential security threat. By default, ASP.NET Web pages - validate that user input does not include script or HTML elements. - [C#] -
-            </%@ Page Language="C#" AutoEventWireup="True" /%>  
</%@ Register Assembly="RadInput.Net2" Namespace="Telerik.WebControls" TagPrefix="radI" /%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
<title>MultiLine RadTextBox Example </title>
-
<script runat="server">
-
protected void SubmitButton_Click(Object sender, EventArgs e)
{
-
Message.Text = "Thank you for your comment: <br />" + Comment.Text;
-
}
-
protected void Check_Change(Object sender, EventArgs e)
{
-
Comment.Wrap = WrapCheckBox.Checked;
Comment.ReadOnly = ReadOnlyCheckBox.Checked;
-
}
-
</script>
-
</head>
<body>
<form id="form1" runat="server">
<h3>
MultiLine RadTextBox Example
</h3>
- Please enter a comment and click the submit button.
<br />
<br />
<radI:RadTextBox ID="Comment" TextMode="MultiLine" Columns="50" Rows="5" runat="server" />
<br />
- <asp:RequiredFieldValidator ID="Value1RequiredValidator" ControlToValidate="Comment"
ErrorMessage="Please enter a comment.<br />" Display="Dynamic" runat="server" />
- <asp:CheckBox ID="WrapCheckBox" Text="Wrap Text" Checked="True" AutoPostBack="True"
OnCheckedChanged="Check_Change" runat="server" />
-
<asp:CheckBox ID="ReadOnlyCheckBox" Text="ReadOnly" Checked="False" AutoPostBack="True"
OnCheckedChanged="Check_Change" runat="server" />
-
<asp:Button ID="SubmitButton" Text="Submit" OnClick="SubmitButton_Click" runat="server" />
<hr />
<asp:Label ID="Message" runat="server" />
</form>
</body>
</html>
-
- [Visual Basic] -
-            </%@ Page Language="VB" AutoEventWireup="True" /%>

</%@ Register Assembly="RadInput.Net2" Namespace="Telerik.WebControls" TagPrefix="radI" /%>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
<title>MultiLine RadTextBox Example </title>

<script runat="server">

- Protected Sub SubmitButton_Click(sender As Object, e As EventArgs )

Message.Text = "Thank you for your comment: <br />" + Comment.Text

End Sub

Protected Sub Check_Change(sender As Object, e As EventArgs )

- Comment.Wrap = WrapCheckBox.Checked
Comment.ReadOnly = ReadOnlyCheckBox.Checked

End Sub

</script>

</head>
<body>
<form id="form1" runat="server">
<h3>
- MultiLine RadTextBox Example
</h3>
Please enter a comment and click the submit button.
<br />
<br />
<radI:RadTextBox ID="Comment" TextMode="MultiLine" Columns="50" Rows="5" runat="server" />
- <br />
<asp:RequiredFieldValidator ID="Value1RequiredValidator" ControlToValidate="Comment"
ErrorMessage="Please enter a comment.<br />" Display="Dynamic" runat="server" />
- <asp:CheckBox ID="WrapCheckBox" Text="Wrap Text" Checked="True" AutoPostBack="True"
- OnCheckedChanged="Check_Change" runat="server" />

<asp:CheckBox ID="ReadOnlyCheckBox" Text="ReadOnly" Checked="False" AutoPostBack="True"
OnCheckedChanged="Check_Change" runat="server" />

- <asp:Button ID="SubmitButton" Text="Submit" OnClick="SubmitButton_Click" runat="server" />
<hr />
<asp:Label ID="Message" runat="server" />
</form>
</body>
</html> -
-
- - Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media - Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP - Starter Edition - The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft - Windows XP SP2, and Windows Server 2003 SP1. - .NET Framework
- Supported in: 3.0, 2.0, 1.1, 1.0
-
-
- - - Gets or sets a value indicating whether the editing of this appointment is allowed. - - true if editing of this appointment is allowed; otherwise, false. - - - - Gets or sets a value indicating whether the deleting of this appointment is allowed. - - true if the deleting of this appointment is allowed; otherwise, false. - - - - Gets or sets the data item represented by the - Appointment object in the - RadScheduler control. - - - This property is available only during data binding. - - - - - Creates an empty AppointmentCollection. - - - - - Determines whether an element is in the AppointmentCollection. - - - The Appointment to locate in the AppointmentCollection. - - true if item is found in the AppointmentCollection; otherwise, false. - - This method performs a linear search; therefore, this method is an O(n) operation, where n is Count. - - - - - Copies the entire AppointmentCollection to a compatible one-dimensional Array, - starting at the specified index of the target array. - - - The one-dimensional Array that is the destination of the Appointments copied from AppointmentCollection. - The Array must have zero-based indexing. - - - The zero-based index in array at which copying begins. - - - - - Searches for the specified Appointment and returns the zero-based index of the - first occurrence within the entire AppointmentCollection. - - - The Appointment to locate in the AppointmentCollection. - - - The zero-based index of the first occurrence of value within the entire AppointmentCollection, if found; otherwise, -1. - - - - - Searches for an Appointment with the specified ID and returns a reference to it. - - - The Appointment ID to search for. - - - The Appointment with the specified ID, if found; otherwise, null. - - - This method determines equality by calling Object.Equals. - - - - - Searches for all Appointments with the specified RecurrenceParentID - and returns a generic IList containing them. - - - The RecurrenceParentID to search for. - - - A generic IList containing the Appointments with the specified RecurrenceParentID, if found. - - - This method determines equality by calling Object.Equals. - - Appointments with recurrence state Exception - are linked to their parents using the RecurrenceParentID property. - - - - - Searches for all Appointments with the specified - RecurrenceParentID and - RecurrenceState. - - - The RecurrenceParentID to search for. - - - The RecurrenceState to search for. - - - A generic IList containing the Appointments - with the specified RecurrenceParentID and - RecurrenceState, if found. - - - This method determines equality by calling Object.Equals. - - - - - Searches for all Appointments that - start in the specified time range and returns a generic IList containing them. - - - The start of the time range. - - - The end of the time range. - - - A generic IList containing the Appointments - that start in the specified time range. - - - - - Searches for all Appointments that - overlap with the specified time range and returns a generic IList containing them. - - - The start of the time range. - - - The end of the time range. - - - A generic IList containing the Appointments - that overlap with the specified time range. - - - - - Searches for all Appointments that - are fully contained within the specified time range. - - - The start of the time range. - - - The end of the time range. - - - A generic IList containing the Appointments - that are fully contained within the specified time range. - - - - - Copies the elements of the AppointmentCollection - to a new Appointment array. - - - An Appointment array containing copies of the elements of the - AppointmentCollection. - - - - - Returns an enumerator for the entire AppointmentCollection. - - - An IEnumerator for the entire AppointmentCollection. - - - - - Gets or sets the Appointment at the specified index. - - The zero-based index of the Appointment to get or set. - The appointment at the specified index. - - - - For internal use only. - - - - - - - For internal use only. - - - - - - - Returns a synchronized (thread safe) wrapper for this provider instance. - - A synchronized (thread safe) wrapper for this provider instance. - - - - Gets a value indicating whether the provider supports multiple resources (of the same type). - - - true if the provider supports multiple resources (of the same type); otherwise, false. - - - - - For internal use only. - - - - - - - A RadScheduler provider that uses XML document as a data store. - - - - - Format string for the dates. The "Z" appendix signifies UTC time. - - - - - Initializes a new instance of the class. - - Name of the data file. - if set to true the changes will be persisted. - - - - Initializes a new instance of the class. - - The document instance to use as a data store. - - - - Initializes a new instance of the class. - - - - - Initializes the provider. - - The friendly name of the provider. - A collection of the name/value pairs representing the provider-specific attributes specified in the configuration for this provider. - The name of the provider is null. - An attempt is made to call on a provider after the provider has already been initialized. - The name of the provider has a length of zero. - - - - Fetches appointments. - - The owner RadScheduler instance. - - - - - Inserts the specified appointment. - - The owner RadScheduler instance. - The appointment to insert. - - - - Updates the specified appointment. - - The owner RadScheduler instance. - The appointment to update. - - - - Deletes the specified appointment. - - The owner RadScheduler instance. - The appointment to delete. - - - - Gets the resource types. - - The owner RadScheduler instance. - - - - - Gets the type of the resources by. - - The owner RadScheduler instance. - Type of the resource. - - - - RadScheduler control class. - - - - For internal use only. - - - - - - - Exports an appointment to iCalendar format. - - - The return value should be saved as a text file with an "ics" extension. - - A string containing the appointment in iCalendar format. - The appointment which should be exported. - - - - Exports an appointment to iCalendar format. - - - The return value should be saved as a text file with an "ics" extension. - - A string containing the appointment in iCalendar format. - The appointment which should be exported. - The time zone offset to apply to the exported appointments. - - - - Exports the specified appointments to iCalendar format. - - - The return value should be saved as a text file with an "ics" extension. - - A string containing the iCalendar representation of the supplied appointments. - A collection of appointments which should be exported. - - - - Exports the specified appointments to iCalendar format. - - - The return value should be saved as a text file with an "ics" extension. - - A string containing the iCalendar representation of the supplied appointments. - An IEnumerable of appointments which should be exported. - - - - Exports the specified appointments to iCalendar format. - - - The return value should be saved as a text file with an "ics" extension. - - A string containing the iCalendar representation of the supplied appointments. - A collection of appointments which should be exported. - The time zone offset to apply to the exported appointments. - - - - Exports the specified appointments to iCalendar format. - - - The return value should be saved as a text file with an "ics" extension. - - A string containing the iCalendar representation of the supplied appointments. - An IEnumerable of appointments which should be exported. - The time zone offset to apply to the exported appointments. - - - - Returns the UTC date that corresponds to midnight on the client for the selected date. - - Client's date and time in UTC. - The UTC date that corresponds to midnight on the client for the selected date. - - - - Shows the inline edit form. - - - The appointment which is edited. Its properties are used to populate the edit form. - - - - - Shows the inline edit form. - - - The appointment which is edited. Its properties are used to populate the edit form. - - - A boolean value indicating whether to edit the recurring series. - - - - - Shows the advanced edit form. - - - The appointment which is edited. Its properties are used to populate the edit form. - - - - - Shows the advanced edit form. - - - The appointment which is edited. Its properties are used to populate the edit form. - - - A boolean value indicating whether to edit the recurring series. - - - - - Shows the inline insert form. - - - Specifies the start time for the insert form. It is used to determine the row in which the form is shown. - - - - - Shows the inline insert form. - - The time slot object where the insert form will be shown - - - - Shows the advansed insert form. - - - Specifies the start time for the insert form. It is used to determine the row in which the form is shown. - - - - - Shows the all-day inline insert form - - - Specifies the start time for the insert form. It is used to determine the row in which the form is shown. - - - - - Retrieves a TimeSlot object from its client-side index - - String representation of the TimeSlot's index - The TimeSlot that corresponds to the passed index - - - - Hides the active insert or edit form (if any). - - - - - Converts a date time object from UTC to client date format using the TimeZoneOffset property. - - The date to convert. Must be in UTC format. - - The date in client format which corresponds to the supplied UTC date - - - RadScheduler always stores dates in UTC format to allow support for multiple time zones. - The UtcToDisplay method must be used when - a date (e.g. Appointment.Start) - should be presented to the client in some way - e.g. displayed in a label. - - - - Appointment appointment = RadScheduler1.Appointments[0]; - Label1.Text = RadScheduler1.UtcToDisplay(appointment.Start).ToString() - - - Dim appointment As Appointment = RadScheduler1.Appointments(0) - Label1.Text = RadScheduler1.UtcToDisplay(appointment.Start).ToString() - - - - - - Converts a date time object from client date format to UTC using the TimeZoneOffset property. - - The date to convert. Must be in client format. - - The date in UTC format which corresponds to the supplied client format date. - - - RadScheduler always stores dates in UTC format to allow support for multiple time zones. The DisplayToUtc method must be used when - a date is supplied to RadScheduler to be persisted in some way. For example updating the Appointment.Start property from a textbox. - - - - Appointment appointment = RadScheduler1.Appointments[0]; - DateTime startInClientFormat = DateTime.Parse(TextBox1.Text); - appointment.Start = RadScheduler1.DisplayToUtc(startInClientFormat); - RadScheduler1.Update(appointment); - - - Dim appointment As Appointment = RadScheduler1.Appointments(0) - Dim startInClientFormat As DateTime = DateTime.Parse(TextBox1.Text) - appointment.Start = RadScheduler1.DisplayToUtc(startInClientFormat) - RadScheduler1.Update(appointment) - - - - - - Inserts the specified appointment in the Appointments collection, - expands the series (if it is recurring) and inserts persists it through the provider. - - The appointment to insert. - - - - Updates the specified appointment and persists the changes through the provider. - - - This method can be used, along with PrepareToEdit - to create and persist a recurrence exceptions. - - - - Appointment occurrence = RadScheduler1.Appointments[0]; - Appointment recurrenceException = RadScheduler1.PrepareToEdit(occurrence, false); - - recurrenceException.Subject = "This is a recurrence exception"; - - RadScheduler1.UpdateAppointment(recurrenceException); - - - Dim occurrence As Appointment = RadScheduler1.Appointments(0) - Dim recurrenceException as Appointment = RadScheduler1.PrepareToEdit(occurrence, False) - - recurrenceException.Subject = "This is a recurrence exception" - - RadScheduler1.UpdateAppointment(recurrenceException) - - - The appointment to update. - - - - Updates the specified appointment and persists the changes through the provider. - - Use this overload when the underlying data source requires both original and modified - data to perform an update operation. One such example is LinqDataSource. - - - This method can be used, along with PrepareToEdit - to create and persist a recurrence exceptions. - - - - Appointment occurrence = RadScheduler1.Appointments[0]; - Appointment recurrenceException = RadScheduler1.PrepareToEdit(occurrence, false); - - Appointment modifiedAppointment = recurrenceException.Clone(); - modifiedAppointment.Subject = "This is a recurrence exception"; - - RadScheduler1.UpdateAppointment(modifiedAppointment, recurrenceException); - - - Dim occurrence As Appointment = RadScheduler1.Appointments(0) - Dim recurrenceException as Appointment = RadScheduler1.PrepareToEdit(occurrence, False) - - Dim modifiedAppointment = recurrenceException.Clone() - modifiedAppointment.Subject = "This is a recurrence exception" - - RadScheduler1.UpdateAppointment(modifiedAppointment, recurrenceException) - - - The appointment to update. - - The original appointment. Use Appointment.Clone - to obtain a copy of the appointment before updating its properties. - - - - - Prepares the specified appointment for editing. - - - If the specified appointment is not recurring, the method does nothing and returns the same appointment. - If the appointment is recurring and editSeries is set to true the method returns the recurrence parent. - Otherwise, the method clones the appointment and updates it state to recurrence exception. - - - - Appointment occurrence = RadScheduler1.Appointments[0]; - Appointment recurrenceException = RadScheduler1.PrepareToEdit(occurrence, false); - - recurrenceException.Subject = "This is a recurrence exception"; - - RadScheduler1.UpdateAppointment(recurrenceException); - - - Dim occurrence As Appointment = RadScheduler1.Appointments(0) - Dim recurrenceException as Appointment = RadScheduler1.PrepareToEdit(occurrence, False) - - recurrenceException.Subject = "This is a recurrence exception" - - RadScheduler1.UpdateAppointment(recurrenceException) - - - The appointment to edit. - if set to true [edit series]. - - - - - Deletes the appointment or the recurrence series it is part of. - - - When deleting an appointment that is part of recurrence series and deleteSeries is set to false - this method will update the master appointment to produce a recurrence exception. - - The appointment to delete. - if set to true delete complete recurrence series. - - - - Removes the associated recurrence exceptions through the provider. - - The recurrence master. - - - - Indicates whether to instantiate a clent-side object for the - advanced insert form (applicable only in Web Service mode). - - - - - Indicates whether to instantiate a clent-side object for the - advanced edit form (applicable only in Web Service mode). - - - - - Gets a collection of Appointment objects that represent individual - appointments in the RadScheduler control. - - - A collection of the currently loaded Appointment objects. - - - - - A collection of all resources loaded by RadScheduler. - - - - - Returns visible start date of the current view. - - - All tasks rendered in the current view will be within the range specified by the VisibleRangeStart - and VisibleRangeEnd properties. - - - - - Returns visible end date of the current view. - - - All tasks rendered in the current view will be within the range specified by the VisibleRangeStart - and VisibleRangeEnd properties. - - - - - Gets a value indicating whether the recurring series are being edited at the moment, as opposed to a single appointment of the series. - - - This property is also used to indicate the target of the delete and move operations. - - - true if the recurring series are being edited at the moment; false otherwise. - - - - - Gets a boolean value that indicates if recurrence support has been configured for this - instance of RadScheduler. - - - - - - True when the - DataRecurrenceField and - DataRecurrenceParentKeyField - fields are set or when using a custom data provider. - - False if either of the above conditions is not satisfied - or when the EnableRecurrenceSupport property - is set to false. - - - - - One of the SchedulerViewType values. The - default is DayView. - - Gets or sets the current view type. - - - - Gets the name of the resource to group by. - Can also be in the format "Date,[Resource Name]" when grouping by date. - - The resource to group by. - - - - Gets or sets a value indicating whether the user can use the advanced insert/edit form. - - true if the user should be able to use the advanced insert/edit form; false otherwise. The default value is true. - - - - Gets or sets a value indicating whether "advanced" mode is the default edit mode. - - true if the "advanced" mode is the default edit mode; false if "inline" is default edit mode. The default value is true. - - - - Gets or sets a value indicating whether "advanced" mode is the default insert mode. - - true if the "advanced" mode is the default insert mode; false if "inline" is default insert mode. The default value is false. - - - - Gets or sets a value indicating whether a delete confirmation dialog should be displayed when the user clicks the "delete" button of an appointment. - - - true if the confirmation dialog should be displayed; false otherwise. The default value is true. - - - - - Gets or sets a value indicating whether a confirmation dialog should be displayed when the user moves a recurring appointment. - - - true if the confirmation dialog should be displayed; false otherwise. The default value is false. - - - - - Gets or sets a value indicating whether RadScheduler is in read-only mode. - - - true if RadScheduler should be read-only; false otherwise. The default value is false. - - - By default the user is able to insert, edit and delete appointments. Use the ReadOnly to disable the editing capabilities of RadScheduler. - - - - - Gets or sets a value indicating the number of visible appointments per day in month view. - - - An integer specifying the number of visible appointments per day. The default value is 2. - - - - - Gets a collection of ResourceType objects that represent - the resource types used by RadScheduler. - - - - - Gets a collection of ResourceStyleMapping - objects can be used to associate resources with particular - cascading style sheet (CSS) classes. - - - Resources are matched by all (boolean AND) specified properties. - - - - - Gets or sets the time zone offset to use when displaying appointments. - - The time zone offset to use when displaying appointments. - The default value is TimeSpan.Zero. - - - - Gets or sets the time zone offset to use when determining todays date. - - The time zone offset to use when determining todays date. - - The default value is the system's time zone offset. - This value is ignored when TimeZoneOffset is set. - - - - - The meaning of this property is different depending on the current - view type. - In day view mode SelectedDate - gets or sets the currently displayed date. - In week and - month view modes SelectedDate - gets or sets the highlighted date in the current week or month. - - - - - Gets or sets the number of rows each time label spans. - - - The number of rows each time label spans. The default value is 2 - - - - Gets or sets the number of minuties which a single row represents - - An integer specifying how many minutes a row represents. The default value is 30. - - - - Gets or sets the number of rows that are hovered when the mouse is over the appointment area. - - An integer specifying the number of rows that are hovered when the mouse is over the appointment area. - The default value is 2. - This value also determines the initial length of inserted appointments. - - - - - Gets or sets the time used to denote the start of the day. - - - The time used to denote the start of the day. - - - This property is ignored in month view mode. - - - - - Gets or sets the time used to denote the end of the day. - - - The time used to denote the end of the day. - - - This property is ignored in month view mode. - - - - - Gets or sets the time used to denote the start of the work day. - - - The time used to denote the start of the work day. - - - The effect from this property is only visual. - This property is ignored in month view mode. - - - - - Gets or sets the time used to denote the end of the work day. - - - The time used to denote the end of the work day. - - - The effect from this property is only visual. - This property is ignored in month view mode. - - - - - Gets or sets a value that indicates whether the resource editing in the advanced form is enabled. - - A value that indicates whether the resource editing in the advanced form is enabled. - - - - Gets or sets a value that indicates whether the attribute editing in the advanced form is enabled. - - A value that indicates whether the attribute editing in the advanced form is enabled. - - - - Gets or sets the first day of the week. - - - Used this property to specify the first day rendered in week view. - - - - - Gets or sets the last day of the week. - - - This property is applied in week and month view. - - - - - Gets or sets a value specifying the way RadScheduler should behave when its content - overflows its dimensions. - - - One of the OverflowBehavior values. The default value is OverflowBehavior.Scroll. - - - By default RadScheduler will render a scrollbar should its content exceed the specified dimensions - (set via the Width and Height properties). If - OverflowBehavior.Expand is set RadScheduler - will expand vertically. The Height property must not be set in that case. - - - - - Gets or sets a value indicating whether to render the hours column in day and week view. - - true if the hours column is rendered in day and week view; otherwise, false. - - - - Gets or sets a value indicating whether to render date headers for the current view. - - true if the date headers for the current view are rendered; otherwise, false. - - - - Gets or sets a value indicating whether to render resource headers for the current view. - - true if the resource headers for the current view are rendered; otherwise, false. - - - - Gets or sets a value indicating whether to render the header. - - true if the header is rendered; otherwise, false. - - - - Gets or sets a value indicating whether to render the footer. - - true if the footer is rendered; otherwise, false. - - - - Gets or sets a value indicating whether to render the navigation links.. - - true if the header is rendered; otherwise, false. - - - - Gets or sets a value indicating whether to render the tabs for switching between the view types. - - true if the tabs is rendered; otherwise, false. - - - - Gets or sets a value indicating whether to render the all day pane. - - true if the header is rendered; otherwise, false. - - - - Gets or sets a value indicating whether to render the column header in week view. - - true if the column header in week view is rendered; otherwise, false. - - - - Gets or sets a value indicating whether to render the column header in month view. - - true if the column header in month view is rendered; otherwise, false. - - - - Gets or sets the day header date format string. - - The day header date format string. - - For additional information, please read this - MSDN article. - - - - - Gets or sets the week header date format string. - - The week header date format string. - - For additional information, please read this - MSDN article. - - - - - Gets or sets the month header date format string. - - The month header date format string. - - For additional information, please read this - MSDN article. - - - - - Gets or sets the week header column date format string. - - The week column header date format string. - - For additional information, please read this - MSDN article. - - - - - Gets or sets the month header date format string. - - The month header date format string. - - For additional information, please read this - MSDN article. - - - - - Gets or sets the edit form date format string. - - The edit form date format string. - - - - Gets or sets the edit form time format string. - - The edit form time format string. - - - - Gets or sets the hours panel time format string. - - The hours panel time format string. - - - - Gets or sets a value indicating whether to display the complete day (24-hour view) or the range between DayStartTime and DayEndTime. - - true if showing the complete day (24-hour view); otherwise, false. - - - - Gets or sets a value indicating whether to start in full time. - When set to true, RadScheduler will display the complete day (24-hour view) on start; otherwise the time range between DayStartTime and DayEndTime. - - - - - Gets or sets the resource grouping direction of the RadScheduler. - - - - - Gets or sets a value indicating whether to enable the date picker for quick navigation. - - true if the date picker for quick navigation is enabled; otherwise, false. - - - - Gets or sets the height of RadScheduler rows. - - The height of a RadScheduler row - - - - Gets or sets the width of each content column. - - The width of each content column - - - - Gets or sets the width of each row header. - - The width of each row header - - - - Gets or sets the minimum height of the inline insert/edit template. - - - The height is applied to the textbox inside the default inline template. - It will be ignored when using custom templates for the inline form. - - The minimum height of the inline insert/edit template. - - - - Gets or sets the minimum width of the inline insert/edit template. - - The minimum width of the inline insert/edit template. - - - - Gets or sets the name of the validation group to be used for the integrated validation controls. - - - - - Overridden. Gets or sets the ID property of the data source control that the - RadScheduler should use to retrieve its data source. - - - - - Gets or sets the provider instance to be used by RadScheduler. Use this property - with providers that are created at runtime. For ASP.NET providers defined in web.config - use the ProviderName property. - - - The provider instance to be used by RadScheduler. - - - - - Gets or sets the name of the current appointment provider used by RadScheduler. The provider - must be defined in the RadScheduler section of web.config. - - - The name of the current appointment provider used by RadScheduler as defined in web.config. - - - - - Gets the current provider context. The context object contains - additional information about the currently performed operation, - that can be used to improve and optimize provider implementations. - - - The current provider context. - The context object can be of type - UpdateAppointmentContext or - CreateRecurrenceExceptionContext. - - - - - Gets or sets the key field for appointments in the data source specified by the - DataSourceID property. - - - The name of the key field for appointments in the data source specified by - DataSourceID. - - - - - Gets or sets the subject field for appointments in the data source specified by the - DataSourceID property. - - - The name of the subject field for appointments in the data source specified by - DataSourceID. - - - - - Gets or sets the end field for appointments in the data source specified by the - DataSourceID property. - - - The name of the end field for appointments in the data source specified by - DataSourceID. - - - - - Gets or sets the start field for appointments in the data source specified by the - DataSourceID property. - - - The name of the start field for appointments in the data source specified by - DataSourceID. - - - - - Gets or sets the recurrence rule field for appointments in the data source specified by - the DataSourceID property. - - - The name of the recurrene rule field for appointments in the data source specified by - DataSourceID. - - - - - Gets or sets the recurrence parent key field for appointments in the data source specified - by the DataSourceID property. - - - The name of the recurrence parent key field for appointments in the data source specified - by DataSourceID. - - - - - Specifies the database fields (column names) which should be loaded as appointment attributes. - - - An array of strings representing the names of the database fields which should be populated as appointment custom attributes. By default RadScheduler does not populate any - database fields as custom attributes. - - - You should use the CustomAttributeNames property when you want RadScheduler to populate the Attributes collection of the appointments. - - - - - Gets or sets the comparer instance used to determine the appointment ordering within the same slot. - By default, appointments are ordered by start time and duration. - - - - - Gets or sets the maximum recurrence candidates limit. - - - This limit is used to prevent lockups when evaluating long recurring series. - The default value should not be changed under normal conditions. - - The maximum recurrence candidates limit. - - - - Gets or sets a value indicating whether the user can create and edit recurring appointments. - - true if the user is allowed to create and edit recurring appointments; false otherwise. The default value is true. - - - - Gets or sets a value indicating whether appointments editing is allowed. - - true if appointments editing is allowed; otherwise, false. - - - - Gets or sets a value indicating whether appointments deleting is allowed. - - true if appointments deleting is allowed; otherwise, false. - - - - Gets or sets a value indicating whether appointments inserting is allowed. - - true if appointments inserting is allowed; otherwise, false. - - - - Occurs when a button is clicked within the appointment template. - - - The AppointmentCommand event is raised when any button is clicked withing the appointment template. - This event is commonly used to handle button controls with a custom CommandName value. - - - - void RadScheduler1_AppointmentCommand(object sender, AppointmentCommandEventArgs e) - { - if (e.CommandName == "Delete") - { - Delete(e.Container.Appointment); - } - } - - - Sub RadScheduler1_AppointmentCommand(sender As Object, e As AppointmentCommandEventArgs) - If e.CommandName = "Delete" Then - Delete(e.Container.Appointment) - End If - End Sub - - - - - - Occurs when an appointment is about to be inserted in the database through the provider. - - - The insert operation can be cancelled by setting the - SchedulerCancelEventArgs.Cancel - property of SchedulerCancelEventArgs to true. - - - - void RadScheduler1_AppointmentInsert(object sender, SchedulerCancelEventArgs e) - { - if (e.Appointment.Subject == String.Empty) - { - e.Cancel = true; - } - } - - - Sub RadScheduler1_AppointmentInsert(sender As Object, e As SchedulerCancelEventArgs) - If e.Appointment.Subject = String.Empty Then - e.Cancel = True - End If - End Sub - - - - - - Occurs when an appointment is about to be updated through the provider. - - - The AppointmentUpdateEventArgs hold a reference both - to the original and the modified appointment. Any modifications on the original appointments are - discarded. - The update operation can be cancelled by setting the - AppointmentUpdateEventArgs.Cancel - property of AppointmentUpdateEventArgs to true. - - - - void RadScheduler1_AppointmentUpdate(object sender, AppointmentUpdateEventArgs e) - { - e.ModifiedAppointment.End = e.ModifiedAppointment.End.AddHours(1); - } - - - Sub RadScheduler1_AppointmentUpdate(sender As Object, e As AppointmentUpdateEventArgs) - e.ModifiedAppointment.End = e.ModifiedAppointment.End.AddHours(1) - End Sub - - - - - - Occurs when an appointment is about to be deleted from the database through the provider. - - - The delete operation can be cancelled by setting the - SchedulerCancelEventArgs.Cancel - property of SchedulerCancelEventArgs to true. - - - - void RadScheduler1_AppointmentDelete(object sender, SchedulerCancelEventArgs e) - { - if (e.Appointment.Attributes["ReadOnly"] == "true") - { - e.Cancel = true; - } - } - - - Sub RadScheduler1_AppointmentDelete(sender As Object, e As SchedulerCancelEventArgs) - If e.Appointment.Attributes("ReadOnly") = "true" Then - e.Cancel = True - End If - End Sub - - - - - - Occurs when an appointment template has been instantiated. - - - You can use this event to modify the appointment template before data binding. - - - - void RadScheduler1_AppointmentCreated(object sender, AppointmentCreatedEventArgs e) - { - Label testLabel = (Label) e.Container.FindControl("Test"); - testLabel.Text = "Test"; - } - - - Sub RadScheduler1_AppointmentCreated(sender As Object, e As AppointmentCreatedEventArgs) - Dim testLabel As Label = CType(e.Container.FindControl("Test"), Label) - testLabel.Text = "Test" - End Sub - - - - - - Occurs when an appointment has been added to the Appointments collection from the data source. - - - You can use this event to make adjustments to the appointments as they are being loaded. - - - - void RadScheduler1_AppointmentDataBound(object sender, SchedulerEventArgs e) - { - e.Appointment.Start = e.Appointment.Start.AddHours(1); - } - - - Sub RadScheduler1_AppointmentDataBound(sender As Object, e As SchedulerEventArgs) - e.Appointment.Start = e.Appointment.Start.AddHours(1) - End Sub - - - - - - Occurs when an appointment has been clicked. - - - You can use this event to perform additional actions when an appointment has been clicked. - - - - void RadScheduler1_AppointmentClick(object sender, SchedulerEventArgs e) - { - Response.Redirect("Page.aspx); - } - - - Sub RadScheduler1_AppointmentClick(sender As Object, e As SchedulerEventArgs) - Response.Redirect("Page.aspx) - End Sub - - - - - - Occurs when the client performs a navigation command. - - - You can use this event to customize the action when the client performs a navigation command. - The event can be cancelled by setting the - SchedulerNavigationCommandEventArgs.Cancel - property of SchedulerNavigationCommandEventArgs to true. - - - - void RadScheduler1_NavigationCommand(object sender, SchedulerNavigationCommandEventArgs e) - { - if (e.Command == SchedulerNavigationCommand.NavigateToNextPeriod) - { - e.Cancel = true; - } - } - - - Sub RadScheduler1_NavigationCommand(sender As Object, e As SchedulerNavigationCommandEventArgs) - If e.Command = SchedulerNavigationCommand.NavigateToNextPeriod Then - e.Cancel = True - End If - End Sub - - - - - - Occurs when a navigation action has been completed. - - - You can use this event to perform custom actions when a navigation action has been completed. - - - - void RadScheduler1_NavigationComplete(object sender, SchedulerNavigationCompleteEventArgs e) - { - Label1.Text = RadScheduler1.SelectedDate; - } - - - Sub RadScheduler1_NavigationComplete(sender As Object, e As SchedulerNavigationCompleteEventArgs) - Label1.Text = RadScheduler1.SelectedDate - End Sub - - - - - - Occurs when an insert/edit form is being created. - - - You can use this event to perform custom actions when a form is about to be created. - The event can be cancelled by setting the - SchedulerFormCreatingEventArgs.Cancel - property of SchedulerFormCreatingEventArgs to true. - - - - void RadScheduler1_FormCreating(object sender, SchedulerFormCreatingEventArgs e) - { - if (e.Mode == SchedulerFormMode.Insert) - { - e.Cancel = true; - } - } - - - Sub RadScheduler1_FormCreating(sender As Object, e As SchedulerFormCreatingEventArgs) - If e.Mode = SchedulerFormMode.Insert Then - e.Cancel = True - End If - End Sub - - - - - - Occurs when an insert/edit form has been created. - - - You can use this event to make modifications to the form template. - - - - void RadScheduler1_FormCreated(object sender, SchedulerFormCreatedEventArgs e) - { - if (e.Container.Mode == SchedulerFormMode.Insert) - { - Label startDate = (Label) e.Container.FindControl("StartDate"); - startDate.Text = e.Container.Appointment.Start; - } - } - - - Sub RadScheduler1_FormCreated(sender As Object, e As SchedulerFormCreatedEventArgs) - If e.Container.Mode = SchedulerFormMode.Insert Then - Dim startDate As Label = CType(e.Container.FindControl("StartDate"), Label) - startDate.Text = e.Container.Appointment.Start - End If - End Sub - - - - - - Occurs when the Cancel button of an edit form is clicked, but before RadScheduler exits edit mode. - - - You can use this event to provide an event-handling method that performs a custom routine, - such as stopping the cancel operation if it would put the appointment in an undesired state. - To stop the cancel action set the - AppointmentCancelingEditEventArgs.Cancel - property of AppointmentCancelingEditEventArgs to true. - - - - void RadScheduler1_FormCreated(object sender, SchedulerFormCreatedEventArgs e) - { - if (e.Container.Mode == SchedulerFormMode.Insert) - { - TextBox startDate = (TextBox) e.Container.FindControl("StartDate"); - if (startDate.Text == String.Empty) - { - e.Cancel = true; - } - } - } - - - Sub RadScheduler1_FormCreated(sender As Object, e As SchedulerFormCreatedEventArgs) - If e.Container.Mode = SchedulerFormMode.Insert Then - Dim startDate As TextBox = CType(e.Container.FindControl("StartDate"), TextBox) - If startDate.Text = String.Empty Then - e.Cancel = true - End If - End If - End Sub - - - - - - Occurs when a time slot has been created. - - - You can use this event to make modifications to the time slots. - - - - void RadScheduler1_TimeSlotCreated(object sender, TimeSlotCreatedEventArgs e) - { - e.TimeSlot.CssClass = "holidayTimeSlot"; - } - - - Sub RadScheduler1_TimeSlotCreated(sender As Object, e As TimeSlotCreatedEventArgs) - e.TimeSlot.CssClass = "holidayTimeSlot" - End Sub - - - - - - Occurs when a resource header has been created. - - - You can use this event to make modifications to the resouce headers. - - - - void RadScheduler1_TimeSlotCreated(object sender, TimeSlotCreatedEventArgs e) - { - e.Container.Controls.Add(new LiteralControl("Test")); - } - - - Sub RadScheduler1_TimeSlotCreated(sender As Object, e As TimeSlotCreatedEventArgs) - e.Container.Controls.Add(new LiteralControl("Test")) - End Sub - - - - - - Occurs when an appointment that represents a recurrence exception is about to be created. - - - The RecurrenceExceptionCreatedEventArgs hold a reference both - to the master and the exception appointment. - The operation can be cancelled by setting the - RecurrenceExceptionCreatedEventArgs.Cancel - property of RecurrenceExceptionCreatedEventArgs to true. - - - - void RadScheduler1_RecurrenceExceptionCreated(object sender, RecurrenceExceptionCreatedEventArgs e) - { - e.Cancel = true; - } - - - Sub RadScheduler1_RecurrenceExceptionCreated(sender As Object, e As RecurrenceExceptionCreatedEventArgs) - e.Cancel = true - End Sub - - - - - - Occurs when the scheduler is about to request resources from the Web Service. - - - - Resources need to be populated from the server when using resource grouping. - Doing so also reduces the client-side initialization time. - - - This operation requires the WebPermission to be granted - for the Web Service URL. This permission is not granted by default in Medium Trust. - - - You can disable the population of the resources from the server and still use - client-side rendering for grouped views. To do so you need to set the - WebServiceSettings.ResourcePopulationMode - to Manual and - populate the resources from the OnInit method of the page. - - - The ResourcesPopulatingEventArgs - contains additional information about the request that is about to be made. - You can use its properties to modify the URL, supply credentials and so on. - - - The operation can be cancelled by setting the - ResourcesPopulatingEventArgs.Cancel - property of ResourcesPopulatingEventArgs to true. - - - - - void RadScheduler1_ResourcesPopulating(object sender, ResourcesPopulatingEventArgs e) - { - e.Cancel = true; - } - - - Sub RadScheduler1_ResourcesPopulating(sender As Object, e As ResourcesPopulatingEventArgs) - e.Cancel = true - End Sub - - - - - - Gets or sets a value indicating the client-side event handler that is called when - an appointment is about to be moved. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - <script type="text/javascript">
- function onClientAppointmentMoveStartHandler(sender, eventArgs)
- {
- var appointment = eventArgs.get_appointment();
- }
- </script>
- <telerik:RadScheduler ID="RadScheduler1"
- runat="server"
- OnClientAppointmentMoveStart="onClientAppointmentMoveStartHandler">
- ....
- </telerik:RadScheduler>
-
- - If specified, the OnClientAppointmentMoveStart client-side event - handler is called when an appointment is about to be moved. - Two parameters are passed to the handler: - - sender, the scheduler client object; - eventArgs with four properties: - - get_appointment(), the instance of the appointment. - set_cancel(), set to true to cancel the move operation. - - - - This event can be cancelled. - -
- - - Gets or sets a value indicating the client-side event handler that is called when - an appointment is being moved. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - <script type="text/javascript">
- function onClientAppointmentMovingHandler(sender, eventArgs)
- {
- var appointment = eventArgs.get_appointment();
- var targetSlot = eventArgs.get_targetSlot();
- }
- </script>
- <telerik:RadScheduler ID="RadScheduler1"
- runat="server"
- OnClientAppointmentMoving="onClientAppointmentMovingHandler">
- ....
- </telerik:RadScheduler>
-
- - If specified, the OnClientAppointmentMoving client-side event - handler is called when an appointment is being moved. - Two parameters are passed to the handler: - - sender, the scheduler client object; - eventArgs with four properties: - - get_appointment(), the instance of the appointment. - get_targetSlot(), the slot that the appointment currently occupies. - set_cancel(), set to true to cancel the move operation. - - - - This event can be cancelled. - -
- - - Gets or sets a value indicating the client-side event handler that is called when - an appointment has been moved. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - <script type="text/javascript">
- function onClientAppointmentMoveEndHandler(sender, eventArgs)
- {
- var appointment = eventArgs.get_appointment();
- var newStartTime = eventArgs.get_newStartTime();
- }
- </script>
- <telerik:RadScheduler ID="RadScheduler1"
- runat="server"
- OnClientAppointmentMoveEnd="onClientAppointmentMoveEndHandler">
- ....
- </telerik:RadScheduler>
-
- - If specified, the OnClientAppointmentMoveEnd client-side event - handler is called when an appointment has been moved. - Two parameters are passed to the handler: - - sender, the scheduler client object; - eventArgs with four properties: - - get_appointment(), the instance of the appointment. - get_newStartTime(), the new start time of the appointment. - get_editingRecurringSeries(), a boolean value indicating whether the user has selected to edit the whole series. - get_targetSlot(), the target slot that the appointment has been moved to. - set_cancel(), set to true to cancel the move operation. - - - - This event can be cancelled. - -
- - - Gets or sets a value indicating the client-side event handler that is called when - the recurrence action confirmation dialog is about to be shown. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - <script type="text/javascript">
- function onClientRecurrenceActionDialogShowingHandler(sender, eventArgs)
- {
- var appointment = eventArgs.get_appointment();
- var action = eventArgs.get_recurrenceAction();
-
- if (action == Telerik.Web.UI.RecurrenceAction.Edit)
- {
- alert("Overriding recurrence action dialog to 'Edit series' for appointment '" + appointment.get_subject() + "'"); - eventArgs.set_cancel(true);
- eventArgs.set_editSeries(true);
- }
- }
- </script>
- <telerik:RadScheduler ID="RadScheduler1"
- runat="server"
- OnClientRecurrenceActionDialogShowing="onClientRecurrenceActionDialogShowingHandler">
- ....
- </telerik:RadScheduler>
-
- - If specified, the OnClientRecurrenceActionDialogShowing client-side event - handler is called when the recurrence action confirmation dialog is about to be shown. - Two parameters are passed to the handler: - - sender, the scheduler client object; - eventArgs with three properties: - - get_appointment(), the instance of the appointment. - set_cancel(), set to true to suppress the confirmation dialog. - set_editSeries(), set to true or false to override the result from the dialog (only if it has been cancelled by calling eventArgs.set_cancel(true)). - - - - This event can be cancelled. - -
- - - Gets or sets a value indicating the client-side event handler that is called when - the recurrence action confirmation dialog has been closed. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - <script type="text/javascript">
- function onClientRecurrenceActionDialogClosedHandler(sender, eventArgs)
- {
- var appointment = eventArgs.get_appointment();
- var editSeries = eventArgs.get_editSeries();
-
- alert("The user has set editSeries to '" + editSeries + "' for appointment '" + appointment.get_subject() + "'"); - }
- </script>
- <telerik:RadScheduler ID="RadScheduler1"
- runat="server"
- OnClientRecurrenceActionDialogClosed="onClientRecurrenceActionDialogClosedHandler">
- ....
- </telerik:RadScheduler>
-
- - If specified, the OnClientRecurrenceActionDialogClosed client-side event - handler is called when the recurrence action confirmation dialog has been closed. - Two parameters are passed to the handler: - - sender, the scheduler client object; - eventArgs with three properties: - - get_appointment(), the instance of the appointment. - get_editSeries(), the selected option from the dialog. - - - - This event cannot be cancelled. - -
- - - Gets or sets a value indicating the client-side event handler that is called when - an edit/insert form has been created. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - <script type="text/javascript">
- function onClientFormCreatedHandler(sender, eventArgs)
- {
- var appointment = eventArgs.get_appointment();
- var formElement = eventArgs.get_formElement();
- }
- </script>
- <telerik:RadScheduler ID="RadScheduler1"
- runat="server"
- OnClientFormCreated="onClientFormCreatedHandler">
- ....
- </telerik:RadScheduler>
-
- - If specified, the OnClientFormCreated client-side event - handler is called when an edit/insert form has been created. - Two parameters are passed to the handler: - - sender, the scheduler client object; - eventArgs with two properties: - - get_appointment(), the instance of the appointment. - get_formElement(), the DOM element of the form. - - - - This event cannot be cancelled. - -
- - - Gets or sets a value indicating the client-side event handler that is called when - an appointment has been right-clicked. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - <script type="text/javascript">
- function onClientAppointmentContextMenuHandler(sender, eventArgs)
- {
- var appointment = eventArgs.get_appointment();
- // ...
- eventArgs.get_domEvent().preventDefault(); // Prevent displaying the browser menu
- }
- </script>
- <telerik:RadScheduler ID="RadScheduler1"
- runat="server"
- OnClientAppointmentContextMenu="onClientAppointmentContextMenuHandler">
- ....
- </telerik:RadScheduler>
-
- - If specified, the OnClientAppointmentContextMenu client-side event - handler is called when an appointment has been right-clicked. - Two parameters are passed to the handler: - - sender, the scheduler client object; - eventArgs with two properties: - - get_appointment(), the instance of the appointment. - get_domEvent(), the original DOM event. - - - - This event cannot be cancelled. - -
- - - Gets or sets a value indicating the client-side event handler that is called when - an empty time slot has been right-clicked. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - <script type="text/javascript">
- function onClientTimeSlotContextMenuHandler(sender, eventArgs)
- {
- var time = eventArgs.get_time();
- // ...
- eventArgs.get_domEvent().preventDefault(); // Prevent displaying the browser menu
- }
- </script>
- <telerik:RadScheduler ID="RadScheduler1"
- runat="server"
- OnClientTimeSlotContextMenu="onClientTimeSlotContextMenuHandler">
- ....
- </telerik:RadScheduler>
-
- - If specified, the OnClientAppointmentContextMenu client-side event - handler is called when an empty time slot has been right-clicked. - Two parameters are passed to the handler: - - sender, the scheduler client object; - eventArgs with three properties: - - get_time(), the time that corresponds to the slot. - get_isAllDay(), a boolean indicating if this is an all-day slot (the time should be discarded in this case). - get_domEvent(), the original DOM event. - - - - This event cannot be cancelled. - -
- - - Gets or sets a value indicating the client-side event handler that is called when - the scheduler is about to request appointments from the Web Service. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - <script type="text/javascript">
- function clientAppointmentsPopulatingHandler(sender, eventArgs)
- {
- alert("Data loading");
- eventArgs.get_schedulerInfo().CustomProperty = "My Data"; - }
- </script>
- <telerik:RadScheduler ID="RadScheduler1"
- runat="server"
- OnClientAppointmentsPopulating="clientAppointmentsPopulatingHandler">
- ....
- </telerik:RadScheduler>
-
- - If specified, the OnClientAppointmentsPopulating client-side event - handler is called when the scheduler is about to request appointments. - In the case of server-side binding, the event will not be raised. - When client-side binding is used, the event will be raised before - the appointments are retrieved from the data service. - The event will be raised again each time new data is about to be retrieved from the web service. - Two parameters are passed to the handler: - - sender, the scheduler client object; - eventArgs with two properties: - - get_schedulerInfo(), the schedulerInfo object that will be passed to the web service method. - set_cancel(), used to cancel the event. - - - - This event can be cancelled. - -
- - - Gets or sets a value indicating the client-side event handler that is called when - the scheduler has received appointments from the Web Service. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - <script type="text/javascript">
- function clientAppointmentsPopulatedHandler(sender)
- {
- alert("Appointments populated");
- }
- </script>
- <telerik:RadScheduler ID="RadScheduler1"
- runat="server"
- OnClientAppointmentsPopulated="clientAppointmentsPopulatedHandler">
- ....
- </telerik:RadScheduler>
-
- - If specified, the OnClientAppointmentsPopulated client-side event - handler is called when the scheduler has received appointments. - In the case of server-side binding, the event will not be raised. - When client-side binding is used, the event will be raised after - the appointments are retrieved from the data service. - The event will be raised again each time new data has been retrieved from the web service. - One parameter is passed to the handler: - - sender, the scheduler client object; - - This event cannot be cancelled. - -
- - - Gets or sets a value indicating the client-side event handler that is called when - an appointment is received from the Web Service and is about to be rendered. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - <script type="text/javascript">
- function clientAppointmentDataBoundHandler(sender, eventArgs)
- {
- alert("Appointment loaded");
- }
- </script>
- <telerik:RadScheduler ID="RadScheduler1"
- runat="server"
- OnClientAppointmentDataBound="clientAppointmentDataBoundHandler">
- ....
- </telerik:RadScheduler>
-
- - If specified, the OnClientAppointmentDataBound client-side event - handler is called when an appointment is received and is about to be rendered. - In the case of server-side binding, the event will not be raised. - When client-side binding is used, the event will be raised after - the appointments are retrieved from the data service. - The event will be raised for each appointment that has been retrieved from the web service. - Two parameters are passed to the handler: - - sender, the scheduler client object; - eventArgs with one property: - - get_appointment(), the instance of the appointment. - - - - This event cannot be cancelled. - -
- - - Gets or sets a value indicating the client-side event handler that is called when - an appointment is received from the Web Service and hase been rendered. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - <script type="text/javascript">
- function clientAppointmentCreatedHandler(sender, eventArgs)
- {
- eventArgs.get_appointment().get_element().style.border = "1px solid red";
- }
- </script>
- <telerik:RadScheduler ID="RadScheduler1"
- runat="server"
- OnClientAppointmentCreated="clientAppointmentCreatedHandler">
- ....
- </telerik:RadScheduler>
-
- - If specified, the OnClientAppointmentCreated client-side event - handler is called when an appointment is received and has been rendered. - In the case of server-side binding, the event will not be raised. - When client-side binding is used, the event will be raised after - the appointments are retrieved from the data service. - The event will be raised for each appointment that has been retrieved from the web service. - Two parameters are passed to the handler: - - sender, the scheduler client object; - eventArgs with one property: - - get_appointment(), the appointment that has been rendered. - - - - This event cannot be cancelled. - -
- - - Gets or sets a value indicating the client-side event handler that is called when - the scheduler is about to request resources from the Web Service. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - <script type="text/javascript">
- function clientResourcesPopulatingHandler(sender, eventArgs)
- {
- alert("Resources loading");
- eventArgs.get_schedulerInfo().CustomProperty = "My Data"; - }
- </script>
- <telerik:RadScheduler ID="RadScheduler1"
- runat="server"
- OnClientResourcesPopulating="clientResourcesPopulatingHandler">
- ....
- </telerik:RadScheduler>
-
- - If specified, the OnClientResourcesPopulating client-side event - handler is called when the scheduler is about to request resources. - In the case of server-side binding, the event will not be raised. - When client-side binding is used, the event will be raised before - the resources are retrieved from the data service. - The event will be raised only once, at the time of the initial load. - Two parameters are passed to the handler: - - sender, the scheduler client object; - eventArgs with two properties: - - get_schedulerInfo(), the schedulerInfo object that will be passed to the web service method. - set_cancel(), used to cancel the event. - - - - This event can be cancelled. - -
- - - Gets or sets a value indicating the client-side event handler that is called when - the scheduler has received resources from the Web Service. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - <script type="text/javascript">
- function clientResourcesPopulatedHandler(sender)
- {
- alert("Resources loaded");
- }
- </script>
- <telerik:RadScheduler ID="RadScheduler1"
- runat="server"
- OnClientResourcesPopulated="clientResourcesPopulatedHandler">
- ....
- </telerik:RadScheduler>
-
- - If specified, the OnClientResourcesPopulated client-side event - handler is called when the scheduler has received resources. - In the case of server-side binding, the event will not be raised. - When client-side binding is used, the event will be raised after - the resources have been retrieved from the data service. - The event will be raised only once, at the time of the initial load. - One parameter is passed to the handler: - - sender, the scheduler client object; - - This event cannot be cancelled. - -
- - - Gets or sets a value indicating the client-side event handler that is called when - the scheduler has been populated with data. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - <script type="text/javascript">
- function clientDataBoundHandler(sender, eventArgs)
- {
- alert("Data loaded");
- }
- </script>
- <telerik:RadScheduler ID="RadScheduler1"
- runat="server"
- OnClientDataBound="clientDataBoundHandler">
- ....
- </telerik:RadScheduler>
-
- - If specified, the OnClientDataBound client-side event - handler is called when the scheduler has been populated with data. - In the case of server-side binding, the event will be raised - immediately after the control is initialized. - When client-side binding is used, the event will be raised when - both the appointments and the resources are retrieved from the data service. - The event will be raised again each time new data is retrieved from the web service. - One parameter is passed to the handler: - - sender, the scheduler client object; - - This event cannot be cancelled. - -
- - - Gets or sets a value indicating the client-side event handler that is called when - a request to the Web Service has failed. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - <script type="text/javascript">
- function clientRequestFailedHandler(sender, eventArgs)
- {
- alert("Request failed!");
- eventArgs.set_cancel(true); - }
- </script>
- <telerik:RadScheduler ID="RadScheduler1"
- runat="server"
- OnClientRequestFailed="clientRequestFailedHandler">
- ....
- </telerik:RadScheduler>
-
- - If specified, the OnClientRequestFailed client-side event - handler is called when a request to the Web Service has failed. - In the case of server-side binding, the event will not be raised. - Two parameters are passed to the handler: - - sender, the scheduler client object; - eventArgs with two properties: - - get_errorMessage(), the error message sent from the server. - set_cancel(), set to true to suppress the default action (alert message). - - - - This event can be cancelled. - -
- - - Gets or sets a value indicating the client-side event handler that is called when - an appointment is about to be stored via Web Service call. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - <script type="text/javascript">
- function clientAppointmentWebServiceInserting(sender, eventArgs)
- {
- alert("Insert cancelled");
- eventArgs.set_cancel(true); - }
- </script>
- <telerik:RadScheduler ID="RadScheduler1"
- runat="server"
- OnClientAppointmentWebServiceInserting="clientAppointmentWebServiceInserting">
- ....
- </telerik:RadScheduler>
-
- - If specified, the OnClientAppointmentWebServiceInserting client-side event - handler is called when an appointment is about to be stored via Web Service call. - In the case of server-side binding, the event will not be raised. - Two parameters are passed to the handler: - - sender, the scheduler client object; - eventArgs with two properties: - - get_appointment(), the appointment that is about to be inserted. - set_cancel(), set to true cancel the operation. - - - - This event can be cancelled. - -
- - - Gets or sets a value indicating the client-side event handler that is called when - an appointment is about to be deleted via Web Service call. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - <script type="text/javascript">
- function clientAppointmentWebServiceDeleting(sender, eventArgs)
- {
- alert("Delete cancelled");
- eventArgs.set_cancel(true); - }
- </script>
- <telerik:RadScheduler ID="RadScheduler1"
- runat="server"
- OnClientAppointmentWebServiceDeleting="clientAppointmentWebServiceDeleting">
- ....
- </telerik:RadScheduler>
-
- - If specified, the OnClientAppointmentWebServiceDeleting client-side event - handler is called when an appointment is about to be deleted via Web Service call. - In the case of server-side binding, the event will not be raised. - Two parameters are passed to the handler: - - sender, the scheduler client object; - eventArgs with three properties: - - get_appointment(), the appointment that is about to be deleted. - get_editingRecurringSeries(), indicates whether the recurring series are being deleted. - set_cancel(), set to true cancel the operation. - - - - This event can be cancelled. - -
- - - Gets or sets a value indicating the client-side event handler that is called when - an appointment is about to be updated via Web Service call. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - <script type="text/javascript">
- function clientAppointmentWebServiceUpdating(sender, eventArgs)
- {
- alert("Update cancelled");
- eventArgs.set_cancel(true); - }
- </script>
- <telerik:RadScheduler ID="RadScheduler1"
- runat="server"
- OnClientAppointmentWebServiceUpdating="clientAppointmentWebServiceUpdating">
- ....
- </telerik:RadScheduler>
-
- - If specified, the OnClientAppointmentWebServiceUpdating client-side event - handler is called when an appointment is about to be updated via Web Service call. - In the case of server-side binding, the event will not be raised. - Two parameters are passed to the handler: - - sender, the scheduler client object; - eventArgs with two properties: - - get_appointment(), the appointment that is about to be updated. - set_cancel(), set to true cancel the operation. - - - - This event can be cancelled. - -
- - - Gets or sets a value indicating the client-side event handler that is called when - a recurrence exception is about to be created via Web Service call. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - <script type="text/javascript">
- function clientRecurrenceExceptionCreating(sender, eventArgs)
- {
- alert("Operation cancelled");
- eventArgs.set_cancel(true); - }
- </script>
- <telerik:RadScheduler ID="RadScheduler1"
- runat="server"
- OnClientRecurrenceExceptionCreating="clientRecurrenceExceptionCreating">
- ....
- </telerik:RadScheduler>
-
- - If specified, the OnClientAppointmentWebServiceUpdating client-side event - handler is called when a recurrence exception is about to be created via Web Service call. - In the case of server-side binding, the event will not be raised. - Two parameters are passed to the handler: - - sender, the scheduler client object; - eventArgs with two properties: - - get_appointment(), the appointment that represents the recurrence exception that is about to be stored. - set_cancel(), set to true cancel the operation. - - - - This event can be cancelled. - -
- - - Gets or sets a value indicating the client-side event handler that is called when - recurrence exceptions are about to be removed via Web Service call. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - <script type="text/javascript">
- function clientRecurrenceExceptionsRemoving(sender, eventArgs)
- {
- alert("Operation cancelled");
- eventArgs.set_cancel(true); - }
- </script>
- <telerik:RadScheduler ID="RadScheduler1"
- runat="server"
- OnClientRecurrenceExceptionsRemoving="clientRecurrenceExceptionsRemoving">
- ....
- </telerik:RadScheduler>
-
- - If specified, the OnClientRecurrenceExceptionsRemoving client-side event - handler is called when recurrence exceptions are about to be removed via Web Service call. - In the case of server-side binding, the event will not be raised. - When client-side binding is used, the event will be raised when the user - chooses to remove the recurrence exceptions of a given series through the advanced form. - - Two parameters are passed to the handler: - - sender, the scheduler client object; - eventArgs with two properties: - - get_appointment(), the master appointment that represents the recurrence series. - set_cancel(), set to true cancel the operation. - - - - This event can be cancelled. - -
- - Occurrences of this rule repeat on a daily basis. - - - using System; - using Telerik.Web.UI; - - namespace RecurrenceExamples - { - class DailyRecurrenceRuleExample1 - { - static void Main() - { - // Creates a sample appointment that starts at 6/1/2007 3:30 PM (local time) and lasts half an hour. - Appointment recurringAppointment = new Appointment("1", Convert.ToDateTime("6/1/2007 3:30 PM"), - Convert.ToDateTime("6/1/2007 4:00 PM"), "Sample appointment"); - - // Creates a recurrence range, that specifies a limit of 10 occurrences for the appointment. - RecurrenceRange range = new RecurrenceRange(); - range.Start = recurringAppointment.Start; - range.EventDuration = recurringAppointment.End - recurringAppointment.Start; - range.MaxOccurrences = 10; - - // Creates a recurrence rule to repeat the appointment every two days. - DailyRecurrenceRule rrule = new DailyRecurrenceRule(2, range); - - Console.WriteLine("Appointment occurrs at the following times: "); - int ix = 0; - foreach (DateTime occurrence in rrule.Occurrences) - { - ix = ix + 1; - Console.WriteLine("{0,2}: {1} ({2})", ix, occurrence.ToLocalTime(), occurrence.DayOfWeek); - } - } - } - } - - /* - This example produces the following results: - - Appointment occurrs at the following times: - 1: 6/1/2007 3:30:00 PM (Friday) - 2: 6/3/2007 3:30:00 PM (Sunday) - 3: 6/5/2007 3:30:00 PM (Tuesday) - 4: 6/7/2007 3:30:00 PM (Thursday) - 5: 6/9/2007 3:30:00 PM (Saturday) - 6: 6/11/2007 3:30:00 PM (Monday) - 7: 6/13/2007 3:30:00 PM (Wednesday) - 8: 6/15/2007 3:30:00 PM (Friday) - 9: 6/17/2007 3:30:00 PM (Sunday) - 10: 6/19/2007 3:30:00 PM (Tuesday) - */ - - - Imports System - Imports Telerik.Web.UI - - Namespace RecurrenceExamples - Class DailyRecurrenceRuleExample1 - Shared Sub Main() - ' Creates a sample appointment that starts at 6/1/2007 3:30 PM (local time) and lasts half an hour. - Dim recurringAppointment As New Appointment("1", Convert.ToDateTime("6/1/2007 3:30 PM"), Convert.ToDateTime("6/1/2007 4:00 PM"), "Sample appointment") - - ' Creates a recurrence range, that specifies a limit of 10 occurrences for the appointment. - Dim range As New RecurrenceRange() - range.Start = recurringAppointment.Start - range.EventDuration = recurringAppointment.[End] - recurringAppointment.Start - range.MaxOccurrences = 10 - - ' Creates a recurrence rule to repeat the appointment every two days. - Dim rrule As New DailyRecurrenceRule(2, range) - - Console.WriteLine("Appointment occurrs at the following times: ") - Dim ix As Integer = 0 - For Each occurrence As DateTime In rrule.Occurrences - ix = ix + 1 - Console.WriteLine("{0,2}: {1} ({2})", ix, occurrence.ToLocalTime(), occurrence.DayOfWeek) - Next - End Sub - End Class - End Namespace - - ' - 'This example produces the following results: - ' - 'Appointment occurrs at the following times: - ' 1: 6/1/2007 3:30:00 PM (Friday) - ' 2: 6/3/2007 3:30:00 PM (Sunday) - ' 3: 6/5/2007 3:30:00 PM (Tuesday) - ' 4: 6/7/2007 3:30:00 PM (Thursday) - ' 5: 6/9/2007 3:30:00 PM (Saturday) - ' 6: 6/11/2007 3:30:00 PM (Monday) - ' 7: 6/13/2007 3:30:00 PM (Wednesday) - ' 8: 6/15/2007 3:30:00 PM (Friday) - ' 9: 6/17/2007 3:30:00 PM (Sunday) - '10: 6/19/2007 3:30:00 PM (Tuesday) - ' - - - - - Provides the abstract base class for recurrence rules. - HourlyRecurrenceRule Class - DailyRecurrenceRule Class - WeeklyRecurrenceRule Class - MonthlyRecurrenceRule Class - YearlyRecurrenceRule Class - - Notes to implementers: This base class is provided to make it - easier for implementers to create a recurrence rule. Implementers are encouraged to - extend this base class instead of creating their own. - - - - - Represents an empty recurrence rule - - - - - Creates a recurrence rule with the specified pattern and range. - - The recurrence pattern. - The recurrence range. - The constructed recurrence rule. - - - Creates a recurrence rule instance from it's string representation. - - - using System; - using Telerik.Web.UI; - - namespace RecurrenceExamples - { - class ParsingExample - { - static void Main() - { - // Creates a sample appointment that starts at 6/1/2007 3:30 PM (local time) and lasts half an hour. - Appointment recurringAppointment = new Appointment("1", Convert.ToDateTime("6/1/2007 3:30 PM"), - Convert.ToDateTime("6/1/2007 4:00 PM"), "Sample appointment"); - - // Creates a recurrence range, that specifies a limit of 10 occurrences for the appointment. - RecurrenceRange range = new RecurrenceRange(); - range.Start = recurringAppointment.Start; - range.EventDuration = recurringAppointment.End - recurringAppointment.Start; - range.MaxOccurrences = 10; - - // Creates a recurrence rule to repeat the appointment every 2 hours. - HourlyRecurrenceRule rrule = new HourlyRecurrenceRule(2, range); - - // Prints the string representation of the recurrence rule: - string rruleAsString = rrule.ToString(); - Console.WriteLine("Recurrence rule:\n\n{0}\n", rruleAsString); - - // The string representation can be stored in a database, etc. - // ... - - // Then it can be reconstructed using TryParse method: - RecurrenceRule parsedRule; - RecurrenceRule.TryParse(rruleAsString, out parsedRule); - Console.WriteLine("After parsing (should be the same):\n\n{0}", parsedRule); - } - } - } - - /* - This example produces the following results: - - Recurrence rule: - - DTSTART:20070601T123000Z - DTEND:20070601T130000Z - RRULE:FREQ=HOURLY;COUNT=10;INTERVAL=2; - - - After parsing (should be the same): - - DTSTART:20070601T123000Z - DTEND:20070601T130000Z - RRULE:FREQ=HOURLY;COUNT=10;INTERVAL=2; - */ - - - Imports System - Imports Telerik.Web.UI - - Namespace RecurrenceExamples - Class ParsingExample - Shared Sub Main() - ' Creates a sample appointment that starts at 6/1/2007 3:30 PM (local time) and lasts half an hour. - Dim recurringAppointment As New Appointment("1", Convert.ToDateTime("6/1/2007 3:30 PM"), Convert.ToDateTime("6/1/2007 4:00 PM"), "Sample appointment") - - ' Creates a recurrence range, that specifies a limit of 10 occurrences for the appointment. - Dim range As New RecurrenceRange() - range.Start = recurringAppointment.Start - range.EventDuration = recurringAppointment.[End] - recurringAppointment.Start - range.MaxOccurrences = 10 - - ' Creates a recurrence rule to repeat the appointment every 2 hours. - Dim rrule As New HourlyRecurrenceRule(2, range) - - ' Prints the string representation of the recurrence rule: - Dim rruleAsString As String = rrule.ToString() - Console.WriteLine("Recurrence rule:" & Chr(10) & "" & Chr(10) & "{0}" & Chr(10) & "", rruleAsString) - - ' The string representation can be stored in a database, etc. - ' ... - - ' Then it can be reconstructed using TryParse method: - Dim parsedRule As RecurrenceRule - RecurrenceRule.TryParse(rruleAsString, parsedRule) - Console.WriteLine("After parsing (should be the same):" & Chr(10) & "" & Chr(10) & "{0}", parsedRule) - End Sub - End Class - End Namespace - - ' - 'This example produces the following results: - ' - 'Recurrence rule: - ' - 'DTSTART:20070601T123000Z - 'DTEND:20070601T130000Z - 'RRULE:FREQ=HOURLY;COUNT=10;INTERVAL=2; - ' - ' - 'After parsing (should be the same): - ' - 'DTSTART:20070601T123000Z - 'DTEND:20070601T130000Z - 'RRULE:FREQ=HOURLY;COUNT=10;INTERVAL=2; - ' - - - True if input was converted successfully, false otherwise. - The string representation to parse. - - When this method returns, contains the recurrence rule instance, if the - conversion succeeded, or null if the conversion failed. The conversion fails if the - value parameter is a null reference (Nothing in Visual Basic) - or represents invalid recurrence rule. - - - - Specifies the effective range for evaluating occurrences. - End date is before Start date. - - The range is inclusive. To clear the effective range call - . - - - - using System; - using Telerik.Web.UI; - - namespace RecurrenceExamples - { - class EffectiveRangeExample - { - static void Main() - { - // Creates a sample appointment that starts at 6/1/2007 3:30 PM (local time) and lasts half an hour. - Appointment recurringAppointment = new Appointment("1", Convert.ToDateTime("6/1/2007 3:30 PM"), - Convert.ToDateTime("6/1/2007 4:00 PM"), "Sample appointment"); - - // Creates a recurrence range, that specifies a limit of 10 occurrences for the appointment. - RecurrenceRange range = new RecurrenceRange(); - range.Start = recurringAppointment.Start; - range.EventDuration = recurringAppointment.End - recurringAppointment.Start; - range.MaxOccurrences = 10; - - // Creates a recurrence rule to repeat the appointment every 2 hours. - HourlyRecurrenceRule rrule = new HourlyRecurrenceRule(2, range); - - // Limits the effective range. - rrule.SetEffectiveRange(Convert.ToDateTime("6/1/2007 5:00 PM"), Convert.ToDateTime("6/1/2007 8:00 PM")); - - Console.WriteLine("Appointment occurrs at the following times: "); - int ix = 0; - foreach (DateTime occurrence in rrule.Occurrences) - { - ix = ix + 1; - Console.WriteLine("{0,2}: {1}", ix, occurrence.ToLocalTime()); - } - } - } - } - - /* - This example produces the following results: - - Appointment occurrs at the following times: - 1: 6/1/2007 5:30:00 PM - 2: 6/1/2007 7:30:00 PM - */ - - - Imports System - Imports Telerik.Web.UI - - Namespace RecurrenceExamples - Class EffectiveRangeExample - Shared Sub Main() - ' Creates a sample appointment that starts at 6/1/2007 3:30 PM (local time) and lasts half an hour. - Dim recurringAppointment As New Appointment("1", Convert.ToDateTime("6/1/2007 3:30 PM"), Convert.ToDateTime("6/1/2007 4:00 PM"), "Sample appointment") - - ' Creates a recurrence range, that specifies a limit of 10 occurrences for the appointment. - Dim range As New RecurrenceRange() - range.Start = recurringAppointment.Start - range.EventDuration = recurringAppointment.[End] - recurringAppointment.Start - range.MaxOccurrences = 10 - - ' Creates a recurrence rule to repeat the appointment every 2 hours. - Dim rrule As New HourlyRecurrenceRule(2, range) - - ' Limits the effective range. - rrule.SetEffectiveRange(Convert.ToDateTime("6/1/2007 5:00 PM"), Convert.ToDateTime("6/1/2007 8:00 PM")) - - Console.WriteLine("Appointment occurrs at the following times: ") - Dim ix As Integer = 0 - For Each occurrence As DateTime In rrule.Occurrences - ix = ix + 1 - Console.WriteLine("{0,2}: {1}", ix, occurrence.ToLocalTime()) - Next - End Sub - End Class - End Namespace - - ' - 'This example produces the following results: - ' - 'Appointment occurrs at the following times: - ' 1: 6/1/2007 5:30:00 PM - ' 2: 6/1/2007 7:30:00 PM - ' - - - ClearEffectiveRange Method - The starting date of the effective range. - The ending date of the effective range. - - - Clears the effective range set by calling . - If no effective range was set, calling this method has no effect. - SetEffectiveRange Method - - - Converts the recurrence rule to it's equivalent string representation. - The string representation of this recurrence rule. - - - using System; - using Telerik.Web.UI; - - namespace RecurrenceExamples - { - class ParsingExample - { - static void Main() - { - // Creates a sample appointment that starts at 6/1/2007 3:30 PM (local time) and lasts half an hour. - Appointment recurringAppointment = new Appointment("1", Convert.ToDateTime("6/1/2007 3:30 PM"), - Convert.ToDateTime("6/1/2007 4:00 PM"), "Sample appointment"); - - // Creates a recurrence range, that specifies a limit of 10 occurrences for the appointment. - RecurrenceRange range = new RecurrenceRange(); - range.Start = recurringAppointment.Start; - range.EventDuration = recurringAppointment.End - recurringAppointment.Start; - range.MaxOccurrences = 10; - - // Creates a recurrence rule to repeat the appointment every 2 hours. - HourlyRecurrenceRule rrule = new HourlyRecurrenceRule(2, range); - - // Prints the string representation of the recurrence rule: - string rruleAsString = rrule.ToString(); - Console.WriteLine("Recurrence rule:\n\n{0}\n", rruleAsString); - - // The string representation can be stored in a database, etc. - // ... - - // Then it can be reconstructed using TryParse method: - RecurrenceRule parsedRule; - RecurrenceRule.TryParse(rruleAsString, out parsedRule); - Console.WriteLine("After parsing (should be the same):\n\n{0}", parsedRule); - } - } - } - - /* - This example produces the following results: - - Recurrence rule: - - DTSTART:20070601T123000Z - DTEND:20070601T130000Z - RRULE:FREQ=HOURLY;COUNT=10;INTERVAL=2; - - - After parsing (should be the same): - - DTSTART:20070601T123000Z - DTEND:20070601T130000Z - RRULE:FREQ=HOURLY;COUNT=10;INTERVAL=2; - */ - - - Imports System - Imports Telerik.Web.UI - - Namespace RecurrenceExamples - Class ParsingExample - Shared Sub Main() - ' Creates a sample appointment that starts at 6/1/2007 3:30 PM (local time) and lasts half an hour. - Dim recurringAppointment As New Appointment("1", Convert.ToDateTime("6/1/2007 3:30 PM"), Convert.ToDateTime("6/1/2007 4:00 PM"), "Sample appointment") - - ' Creates a recurrence range, that specifies a limit of 10 occurrences for the appointment. - Dim range As New RecurrenceRange() - range.Start = recurringAppointment.Start - range.EventDuration = recurringAppointment.[End] - recurringAppointment.Start - range.MaxOccurrences = 10 - - ' Creates a recurrence rule to repeat the appointment every 2 hours. - Dim rrule As New HourlyRecurrenceRule(2, range) - - ' Prints the string representation of the recurrence rule: - Dim rruleAsString As String = rrule.ToString() - Console.WriteLine("Recurrence rule:" & Chr(10) & "" & Chr(10) & "{0}" & Chr(10) & "", rruleAsString) - - ' The string representation can be stored in a database, etc. - ' ... - - ' Then it can be reconstructed using TryParse method: - Dim parsedRule As RecurrenceRule - RecurrenceRule.TryParse(rruleAsString, parsedRule) - Console.WriteLine("After parsing (should be the same):" & Chr(10) & "" & Chr(10) & "{0}", parsedRule) - End Sub - End Class - End Namespace - - ' - 'This example produces the following results: - ' - 'Recurrence rule: - ' - 'DTSTART:20070601T123000Z - 'DTEND:20070601T130000Z - 'RRULE:FREQ=HOURLY;COUNT=10;INTERVAL=2; - ' - ' - 'After parsing (should be the same): - ' - 'DTSTART:20070601T123000Z - 'DTEND:20070601T130000Z - 'RRULE:FREQ=HOURLY;COUNT=10;INTERVAL=2; - ' - - - - The string representation is based on the iCalendar data format (RFC - 2445). - - - - Overriden. Returns the hash code for this instance. - The hash code for this instance. - - - - Overloaded. Overridden. Returns a value indicating whether this instance is equal - to a specified object. - - - true if value is an instance of - and equals the value of this instance; - otherwise, false. - - An object to compare with this instance. - - - - Overloaded. Overridden. Returns a value indicating whether this instance is equal - to a specified object. - - - true if value equals the value of this instance; - otherwise, false. - - An object to compare with this instance. - - - - Determines whether two specified objects have the - same value. - - - - - Determines whether two specified objects have - different values. - - - - - Populates a SerializationInfo with the data needed to serialize this - object. - - The to populate with data. - The destination (see ) for this serialization. - - - Gets the associated with this recurrence rule. - The associated with this recurrence rule. - - By calling the range of the generated - occurrences can be narrowed. - - - - Gets the associated with this recurrence rule. - The associated with this recurrence rule. - - - Occurrence times are in UTC. - Gets the evaluated occurrence times of this recurrence rule. - The evaluated occurrence times of this recurrence rule. - - - using System; - using Telerik.Web.UI; - - namespace RecurrenceExamples - { - class HourlyRecurrenceRuleExample - { - static void Main() - { - // Creates a sample appointment that starts at 6/1/2007 3:30 PM (local time) and lasts half an hour. - Appointment recurringAppointment = new Appointment("1", Convert.ToDateTime("6/1/2007 3:30 PM"), - Convert.ToDateTime("6/1/2007 4:00 PM"), "Sample appointment"); - - // Creates a recurrence range, that specifies a limit of 10 occurrences for the appointment. - RecurrenceRange range = new RecurrenceRange(); - range.Start = recurringAppointment.Start; - range.EventDuration = recurringAppointment.End - recurringAppointment.Start; - range.MaxOccurrences = 10; - - // Creates a recurrence rule to repeat the appointment every 2 hours. - HourlyRecurrenceRule rrule = new HourlyRecurrenceRule(2, range); - - Console.WriteLine("Appointment occurrs at the following times: "); - int ix = 0; - foreach (DateTime occurrence in rrule.Occurrences) - { - ix = ix + 1; - Console.WriteLine("{0,2}: {1}", ix, occurrence.ToLocalTime()); - } - } - } - } - - /* - This example produces the following results: - - Appointment occurrs at the following times: - 1: 6/1/2007 3:30:00 PM - 2: 6/1/2007 5:30:00 PM - 3: 6/1/2007 7:30:00 PM - 4: 6/1/2007 9:30:00 PM - 5: 6/1/2007 11:30:00 PM - 6: 6/2/2007 1:30:00 AM - 7: 6/2/2007 3:30:00 AM - 8: 6/2/2007 5:30:00 AM - 9: 6/2/2007 7:30:00 AM - 10: 6/2/2007 9:30:00 AM - */ - - - Imports System - Imports Telerik.Web.UI - - Namespace RecurrenceExamples - Class HourlyRecurrenceRuleExample - Shared Sub Main() - ' Creates a sample appointment that starts at 6/1/2007 3:30 PM (local time) and lasts half an hour. - Dim recurringAppointment As New Appointment("1", Convert.ToDateTime("6/1/2007 3:30 PM"), Convert.ToDateTime("6/1/2007 4:00 PM"), "Sample appointment") - - ' Creates a recurrence range, that specifies a limit of 10 occurrences for the appointment. - Dim range As New RecurrenceRange() - range.Start = recurringAppointment.Start - range.EventDuration = recurringAppointment.[End] - recurringAppointment.Start - range.MaxOccurrences = 10 - - ' Creates a recurrence rule to repeat the appointment every 2 hours. - Dim rrule As New HourlyRecurrenceRule(2, range) - - Console.WriteLine("Appointment occurrs at the following times: ") - Dim ix As Integer = 0 - For Each occurrence As DateTime In rrule.Occurrences - ix = ix + 1 - Console.WriteLine("{0,2}: {1}", ix, occurrence.ToLocalTime()) - Next - End Sub - End Class - End Namespace - - ' - 'This example produces the following results: - ' - 'Appointment occurrs at the following times: - ' 1: 6/1/2007 3:30:00 PM - ' 2: 6/1/2007 5:30:00 PM - ' 3: 6/1/2007 7:30:00 PM - ' 4: 6/1/2007 9:30:00 PM - ' 5: 6/1/2007 11:30:00 PM - ' 6: 6/2/2007 1:30:00 AM - ' 7: 6/2/2007 3:30:00 AM - ' 8: 6/2/2007 5:30:00 AM - ' 9: 6/2/2007 7:30:00 AM - '10: 6/2/2007 9:30:00 AM - ' - - - - - - Gets a value indicating whether this recurrence rule yields any - occurrences. - - True this recurrence rule yields any occurrences, false otherwise. - - - Gets or sets a list of the exception dates associated with this recurrence rule. - A list of the exception dates associated with this recurrence rule. - - - using System; - using Telerik.Web.UI; - - namespace RecurrenceExamples - { - class RecurrenceExceptionsExample - { - static void Main() - { - // Creates a sample appointment that starts at 6/1/2007 3:30 PM (local time) and lasts half an hour. - Appointment recurringAppointment = new Appointment("1", Convert.ToDateTime("6/1/2007 3:30 PM"), - Convert.ToDateTime("6/1/2007 4:00 PM"), "Sample appointment"); - - // Creates a recurrence range, that specifies a limit of 10 occurrences for the appointment. - RecurrenceRange range = new RecurrenceRange(); - range.Start = recurringAppointment.Start; - range.EventDuration = recurringAppointment.End - recurringAppointment.Start; - range.MaxOccurrences = 10; - - // Creates a recurrence rule to repeat the appointment every 2 hours. - HourlyRecurrenceRule rrule = new HourlyRecurrenceRule(2, range); - - // Creates a recurrence exception for 5:30 PM (local time). - // Note that exception dates must be in universal time. - rrule.Exceptions.Add(Convert.ToDateTime("6/1/2007 5:30 PM").ToUniversalTime()); - - Console.WriteLine("Appointment occurrs at the following times: "); - int ix = 0; - foreach (DateTime occurrence in rrule.Occurrences) - { - ix = ix + 1; - Console.WriteLine("{0,2}: {1}", ix, occurrence.ToLocalTime()); - } - } - } - } - - /* - This example produces the following results: - - Appointment occurrs at the following times: - 1: 6/1/2007 3:30:00 PM - 2: 6/1/2007 7:30:00 PM - 3: 6/1/2007 9:30:00 PM - 4: 6/1/2007 11:30:00 PM - 5: 6/2/2007 1:30:00 AM - 6: 6/2/2007 3:30:00 AM - 7: 6/2/2007 5:30:00 AM - 8: 6/2/2007 7:30:00 AM - 9: 6/2/2007 9:30:00 AM - */ - - - Imports System - Imports Telerik.Web.UI - - Namespace RecurrenceExamples - Class RecurrenceExceptionsExample - Shared Sub Main() - ' Creates a sample appointment that starts at 6/1/2007 3:30 PM (local time) and lasts half an hour. - Dim recurringAppointment As New Appointment("1", Convert.ToDateTime("6/1/2007 3:30 PM"), Convert.ToDateTime("6/1/2007 4:00 PM"), "Sample appointment") - - ' Creates a recurrence range, that specifies a limit of 10 occurrences for the appointment. - Dim range As New RecurrenceRange() - range.Start = recurringAppointment.Start - range.EventDuration = recurringAppointment.[End] - recurringAppointment.Start - range.MaxOccurrences = 10 - - ' Creates a recurrence rule to repeat the appointment every 2 hours. - Dim rrule As New HourlyRecurrenceRule(2, range) - - ' Creates a recurrence exception for 5:30 PM (local time). - ' Note that exception dates must be in universal time. - rrule.Exceptions.Add(Convert.ToDateTime("6/1/2007 5:30 PM").ToUniversalTime()) - - Console.WriteLine("Appointment occurrs at the following times: ") - Dim ix As Integer = 0 - For Each occurrence As DateTime In rrule.Occurrences - ix = ix + 1 - Console.WriteLine("{0,2}: {1}", ix, occurrence.ToLocalTime()) - Next - End Sub - End Class - End Namespace - - ' - 'This example produces the following results: - ' - 'Appointment occurrs at the following times: - ' 1: 6/1/2007 3:30:00 PM - ' 2: 6/1/2007 7:30:00 PM - ' 3: 6/1/2007 9:30:00 PM - ' 4: 6/1/2007 11:30:00 PM - ' 5: 6/2/2007 1:30:00 AM - ' 6: 6/2/2007 3:30:00 AM - ' 7: 6/2/2007 5:30:00 AM - ' 8: 6/2/2007 7:30:00 AM - ' 9: 6/2/2007 9:30:00 AM - ' - - - - Any date placed in the list will be considered a recurrence exception, i.e. an - occurrence will not be generated for that date. The dates must be in universal - time. - - - - - Gets a value indicating whether this recurrence rule has associated - exceptions. - - True if this recurrence rule has associated exceptions, false otherwise. - - - - Gets or sets the maximum candidates limit. - - - This limit is used to prevent lockups when evaluating infinite rules without using SetEffectiveRange. - The default value should not be changed under normal conditions. - - The maximum candidates limit. - - - - - using System; - using Telerik.Web.UI; - - namespace RecurrenceExamples - { - class DailyRecurrenceRuleExample1 - { - static void Main() - { - // Creates a sample appointment that starts at 6/1/2007 3:30 PM (local time) and lasts half an hour. - Appointment recurringAppointment = new Appointment("1", Convert.ToDateTime("6/1/2007 3:30 PM"), - Convert.ToDateTime("6/1/2007 4:00 PM"), "Sample appointment"); - - // Creates a recurrence range, that specifies a limit of 10 occurrences for the appointment. - RecurrenceRange range = new RecurrenceRange(); - range.Start = recurringAppointment.Start; - range.EventDuration = recurringAppointment.End - recurringAppointment.Start; - range.MaxOccurrences = 10; - - // Creates a recurrence rule to repeat the appointment every two days. - DailyRecurrenceRule rrule = new DailyRecurrenceRule(2, range); - - Console.WriteLine("Appointment occurrs at the following times: "); - int ix = 0; - foreach (DateTime occurrence in rrule.Occurrences) - { - ix = ix + 1; - Console.WriteLine("{0,2}: {1} ({2})", ix, occurrence.ToLocalTime(), occurrence.DayOfWeek); - } - } - } - } - - /* - This example produces the following results: - - Appointment occurrs at the following times: - 1: 6/1/2007 3:30:00 PM (Friday) - 2: 6/3/2007 3:30:00 PM (Sunday) - 3: 6/5/2007 3:30:00 PM (Tuesday) - 4: 6/7/2007 3:30:00 PM (Thursday) - 5: 6/9/2007 3:30:00 PM (Saturday) - 6: 6/11/2007 3:30:00 PM (Monday) - 7: 6/13/2007 3:30:00 PM (Wednesday) - 8: 6/15/2007 3:30:00 PM (Friday) - 9: 6/17/2007 3:30:00 PM (Sunday) - 10: 6/19/2007 3:30:00 PM (Tuesday) - */ - - - Imports System - Imports Telerik.Web.UI - - Namespace RecurrenceExamples - Class DailyRecurrenceRuleExample1 - Shared Sub Main() - ' Creates a sample appointment that starts at 6/1/2007 3:30 PM (local time) and lasts half an hour. - Dim recurringAppointment As New Appointment("1", Convert.ToDateTime("6/1/2007 3:30 PM"), Convert.ToDateTime("6/1/2007 4:00 PM"), "Sample appointment") - - ' Creates a recurrence range, that specifies a limit of 10 occurrences for the appointment. - Dim range As New RecurrenceRange() - range.Start = recurringAppointment.Start - range.EventDuration = recurringAppointment.[End] - recurringAppointment.Start - range.MaxOccurrences = 10 - - ' Creates a recurrence rule to repeat the appointment every two days. - Dim rrule As New DailyRecurrenceRule(2, range) - - Console.WriteLine("Appointment occurrs at the following times: ") - Dim ix As Integer = 0 - For Each occurrence As DateTime In rrule.Occurrences - ix = ix + 1 - Console.WriteLine("{0,2}: {1} ({2})", ix, occurrence.ToLocalTime(), occurrence.DayOfWeek) - Next - End Sub - End Class - End Namespace - - ' - 'This example produces the following results: - ' - 'Appointment occurrs at the following times: - ' 1: 6/1/2007 3:30:00 PM (Friday) - ' 2: 6/3/2007 3:30:00 PM (Sunday) - ' 3: 6/5/2007 3:30:00 PM (Tuesday) - ' 4: 6/7/2007 3:30:00 PM (Thursday) - ' 5: 6/9/2007 3:30:00 PM (Saturday) - ' 6: 6/11/2007 3:30:00 PM (Monday) - ' 7: 6/13/2007 3:30:00 PM (Wednesday) - ' 8: 6/15/2007 3:30:00 PM (Friday) - ' 9: 6/17/2007 3:30:00 PM (Sunday) - '10: 6/19/2007 3:30:00 PM (Tuesday) - ' - - - - Initializes a new instance of with the - specified interval (in days) and . - - The number of days between the occurrences. - - The instance that specifies the range of this - recurrence rule. - - - - - - using System; - using Telerik.Web.UI; - - namespace RecurrenceExamples - { - class DailyRecurrenceRuleExample2 - { - static void Main() - { - // Creates a sample appointment that starts at 6/1/2007 3:30 PM (local time) and lasts half an hour. - Appointment recurringAppointment = new Appointment("1", Convert.ToDateTime("6/1/2007 3:30 PM"), - Convert.ToDateTime("6/1/2007 4:00 PM"), "Sample appointment"); - - // Creates a recurrence range, that specifies a limit of 10 occurrences for the appointment. - RecurrenceRange range = new RecurrenceRange(); - range.Start = recurringAppointment.Start; - range.EventDuration = recurringAppointment.End - recurringAppointment.Start; - range.MaxOccurrences = 10; - - // Creates a recurrence rule to repeat the appointment every week day. - DailyRecurrenceRule rrule = new DailyRecurrenceRule(RecurrenceDay.WeekDays, range); - - Console.WriteLine("Appointment occurrs at the following times: "); - int ix = 0; - foreach (DateTime occurrence in rrule.Occurrences) - { - ix = ix + 1; - Console.WriteLine("{0,2}: {1} ({2})", ix, occurrence.ToLocalTime(), occurrence.DayOfWeek); - } - } - } - } - - /* - This example produces the following results: - - Appointment occurrs at the following times: - 1: 6/1/2007 3:30:00 PM (Friday) - 2: 6/4/2007 3:30:00 PM (Monday) - 3: 6/5/2007 3:30:00 PM (Tuesday) - 4: 6/6/2007 3:30:00 PM (Wednesday) - 5: 6/7/2007 3:30:00 PM (Thursday) - 6: 6/8/2007 3:30:00 PM (Friday) - 7: 6/11/2007 3:30:00 PM (Monday) - 8: 6/12/2007 3:30:00 PM (Tuesday) - 9: 6/13/2007 3:30:00 PM (Wednesday) - 10: 6/14/2007 3:30:00 PM (Thursday) - */ - - - Imports System - Imports Telerik.Web.UI - - Namespace RecurrenceExamples - Class DailyRecurrenceRuleExample2 - Shared Sub Main() - ' Creates a sample appointment that starts at 6/1/2007 3:30 PM (local time) and lasts half an hour. - Dim recurringAppointment As New Appointment("1", Convert.ToDateTime("6/1/2007 3:30 PM"), Convert.ToDateTime("6/1/2007 4:00 PM"), "Sample appointment") - - ' Creates a recurrence range, that specifies a limit of 10 occurrences for the appointment. - Dim range As New RecurrenceRange() - range.Start = recurringAppointment.Start - range.EventDuration = recurringAppointment.[End] - recurringAppointment.Start - range.MaxOccurrences = 10 - - ' Creates a recurrence rule to repeat the appointment every week day. - Dim rrule As New DailyRecurrenceRule(RecurrenceDay.WeekDays, range) - - Console.WriteLine("Appointment occurrs at the following times: ") - Dim ix As Integer = 0 - For Each occurrence As DateTime In rrule.Occurrences - ix = ix + 1 - Console.WriteLine("{0,2}: {1} ({2})", ix, occurrence.ToLocalTime(), occurrence.DayOfWeek) - Next - End Sub - End Class - End Namespace - - ' - 'This example produces the following results: - ' - 'Appointment occurrs at the following times: - ' 1: 6/1/2007 3:30:00 PM (Friday) - ' 2: 6/4/2007 3:30:00 PM (Monday) - ' 3: 6/5/2007 3:30:00 PM (Tuesday) - ' 4: 6/6/2007 3:30:00 PM (Wednesday) - ' 5: 6/7/2007 3:30:00 PM (Thursday) - ' 6: 6/8/2007 3:30:00 PM (Friday) - ' 7: 6/11/2007 3:30:00 PM (Monday) - ' 8: 6/12/2007 3:30:00 PM (Tuesday) - ' 9: 6/13/2007 3:30:00 PM (Wednesday) - '10: 6/14/2007 3:30:00 PM (Thursday) - ' - - - - Initializes a new instance of with the - specified days of week bit mask and . - - A bit mask that specifies the week days on which the event recurs. - - The instance that specifies the range of this - recurrence rule. - - - - Gets the interval (in days) between the occurrences. - The interval (in days) between the occurrences. - - - - Gets or sets the bit mask that specifies the week days on which the event - recurs. - - RecurrenceDay Enumeration - - For additional information on how to create masks see the - documentation. - - A bit mask that specifies the week days on which the event recurs. - - - Occurrences of this rule repeat every given number of hours. - - - using System; - using Telerik.Web.UI; - - namespace RecurrenceExamples - { - class HourlyRecurrenceRuleExample - { - static void Main() - { - // Creates a sample appointment that starts at 6/1/2007 3:30 PM (local time) and lasts half an hour. - Appointment recurringAppointment = new Appointment("1", Convert.ToDateTime("6/1/2007 3:30 PM"), - Convert.ToDateTime("6/1/2007 4:00 PM"), "Sample appointment"); - - // Creates a recurrence range, that specifies a limit of 10 occurrences for the appointment. - RecurrenceRange range = new RecurrenceRange(); - range.Start = recurringAppointment.Start; - range.EventDuration = recurringAppointment.End - recurringAppointment.Start; - range.MaxOccurrences = 10; - - // Creates a recurrence rule to repeat the appointment every 2 hours. - HourlyRecurrenceRule rrule = new HourlyRecurrenceRule(2, range); - - Console.WriteLine("Appointment occurrs at the following times: "); - int ix = 0; - foreach (DateTime occurrence in rrule.Occurrences) - { - ix = ix + 1; - Console.WriteLine("{0,2}: {1}", ix, occurrence.ToLocalTime()); - } - } - } - } - - /* - This example produces the following results: - - Appointment occurrs at the following times: - 1: 6/1/2007 3:30:00 PM - 2: 6/1/2007 5:30:00 PM - 3: 6/1/2007 7:30:00 PM - 4: 6/1/2007 9:30:00 PM - 5: 6/1/2007 11:30:00 PM - 6: 6/2/2007 1:30:00 AM - 7: 6/2/2007 3:30:00 AM - 8: 6/2/2007 5:30:00 AM - 9: 6/2/2007 7:30:00 AM - 10: 6/2/2007 9:30:00 AM - */ - - - Imports System - Imports Telerik.Web.UI - - Namespace RecurrenceExamples - Class HourlyRecurrenceRuleExample - Shared Sub Main() - ' Creates a sample appointment that starts at 6/1/2007 3:30 PM (local time) and lasts half an hour. - Dim recurringAppointment As New Appointment("1", Convert.ToDateTime("6/1/2007 3:30 PM"), Convert.ToDateTime("6/1/2007 4:00 PM"), "Sample appointment") - - ' Creates a recurrence range, that specifies a limit of 10 occurrences for the appointment. - Dim range As New RecurrenceRange() - range.Start = recurringAppointment.Start - range.EventDuration = recurringAppointment.[End] - recurringAppointment.Start - range.MaxOccurrences = 10 - - ' Creates a recurrence rule to repeat the appointment every 2 hours. - Dim rrule As New HourlyRecurrenceRule(2, range) - - Console.WriteLine("Appointment occurrs at the following times: ") - Dim ix As Integer = 0 - For Each occurrence As DateTime In rrule.Occurrences - ix = ix + 1 - Console.WriteLine("{0,2}: {1}", ix, occurrence.ToLocalTime()) - Next - End Sub - End Class - End Namespace - - ' - 'This example produces the following results: - ' - 'Appointment occurrs at the following times: - ' 1: 6/1/2007 3:30:00 PM - ' 2: 6/1/2007 5:30:00 PM - ' 3: 6/1/2007 7:30:00 PM - ' 4: 6/1/2007 9:30:00 PM - ' 5: 6/1/2007 11:30:00 PM - ' 6: 6/2/2007 1:30:00 AM - ' 7: 6/2/2007 3:30:00 AM - ' 8: 6/2/2007 5:30:00 AM - ' 9: 6/2/2007 7:30:00 AM - '10: 6/2/2007 9:30:00 AM - ' - - - - - - Initializes a new instance of the class - with the specified interval (in hours) and . - - The number of hours between the occurrences. - - The instance that specifies the range of this - recurrence rule. - - - - Gets the interval (in hours) assigned to the current instance. - The interval (in hours) assigned to the current instance. - - - - Occurrences of this rule repeat on a monthly basis. - - - - using System; - using Telerik.Web.UI; - - namespace RecurrenceExamples - { - class MonthlyRecurrenceRuleExample1 - { - static void Main() - { - // Creates a sample appointment that starts at 6/1/2007 3:30 PM (local time) and lasts half an hour. - Appointment recurringAppointment = new Appointment("1", Convert.ToDateTime("6/1/2007 3:30 PM"), - Convert.ToDateTime("6/1/2007 4:00 PM"), "Sample appointment"); - - // Creates a recurrence range, that specifies a limit of 10 occurrences for the appointment. - RecurrenceRange range = new RecurrenceRange(); - range.Start = recurringAppointment.Start; - range.EventDuration = recurringAppointment.End - recurringAppointment.Start; - range.MaxOccurrences = 5; - - // Creates a recurrence rule to repeat the appointment on the 5th day of every month. - MonthlyRecurrenceRule rrule = new MonthlyRecurrenceRule(5, 1, range); - - Console.WriteLine("Appointment occurrs at the following times: "); - int ix = 0; - foreach (DateTime occurrence in rrule.Occurrences) - { - ix = ix + 1; - Console.WriteLine("{0,2}: {1}", ix, occurrence.ToLocalTime()); - } - } - } - } - - /* - This example produces the following results: - - Appointment occurrs at the following times: - 1: 6/5/2007 3:30:00 PM - 2: 7/5/2007 3:30:00 PM - 3: 8/5/2007 3:30:00 PM - 4: 9/5/2007 3:30:00 PM - 5: 10/5/2007 3:30:00 PM - */ - - - Imports System - Imports Telerik.Web.UI - - Namespace RecurrenceExamples - Class MonthlyRecurrenceRuleExample1 - Shared Sub Main() - ' Creates a sample appointment that starts at 6/1/2007 3:30 PM (local time) and lasts half an hour. - Dim recurringAppointment As New Appointment("1", Convert.ToDateTime("6/1/2007 3:30 PM"), Convert.ToDateTime("6/1/2007 4:00 PM"), "Sample appointment") - - ' Creates a recurrence range, that specifies a limit of 10 occurrences for the appointment. - Dim range As New RecurrenceRange() - range.Start = recurringAppointment.Start - range.EventDuration = recurringAppointment.[End] - recurringAppointment.Start - range.MaxOccurrences = 5 - - ' Creates a recurrence rule to repeat the appointment on the 5th day of every month. - Dim rrule As New MonthlyRecurrenceRule(5, 1, range) - - Console.WriteLine("Appointment occurrs at the following times: ") - Dim ix As Integer = 0 - For Each occurrence As DateTime In rrule.Occurrences - ix = ix + 1 - Console.WriteLine("{0,2}: {1}", ix, occurrence.ToLocalTime()) - Next - End Sub - End Class - End Namespace - - ' - 'This example produces the following results: - ' - 'Appointment occurrs at the following times: - ' 1: 6/5/2007 3:30:00 PM - ' 2: 7/5/2007 3:30:00 PM - ' 3: 8/5/2007 3:30:00 PM - ' 4: 9/5/2007 3:30:00 PM - ' 5: 10/5/2007 3:30:00 PM - ' - - - - - - Initializes a new instance of the class. - - - - using System; - using Telerik.Web.UI; - - namespace RecurrenceExamples - { - class MonthlyRecurrenceRuleExample1 - { - static void Main() - { - // Creates a sample appointment that starts at 6/1/2007 3:30 PM (local time) and lasts half an hour. - Appointment recurringAppointment = new Appointment("1", Convert.ToDateTime("6/1/2007 3:30 PM"), - Convert.ToDateTime("6/1/2007 4:00 PM"), "Sample appointment"); - - // Creates a recurrence range, that specifies a limit of 10 occurrences for the appointment. - RecurrenceRange range = new RecurrenceRange(); - range.Start = recurringAppointment.Start; - range.EventDuration = recurringAppointment.End - recurringAppointment.Start; - range.MaxOccurrences = 5; - - // Creates a recurrence rule to repeat the appointment on the 5th day of every month. - MonthlyRecurrenceRule rrule = new MonthlyRecurrenceRule(5, 1, range); - - Console.WriteLine("Appointment occurrs at the following times: "); - int ix = 0; - foreach (DateTime occurrence in rrule.Occurrences) - { - ix = ix + 1; - Console.WriteLine("{0,2}: {1}", ix, occurrence.ToLocalTime()); - } - } - } - } - - /* - This example produces the following results: - - Appointment occurrs at the following times: - 1: 6/5/2007 3:30:00 PM - 2: 7/5/2007 3:30:00 PM - 3: 8/5/2007 3:30:00 PM - 4: 9/5/2007 3:30:00 PM - 5: 10/5/2007 3:30:00 PM - */ - - - Imports System - Imports Telerik.Web.UI - - Namespace RecurrenceExamples - Class MonthlyRecurrenceRuleExample1 - Shared Sub Main() - ' Creates a sample appointment that starts at 6/1/2007 3:30 PM (local time) and lasts half an hour. - Dim recurringAppointment As New Appointment("1", Convert.ToDateTime("6/1/2007 3:30 PM"), Convert.ToDateTime("6/1/2007 4:00 PM"), "Sample appointment") - - ' Creates a recurrence range, that specifies a limit of 10 occurrences for the appointment. - Dim range As New RecurrenceRange() - range.Start = recurringAppointment.Start - range.EventDuration = recurringAppointment.[End] - recurringAppointment.Start - range.MaxOccurrences = 5 - - ' Creates a recurrence rule to repeat the appointment on the 5th day of every month. - Dim rrule As New MonthlyRecurrenceRule(5, 1, range) - - Console.WriteLine("Appointment occurrs at the following times: ") - Dim ix As Integer = 0 - For Each occurrence As DateTime In rrule.Occurrences - ix = ix + 1 - Console.WriteLine("{0,2}: {1}", ix, occurrence.ToLocalTime()) - Next - End Sub - End Class - End Namespace - - ' - 'This example produces the following results: - ' - 'Appointment occurrs at the following times: - ' 1: 6/5/2007 3:30:00 PM - ' 2: 7/5/2007 3:30:00 PM - ' 3: 8/5/2007 3:30:00 PM - ' 4: 9/5/2007 3:30:00 PM - ' 5: 10/5/2007 3:30:00 PM - ' - - - The day of month on which the event recurs. - The interval (in months) between the occurrences. - The instance that specifies the range of this rule. - - - - Initializes a new instance of the class. - - - - using System; - using Telerik.Web.UI; - - namespace RecurrenceExamples - { - class MonthlyRecurrenceRuleExample2 - { - static void Main() - { - // Creates a sample appointment that starts at 6/1/2007 3:30 PM (local time) and lasts half an hour. - Appointment recurringAppointment = new Appointment("1", Convert.ToDateTime("6/1/2007 3:30 PM"), - Convert.ToDateTime("6/1/2007 4:00 PM"), "Sample appointment"); - - // Creates a recurrence range, that specifies a limit of 10 occurrences for the appointment. - RecurrenceRange range = new RecurrenceRange(); - range.Start = recurringAppointment.Start; - range.EventDuration = recurringAppointment.End - recurringAppointment.Start; - range.MaxOccurrences = 5; - - // Creates a recurrence rule to repeat the appointment on the last monday of every two months. - MonthlyRecurrenceRule rrule = new MonthlyRecurrenceRule(-1, RecurrenceDay.Monday, 2, range); - - Console.WriteLine("Appointment occurrs at the following times: "); - int ix = 0; - foreach (DateTime occurrence in rrule.Occurrences) - { - ix = ix + 1; - Console.WriteLine("{0,2}: {1}", ix, occurrence.ToLocalTime()); - } - } - } - } - - /* - This example produces the following results: - - Appointment occurrs at the following times: - 1: 6/25/2007 3:30:00 PM - 2: 8/27/2007 3:30:00 PM - 3: 10/29/2007 2:30:00 PM - 4: 12/31/2007 2:30:00 PM - 5: 2/25/2008 2:30:00 PM - */ - - - Imports System - Imports Telerik.Web.UI - - Namespace RecurrenceExamples - Class MonthlyRecurrenceRuleExample2 - Shared Sub Main() - ' Creates a sample appointment that starts at 6/1/2007 3:30 PM (local time) and lasts half an hour. - Dim recurringAppointment As New Appointment("1", Convert.ToDateTime("6/1/2007 3:30 PM"), Convert.ToDateTime("6/1/2007 4:00 PM"), "Sample appointment") - - ' Creates a recurrence range, that specifies a limit of 10 occurrences for the appointment. - Dim range As New RecurrenceRange() - range.Start = recurringAppointment.Start - range.EventDuration = recurringAppointment.[End] - recurringAppointment.Start - range.MaxOccurrences = 5 - - ' Creates a recurrence rule to repeat the appointment on the last monday of every two months. - Dim rrule As New MonthlyRecurrenceRule(-1, RecurrenceDay.Monday, 2, range) - - Console.WriteLine("Appointment occurrs at the following times: ") - Dim ix As Integer = 0 - For Each occurrence As DateTime In rrule.Occurrences - ix = ix + 1 - Console.WriteLine("{0,2}: {1}", ix, occurrence.ToLocalTime()) - Next - End Sub - End Class - End Namespace - - ' - 'This example produces the following results: - ' - 'Appointment occurrs at the following times: - ' 1: 6/25/2007 3:30:00 PM - ' 2: 8/27/2007 3:30:00 PM - ' 3: 10/29/2007 2:30:00 PM - ' 4: 12/31/2007 2:30:00 PM - ' 5: 2/25/2008 2:30:00 PM - ' - - - The day ordinal modifier. See for additional information. - A bit mask that specifies the week days on which the event recurs. - The interval (in months) between the occurrences. - The instance that specifies the range of this rule. - - - - Gets the day of month on which the event recurs. - - The day of month on which the event recurs. - - - - Gets the day ordinal modifier. See for additional information. - - - The day ordinal modifier. - - - - Gets the month in which the event recurs. - - The month in which the event recurs. - - - Gets the interval (in months) between the occurrences. - The interval (in months) between the occurrences. - - - - Specifies the days of the week. Members might be combined using bitwise - operations to specify multiple days. - - - The constants in the enumeration might be combined - with bitwise operations to represent any combination of days. It is designed to be - used in conjunction with the class to filter - the days of the week for which the recurrence pattern applies. - - - Consider the following example that demonstrates the basic usage pattern of - RecurrenceDay. The most common operators used for manipulating bit fields - are: - - Bitwise OR: Turns a flag on. - Bitwise XOR: Toggles a flag. - Bitwise AND: Checks if a flag is turned on. - Bitwise NOT: Turns a flag off. - - - using System; - using Telerik.Web.UI; - - namespace RecurrenceExamples - { - class RecurrenceDayExample - { - static void Main() - { - // Selects Friday, Saturday and Sunday. - RecurrenceDay dayMask = RecurrenceDay.Friday | RecurrenceDay.WeekendDays; - PrintSelectedDays(dayMask); - - // Selects all days, except Thursday. - dayMask = RecurrenceDay.EveryDay ^ RecurrenceDay.Thursday; - PrintSelectedDays(dayMask); - } - - static void PrintSelectedDays(RecurrenceDay dayMask) - { - Console.WriteLine("Value: {0,3} - {1}", (int) dayMask, dayMask); - } - } - } - - /* - This example produces the following results: - - Value: 112 - Friday, WeekendDays - Value: 119 - Monday, Tuesday, Wednesday, Friday, WeekendDays - */ - - - Imports System - Imports Telerik.Web.UI - - Namespace RecurrenceExamples - Class RecurrenceDayExample - Shared Sub Main() - ' Selects Friday, Saturday and Sunday. - Dim dayMask As RecurrenceDay = RecurrenceDay.Friday Or RecurrenceDay.WeekendDays - PrintSelectedDays(dayMask) - - ' Selects all days, except Thursday. - dayMask = RecurrenceDay.EveryDay Xor RecurrenceDay.Thursday - PrintSelectedDays(dayMask) - End Sub - - Shared Sub PrintSelectedDays(ByVal dayMask As RecurrenceDay) - Console.WriteLine("Value: {0,3} - {1}", DirectCast(dayMask, Integer), dayMask) - End Sub - End Class - End Namespace - - ' - 'This example produces the following results: - ' - 'Value: 112 - Friday, WeekendDays - 'Value: 119 - Monday, Tuesday, Wednesday, Friday, WeekendDays - ' - - - - - Indicates no selected day. - - - Indicates Monday. - - - Indicates Tuesday. - - - Indicates Wednesday. - - - Indicates Thursday. - - - Indicates Friday. - - - Indicates Saturday. - - - Indicates Sunday. - - - Indicates the range from Sunday to Saturday inclusive. - - - Indicates the range from Monday to Friday inclusive. - - - Indicates the range from Saturday to Sunday inclusive. - - - Specifies the frequency of a recurrence. - - - Indicates no recurrence. - - - Indicates hourly recurrence. - - - Indicates daily recurrence. - - - Indicates weekly recurrence. - - - Indicates monthly recurrence. - - - Indicates yearly recurrence. - - - Specifies the months in which given event recurs. - - - Indicates no monthly recurrence. - - - Indicates that the event recurs in January. - - - Indicates that the event recurs in February. - - - Indicates that the event recurs in March. - - - Indicates that the event recurs in April. - - - Indicates that the event recurs in May. - - - Indicates that the event recurs in June. - - - Indicates that the event recurs in July. - - - Indicates that the event recurs in August. - - - Indicates that the event recurs in September. - - - Indicates that the event recurs in October. - - - Indicates that the event recurs in November. - - - Indicates that the event recurs in December. - - - - Specifies the pattern that uses to evaluate the - recurrence dates set. - - - - The properties of the class work together - to define a complete pattern definition to be used by the - engine. - - - You should not need to work with it directly as specialized - classes are provided for the supported modes - of recurrence. They take care of constructing appropriate - objects. - - - - - using System; - using Telerik.Web.UI; - - namespace RecurrenceExamples - { - class RecurrencePatternExample - { - static void Main() - { - // Creates a sample appointment that starts at 6/1/2007 3:30 PM and lasts half an hour. - Appointment recurringAppointment = new Appointment("1", Convert.ToDateTime("6/1/2007 3:30 PM"), - Convert.ToDateTime("6/1/2007 4:00 PM"), "Sample appointment"); - - // Creates a recurrence range, that specifies a limit of 10 occurrences for the appointment. - RecurrenceRange range = new RecurrenceRange(); - range.Start = recurringAppointment.Start; - range.EventDuration = recurringAppointment.End - recurringAppointment.Start; - range.MaxOccurrences = 10; - - // Creates a recurrence rule for the appointment. - DailyRecurrenceRule rrule = new DailyRecurrenceRule(1, range); - - // Displays the relevant parts of the generated pattern: - Console.WriteLine("The active recurrence pattern is:"); - Console.WriteLine(" Frequency: {0}", rrule.Pattern.Frequency); - Console.WriteLine(" Interval: {0}", rrule.Pattern.Interval); - Console.WriteLine(" Days of week: {0}\n", rrule.Pattern.DaysOfWeekMask); - - Console.WriteLine("Appointment occurrs at the following times: "); - int ix = 0; - foreach (DateTime occurrence in rrule.Occurrences) - { - ix = ix + 1; - Console.WriteLine("{0,2}: {1}", ix, occurrence.ToLocalTime()); - } - } - } - } - - /* - This example produces the following results: - - The active recurrence pattern is: - Frequency: Daily - Interval: 1 - Days of week: EveryDay - - Appointment occurrs at the following times: - 1: 6/1/2007 3:30:00 PM - 2: 6/2/2007 3:30:00 PM - 3: 6/3/2007 3:30:00 PM - 4: 6/4/2007 3:30:00 PM - 5: 6/5/2007 3:30:00 PM - 6: 6/6/2007 3:30:00 PM - 7: 6/7/2007 3:30:00 PM - 8: 6/8/2007 3:30:00 PM - 9: 6/9/2007 3:30:00 PM - 10: 6/10/2007 3:30:00 PM - */ - - - Imports System - Imports Telerik.Web.UI - - Namespace RecurrenceExamples - Class RecurrencePatternExample - Shared Sub Main() - ' Creates a sample appointment that starts at 6/1/2007 3:30 PM and lasts half an hour. - Dim recurringAppointment As New Appointment("1", Convert.ToDateTime("6/1/2007 3:30 PM"), Convert.ToDateTime("6/1/2007 4:00 PM"), "Sample appointment") - - ' Creates a recurrence range, that specifies a limit of 10 occurrences for the appointment. - Dim range As New RecurrenceRange() - range.Start = recurringAppointment.Start - range.EventDuration = recurringAppointment.[End] - recurringAppointment.Start - range.MaxOccurrences = 10 - - ' Creates a recurrence rule for the appointment. - Dim rrule As New DailyRecurrenceRule(1, range) - - ' Displays the relevant parts of the generated pattern: - Console.WriteLine("The active recurrence pattern is:") - Console.WriteLine(" Frequency: {0}", rrule.Pattern.Frequency) - Console.WriteLine(" Interval: {0}", rrule.Pattern.Interval) - Console.WriteLine(" Days of week: {0}" & Chr(10) & "", rrule.Pattern.DaysOfWeekMask) - - Console.WriteLine("Appointment occurrs at the following times: ") - Dim ix As Integer = 0 - For Each occurrence As DateTime In rrule.Occurrences - ix = ix + 1 - Console.WriteLine("{0,2}: {1}", ix, occurrence.ToLocalTime()) - Next - End Sub - End Class - End Namespace - - ' - 'This example produces the following results: - ' - 'The active recurrence pattern is: - ' Frequency: Daily - ' Interval: 1 - ' Days of week: EveryDay - ' - 'Appointment occurrs at the following times: - ' 1: 6/1/2007 3:30:00 PM - ' 2: 6/2/2007 3:30:00 PM - ' 3: 6/3/2007 3:30:00 PM - ' 4: 6/4/2007 3:30:00 PM - ' 5: 6/5/2007 3:30:00 PM - ' 6: 6/6/2007 3:30:00 PM - ' 7: 6/7/2007 3:30:00 PM - ' 8: 6/8/2007 3:30:00 PM - ' 9: 6/9/2007 3:30:00 PM - '10: 6/10/2007 3:30:00 PM - ' - - - - - - Overloaded. Overridden. Returns a value indicating whether this instance is equal - to a specified object. - - - true if value is an instance of - and equals the value of this instance; - otherwise, false. - - An object to compare with this instance. - - - Overriden. Returns the hash code for this instance. - The hash code for this instance. - - - - Overloaded. Overridden. Returns a value indicating whether this instance is equal - to a specified object. - - - true if value equals the value of this instance; - otherwise, false. - - An object to compare with this instance. - - - - Determines whether two specified objects have the - same value. - - - - - Determines whether two specified objects have - different values. - - - - - - A enumerated constant that indicates the - frequency of recurrence. - - - Gets or sets the frequency of recurrence. - The default value is . - RecurrenceFrequency Enumeration - - - Gets or sets the interval of recurrence. - - - A positive integer representing how often the recurrence rule repeats, - expressed in units. - - - The default value is 1. - - - - Gets or sets the bit mask that specifies the week days on which the event - recurs. - - RecurrenceDay Enumeration - - For additional information on how to create masks see the - documentation. - - A bit mask that specifies the week days on which the event recurs. - - - Gets or sets the day month on which the event recurs. - The day month on which the event recurs. - - - - - This property is meaningful only when is - set to or - and - is not set. - - In such scenario it selects the n-th occurrence within the set of events - specified by the rule. Valid values are from -31 to +31, 0 is ignored. - For example with RecurrenceFrequency set to Monthly and DaysOfWeekMask set to - Monday DayOfMonth is interpreted in the following way: - - -
    -
  • 1: Selects the first monday of the month.
  • -
  • 3: Selects the third monday of the month.
  • -
  • -1: Selects the last monday of the month.
  • -
-
-
- - For detailed examples see the documentation of the - class. - -
- MonthlyRecurrenceRule Class -
- - Gets or sets the month on which the event recurs. - - This property is only meaningful when is set - to . - - - - Gets or sets the day on which the week starts. - - This property is only meaningful when is set - to and is greater than 1. - - - - - - Specifies the time frame for which given is - active. It consists of the start time of the event, it's duration and optional - limits. - - - - - Limits for both occurrence count and end date can be specified via the - and - properties. - - - Start and EventDuration properties refer to the recurring event's start and - duration. In the context of they are usually - derived from and . - - - - - using System; - using Telerik.Web.UI; - - namespace RecurrenceExamples - { - class RecurrenceRangeExample - { - static void Main() - { - // Creates a sample appointment that starts at 6/1/2007 3:30 PM and lasts half an hour. - Appointment recurringAppointment = new Appointment("1", Convert.ToDateTime("6/1/2007 3:30 PM"), - Convert.ToDateTime("6/1/2007 4:00 PM"), "Sample appointment"); - - // Creates a recurrence range, that specifies a limit of 10 occurrences for the appointment. - RecurrenceRange range = new RecurrenceRange(); - range.Start = recurringAppointment.Start; - range.EventDuration = recurringAppointment.End - recurringAppointment.Start; - range.MaxOccurrences = 10; - - // Creates a daily recurrence rule for the appointment. - DailyRecurrenceRule rrule = new DailyRecurrenceRule(1, range); - - Console.WriteLine("Appointment occurrs at the following times: "); - int ix = 0; - foreach (DateTime occurrence in rrule.Occurrences) - { - ix = ix + 1; - Console.WriteLine("{0,2}: {1}", ix, occurrence.ToLocalTime()); - } - } - } - } - - /* - This example produces the following results: - - Appointment occurrs at the following times: - 1: 6/1/2007 3:30:00 PM - 2: 6/2/2007 3:30:00 PM - 3: 6/3/2007 3:30:00 PM - 4: 6/4/2007 3:30:00 PM - 5: 6/5/2007 3:30:00 PM - 6: 6/6/2007 3:30:00 PM - 7: 6/7/2007 3:30:00 PM - 8: 6/8/2007 3:30:00 PM - 9: 6/9/2007 3:30:00 PM - 10: 6/10/2007 3:30:00 PM - */ - - - Imports System - Imports Telerik.Web.UI - - Namespace RecurrenceExamples - Class RecurrenceRangeExample - Shared Sub Main() - ' Creates a sample appointment that starts at 6/1/2007 3:30 PM and lasts half an hour. - Dim recurringAppointment As New Appointment("1", Convert.ToDateTime("6/1/2007 3:30 PM"), Convert.ToDateTime("6/1/2007 4:00 PM"), "Sample appointment") - - ' Creates a recurrence range, that specifies a limit of 10 occurrences for the appointment. - Dim range As New RecurrenceRange() - range.Start = recurringAppointment.Start - range.EventDuration = recurringAppointment.[End] - recurringAppointment.Start - range.MaxOccurrences = 10 - - ' Creates a daily recurrence rule for the appointment. - Dim rrule As New DailyRecurrenceRule(1, range) - - Console.WriteLine("Appointment occurrs at the following times: ") - Dim ix As Integer = 0 - For Each occurrence As DateTime In rrule.Occurrences - ix = ix + 1 - Console.WriteLine("{0,2}: {1}", ix, occurrence.ToLocalTime()) - Next - End Sub - End Class - End Namespace - - ' - 'This example produces the following results: - ' - 'Appointment occurrs at the following times: - ' 1: 6/1/2007 3:30:00 PM - ' 2: 6/2/2007 3:30:00 PM - ' 3: 6/3/2007 3:30:00 PM - ' 4: 6/4/2007 3:30:00 PM - ' 5: 6/5/2007 3:30:00 PM - ' 6: 6/6/2007 3:30:00 PM - ' 7: 6/7/2007 3:30:00 PM - ' 8: 6/8/2007 3:30:00 PM - ' 9: 6/9/2007 3:30:00 PM - '10: 6/10/2007 3:30:00 PM - ' - - - - - - Overloaded. Initializes a new instance of the - class. - - - - - Overloaded. Initializes a new instance of the - class with to the specified Start, EventDuration, RecursUntil and MaxOccurrences - values. - - The start of the recurring event. - The duration of the recurring event. - - Optional end date for the recurring appointment. Defaults to no end date - (DateTime.MaxValue). - - - Optional limit for the number of occurrences. Defaults to no limit - (Int32.MaxInt). - - - - - Overloaded. Overridden. Returns a value indicating whether this instance is equal - to a specified object. - - - true if value is an instance of - and equals the value of this instance; - otherwise, false. - - An object to compare with this instance. - - - Overriden. Returns the hash code for this instance. - - - - Overloaded. Overridden. Returns a value indicating whether this instance is equal - to a specified object. - - - true if value equals the value of this instance; - otherwise, false. - - An object to compare with this instance. - - - - Determines whether two specified objects have the - same value. - - - - - Determines whether two specified objects have - different values. - - - - The start of the recurring event. - - - The duration of the recurring event. - - - - Optional end date for the recurring appointment. Defaults to no end date - (DateTime.MaxValue). - - - - - Optional limit for the number of occurrences. Defaults to no limit - (Int32.MaxInt). - - - - - Optional limit for the number of occurrences. Defaults to no limit - (Int32.MaxInt). - - - - - Provides a type converter to convert RecurrenceRule objects to and from string - representation. - - - - - Overloaded. Returns whether this converter can convert an object of one type to - the type of this converter. - - - - - Overloaded. Converts the given value to the type of this converter. - - - - - Overloaded. Returns whether this converter can convert the object to the - specified type. - - - - Overloaded. Converts the given value object to the specified type. - - - Overloaded. Returns whether the given value object is valid for this type. - - - Occurrences of this rule repeat on a weekly basis. - - - using System; - using Telerik.Web.UI; - - namespace RecurrenceExamples - { - class WeeklyRecurrenceRuleExample - { - static void Main() - { - // Creates a sample appointment that starts at 6/1/2007 3:30 PM (local time) and lasts half an hour. - Appointment recurringAppointment = new Appointment("1", Convert.ToDateTime("6/1/2007 3:30 PM"), - Convert.ToDateTime("6/1/2007 4:00 PM"), "Sample appointment"); - - // Creates a recurrence range, that specifies a limit of 10 occurrences for the appointment. - RecurrenceRange range = new RecurrenceRange(); - range.Start = recurringAppointment.Start; - range.EventDuration = recurringAppointment.End - recurringAppointment.Start; - range.MaxOccurrences = 10; - - // Creates a recurrence rule to repeat the appointment every two weeks on Mondays and Tuesdays. - RecurrenceDay mask = RecurrenceDay.Monday | RecurrenceDay.Tuesday; - WeeklyRecurrenceRule rrule = new WeeklyRecurrenceRule(2, mask, range); - - Console.WriteLine("Appointment occurrs at the following times: "); - int ix = 0; - foreach (DateTime occurrence in rrule.Occurrences) - { - ix = ix + 1; - Console.WriteLine("{0,2}: {1} ({2})", ix, occurrence.ToLocalTime(), occurrence.DayOfWeek); - } - } - } - } - - /* - This example produces the following results: - - Appointment occurrs at the following times: - 1: 6/4/2007 3:30:00 PM (Monday) - 2: 6/5/2007 3:30:00 PM (Tuesday) - 3: 6/18/2007 3:30:00 PM (Monday) - 4: 6/19/2007 3:30:00 PM (Tuesday) - 5: 7/2/2007 3:30:00 PM (Monday) - 6: 7/3/2007 3:30:00 PM (Tuesday) - 7: 7/16/2007 3:30:00 PM (Monday) - 8: 7/17/2007 3:30:00 PM (Tuesday) - 9: 7/30/2007 3:30:00 PM (Monday) - 10: 7/31/2007 3:30:00 PM (Tuesday) - */ - - - Imports System - Imports Telerik.Web.UI - - Namespace RecurrenceExamples - Class WeeklyRecurrenceRuleExample - Shared Sub Main() - ' Creates a sample appointment that starts at 6/1/2007 3:30 PM (local time) and lasts half an hour. - Dim recurringAppointment As New Appointment("1", Convert.ToDateTime("6/1/2007 3:30 PM"), Convert.ToDateTime("6/1/2007 4:00 PM"), "Sample appointment") - - ' Creates a recurrence range, that specifies a limit of 10 occurrences for the appointment. - Dim range As New RecurrenceRange() - range.Start = recurringAppointment.Start - range.EventDuration = recurringAppointment.[End] - recurringAppointment.Start - range.MaxOccurrences = 10 - - ' Creates a recurrence rule to repeat the appointment every two weeks on Mondays and Tuesdays. - Dim mask As RecurrenceDay = RecurrenceDay.Monday Or RecurrenceDay.Tuesday - Dim rrule As New WeeklyRecurrenceRule(2, mask, range) - - Console.WriteLine("Appointment occurrs at the following times: ") - Dim ix As Integer = 0 - For Each occurrence As DateTime In rrule.Occurrences - ix = ix + 1 - Console.WriteLine("{0,2}: {1} ({2})", ix, occurrence.ToLocalTime(), occurrence.DayOfWeek) - Next - End Sub - End Class - End Namespace - - ' - 'This example produces the following results: - ' - 'Appointment occurrs at the following times: - ' 1: 6/4/2007 3:30:00 PM (Monday) - ' 2: 6/5/2007 3:30:00 PM (Tuesday) - ' 3: 6/18/2007 3:30:00 PM (Monday) - ' 4: 6/19/2007 3:30:00 PM (Tuesday) - ' 5: 7/2/2007 3:30:00 PM (Monday) - ' 6: 7/3/2007 3:30:00 PM (Tuesday) - ' 7: 7/16/2007 3:30:00 PM (Monday) - ' 8: 7/17/2007 3:30:00 PM (Tuesday) - ' 9: 7/30/2007 3:30:00 PM (Monday) - '10: 7/31/2007 3:30:00 PM (Tuesday) - ' - - - - - - Initializes a new instance of with the - specified interval, days of week bit mask and . - - The number of weeks between the occurrences. - A bit mask that specifies the week days on which the event recurs. - - The instance that specifies the range of this rule. - - - - - Initializes a new instance of with the - specified interval, days of week bit mask and . - - The number of weeks between the occurrences. - A bit mask that specifies the week days on which the event recurs. - - The instance that specifies the range of this rule. - - - The first day of week to use for calculations. - - - - Gets the interval (in weeks) assigned to the current instance. - The interval (in weeks) assigned to the current instance. - - - - Gets the bit mask that specifies the week days on which the event - recurs. - - RecurrenceDay Enumeration - - For additional information on how to create masks see the - documentation. - - A bit mask that specifies the week days on which the event recurs. - - - - Occurrences of this rule repeat on a yearly basis. - - - - using System; - using Telerik.Web.UI; - - namespace RecurrenceExamples - { - class YearlyRecurrenceRuleExample1 - { - static void Main() - { - // Creates a sample appointment that starts at 4/1/2007 10:00 AM (local time) and lasts half an hour. - Appointment recurringAppointment = new Appointment("1", Convert.ToDateTime("4/1/2007 10:00 AM"), - Convert.ToDateTime("4/1/2007 10:30 AM"), "Sample appointment"); - - // Creates a recurrence range, that specifies a limit of 10 occurrences for the appointment. - RecurrenceRange range = new RecurrenceRange(); - range.Start = recurringAppointment.Start; - range.EventDuration = recurringAppointment.End - recurringAppointment.Start; - range.MaxOccurrences = 5; - - // Creates a recurrence rule to repeat the appointment on the 1th of April each year. - YearlyRecurrenceRule rrule = new YearlyRecurrenceRule(RecurrenceMonth.April, 1, range); - - Console.WriteLine("Appointment occurrs at the following times: "); - int ix = 0; - foreach (DateTime occurrence in rrule.Occurrences) - { - ix = ix + 1; - Console.WriteLine("{0,2}: {1}", ix, occurrence.ToLocalTime()); - } - } - } - } - - /* - This example produces the following results: - - Appointment occurrs at the following times: - 1: 4/1/2007 10:00:00 AM - 2: 4/1/2008 10:00:00 AM - 3: 4/1/2009 10:00:00 AM - 4: 4/1/2010 10:00:00 AM - 5: 4/1/2011 10:00:00 AM - */ - - - Imports System - Imports Telerik.Web.UI - - Namespace RecurrenceExamples - Class YearlyRecurrenceRuleExample1 - Shared Sub Main() - ' Creates a sample appointment that starts at 4/1/2007 10:00 AM (local time) and lasts half an hour. - Dim recurringAppointment As New Appointment("1", Convert.ToDateTime("4/1/2007 10:00 AM"), Convert.ToDateTime("4/1/2007 10:30 AM"), "Sample appointment") - - ' Creates a recurrence range, that specifies a limit of 10 occurrences for the appointment. - Dim range As New RecurrenceRange() - range.Start = recurringAppointment.Start - range.EventDuration = recurringAppointment.[End] - recurringAppointment.Start - range.MaxOccurrences = 5 - - ' Creates a recurrence rule to repeat the appointment on the 1th of April each year. - Dim rrule As New YearlyRecurrenceRule(RecurrenceMonth.April, 1, range) - - Console.WriteLine("Appointment occurrs at the following times: ") - Dim ix As Integer = 0 - For Each occurrence As DateTime In rrule.Occurrences - ix = ix + 1 - Console.WriteLine("{0,2}: {1}", ix, occurrence.ToLocalTime()) - Next - End Sub - End Class - End Namespace - - ' - 'This example produces the following results: - ' - 'Appointment occurrs at the following times: - ' 1: 4/1/2007 10:00:00 AM - ' 2: 4/1/2008 10:00:00 AM - ' 3: 4/1/2009 10:00:00 AM - ' 4: 4/1/2010 10:00:00 AM - ' 5: 4/1/2011 10:00:00 AM - ' - - - - - - Initializes a new instance of the class. - - - - using System; - using Telerik.Web.UI; - - namespace RecurrenceExamples - { - class YearlyRecurrenceRuleExample1 - { - static void Main() - { - // Creates a sample appointment that starts at 4/1/2007 10:00 AM (local time) and lasts half an hour. - Appointment recurringAppointment = new Appointment("1", Convert.ToDateTime("4/1/2007 10:00 AM"), - Convert.ToDateTime("4/1/2007 10:30 AM"), "Sample appointment"); - - // Creates a recurrence range, that specifies a limit of 10 occurrences for the appointment. - RecurrenceRange range = new RecurrenceRange(); - range.Start = recurringAppointment.Start; - range.EventDuration = recurringAppointment.End - recurringAppointment.Start; - range.MaxOccurrences = 5; - - // Creates a recurrence rule to repeat the appointment on the 1th of April each year. - YearlyRecurrenceRule rrule = new YearlyRecurrenceRule(RecurrenceMonth.April, 1, range); - - Console.WriteLine("Appointment occurrs at the following times: "); - int ix = 0; - foreach (DateTime occurrence in rrule.Occurrences) - { - ix = ix + 1; - Console.WriteLine("{0,2}: {1}", ix, occurrence.ToLocalTime()); - } - } - } - } - - /* - This example produces the following results: - - Appointment occurrs at the following times: - 1: 4/1/2007 10:00:00 AM - 2: 4/1/2008 10:00:00 AM - 3: 4/1/2009 10:00:00 AM - 4: 4/1/2010 10:00:00 AM - 5: 4/1/2011 10:00:00 AM - */ - - - Imports System - Imports Telerik.Web.UI - - Namespace RecurrenceExamples - Class YearlyRecurrenceRuleExample1 - Shared Sub Main() - ' Creates a sample appointment that starts at 4/1/2007 10:00 AM (local time) and lasts half an hour. - Dim recurringAppointment As New Appointment("1", Convert.ToDateTime("4/1/2007 10:00 AM"), Convert.ToDateTime("4/1/2007 10:30 AM"), "Sample appointment") - - ' Creates a recurrence range, that specifies a limit of 10 occurrences for the appointment. - Dim range As New RecurrenceRange() - range.Start = recurringAppointment.Start - range.EventDuration = recurringAppointment.[End] - recurringAppointment.Start - range.MaxOccurrences = 5 - - ' Creates a recurrence rule to repeat the appointment on the 1th of April each year. - Dim rrule As New YearlyRecurrenceRule(RecurrenceMonth.April, 1, range) - - Console.WriteLine("Appointment occurrs at the following times: ") - Dim ix As Integer = 0 - For Each occurrence As DateTime In rrule.Occurrences - ix = ix + 1 - Console.WriteLine("{0,2}: {1}", ix, occurrence.ToLocalTime()) - Next - End Sub - End Class - End Namespace - - ' - 'This example produces the following results: - ' - 'Appointment occurrs at the following times: - ' 1: 4/1/2007 10:00:00 AM - ' 2: 4/1/2008 10:00:00 AM - ' 3: 4/1/2009 10:00:00 AM - ' 4: 4/1/2010 10:00:00 AM - ' 5: 4/1/2011 10:00:00 AM - ' - - - The month in which the event recurs. - The day of month on which the event recurs. - The instance that specifies the range of this rule. - - - - Initializes a new instance of the class. - - - - using System; - using Telerik.Web.UI; - - namespace RecurrenceExamples - { - class YearlyRecurrenceRuleExample2 - { - static void Main() - { - // Creates a sample appointment that starts at 4/1/2007 10:00 AM (local time) and lasts half an hour. - Appointment recurringAppointment = new Appointment("1", Convert.ToDateTime("4/1/2007 10:00 AM"), - Convert.ToDateTime("4/1/2007 10:30 AM"), "Sample appointment"); - - // Creates a recurrence range, that specifies a limit of 10 occurrences for the appointment. - RecurrenceRange range = new RecurrenceRange(); - range.Start = recurringAppointment.Start; - range.EventDuration = recurringAppointment.End - recurringAppointment.Start; - range.MaxOccurrences = 5; - - // Creates a recurrence rule to repeat the appointment on the second monday of April each year. - YearlyRecurrenceRule rrule = new YearlyRecurrenceRule(2, RecurrenceMonth.April, RecurrenceDay.Monday, range); - - Console.WriteLine("Appointment occurrs at the following times: "); - int ix = 0; - foreach (DateTime occurrence in rrule.Occurrences) - { - ix = ix + 1; - Console.WriteLine("{0,2}: {1}", ix, occurrence.ToLocalTime()); - } - } - } - } - - /* - This example produces the following results: - - Appointment occurrs at the following times: - 1: 4/9/2007 10:00:00 AM - 2: 4/14/2008 10:00:00 AM - 3: 4/13/2009 10:00:00 AM - 4: 4/12/2010 10:00:00 AM - 5: 4/11/2011 10:00:00 AM - */ - - - Imports System - Imports Telerik.Web.UI - - Namespace RecurrenceExamples - Class YearlyRecurrenceRuleExample2 - Shared Sub Main() - ' Creates a sample appointment that starts at 4/1/2007 10:00 AM (local time) and lasts half an hour. - Dim recurringAppointment As New Appointment("1", Convert.ToDateTime("4/1/2007 10:00 AM"), Convert.ToDateTime("4/1/2007 10:30 AM"), "Sample appointment") - - ' Creates a recurrence range, that specifies a limit of 10 occurrences for the appointment. - Dim range As New RecurrenceRange() - range.Start = recurringAppointment.Start - range.EventDuration = recurringAppointment.[End] - recurringAppointment.Start - range.MaxOccurrences = 5 - - ' Creates a recurrence rule to repeat the appointment on the second monday of April each year. - Dim rrule As New YearlyRecurrenceRule(2, RecurrenceMonth.April, RecurrenceDay.Monday, range) - - Console.WriteLine("Appointment occurrs at the following times: ") - Dim ix As Integer = 0 - For Each occurrence As DateTime In rrule.Occurrences - ix = ix + 1 - Console.WriteLine("{0,2}: {1}", ix, occurrence.ToLocalTime()) - Next - End Sub - End Class - End Namespace - - ' - 'This example produces the following results: - ' - 'Appointment occurrs at the following times: - ' 1: 4/9/2007 10:00:00 AM - ' 2: 4/14/2008 10:00:00 AM - ' 3: 4/13/2009 10:00:00 AM - ' 4: 4/12/2010 10:00:00 AM - ' 5: 4/11/2011 10:00:00 AM - ' - - - The day ordinal modifier. See for additional information. - The month in which the event recurs. - A bit mask that specifies the week days on which the event recurs. - The instance that specifies the range of this rule. - - - - Gets the day of month on which the event recurs. - - The day of month on which the event recurs. - - - - Gets the day ordinal modifier. See for additional information. - - The day ordinal modifier. - - - - Gets the month in which the event recurs. - - The month in which the event recurs. - - - - Gets the bit mask that specifies the week days on which the event - recurs. - - RecurrenceDay Enumeration - - For additional information on how to create masks see the - documentation. - - A bit mask that specifies the week days on which the event recurs. - - - - Gets or sets a value indicating the resource primary key value. - - - The resource primary key value. - - - - - Gets or sets a value indicating the user-friendly description of the resource. - - - The user-friendly description of the resource. - - - - - Gets or sets a value indicating the resource type. - - - The resource type. - - - The type must be one of the described resource types in - ResourceTypes collection. - - - - - Gets or sets a value indicating if the resource is a available. - - - A value indicating if the resource is a available. - - - Resources marked as unavailable will not be visible - in the drop-down lists in the advanced form (if applicable). - - - - - Gets or sets the cascading style sheet (CSS) class rendered for appointments that use this resource. - - - The cascading style sheet (CSS) class rendered for appointments that use this resource. - The default value is Empty. - - - You can define your own CSS class name or use some of the predefined class names: - - rsCategoryRed - rsCategoryBlue - rsCategoryOrange - rsCategoryGreen - - - - - - Gets the collection of arbitrary attributes that do not correspond to properties on the resource. - - - A System.Web.UI.AttributeCollection of name and value pairs. - - - - - Gets or sets the data item represented by the - Resource object in the - RadScheduler control. - - - This property is available only during data binding. - - - - - Gets the first resource (if any) of the specified type. - - The type of resource to search for. - The first resource of the specified type; null if no resource matches. - - - - Gets the resources of the specified type. - - The type of resource to search for. - The resources of the specified type. - - - - Gets the resource that matches the specified type and key. - - The type. - The key. - The resource that matches the specified type and key; null if no resource matches. - - - - For internal use only. - - - - - - - For internal use only. - - - - - - - For internal use only. - - - - - - - For internal use only. - - - - - - - For internal use only. - - - - - - - Represents a directory item in the FileBrowser control. - - - - - The base class of the FileItem and DirectoryItem classes. Contains the common functionality. - - - - - Serializes the item into a javascript array. This method should be overriden only when developing - a custom FileBrowser control. - - a StringWriter used as a target for the serialization. - - - - Utility method used when serializing. Escapes a string for javascript. - - - - - Utility method used when serializing. Writes a javascript array separator. - - - - - Utility method used when serializing. Removes the last javascript array separator from the underlying - StringBuilder of writer. - - - - - Serializes the Attributes array. - - - - - - Gets or sets a string array containing custom values which can be used on the client when - customizing the FileBrowser control. - - - - - Clears the Directories array. Can be used when building the directory list in List mode. - - - - - Serializes the directory item into a javascript array. This method should be overriden only when developing - a custom FileBrowser control. - - a StringWriter used as a target for the serialization. - - - - Serializes the children of the directory item as a javascript array. - Recursively calls the Serialize methods of all child objects. - - a StringWriter used as a target for the serialization. - - - - Creates an instance of the DirectoryItem class. - - The name of the directory item. - The location of the directory item. To let the FileBrowser control - automatically build its path you should set this parameter to string.Empty. If the DirectoryItem is a - root item, this parameter must contain the virtual location of the item. - The full virtual path of the directory item. Used by the ContentProvider for - populating the Directories and Files properties. - The tag of the directory item. Used when the virtual path must be different than the url of the item. - When the value of this property is set, the FileBrowser control uses it instead of the combined virtual path. - The permissions for this directory item. - A FileItem array containing all child file items. - A DirectoryItem array containing all child directory items. - - - - Gets the full virtual path to the directory item. - - - - - Gets the virtual location of the directory item. When the item is not root, the value - of this property should be string.Empty. The FileBrowser control recursively combines the names - of all parent directory items in order to get the full virtual path of the item. - - - - - Gets the name of the directory item. The value of this property is displayed in the FileBrowser control. - - - - - Gets the permissions for this directory item. - - - - - Gets the tag of the directory item. Used when the virtual path must be different than the url of the item. - When the value of this property is set, the FileBrowser control uses it instead of the combined virtual path. - - - - - Gets a DirectoryItem array containing all child directory items. - - - - - Gets a FileItem array containing all child file items. - - - - - This will set the width of the dropdown if it was set before. - - Unit containing the new default width - - - - Provides storage independent mechanism for uploading files and - populating the content of the FileBrowser dialog controls. - - - - - Creates a new instance of the class. Used internally by FileManager to create instances of the content provider. - - The current HttpContext. - Search patterns for files. Allows wildcards. - The paths which will be displayed in the FileManager. You can disregard - this value if you have custom mechanism for determining the rights for directory / file displaying. - The paths which will allow uploading in the FileManager. You can disregard this - value if you have custom mechanism for determining the rights for uploading. - The paths which will allow deleting in the dialog. You can disregard this - value if you have custom mechanism for determining the rights for deleting. - The selected url in the file browser. The file browser will navigate to the item - which has this url. - The selected tag in the file browser. The file browser will navigate to the - item which has this tag. - - - - Resolves a root directory with the given path in list mode. - - The virtual path of the directory. - A DirectoryItem array, containing the root directory and all child directories. - - - - Resolves a root directory with the given path in tree mode. - - The virtual path of the directory. - A DirectoryItem, containing the root directory. - - - - Resolves a directory with the given path. - - The virtual path of the directory. - A DirectoryItem, containing the directory. - - Used mainly in the Ajax calls. - - - - - Get the name of the file with the given url. - - The url of the file. - String containing the file name. - - - - Gets the virtual path of the item with the given url. - - The url of the item. - String containing the path of the item. - - - - Gets a read only Stream for accessing the file item with the given url. - - The url of the file. - Stream for accessing the contents of the file item with the given url. - - - - Stores an image with the given url and image format. - - The Bitmap object to be stored. - The url of the bitmap. - The image format of the bitmap. - string.Empty when the operation was successful; otherwise an error message token. - - Used when creating thumbnails in the ImageManager dialog. - - - - - Creates a file item from a HttpPostedFile to the given path with the given name. - - The uploaded HttpPostedFile to store. - The virtual path where the file item should be created. - The name of the file item. - Additional values to be stored such as Description, DisplayName, etc. - String containing the full virtual path (including the file name) of the file item. - - The default FileUploader control does not include the arguments parameter. If you need additional arguments - you should create your own FileUploader control. - - - - - Creates a file item from a Telerik.Web.UI.UploadedFile in the given path with the given name. - - The UploadedFile instance to store. - The virtual path where the file item should be created. - The name of the file item. - Additional values to be stored such as Description, DisplayName, etc. - String containing the full virtual path (including the file name) of the file item. - - The default FileUploader control does not include the arguments parameter. If you need additional arguments - you should create your own FileUploader control. - - - - - Deletes the file item with the given virtual path. - - The virtual path of the file item. - string.Empty when the operation was successful; otherwise an error message token. - - - - Deletes the directory item with the given virtual path. - - The virtual path of the directory item. - string.Empty when the operation was successful; otherwise an error message token. - - - - Creates a directory item in the given path with the given name. - - The path where the directory item should be created. - The name of the new directory item. - string.Empty when the operation was successful; otherwise an error message token. - - - - Moves a file from a one virtual path to a new one. This method can also be used for renaming items. - - old virtual location - new virtual location - string.Empty when the operation was successful; otherwise an error message token. - - - - Moves a directory from a one virtual path to a new one. This method can also be used for renaming items. - - old virtual location - new virtual location - string.Empty when the operation was successful; otherwise an error message token. - - - - Removes the protocol and the server names from the given url. - - Fully qualified url to a file or directory item. - The root based absolute path. - -

- Url: http://www.myserver.com/myapp/mydirectory/myfile - Result: /myapp/mydirectory/myfile -

-

- Url: www.myserver.com/myapp/mydirectory/myfile - Result: /myapp/mydirectory/myfile -

-
-
- - - The current display mode of the content provider. Can be FileBrowserDisplayMode.Tree or FileBrowserDisplayMode.List. - The value of this property is set by the FileBrowser control. - - - - - Gets a value indicating whether the ContentProvider can create directory items or not. The visibility of the - Create New Directory icon is controlled by the value of this property. - - - - - The HttpContext object, set in the constructor of the class. - - - - - Gets or sets the url of the selected item. The file browser will navigate to the item - which has this url. - - - - - Gets or sets the tag of the selected item. The file browser will navigate to the item - which has this tag. Used mainly in Database content providers, where the file items have - special url for accessing. - - - - - Gets the search patterns for the file items to be displayed in the FileBrowser control. This property - is set in the constructor of the class. Supports wildcards. - - - - - Gets the paths which will be displayed in the dialog. This is passed by RadEditor and is - one of the values of ImagesPaths, DocumentsPaths, MediaPaths, FlashPaths, TemplatesPaths properties. - You can disregard this value if you have custom mechanism for determining the rights for - directory / file displaying. - - - - - Gets the paths which will allow uploading in the dialog. This is passed by RadEditor and is - one of the values of UploadImagesPaths, UploadDocumentsPaths, UploadMediaPaths, UploadFlashPaths, - UploadTemplatesPaths properties. You can disregard this value if you have custom mechanism for determining the rights - for uploading. - - - - - The paths which will allow deleting in the dialog. This is passed by RadEditor and is - one of the values of DeleteImagesPaths, DeleteDocumentsPaths, DeleteMediaPaths, DeleteFlashPaths, - DeleteTemplatesPaths properties. You can disregard this value if you have custom mechanism for determining the rights - for deleting. - - - - - Represents a file item in the FileBrowser control. - - - - - Serializes the file item into a javascript array. This method should be overriden only when developing - a custom FileBrowser control. - - a StringWriter used as a target for the serialization. - - - - Creates an instance of the FileItem class. - - The name of the file item. The value of this property will be displayed in the FileBrowser control. - The file extension of the file item. - The size of the file item in bytes. - The virtual path of the parent directory item. When the value is string.Empty, the location is the - parent's full path. - The url which will be inserted into the RadEditor content area. - The tag of the file item. Used when the virtual path must be different than the url of the item. - When the value of this property is set, the FileBrowser control uses it instead of the combined virtual path. - The permissions on the file item. - - - - Gets the file extension of the file item. - - - - - Gets the size of the file item in bytes. - - - - - Gets the virtual path of the parent directory item. When the value is string.Empty, the location is got - from the item's parent. - - - - - Gets the url which will be inserted into the RadEditor content area. - - - - - Gets the name of the file item. The value of this property will be displayed in the FileBrowser control. - - - - - Gets the permissions on the file item. - - - - - Gets the tag of the file item. Used when the virtual path must be different than the url of the item. - When the value of this property is set, the FileBrowser control uses it instead of the combined virtual path. - - - - - Represents the actions which will be allowed on the FileBrowserItem. - - -

- If you want to specify multiple permissions, use the following syntax: -

-
-            Dim permissions As PathPermissions = PathPermissions.Read Or PathPermissions.Upload Or PathPermissions.Delete
-            
-
-
- - - The default permission. The FileBrowserItem can only be displayed. - - - - - Used for DirectoryItems. If enabled, the Upload tab of the dialog will be enabled when - the DirectoryItem is opened. - - - - - If enabled, the DirectoryItem or the FileItem can be deleted. - - - - - Container of misc. export settings of RadEditor control - - - - - A string specifying the name (without the extension) of the file that will be - created. The file extension is automatically added based on the method that is - used. - - - - Opens the exported editor content in a new window instead of the same page. - - - - Provides enumerated values to be used to set edit mode in RadEditor - This enumeration has a FlagsAttribute attribute that allows - a bitwise combination of its member values. - - - - - Design mode. The default edit mode in RadEditor, where you could edit HTML in WYSIWYG fashion. - - - - - HTML mode. Advanced edit mode where you could directly modify the HTML. - - - - - Preview mode. In this mode RadEditor will display its content the same way as it should be displayed when placed outside of the control. - - - - - Provides enumerated values to be used to set format cleaning options on - paste. - This enumeration has a FlagsAttribute attribute that allows - a bitwise combination of its member values. - - - - Doesn't strip anything on paste, asks a question when MS Word formatting detected. - - - Doesn't strip anything on paste and does not ask a question. - - - Strips only MSWord related attributes and tags on paste. - - - Strips the MSWord related attributes and tags and font tags on paste. - - - Strips MSWord related attributes and tags, font tags and font size attributes on paste. - - - Removes style attributes on paste. - - - Removes Font tags on paste. - - - Clears Span tags on paste. - - - Clears all tags except "br" and new lines (\n) on paste. - - - Remove all HTML formatting on paste. - - - - Provides enumerated values to be used to set the active content filters - This enumeration has a FlagsAttribute attribute that allows - a bitwise combination of its member values. - - - - - Causes a tooltip to open automatically when the page is loaded - - - - - Gets or sets a value indicating whether the tooltip will open automatically when its parent [aspx] page is loaded on the client. - - The default value is false. - - - - Get/Set the animation effect of the tooltip - - - - - Get/Set whether the tooltip will need to be closed manually by the user using the [x] button, or will close automatically - - - - - Get/Set whether the tooltip will hide when the mouse moves away from the target element, or when the mouse [enters] and moves out of the tooltip itself. - - - - - Get/Set the client event at which the tooltip will be hidden - - - - - Get/Set the client event at which the tooltip will be made visible for a particular target control - - - - - Get/Set the Width of the tooltip - - - - - Get/Set the Height of the tooltip - - - - - Get/Set the Text that will appear in the tooltip (if it should be other than the content of the 'title' attribute of the target element - - - - - Get/Set a title for the tooltip - - - - - Get/Set the top/left position of the tooltip relative to the target element - - - - - Get/Set overflow of the tooltip's content area - - - - - Get/Set whether the tooltip should appear relative to the mouse or to the target element. Works in coopearation with the Position property. - - - - - Get/Set the tooltip's horizontal offset from the target control. Works in coopearation with the Position property. - - - - - Get/Set the tooltip's vertical offset from the target control. Works in coopearation with the Position property. - - - - - Get/Set the delay after which the tooltip will hide if the mouse stands still over the target element. - - - - - Get/Set delay in miliseconds for the tooltip to hide after the mouse leaves the target element. - - - - - Get/Set the time for which the user should hold the mouse over a target element for the tooltip to appear - - - - - Get/Set whether the tooltip will move to follow mouse movement or will stay fixed. - - - - - Get/Set whether the tooltip will hide when the mouse moves away from the target element, or when the mouse [enters] and moves out of the tooltip itself. - - - - - Get/Set whether the tooltip should be added as a child of the root element or as a child of its direct parent. - - - - Gets or sets a value indicating whether a tooltip is modal or not. - The default value is false. - - - - Gets or sets a value indicating the client-side event handler that is called when - the RadToolTip control is initialized. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - If specified, the OnClientBeforeShow - client-side event handler is called before the RadToolTip - is shown. Two parameters are passed to the handler: - - sender, the RadToolTip object. - args. - - This event can be cancelled. - - - The following example demonstrates how to use the - OnClientBeforeShow property. - -
- <script type="text/javascript">
- function OnToolTipShowHandler(sender, args)
- {
- var tooltip = sender;
- }
- </script> -
-
- <radsld:RadToolTip ID="RadToolTip1"
- runat= "server"
- OnClientBeforeShow="OnToolTipShowHandler">
- ....
- </radsld:RadToolTip> -
-
-
-
- - - Gets or sets a value indicating the client-side event handler that is called before - the sliding is started. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - If specified, the OnClientShow - client-side event handler is called after the tooltip is shown - Two parameters are passed to the handler: - - sender, the RadToolTip object. - args. - - This event cannot be cancelled. - - - The following example demonstrates how to use the - OnClientShow property. - -
- <script type="text/javascript">
- function OnClientShowHandler(sender, args)
- {
- var tooltip = sender;
- }
- </script> -
-
- <radsld:RadToolTip ID="RadToolTip1"
- runat= "server"
- OnClientShow="OnClientShowHandler">
- ....
- </radsld:RadToolTip> -
-
-
-
- - - Gets or sets a value indicating the client-side event handler that is called - while the handle is being slided. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - If specified, the OnClientBeforeHide - client-side event handler that is called - before the tooltip is hidden. Two parameters are passed to the handler: - - sender, the RadToolTip object. - args. - - This event can be cancelled. - - - The following example demonstrates how to use the - OnClientBeforeHide property. - -
- <script type="text/javascript">
- function OnBeforeHideHandler(sender, args)
- {
- var tooltip = sender;
- }
- </script> -
-
- <radsld:RadToolTip ID="RadToolTip1"
- runat= "server"
- OnClientBeforeHide="OnBeforeHideHandler">
- ....
- </radsld:RadToolTip> -
-
-
-
- - - Gets or sets a value indicating the client-side event handler that is called - when slide has ended. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - If specified, the OnClientHide - client-side event handler that is called - after the tooltip is hidden. Two parameters are passed to the handler: - - sender, the RadToolTip object. - args. - - This event cannot be cancelled. - - - The following example demonstrates how to use the - OnClientHide property. - -
- <script type="text/javascript">
- function OnHideHandler(sender, args)
- {
- var tooltip = sender;
- }
- </script> -
-
- <radsld:RadToolTip ID="RadToolTip1"
- runat= "server"
- OnClientHide="OnHideHandler">
- ....
- </radsld:RadToolTip> -
-
-
-
- - - Get/Set the target control property of the tooltip - - - - - Get/Set whether the TargetControlID is server or client ID - - - - - Allows for dynamic content to be set into the tooltip with an ajax request. - The tooltip triggers the event when it is shown on the client. - - - A string specifying the name of the server-side event handler that will handle the - event. The default value is empty string. - - - If specified, the OnAjaxUpdate - is triggered when the tooltip is shown on the client. Two parameters are passed to the handler: - - sender, the RadToolTip object. - args. - - This event cannot be cancelled. - - - The following example demonstrates how to use the - OnAjaxUpdate property. - -
- <telerik:RadToolTip ID="RadToolTip1"
- runat= "server"
- OnAjaxUpdate="OnAjaxUpdate">
- ....
- </telerik:RadToolTip> -
-
-
-
- - - Gets the settings for the web service used to populate items. - - - An WebServiceSettings that represents the - web service used for populating items. - - - - Use the WebServiceSettings property to configure the web - service used to populate items on demand. - You must specify both - Path and - Method - to fully describe the service. - - - In order to use the integrated support, the web service should have the following signature: - - - [ScriptService] - public class WebServiceName : WebService - { - [WebMethod] - public string WebServiceMethodName(object context) - { - // We cannot use a dictionary as a parameter, because it is only supported by script services. - // The context object should be cast to a dictionary at runtime. - IDictionary<string, object> contextDictionary = (IDictionary<string, object>) context; - - //... - } - } - - - - - - - Gets or sets a value indicating the client-side event handler that is called when - the RadToolTipManager receives the server response from a WebService or AJAX request. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - If specified, the OnClientResponseEnd - client-side event handler is called before the RadToolTipManager - displays the content returned from the server. Two parameters are passed to the handler: - - sender, the RadToolTipManager object. - args. - - This event cannot be cancelled. - - - The following example demonstrates how to use the - OnClientResponseEnd property. - -
- <script type="text/javascript">
- function OnClientResponseEnd(sender, args)
- {
- var tooltipManager = sender;
- }
- </script> -
-
- <radsld:RadToolTipManager ID="RadToolTipManager1"
- runat= "server"
- OnClientResponseEnd="OnClientResponseEnd">
- ....
- </radsld:RadToolTipManager> -
-
-
-
- - - Gets or sets the id (ClientID if a runat=server is used) of a html element whose children will be tooltipified - - - - - Gets or sets a value whether the RadToolTipManager, when its TargetControls collection is empty will tooltipify automatically all elements on the page that have a 'title' attribute - - - - - Gets a collection of TargetControl objects that allows for specifying the objects for which tooltips will be created on the client-side. - - - Gets a collection of TargetControl objects that allows for specifying the objects for which tooltips will be created on the client-side. - - - Use the TargetControls collection to programmatically control which objects should be tooltipified on the client-side. - - - - - Gets a reference to the UpdatePanel property of RadToolTipManager. The UpdatePanel allows for sending AJAX content to the client-side during the OnAjaxUpdate event. - - - Gets a reference to the UpdatePanel property of RadToolTipManager. The UpdatePanel allows for sending AJAX content to the client-side during the OnAjaxUpdate event. - - - - - The ClientID of the target control for which the tooltip is currently being shown. - - - - - An optional parameter allowing arbitrary information to be passed from the client to the server to help determine what information to load in the tooltip in the AJAX request - - - - - Provides a reference to the UpdatePanel of RadToolTipManager. Allows content and controls to be set and displayed in the tooltip on the client - - - - - - - The byte array, which is currently being used - The index (distributed in the _bufferedBytes array and the chunk), - at which the field starts - The count of the field bytes to be added to the state store - Indicates if this is the final part of data - for the field (i.e. a boundary was found) - - - - Provides a way to access individual files that have been uploaded by a client - via a RadUpload control. - - - The UploadedFileCollection class provides access to all - files uploaded from a client via single RadUpload instance as a file collection. - UploadedFile provides properties and methods to get information on an - individual file and to read and save the file. Files are uploaded in MIME - multipart/form-data format and are NOT buffered in the server - memory if the RadUploadModule is used. - The RadUpload control must be used to select and upload - files from a client. - You can specify the maximum allowable upload file size in a machine.config or - Web.config configuration file in the maxRequestLength attribute of the - <httpRuntime> Element element. - - - Set the maximum allowable upload file size to 1000kB - - <httpRuntime maxRequestLength="1000" /> - - - <httpRuntime maxRequestLength="1000" /> - - - - - - Returns the name and extension of the file on the client's computer. - - - A string consisting of the characters after the last directory character in file name on the client's computer. - - - The separator characters used to determine the start of the - file name are DirectorySeparatorChar and AltDirectorySeparatorChar. - - - - - Returns the name of the file on the client's computer without the extension. - - - A string containing the name of the file on the client's computer without the extension. - - - A string containing the string returned by GetFileName, minus the last period (.) and all characters following it. - - - - - Returns the extension of the file on the client's computer. - - - A string containing the extension of the file including the ".". If the file name does not have - extension information, GetExtension returns string.Empty. - - - The extension of the file name is obtained by searching it for a period (.), starting with the last character - and continuing toward the start. If a period is found before a DirectorySeparatorChar or AltDirectorySeparatorChar - character, the returned string contains the period and the characters after it; otherwise, string.Empty is returned. - - - - - Returns the value of a custom field. - - - A string containing the value of the custom field with name fieldName - - The name of the field wich value will be retrieved - Check the general help for more information and an example. - - - - Returns the checked state of a custom field. - - - A string containing the checked state of the custom field with name fieldName - - The name of the field wich checked state will be retrieved - Check the general help for more information and an example. - - - Saves the contents of an uploaded file. - - The maximum allowed uploaded file size is 4MB by default. Maximum file size - can be specified in the machine.config or Web.config configuration files in the - maxRequestLength attribute of the <httpRuntime> element. - The ASP.NET process must have proper rights for writing on the folder where - the files are saved. - - - The following example saves all the files uploaded by the client to a folder named - "C:\TempFiles" on the Web server's local disk. - - Dim Loop1 As Integer - Dim TempFileName As String - Dim MyFileCollection As UploadedFileCollection = RadUpload1.UploadedFiles - - For Loop1 = 0 To MyFileCollection.Count - 1 - ' Create a new file name. - TempFileName = "C:\TempFiles\File_" & CStr(Loop1) - ' Save the file. - MyFileCollection(Loop1).SaveAs(TempFileName) - Next Loop1 - - - String TempFileName; - UploadedFileCollection MyFileCollection = RadUpload1.UploadedFiles; - - for (int Loop1 = 0; Loop1 < MyFileCollection.Count; Loop1++) - { - // Create a new file name. - TempFileName = "C:\\TempFiles\\File_" + Loop1.ToString(); - // Save the file. - MyFileCollection[Loop1].SaveAs(TempFileName); - } - - - - - Saves the contents of an uploaded file. - - The maximum allowed uploaded file size is 4MB by default. Maximum file size - can be specified in the machine.config or Web.config configuration files in the - maxRequestLength attribute of the <httpRuntime> element. - The ASP.NET process must have proper rights for writing on the folder where - the files are saved. - - - The following example saves all the files uploaded by the client to a folder named - "C:\TempFiles" on the Web server's local disk. The existing files are overwritten. - - Dim Loop1 As Integer - Dim TempFileName As String - Dim ShouldOverwrite As Boolean = True - Dim MyFileCollection As UploadedFileCollection = RadUpload1.UploadedFiles - - For Loop1 = 0 To MyFileCollection.Count - 1 - ' Create a new file name. - TempFileName = "C:\TempFiles\File_" & CStr(Loop1) - ' Save the file. - MyFileCollection(Loop1).SaveAs(TempFileName, ShouldOverwrite) - Next Loop1 - - - String TempFileName; - bool ShouldOverwrite = true; - UploadedFileCollection MyFileCollection = RadUpload1.UploadedFiles; - - for (int Loop1 = 0; Loop1 < MyFileCollection.Count; Loop1++) - { - // Create a new file name. - TempFileName = "C:\\TempFiles\\File_" + Loop1.ToString(); - // Save the file. - MyFileCollection[Loop1].SaveAs(TempFileName, ShouldOverwrite); - } - - - The name of the saved file. - - true to allow an existing file to be overwritten; otherwise, false. - - - - - Creates a UploadedFile instance from HttpPostedFile instance. - - The value of the name attribute of the file input field - (equals the UniqueID of the FileUpload control) - The HttpPostedFile instance. Usually, you could get this from a - ASP:FileUpload control's PostedFile property - - - - - Creates a UploadedFile instance from HttpPostedFile instance. - - The HttpPostedFile instance. Usually, you could get this from a - ASP:FileUpload control's PostedFile property - - - - Gets the size in bytes of an uploaded file. - The length of the file. - - This example validates the file size of an uploaded file. - - bool isValid = true; - if (file.ContentLength > MaxFileSize) - { - isValid = false; - } - - - Dim isValid As Boolean = True; - If file.ContentLength > MaxFileSize Then - isValid = False; - End If - - - - - Gets the MIME content type of a file sent by a client. - The MIME content type of the uploaded file. - - The following example loops through all the files in the uploaded files collection - and takes action when the MIME type of a file is US-ASCII . - - Dim Loop1 As Integer - Dim MyFileCollection As UploadedFileCollection = RadUpload1.UploadedFiles - - For Loop1 = 0 To MyFileCollection.Count - 1 - If MyFileCollection(Loop1).ContentType = "video/mpeg" Then - '... - End If - Next Loop1 - - - UploadedFileCollection MyFileCollection = RadUpload1.UploadedFiles; - - for (int Loop1 = 0; Loop1 < MyFileCollection.Count; Loop1++) - { - if (MyFileCollection[Loop1].ContentType == "video/mpeg") - { - //... - } - } - - - - - - Gets the fully-qualified name of the file on the client's computer (for example - "C:\MyFiles\Test.txt"). - - A string containing the fully-qualified name of the file on the client's computer. - - The following example assigns the name of an uploaded file (the first file in the - file collection) to a string variable. - - UploadedFile MyUploadedFile = RadUpload1.UploadedFiles[0]; - string MyFileName = MyUploadedFile.FileName; - - - Dim MyUploadedFile As UploadedFile = RadUpload1.UploadedFiles(0) - Dim MyFileName As String = MyUploadedFile.FileName - - - - - - Gets a Stream object which points to the uploaded file to prepare for reading the contents of the file. - - - A Stream pointing to the file. - - - - - RadProgressManager Control - - - - - Specifies the localization of the RadProgressArea (the language which will be used). - - The default value is en-US. - - - <radU:RadUpload Language="es-Es" ... /> - - - <radU:RadUpload Language="es-Es" ... /> - - - - - - Specifies the client-side function to be executed when the Progress Area status is about to be updated. - - The default value is string.Empty. - - This example demonstrates how to set a javascript function to execute when the - client side progress area is about to be updated. - - <radU:RadProgressArea OnClientProgressUpdating="myOnClientProgressUpdating" ... /> - ... - <script> - function myOnClientProgressUpdating() - { - alert("The progress will be updated"); - } - </script> - - - <radU:RadProgressArea OnClientProgressUpdating="myOnClientProgressUpdating" ... /> - ... - <script> - function myOnClientProgressUpdating() - { - alert("The progress will be updated"); - } - </script> - - - Microsoft .NET Framework - - - - Specifies the client-side function to be executed when a progress bar is about to be updated. - - The default value is string.Empty. - Microsoft .NET Framework - - - - Provides access to the localization strings of the control. - - - This example demonstrates how to change the localization strings of RadProgressArea - object with code. - - RadProgressArea1.Localization["CancelButton"] = "Cancel"; - RadProgressArea1.Localization["ElapsedTime"] = "Elapsed time: "; - RadProgressArea1.Localization["EstimatedTime"] = "Estimated time: "; - RadProgressArea1.Localization["TransferSpeed"] = "Speed: "; - RadProgressArea1.Localization["CurrentFileName"] = "Uploading file: "; - RadProgressArea1.Localization["Uploaded"] = "Uploaded "; - RadProgressArea1.Localization["UploadedFiles"] = "Uploaded files: "; - RadProgressArea1.Localization["Total"] = "Total "; - RadProgressArea1.Localization["TotalFiles"] = "Total files: "; - - - RadProgressArea1.Localization("CancelButton") = "Cancel" - RadProgressArea1.Localization("ElapsedTime") = "Elapsed time: " - RadProgressArea1.Localization("EstimatedTime") = "Estimated time: " - RadProgressArea1.Localization("TransferSpeed") = "Speed: " - RadProgressArea1.Localization("CurrentFileName") = "Uploading file: " - RadProgressArea1.Localization("Uploaded") = "Uploaded " - RadProgressArea1.Localization("UploadedFiles") = "Uploaded files: " - RadProgressArea1.Localization("Total") = "Total " - RadProgressArea1.Localization("TotalFiles") = "Total files: " - - - - Localization name/value collection. - - - This property is intended to be used when there is a need to access the localization - strings of the control from the code behind. - - - - - - - - - RadProgressManager control - - - - - - - - - Adds RadUrid=[GUID] parameter to the supplied URL. - - - Use this method to generate proper URL for cross page postbacks - which will enable RadMemoryOptimization and RadProgressArea. - - - This example demonstrates how to set the PostBackUrl property of a button - in order to enable RadMemoryOptimization and RadProgressArea. This example - will postback to the current page, but you could use URL of your choice. - - Button1.PostBackUrl = RadProgressManager1.ApplyUniquePageIdentifier(Request.Url.PathAndQuery) - - - Button1.PostBackUrl = RadProgressManager1.ApplyUniquePageIdentifier(Request.Url.PathAndQuery); - - - - - - Deprecated. Memory optimization is implemented as part of the .NET Framework and is no longer a feature of RadUpload. - - - - - Gets or sets a value indicating wether an error message will be displayed when the RadUploadHttpModule is not registered. - - - - - Gets or sets the period (in milliseconds) of the progress data refresh. - - - The period of the progress data refresh in milliseconds. The default value is - 500. - - - The refresh period might not be exactly the same as the value specified if - the AJAX request has not been completed before the upload. The minimum value is 50 - ms. - Note: If the value is very low (50ms) both the client CPU - and server CPU load would increase because of the increased number of AJAX requests - performed. - - - - - - - - - RadProgressManager's FormId property is not used anymore. Please, remove any assignments. - - - - Specifies which control objects will be visible on a RadUpload control. - - - Only the file inputs will be visible. - - - Display checkboxes for selecting a file input. - - - Display buttons for removing a file input. - - - Display buttons for clearing a file input. - - - Display button for adding a file input. - - - Display button for removing the file inputs with checked checkboxes. - - - CheckBoxes | RemoveButtons | AddButton | DeleteSelectedButton - - - - CheckBoxes | RemoveButtons | ClearButtons | AddButton | - DeleteSelectedButton - - - - - Telerik RadUpload - - - - - Fires the ValidatingFile event. - - - - - Fires the FileExists event. - - - - - Occurs before the internal validation of every file in the UploadedFiles collection. - - - To skip the internal validation of the file, set e.SkipInternalValidation = true. - - - This example demostrates how to implement custom validation for specific file type. - - - Private Sub RadUpload1_ValidatingFile(ByVal sender As Object, ByVal e As WebControls.ValidateFileEventArgs) Handles RadUpload1.ValidatingFile - If e.UploadedFile.GetExtension.ToLower = ".zip" Then - Dim maxZipFileSize As Integer = 10000000 '~10MB - If e.UploadedFile.ContentLength > maxZipFileSize Then - e.IsValid = False - End If - 'The zip files are not validated for file size, extension and mime type - e.SkipInternalValidation = True - End If - End Sub - - - private void RadUpload1_ValidatingFile(object sender, ValidateFileEventArgs e) - { - if (e.UploadedFile.GetExtension().ToLower() == ".zip") - { - int maxZipFileSize = 10000000; //~10MB - if (e.UploadedFile.ContentLength > maxZipFileSize) - { - e.IsValid = false; - } - //The zip files are not validated for file size, extension and content type - e.SkipInternalValidation = true; - } - } - - - MaxFileSize Property - AllowedMimeTypes Property - AllowedFileExtensions Property - - - - Occurs after an unsuccessful attempt for automatic saving of a file in the - UploadedFiles collection. - - - - This event should be consumed only when the automatic file saving is enabled by - setting the TargetFolder property. In this mode - the files are saved in the selected folder with the same name as on the client - computer. If a file with such name already exists in the - TargetFolder it is either overwritten or skipped - depending the value of the - OverwriteExistingFiles property. This - event is fired if - OverwriteExistingFiles is set to - false and a file with the same name already exists in the - TargetFolder. - - - - This example demostrates how to create custom logic for renaming and saving the - existing uploaded files. - - Private Sub RadUpload1_FileExists(ByVal sender As Object, ByVal e As WebControls.UploadedFileEventArgs) Handles RadUpload1.FileExists - Dim TheFile As Telerik.WebControls.UploadedFile = e.UploadedFile - - TheFile.SaveAs(Path.Combine(RadUpload1.TargetFolder, TheFile.GetNameWithoutExtension() + "1" + TheFile.GetExtension()), true) - End Sub - - - private void RadUpload1_FileExists(object sender, Telerik.WebControls.UploadedFileEventArgs e) - { - Telerik.WebControls.UploadedFile TheFile = e.UploadedFile; - - TheFile.SaveAs(Path.Combine(RadUpload1.TargetFolder, TheFile.GetNameWithoutExtension() + "1" + TheFile.GetExtension()), true); - } - - - OverwriteExistingFiles Property - TargetFolder Property - TargetPhysicalFolder Property - - - - Gets or sets the size of the file input field - - The default value is 23. - - - - Gets or sets the allowed file extensions for uploading. - - - Set this property to empty array of strings in order to prevent the file - extension checking. - Note that the file extensions must include the dot before the actual - extension. See the example below. - - - The default value is empty string array. In order to check for multiple file - extensions you should set an array of strings containing the allowed file extensions - for uploading. - - - This example demonstrates how to set multiple allowed file extensions in a - RadUpload control. - - Dim allowedFileExtensions As String() = New String(2) {".zip", ".doc", ".config"} - RadUpload1.AllowedFileExtensions = allowedFileExtensions - - - string[] allowedFileExtensions = new string[3] {".zip", ".doc", ".config"}; - RadUpload1.AllowedFileExtensions = allowedFileExtensions; - - - MaxFileSize Property - AllowedMimeTypes Property - ValidatingFile Event - - - - Gets or sets the allowed MIME types for uploading. - - - Set this property to string.Empty in order to prevent the - mime type checking. - - - The default value is empty string array. In order to check for multiple mime - types you should set an array of strings containing the allowed MIME types - for uploading. - - - This example demostrates how to set multiple allowed MIME types to a RadUpload - control. - - ' For example you can Get these from your web.config file - Dim commaSeparatedMimeTypes As String = "application/octet-stream,application/msword,video/mpeg" - - Dim allowedMimeTypes As String() = commaSeparatedMimeTypes.Split(",") - RadUpload1.AllowedMimeTypes = allowedMimeTypes - - - // For example you can get these from your web.config file - string commaSeparatedMimeTypes = "application/octet-stream,application/msword,video/mpeg"; - - string[] allowedMimeTypes = commaSeparatedMimeTypes.Split(','); - RadUpload1.AllowedMimeTypes = allowedMimeTypes; - - - MaxFileSize Property - AllowedFileExtensions Property - ValidatingFile Event - - - - Gets or sets the value indicating which control objects will be displayed. - - - The default value is ControlObjectsVisibility.Default. You can - set any combination of the enum values. - - - ControlObjectVisibility enum members - - - Member - Description - - - None - Only the file inputs will be visible. - - - CheckBoxes - Display checkboxes for selecting a file input. - - - RemoveButtons - Display buttons for removing a file input. - - - ClearButtons - Display buttons for clearing a file input. - - - AddButton - Display button for adding a file input. - - - DeleteSelectedButton - Display button for removing the file inputs with checked - checkboxes. - - - Default - CheckBoxes | RemoveButtons | AddButton | - DeleteSelectedButton - - - All - CheckBoxes | RemoveButtons | ClearButtons | AddButton | - DeleteSelectedButton - - - - - This example demostrates how to display only the Add and Remove buttons on a - RadUpload control. - - RadUpload1.ControlObjectsVisibility = Telerik.WebControls.ControlObjectsVisibility.AddButton Or _ - Telerik.WebControls.ControlObjectsVisibility.RemoveButtons - - - RadUpload1.ControlObjectsVisibility = Telerik.WebControls.ControlObjectsVisibility.AddButton | - Telerik.WebControls.ControlObjectsVisibility.RemoveButtons; - - - MaxFileInputsCount Property - InitialFileInputsCount Property - ControlObjectsVisibility Enumeration - - - - Gets or sets the value indicating whether the file input fields skinning will be enabled. - - - true when the file input skinning is enabled; otherwise false. - - - The <input type=file> DHTML elements are not skinnable by default. If the - EnableFileInputSkinning is true some browsers can have strange behaviour. - - - - - Gets or sets the initial count of file input fields, which will appear in RadUpload. - - - The file inputs count which will be available at startup. The default value is - 1. - - MaxFileInputsCount Property - ControlObjectsVisibility Property - - - - Provides access to the invalid files uploaded by the RadUpload - instance. This is populated only if a validation was set. - - - If the internal validation is enabled this collection contains the invalid - uploaded files for the particular instance of RadUpload - control. - - - - - Gets or sets the localization language of the RadUpload user interface. - - - A string containing the localization language of the RadUpload user inteface. The - default value is en-US. - - - - - Gets or sets the maximum file input fields that can be added to the control. - - The default value is 0 (unlimited). - - Using this property you can limit the maximum number of file inputs which can be - added to a RadUpload instance. - - InitialFileInputsCount Property - ControlObjectsVisibility Property - - - Gets or sets the maximum file size allowed for uploading in bytes. - The default value is 0 (unlimited). - Set this property to 0 in order to prevent the file size checking. - AllowedMimeTypes Property - AllowedFileExtensions Property - ValidatingFile Event - - - - Gets or sets the name of the client-side function which will be executed before - a new fileinput is added to a RadUpload instance. - - The default value is string.Empty. - - This example demonstrates how to create a javascript function which is called every - time when the used adds a new file input to the RadUpload instance. - - <radU:RadUpload OnClientAdding="myOnClientAdding" ... /> - ... - <script> - function myOnClientAdding() - { - alert("You just added a new file input."); - } - </script> - - - <radU:RadUpload OnClientAdding="myOnClientAdding" ... /> - ... - <script> - function myOnClientAdding() - { - alert("You just added a new file input."); - } - </script> - - - - - - Gets or sets the name of the client-side function which will be executed after - a new fileinput is added to a RadUpload instance. - - The default value is string.Empty. - - This example demonstrates how to create a javascript function which is called every - time when the used adds a new file input to the RadUpload instance. - - <radU:RadUpload OnClientAdded="myOnClientAdded" ... /> - ... - <script> - function myOnClientAdded() - { - alert("You just added a new file input."); - } - </script> - - - <radU:RadUpload OnClientAdded="myOnClientAdded" ... /> - ... - <script> - function myOnClientAdded() - { - alert("You just added a new file input."); - } - </script> - - - - - - Gets or sets the name of the client-side function which will be executed before a file input is deleted - from a RadUpload instance. - - The default value is string.Empty. - - This example demonstrates how to implement a confirmation dialog when removing a - file input item. - - <radU:RadUpload OnClientDeleting="myOnClientDeleting" ... /> - <script language="javascript"> - function myOnClientDeleting() - { - return prompt("Are you sure?"); - } - </script> - - - <radU:RadUpload OnClientDeleting="myOnClientDeleting" ... /> - <script language="javascript"> - function myOnClientDeleting() - { - Return prompt("Are you sure?"); - } - </script> - - - - If you want to cancel the deleting of the file input return - false in the javascript handler. - - - - - Gets or sets the name of the client-side function which will be executed before a fileinput field is - cleared in a RadUpload instance using the Clear button. - - The default value is string.Empty. - - This example demonstrates how to create a client side confirmation dialog when - clearing a file input item of a RadUpload instance. - - <radU:RadUpload OnClientClearing="myOnClientClearing" ... /> - ... - <script> - function myOnClientClearing() - { - return confirm("Are you sure you want to clear this input?"); - } - </script> - - - <radU:RadUpload OnClientClearing="myOnClientClearing" ... /> - ... - <script> - function myOnClientClearing() - { - Return confirm("Are you sure you want to clear this input?"); - } - </script> - - - - - - Gets or sets the name of the client-side function which will be executed when a file input value changed. - - The default value is string.Empty. - - - - Gets or sets the name of the client-side function which will be executed before the selected file inputs are removed. - - The default value is string.Empty. - - This example demonstrates how to create a client side confirmation dialog when - removing the selected file input items from a RadUpload control. - - <radU:RadUpload OnClientDeletingSelected="myOnClientDeletingSelected" ... /> - - <script> - function myOnClientDeletingSelected() - { - var mustCancel = confirm("Are you sure?"); - return mustCancel; - } - </script> - - - <radU:RadUpload OnClientDeletingSelected="myOnClientDeletingSelected" ... /> - - <script> - function myOnClientDeletingSelected() - { - var mustCancel = confirm("Are you sure?"); - return mustCancel; - } - </script> - - - - You can cancel the removing of the file input items by returning - false in the javascript function. - - - - - Gets or sets the value indicating whether RadUpload should overwrite existing files having same name in the TargetFolder. - - - true when the existing files should be overwritten; otherwise - false. The default value is false. - - - When set to true, the existing files are overwritten, else no - action is taken. - - FileExists Event - TargetFolder Property - TargetPhysicalFolder Property - - - - Gets or sets a value indicating if the file input fields should be read-only - (e.g. no typing allowed). - - - true when the file input fields should be read-only; otherwise - false. - - - When users type into the box and the filename is not valid, the form submission - in Internet Explorer could not proceed or even display a javascript error. This - behavior can be avoided by setting the ReadOnlyFileInputs property to true. - - - - - Gets or sets the virtual path of the folder, where RadUpload will automatically save the valid files after the upload completes. - - - A string containing the virtual path of the folder where RadUpload will automatically save the valid files - after the upload completes. The default value is string.Empty. - - - When set to string.Empty, the files must be saved manually to the desired location. - If both TargetPhysicalFolder property and this property are set, the - TargetPhysicalFolder will override the virtual path provided by TargetFolder. - - OverwriteExistingFiles Property - FileExists Event - TargetPhysicalFolder Property - - - - Gets or sets the physical path of the folder, where RadUpload will automatically save the valid files after the upload completes. - - - A string containing the physical path of the folder where RadUpload will automatically save the valid files - after the upload completes. The default value is string.Empty. - - - When set to string.Empty, the files must be saved manually to the desired location. - If both TargetFolder property and this property are set, the - TargetPhysicalFolder will override the virtual path provided by TargetFolder. - - TargetFolder Property - OverwriteExistingFiles Property - FileExists Event - - - - Provides access to the valid files uploaded by the RadUpload - instance. - - - UploadedFileCollection containing all valid files uploaded using - a RadUpload control. - - - The collection contains only the files uploaded with the particular instance of - the RadUpload control. If the RadUploadHttpModule is used, the - uploaded files are removed from the Request.Files collection in order - to conserve the server's memory. Else the Request.Files contains all uploaded files as - a HttpPostedFile collection and each RadUpload instance has its own - uploaded files as UploadedFileCollection. - - - This example demonstrates how to save the valid uploaded files with a - RadUpload control. - - For Each file As Telerik.WebControls.UploadedFile In RadUpload1.UploadedFiles - file.SaveAs(Path.Combine("c:\my files\", file.GetName()), True) - Next - - - foreach (Telerik.WebControls.UploadedFile file in RadUpload1.UploadedFiles) - { - file.SaveAs(Path.Combine(@"c:\my files\", file.GetName()), true); - } - - - - - Gets or sets the value indicating whether the first file input field of RadUpload should get - the focus on itself on load. - - true when the first file input field of RadUpload should get - the focus; otherwise false. The default value is false. - - - - - Gets a value indicating whether the RadUpload HttpModule is registered in the current web.application - - - - Provides access to and organizes files uploaded by a client. - - Clients encode files and transmit them in the content body using multipart MIME - format with an HTTP Content-Type header of multipart/form-data. RadUpload - extracts the encoded file(s) from the content body into individual members of an - UploadedFileCollection. Methods and properties of the - UploadedFile class provide access to the contents and properties of - each file. - - - - - Gets an individual UploadedFile object from the file - collection. - In C#, this property is the indexer for the - UploadedFileCollection class. - - The UploadedFile specified by index. - - The following example retrieves the first file object (index = 0) from the - collection sent by the client and retrieves the name of the actual file represented - by the object. - - Dim MyUploadedFile As UploadedFile = RadUpload1.UploadedFiles(0) - Dim MyFileName As String = UploadedFile.FileName - - - HttpPostedFile MyUploadedFile = RadUpload1.UploadedFiles[0]; - String MyFileName = MyUploadedFile.FileName; - - - UploadedFile Class - The index of the item to get from the file collection. - - - - Telerik RadWindow - - - - - Gets or sets the client callback function that will be called when a window - dialog is being closed. - - - - - - Gets or sets the id (ClientID if a runat=server is used) of a html element, whose - left and top position will be used as 0,0 of the RadWindow object when it is first - shown. - - - - - Gets or sets the id (ClientID if a runat=server is used) of a html element where - the windows will be "docked" when minimized. - - - - - Gets or sets the url of the icon in the upper left corner of the - RadWindow titlebar. - - - - - Gets or sets the url of the minimized icon of the - RadWindow. - - - - - Gets or sets a value indicating the behavior of this object - if can be resized, has expand/collapse commands, closed command, etc. - - - - - Gets or sets a value indicating the initial behavior of this object - most useful to specify an initially minimized, maximized or pinned window. - - - - - Get/Set the animation effect of the window - - - - - Get/Set the Width of the window - - - - - Get/Set the Height of the window - - - - - Get/Set a title for the window - - - - - Gets or sets the horizontal distance from the browser origin, or from the top left corner of the OffsetElement - - - - - Gets or sets the vertical distance from the browser origin, or from the top left corner of the OffsetElement - - - - - Gets or sets the id (ClientID if a runat=server is used) of a html element in which - the windows will be able to move. - - - - - Gets or sets a value indicating whether the window will be disposed and made inaccessible once it is closed. - If property is set to true, the next time a window with this ID is requested, a new window with default settings is created and returned. - - The default value is false. - - - - Gets or sets a value indicating whether the page that is loaded in the window should be loaded everytime from the server or - will leave the browser default behaviour. - - The default value is false. - - - - Gets or sets a value indicating whether the page that is loaded - in the window should be shown during the loading process, or when it has finished loading. - - The default value is true. - - - - Gets or sets a value indicating whether the window will open automatically when its parent [aspx] page is loaded on the client. - - The default value is false. - - - Gets or sets a value indicating whether the window has a titlebar visible. - The default value is true. - - - - Gets or sets a value indicating whether the window has a visible status bar or - not. - - The default value is true. - - - Gets or sets a value indicating whether a dialog is modal or not. - The default value is false. - - - Gets or sets a value indicating whether the window will create an overlay element. - The default value is false. - - - Gets or sets a value indicating whether the window will stay in the visible viewport of the browser window. - The default value is false. - - - Gets or sets a value indicating whether the window will automatically resize itself acciording to its content page or not. - The default value is false. - - - - Gets or sets the client-side script that executes when a RadWindow command (Restore, Minimize, Maximize, Pin On, Pin Off, Reload is raised - - - - - Gets or sets the client-side script that executes when a RadWindow Resize event is raised - - - - - Gets or sets the client-side script that executes when a RadWindow DragStart event is raised - - - - - Gets or sets the client-side script that executes when a RadWindow DragEnd event is raised - - - - - Gets or sets a value indicating the client-side event handler that is called when - the RadWindow control becomes the active visible window. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - If specified, the OnClientActivate - client-side event handler is called when the RadWindow - control becomes the active visible window Two parameters are passed to the handler: - - sender, the RadWindow object. - args. - - - - The following example demonstrates how to use the - OnClientActivate property. - -
- <script type="text/javascript">
- function OnWindowActivateHandler(sender, args)
- {
- var window = sender;
- }
- </script> -
-
- <radsld:RadWindow ID="RadWindow1"
- runat= "server"
- OnClientActivate="OnWindowActivateHandler">
- ....
- </radsld:RadWindow> -
-
-
-
- - - Gets or sets a value indicating the client-side event handler that is called before - the sliding is started. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - If specified, the OnClientShow - client-side event handler is called after the window is shown - Two parameters are passed to the handler: - - sender, the RadWindow object. - args. - - This event cannot be cancelled. - - - The following example demonstrates how to use the - OnClientShow property. - -
- <script type="text/javascript">
- function OnClientShowHandler(sender, args)
- {
- var window = sender;
- }
- </script> -
-
- <radsld:RadWindow ID="RadWindow1"
- runat= "server"
- OnClientShow="OnClientShowHandler">
- ....
- </radsld:RadWindow> -
-
-
-
- - - Gets or sets a value indicating the client-side event handler that is called - when the page inside the RadWindow object completes loading. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - If specified, the OnClientPageLoad - client-side event handler that is called - when the page inside the RadWindow object completes loading. Two parameters are passed to the handler: - - sender, the RadWindow object. - args. - - - - The following example demonstrates how to use the - OnClientPageLoad property. - -
- <script type="text/javascript">
- function OnPageLoadHandler(sender, args)
- {
- var window = sender;
- }
- </script> -
-
- <radsld:RadWindow ID="RadWindow1"
- runat= "server"
- OnClientPageLoad="OnPageLoadHandler">
- ....
- </radsld:RadWindow> -
-
-
-
- - - Gets or sets a value indicating the client-side event handler that is called - when slide has ended. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - If specified, the OnClientClose - client-side event handler that is called - after the window is hidden. Two parameters are passed to the handler: - - sender, the RadWindow object. - args. - - This event cannot be cancelled. - - - The following example demonstrates how to use the - OnClientClose property. - -
- <script type="text/javascript">
- function OnCloseHandler(sender, args)
- {
- var window = sender;
- }
- </script> -
-
- <radsld:RadWindow ID="RadWindow1"
- runat= "server"
- OnClientClose="OnCloseHandler">
- ....
- </radsld:RadWindow> -
-
-
-
- - - Gets or sets a value indicating the client-side event handler that is called - when the RadWindow is closing. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - If specified, the OnClientClosing - client-side event handler that is called - just before the window is hidden. Two parameters are passed to the handler: - - sender, the RadWindow object. - args. - - This event can be cancelled. - - - The following example demonstrates how to use the - OnClientClosing property. - -
- <script type="text/javascript">
- function OnClosingHandler(sender, args)
- {
- var window = sender;
- }
- </script> -
-
- <radsld:RadWindow ID="RadWindow1"
- runat= "server"
- OnClientClosing="OnClosingHandler">
- ....
- </radsld:RadWindow> -
-
-
-
- - - Get/Set the target control property of the tooltip - - - - - Specifies the URL that will originally be loaded in the - RadWindow (can be changed on the client). - - The default is Default. - - - - Gets a collection of RadWindow objects - - - Gets a collection of RadWindow objects - - - - - Gets or sets a value indicating whether window objects' state (size, location, behavior) will be - persisted in a client cookie to restore state over page postbacks. - - - - - This property allows to specify the HTML for the alert popup, which will override - the alerttemplate defined in the - Skins/CURRENT_SKIN/Window/CoreTemplates.xml file. - - - - - This property allows to specify the HTML for the confirm popup, which will - override the alerttemplate defined in the - Skins/CURRENT_SKIN/Window/CoreTemplates.xml file. - - - - - This property allows to specify the HTML for the prompt popup, which will - override the alerttemplate defined in the - Skins/CURRENT_SKIN/Window/CoreTemplates.xml file. - - - - - Specifies the behaviors of the radWindow object - - - - - No behavior is specified. - - 0 - - - - The object can be resized. - - 1 - - - - The object can be minimized. - - 2 - - - - The object can be closed. - - 4 - - - - The objct can be pinned. - - 8 - - - - The object can be maximized. - - 16 - - - - The object can be moved. - - 32 - - - - The object will have a reload button. - - 64 - - - - Default object behavior: all together. - - (Minimize | Maximize | Close | Pin | Resize | Move | Reload) - - - - PlotArea scrollable mode. - - - - - PlotArea will be scrollable by X axis. - - - - - PlotArea will be scrollable by Y axis. - - - - - PlotArea will be scrollable by both X and Y axis. - - - - - PlotArea will not be scrollable. - - - - Chart client settings - - - - - - - - Gets or sets a value indicating whether the zoom assist axis markers are enabled. - - - - - Gets or sets a value indicating the color of the zoom assist axis markers. - - - - - Gets or sets a value indicating the size of the axis markers in pixels (size for the YAxis marker represents its width, while size for the XAxis marker -- its height). - - - - - Gets or sets a value indicating whether the client-side zoom functionality is enabled. - - - - - Gets or sets a value indicating the color of the zoom rectangle. - - - - - Gets or sets a value indicating the opacity of the zoom rectangle. - - - - - Gets or sets a value indicating the plotarea client scroll mode. - - - - - Gets or sets a value indicating the YAxis scroll offset ratio. - - - YScrollOffset accepts values between 0 and 1. - - - - - Gets or sets a value indicating the XAxis scroll offset ratio. - - - XScrollOffset accepts values between 0 and 1. - - - - - Gets or sets a value indicating the plotarea scale value by Y axis. - - - - - Gets or sets a value indicating the plotarea scale value by X axis. - - - - - A collection of ColorPickerItem objects in a - RadColorPicker control. - - - The ColorPickerItemCollection class represents a collection of - ColorPickerItem objects. The ColorPickerItem objects in turn represent - Colors items within a RadColorPicker control. - - - Use the indexer to programmatically retrieve a - single ColorPickerItem from the collection, using array notation. - - - Use the Count property to determine the total - number of Items in the collection. - - - Use the Add method to add Items in the collection. - - - Use the Remove method to remove Items from the - collection. - - - - - - - - Specifies the visible modes of the RadColorPicker's palette. - - - - - WebPalette - - 1 - - - - RGB RadSliders - - 2 - - - - Default object behavior: all together. - - (WebPalette | RGBSliders) - - - - Gets or sets a value indicating the server-side event handler that is called - when the value of the ColorPicker has been changed. - - - A string specifying the name of the server-side event handler that will handle the - event. The default value is empty string. - - - If specified, the OnColorChanged - event handler that is called - when the value of the ColorPicker has been changed. Two parameters are passed to the handler: - - sender, the RadColorPicker object. - args. - - This event cannot be cancelled. - - - The following example demonstrates how to use the - OnColorChanged property. - -
- <telerik:RadColorPicker ID="RadColorPicker1"
- runat= "server"
- OnColorChanged="OnColorChanged">
- ....
- </telerik:RadColorPicker> -
-
-
-
- - - A helper to generate a MSOffice2007 like pallete - - - - - - - Collection of the color picker items - - - - - Get/Set the preset colors of the color picker - - - - - Get/Set the selected color of the ColorPicker - - - - - Get/Set the number of the columns in the palette - - - - - True to cause a postback on value change. - - - - - True to show the None color selection - - - - - True to show the color picker as an icon, which when clicked opens the palette - - - - - True to preview the color which has been selected - - - - - Gets or sets the tooltip of the icon - - - - - Gets or sets the text in the icon - - - - - Gets or sets the text for the no color box - - - - - True to enable the ColorPicker,False to disable - - - - - Gets or sets a value indicating the behavior of this object - if can be resized, has expand/collapse commands, closed command, etc. - - - - Gets or sets a value indicating whether the colorpicker will create an overlay element. - The default value is false. - - - - Gets or sets a value indicating the client-side event handler that is called when - the RadColorPicker control is initialized. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - If specified, the OnClientLoaded - client-side event handler is called when the RadColorPicker - is initialized. Two parameters are passed to the handler: - - sender, the RadColorPicker object. - args. - - This event cannot be cancelled. - - - The following example demonstrates how to use the - OnClientLoaded property. - -
- <script type="text/javascript">
- function OnColorPickerLoadHandler(sender, args)
- {
- var ColorPicker = sender;
- }
- </script> -
-
- <telerik:RadColorPicker ID="RadColorPicker1"
- runat= "server"
- OnClientLoaded="OnColorPickerLoadHandler">
- ....
- </telerik:RadColorPicker> -
-
-
-
- - - Gets or sets a value indicating the client-side event handler that is called when a user has selected a color, but still not changed the value. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - If specified, the OnClientColorSelecting - client-side event handler is called when a color is selected - but still not changed. Two parameters are passed to the handler: - - sender, the RadColorPicker object. - args. - - This event cannot be cancelled. - - - The following example demonstrates how to use the - OnClientColorSelecting property. - -
- <script type="text/javascript">
- function OnColorSelectingHandler(sender, args)
- {
- var ColorPicker = sender;
- }
- </script> -
-
- <telerik:RadColorPicker ID="RadColorPicker1"
- runat= "server"
- OnClientColorSelecting="OnColorSelectingHandler">
- ....
- </telerik:RadColorPicker> -
-
-
-
- - - Gets or sets a value indicating the client-side event handler that is called - while the value of the color picker has been changed. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - If specified, the OnClientColorChange - client-side event handler that is called - when the value of the color picker has been changed. Two parameters are passed to the handler: - - sender, the RadColorPicker object. - args. - - This event cannot be cancelled. - - - The following example demonstrates how to use the - OnClientColorChange property. - -
- <script type="text/javascript">
- function OnColorChangeHandler(sender, args)
- {
- var ColorPicker = sender;
- }
- </script> -
-
- <telerik:RadColorPicker ID="RadColorPicker1"
- runat= "server"
- OnClientColorChange="OnColorChangeHandler">
- ....
- </telerik:RadColorPicker> -
-
-
-
- - - Represents the animation settings like type and duration for the control. - - - - - Represents the animation settings like type and duration. - - - - - - - - Gets or sets the effect that will be used for the animation. - - On of the AnimationType values. The default value - is OutQuart. - - - Use the Type property of the AnimationSettings - class to customize the effect used for the animation. To turn off animation effects set - this property to None. - - - - Gets or sets the duration in milliseconds of the animation. - An integer representing the duration in milliseconds of the animation. - - - Gets or sets the duration in milliseconds of the animation. - - An integer representing the duration in milliseconds of the animation. - The default value is 450 milliseconds. - - - - - The Telerik.Web.UI.RadComboBoxFilter enumeration supports three values - None, Contains, StartsWith. Default is None. - - - - - The Telerik.Web.UI.RadComboBoxSort enumeration supports three values - None, Ascending, Descending. Default is None. - - - - - Items are not sorted at all. - - - - - Items are sorted in ascending order (min to max) - - - - - Items are sorted in descending order (max to min) - - - - - Data class used for transferring control items (menu items, tree nodes, etc.) - from and to web services. - - - - - - - - - Text for the item to pass to the client. - - - - - Value for the item to pass to the client. - - - - - A value indicating if the item to pass to the client is enabled. - - - - - Custom attributes for the item to pass to the client. - - - - - Gets value indicating if the HTTP compression is activated - - - - - Retrieves 's configuration section from the webconfig - - - - - - Gets value indicating if the compression filter should be applied on full page postbacks - - - - - - Gets value indicating if the ViewState compression is activated - - - - - - - - - Used internally. - - - - - This enumeration lists the available controls in the file explorer and allows customizing the look of the control. - - - - - A treeview, which shows the folders in the file explorer. - - - - - A grid, which shows the files/folders in the current file explorer folder - - - - - A toolbar, which provides shortcuts for the file explorer commands (delete, new folder, back, forward, etc.) - - - - - A textbox, which shows the current selected path in the file explorer - - - - - The grid and treeview context menus, which are shown when the user right clicks inside the controls. - - - - - The default value for the RadFileExplorer control - all controls are shown - - - - - Telerik File Explorer control - - - - - Fired when on all file explorer file and folder operations. - - an instance of the RadFileExplorerEventArgs event argument. - False to cancel the command, True to continue - - - - The method is called, when perform initial data binding on the grid - - the grid instance - event arguments - - - - Implemented using ASP.NET 2.0 Callback functionality built into RadTreeView - - the tree instance - event arguments - - - - Handle Creating NewFolder, Delete, and Load folder - - ajax panel instance - ajax request arguments - - - - Handle Renaming of folders - - tree instance - rename event arguments - - - - This method is used in the RadTreeView1_NodeExpand handler, in the TreeUpdatePanel_AjaxRequest method, when a folder is created - and in the TreeUpdatePanel_AjaxRequest method, in order to reach a node in the tree - - The node to be populated - - - - This method is used in OnNodeEdit hendler and in RenameGridItem method to handle renaming the folder - and node in tree - - the virtual path of the new node - node to rename - new name - - - - Create folder when perform this action in tree or in grid - - parent folder path - new folder name - - - - delete folder/file(s) from the grid or tree - - a list of virtual paths to the item being deleted - - - - Get the Grid data for the current selected folder in the file explorer tree - - path to current selected folder - sort argument (column and direction) - a list of files and folders in the selected path - - - - Gets or sets a value indicating whether to allow creating new folders - - - - - Gets or sets a value indicating whether to allow opening a new window with the file - - - - - Gets or sets the width of the Web server control. - - - A System.Web.UI.WebControls.Unit that represents the width of the control. - The default is System.Web.UI.WebControls.Unit.Empty. - - The width of the Web server control was set to a negative value. - - - - Gets or sets the width of the file explorer's tree pane - - - A System.Web.UI.WebControls.Unit that represents the width of the control. - The default is 222 pixels. - - The width of the Web server control was set to a negative value. - - - - Gets or sets the height of the Web server control. - - - A System.Web.UI.WebControls.Unit that represents the height of the control. - The default is System.Web.UI.WebControls.Unit.Empty. - - The height of the Web server control was set to a negative value. - - - - Gets a reference to the toolbar, which shows on the top of the file explorer control. - - - - - Gets a reference to the grid, which shows on the right of the file explorer control. - - - - - Gets a reference to the tree, which shows on the left of the file explorer control. - - - - - Gets a reference to the context menu, which shows when the user right-clicks the grid control - - - - - Gets a reference to the upload component, which shows inside a popup window when the user wants to upload files. - If you want to set the allowed file types or max upload file size, please use the Configuration property - - - - - Gets a reference to the window component, which shows the upload popup and the alert/confirmation dialogs. - - - - - Specifies an access key to enable keyboard navigation for the File Explorer control - - - - - Gets or sets a string containing the localization language for the RadEditor UI - - - - - Gets or sets a value indicating where the control will look for its .resx localization files. - By default these files should be in the App_GlobalResources folder. However, if you cannot put - the resource files in the default location or .resx files compilation is disabled for some reason - (e.g. in a DotNetNuke environment), this property should be set to the location of the resource files. - - - A relative path to the dialogs location. For example: "~/controls/RadEditorResources/". - - - If specified, the LocalizationPath - property will allow you to load the control localization files from any location in the - web application. - - - - - Specifies the skin that will be used by the control - - - - - Contains the FileExplorer configuration (paths, content provider type, etc.). - - - An FileManagerDialogConfiguration - instance, containing the configuration of the control - - - - - Gets or sets the initial path that will be shown in the file explorer control. - - - If this property is not set, the file explorer will use the first path in the ViewPaths as the initial one. - - - - - Gets or sets a value indicating whether to show the up one folder (..) item in the grid if available. - - - - - Returns the currently selected node in the tree. This property is useful during postbacks. - - - - - The name of the javascript function called when the user selects an item in the explorer. - - - - - The name of the javascript function called when a folder is loaded in the grid. - - - - - The name of the javascript function called when an item is double clicked in the grid. - - - - - The name of the javascript function called when the the selected folder in the tree changes. - - - - - The name of the javascript function called when the control loads in the browser. - - - - - The name of the javascript function called when the user tries to create a new folder. - - - - - The name of the javascript function called when the user tries to delete a file. - - - - - The name of the javascript function called when the user tries to rename/move a file or folder. - - - - - This event is fired when on all file and folder operations of the file explorer. If you wish to cancel the command - simply return False from your event handler. - - - - - Gets the virtual path for the current item command - - - - - Gets the second virtual path for the current item command (for rename, move, etc. commands) - - - - - Gets the virtual command name - - - - - Set this argument to true if you wish to cancel the file explorer command - - - - - Represents a EditorDropDown tool that renders as a custom dropdown in the editor - - - - - Represents a EditorDropDown tool that renders as a custom dropdown in the editor - - - - - - - - - - - - - - - - - - - - - Gets the collection of EditorTool objects, inside the tool strip. - - The tools. - - - - Provides properties related to setting the client-side data-binding in - Telerik RadGrid. - - - You can get a reference to this class using - property. - - - - - Gets a reference to class providing properties - related to client-side ADO.NET DataService data-binding. - - - - - Gets or sets url for the WebService or Page which will be requested to get data. - - - - - Gets or sets method name in the WebService or Page which will be requested to get data. - - - - - Gets or sets method name in the WebService or Page which will be requested to get total records count. - - - - - Gets or sets maximum rows parameter name for the SelectMethod in the WebService or Page which will be requested to get data. - - - - - Gets or set start row index parameter name for the SelectMethod in the WebService or Page which will be requested to get data. - - - - - Gets or set sort parameter name for the SelectMethod in the WebService or Page which will be requested to get data. - - - - - Gets or set filter parameter name for the SelectMethod in the WebService or Page which will be requested to get data. - - - - - Gets or set filter parameter type for the SelectMethod in the WebService or Page which will be requested to get data. Default value is List. - - - - - Gets or set sort parameter type for the SelectMethod in the WebService or Page which will be requested to get data. Default value is List. - - - - - Gets or set a value indicating whether the client-side caching should be enabled or not. - - - - - Gets or set data property name for the SelectMethod in the WebService or Page which will be requested to get data and count. Default is "Data"! - - - - - Gets or set data property total records count for the SelectMethod in the WebService or Page which will be requested to get data and count. Default is "Count"! - - - - - Gets or set table name for the specified ADO.NET DataService. Default is empty string! - - - - - Gets a collection of TargetInput objects that allows for - specifying the objects for which input will be created on the client-side. - - - Use the TargetControls collection to programmatically control - which objects should be inputtipified on the client-side. - - - - - Gets or sets an instance of the InputManagerClientEvents class - which defines the JavaScript functions (client-side event handlers) that are invoked - when specific client-side events are raised. - - - - - Gets an instance of the InputSettingValidation class - which defines the validation behavior. - - - - Gets or sets the css style for enabled TextBox control. - - A string object that represents the css style properties for enabled TextBox - control. The default value is an empty string. - - - - Gets or sets a value to access the client-side behavior. - - In cases where you would like to access the client-side behavior for - your setting from script code in the client, you can set this BehaviorID to simplify - the process. See example below: - - - - Gets or sets the css style for hovered TextBox control. - - A string object that represents the css style properties for hovered TextBox - control. The default value is an empty string object. - - - - Gets or stes the css style for invalid state of TextBox control. - - A string object that represents the style properties for invalid TextBox control. - The default value is an empty string object. - - - - Gets or sets the css style for invalid state of TextBox control. - - A string object that represents the css style for invalid TextBox control. The - default value is an empty string object. - - - - Gets or sets the css style for Read Only state of TextBox control. - - A string object that represents the css style for Read Only TextBox control. The - default value is an empty string object. - - - - Gets or sets the css style for TextBox when when the control is disabled. - - A string object that represents the css style for TextBox control. The default - value is an empty string object. - - - - Gets or sets the css style for TextBox when when the control is empty. - - A string object that represents the css style for TextBox control. The default - value is an empty string object. - - - - Gets or sets a value message shown when the control is empty. - - A string specifying the empty message. The default value is empty string. - (""). - - - Shown when the control is empty and loses focus. You can set the empty message - text through EmptyMessage property. - - - - - Gets or sets the culture used by RadDateSetting to format the - date. - - - A - CultureInfo object that represents the current culture used. The default value is - System.Threading.Thread.CurrentThread.CurrentUICulture. - - - - - - - - - Gets or sets the smallest date value allowed by - RadDateSetting. - - - A - DateTime object that represents the smallest date value by - RadDateSetting. The default value is 1/1/1980. - - - - - Gets or sets the largest date value allowed by - RadDateSetting. - - - A - DateTime object that represents the largest date value allowed by - RadDateSetting. The default value is 12/31/2099. - - - - - Gets or sets the date and time format used by - RadDateSetting. - - - A string specifying the date format used by RadDateSetting. The - default value is "d" (short date format). - - - - - Gets or sets the display date format used by - RadDateSetting.(Visible when the control is not on focus.) - - - A string specifying the display date format used by - RadDateSetting. The default value is "d" (short date format). If the - DisplayDateFormat is left blank, the DateFormat will - be used both for editing and display. - - - - - Gets or sets a value that indicates the end of the century that is used to - interpret the year value when a short year (single-digit or two-digit year) is entered - in the input. - - The year when the century ends. Default is 2029. - - - - - - - - Registers the control with the ScriptManager - - - - - Registers the CSS references - - - - - Loads the client state data - - - - - - Saves the client state data - - - - - Gets or sets the skin name for the control user interface. - A string containing the skin name for the control user interface. The default is string.Empty. - - - If this property is not set, the control will render using the skin named "Default". - If EnableEmbeddedSkins is set to false, the control will not render skin. - - - - - - For internal use. - - - - - Gets or sets the value, indicating whether to render script references to the embedded scripts or not. - - - - If EnableEmbeddedScripts is set to false you will have to register the needed Scripts files by hand. - - - - - Gets or sets the value, indicating whether to render links to the embedded skins or not. - - - If EnableEmbeddedSkins is set to false you will have to register the needed CSS files by hand. - - - - - Gets or sets the value, indicating whether to render the link to the embedded base stylesheet of the control or not. - - - If EnableEmbeddedBaseStylesheet is set to false you will have to register the needed control base CSS file by hand. - - - - - - Gets the real skin name for the control user interface. If Skin is not set, returns - "Default", otherwise returns Skin. - - - - Gets or sets the value, indicating whether to render the skin CSS files during Ajax requests - - - If EnableAjaxSkinRendering is set to false you will have to register the needed control base CSS file by hand when adding/showing the control with Ajax. - - - - - - The CssClass property will now be used instead of the former Skin - and will be modified in AddAttributesToRender() - - - protected override string CssClassFormatString - { - get - { - return "RadDock RadDock_{0} rdWTitle rdWFooter"; - } - } - - - - - Gets or sets url for the WebService or Page which will be requested to validate data. - - - - - Gets or sets method name in the WebService or Page which will be requested to validate data. - - - - - Gets a collection of InputSetting objects that allows for specifying the objects - for which input elements will be created on the client-side. - - - - Gets or sets a value indicating whether manager should be enabled or not. - - - Gets or sets the string to use as the decimal separator in values. - The string to use as the decimal separator in values. - The property is being set to an empty string. - The property is being set to null. - - - Gets or sets the number of decimal places to use in numeric values - The number of decimal places to use in values. - The property is being set to a value that is less than 0 or greater than 99. - - - - Gets or sets the number of digits in each group to the left of the decimal in - values. - - The number of digits in each group to the left of the decimal in values. - The property is being set to null. - - - - Gets or sets the string that separates groups of digits to the left of the - decimal in values. - - - The string that separates groups of digits to the left of the decimal in - values. - - The property is being set to null. - - - Gets or sets the format pattern for negative values. - The format pattern for negative percent values. - The property is being set to a value that is less than 0 or greater than 11. - - - Gets or sets the format pattern for positive values. - The format pattern for positive percent values. The - The property is being set to a value that is less than 0 or greater than 3. - - - - Gets or sets the culture used by NumericTextBoxSetting to format - the numburs. - - - A CultureInfo object that represents the current culture used. - The default value is System.Threading.Thread.CurrentThread.CurrentUICulture. - - - - - Gets or sets the largest possible value of a - NumericTextBoxSetting. - - The default value is positive 2^46. - - - - Represents the animation settings like type and duration for the control. - - - - Gets or sets the duration in milliseconds of the animation. - - An integer representing the duration in milliseconds of the animation. - The default value is 450 milliseconds. - - - - - Represents the animation settings like type and duration for the control. - - - - Gets or sets the duration in milliseconds of the animation. - - An integer representing the duration in milliseconds of the animation. - The default value is 450 milliseconds - - - - - RadTicker control - - - - - Binds the ticker to a IEnumerable data source - - IEnumerable data source - - - - The collection that holds all RadTickerItem objects. - - - - - Specifies whether the ticker begins ticking automatically. - - - You should leave this set to false if you are using the ticker within a RadTicker - If you use the ticker independently and leave this setting to false you should use the - client API call ticker_id.startTicker() to start it. - - - Default: False - - - - - Specifies whether will begin ticking the next tickerline - (if any) after it has finished ticking the current one. - - - If you set the AutoAdvance property to false, then you will have to use - a client API Call ticker_id.tickNextLine() - - - Default: True - - - - - Specifies whether will repeat the first tickerline after displaying the last one. - - - If you set this property to true RadTicker will never finish ticking. - This may have possible implications when having more than one instance in - a . This way works is that when the first ticker - on a frame has finished ticking it will start ticking the next ticker on the frame. If a - instance is ticking (has Loop=true) it will never finish and the next ticker on the frame will not get started. - - - Default: False - - - - - Specifies the duration in milliseconds between ticking each character of a tickerline. - The lower the value the faster a line will finish ticking. - - - Default: 20ms - - - - - Specifies in milliseconds the pause makes before starting to tick - the next line (if AutoAdvance=True). - - - Default: 2000ms - - - - - Gets or sets a value indicating whether a postback to the server automatically occurs when the user interacts with the control. - - - Setting this property to true will make Telerik RadTicker postback to the server on item click. - - - The default value is false. - - - - - Gets or sets the field of the data source that provides the value of the ticker lines. - - - A string that specifies the field of the data source that provides the value of the ticker lines. - The default value is an empty string. - - - Use the DataTextField property to specify the field of the data source (in most cases the name of the database column) - which provides the values for the Text property of databound ticker items. The DataTextField property is - taken into account only during data binding. If the DataTextField property is not set and your datasource is not a list of strings, - the RadTicker control will throw an exception. - - - The following example demonstrates how to use the DataTextField. - - DataTable data = new DataTable(); - data.Columns.Add("MyID"); - data.Columns.Add("MyValue"); - - data.Rows.Add(new object[] {"1", "ticker item text 1"}); - data.Rows.Add(new object[] {"2", "ticker item text 2"}); - - RadTicker1.DataSource = data; - RadTicker1.DataTextField = "MyValue"; //"MyValue" column provides values for the Text property of databound ticker items - RadTicker1.DataBind(); - - - Dim data As new DataTable(); - data.Columns.Add("MyID") - data.Columns.Add("MyValue") - - data.Rows.Add(New Object() {"1", "ticker item text 1"}) - data.Rows.Add(New Object() {"2", "ticker item text 2"}) - - RadTicker1.DataSource = data - RadTicker1.DataTextField = "MyValue" '"MyValue" column provides values for the Text property of databound ticker items - RadTicker1.DataBind() - - - - - - This class represents a item. - - - - - Gets the zero based index of the item. - - - - - A collection of RadTickerItem objects in a - RadTicker control. - - - - - - Initializes a new instance of the RadTickerItemCollection class. - - The parent Ticker control. - - - Gets or sets the effect that will be used for the animation. - - - Gets or sets the animation duration in milliseconds. - - - - Returns the web.config value which specifies the application EnableEmbeddedScripts property. - - - Telerik.[ShortControlName].EnableEmbeddedScripts or Telerik.EnableEmbeddedScripts, depending on which value was set. - - - - - Returns the web.config value which specifies the application EnableEmbeddedSkins property. - - - Telerik.[ShortControlName].EnableEmbeddedSkins or Telerik.EnableEmbeddedSkins, depending on which value was set. - - - - - Represents an client-side operation (e.g. adding an item, removing an item, updating an item etc.) - - The type of the item (e.g. , , - , , , ) - - - - - Returns the item (, , - , , , ) - associated with this client operation. - - - When the of the operation is the Item property will - return null (Nothing in VB.NET) in case the items of the control have been cleared. - - - - - Gets the type of the client operation - - - One of the enumeration values. - - - If the Type property is equal to the type will be used. - - - - - Specifies the type of the . - - - - - An item has been inserted in the control. - - - - - An item has been removed from the control. - - - - - A property of the item has been changed. - - - - - All children of the control or the item have been removed. - - - - - Used in case of update client operations. - - The type of the item (e.g. , , - , , , ) - - - - - Gets the name of the property which has been changed on the client side. - - - - - - - - - Represents the settings to be used for load on demand through web service. - - - - - - - - - - - - - Gets or sets the name of the web service to be used to populate items with - ExpandMode set to WebService. - - - - - Gets or sets the method name to be called to populate items with - ExpandMode set to WebService. - - - The method must be part of the web service specified through the - Path property. - - - - - Gets or sets a boolean value - - - - - - - - Regular expression for detecting WebResource/ScriptResource substitutions in script files - - - - - Outputs the combined script file requested by the HttpRequest to the HttpResponse - - A Page, representing the HttpHandler - HttpContext for the transaction - true if the script file was output - - - - Represents a script reference - including tracking its loaded state in the client browser - - - - - Request param name for the serialized combined scripts string - - - - - Request param name for the hidden field name - - - - - Containing Assembly - - - - - Script name - - - - - Culture to render the script in - - - - - Reference to the Assembly object (if loaded by LoadAssembly) - - - - - Constructor - - containing assembly - script name - culture for rendering the script - - - - Constructor - - script reference - - - - Gets the script corresponding to the object - - script text - - - - Loads the associated Assembly - - Assembly reference - - - - Equals override to compare two ScriptEntry objects - - comparison object - true iff both ScriptEntries represent the same script - - - - GetHashCode override corresponding to the Equals override above - - hash code for the object - - - - Deserialize a list of ScriptEntries - - - Serialized list looks like: - ;Assembly1.dll Version=1:Culture:MVID1:ScriptName1Hash:ScriptName2Hash;Assembly2.dll Version=2:Culture:MVID1:ScriptName3Hash - - serialized list - list of scripts - - - - This class loads the dialog resources - localization, skins, base scripts, etc. - - - - - Gets or sets a string containing the localization language for the RadEditor UI - - - - - Override this to process the pixel in the first pass of the algorithm - - The pixel to quantize - - This function need only be overridden if your quantize algorithm needs two passes, - such as an Octree quantizer. - - - - - Override this to process the pixel in the second pass of the algorithm - - The pixel to quantize - The quantized value - - - - Retrieve the palette for the quantized image - - Any old palette, this is overrwritten - The new color palette - - - - Struct that defines a 32 bpp colour - - - This struct is used to read data from a 32 bits per pixel image - in memory, and is ordered in this manner as this is the way that - the data is layed out in memory - - - - - Holds the blue component of the colour - - - - - Holds the green component of the colour - - - - - Holds the red component of the colour - - - - - Holds the alpha component of the colour - - - - - Permits the color32 to be treated as an int32 - - - - - Return the color for this Color32 object - - - - - Construct the octree quantizer - - - The Octree quantizer is a two pass algorithm. The initial pass sets up the octree, - the second pass quantizes a color based on the nodes in the tree - - The maximum number of colors to return - The number of significant bits - - - - Construct the octree - - The maximum number of significant bits in the image - - - - Add a given color value to the octree - - - - - - Reduce the depth of the tree - - - - - Keep track of the previous node that was quantized - - The node last quantized - - - - Convert the nodes in the octree to a palette with a maximum of colorCount colors - - The maximum number of colors - An arraylist with the palettized colors - - - - Get the palette index for the passed color - - - - - - - Mask used when getting the appropriate pixels for a given node - - - - - The root of the octree - - - - - Number of leaves in the tree - - - - - Array of reducible nodes - - - - - Maximum number of significant bits in the image - - - - - Store the last node quantized - - - - - Cache the previous color quantized - - - - - Get/Set the number of leaves in the tree - - - - - Return the array of reducible nodes - - - - - Class which encapsulates each node in the tree - - - - - Construct the node - - The level in the tree = 0 - 7 - The number of significant color bits in the image - The tree to which this node belongs - - - - Add a color into the tree - - The color - The number of significant color bits - The level in the tree - The tree to which this node belongs - - - - Reduce this node by removing all of its children - - The number of leaves removed - - - - Traverse the tree, building up the color palette - - The palette - The current palette index - - - - Return the palette index for the passed color - - - - - Increment the pixel count and add to the color information - - - - - Flag indicating that this is a leaf node - - - - - Number of pixels in this node - - - - - Red component - - - - - Green Component - - - - - Blue component - - - - - Pointers to any child nodes - - - - - Pointer to next reducible node - - - - - The index of this node in the palette - - - - - Get/Set the next reducible node - - - - - Return the child nodes - - - - - Summary description for TagSnippet. - - - - - Summary description for HtmlParser. - - - - - Summary description for TagSnippet. - - - - - Summary description for TagSnippet. - - - - - Summary description for TagSnippet. - - - - - Summary description for TagSnippet. - - - - - Allow the transfer of data files using the W3C's - specification for HTTP multipart form data. - Microsoft's version has a bug where it does not - format the ending boundary correctly. - - - - - Transmits a file to the web server stated - in the URL property. - You may call this several times and it will - use the values previously set for fields and URL. - - the text to send - The local path of - the file to send. - - - - Initialize our class for use to - send data files. - - The URL of the - destination server. - - - - Used to signal we want the output to go to a - text file verses being transfered to a URL. - - The local path to the - output file. - - - - Allows you to add some additional field data - to be sent along with the transfer. - This is usually used for things like userid - and password to validate the transfer. - - The name of the - custom field. - The value of the - custom field. - - - - Allows you to add some additional header data - to be sent along with the transfer. - - The name of the custom header. - The value of the custom header. - - - - Determines if we have a file stream set, and - returns either the HttpWebRequest stream or - the file. - - Either the HttpWebRequest stream or - the local output file. - - - - Make the request to the web server and - retrieve it's response into a text buffer. - - - - - Builds the proper format of the multipart - data that contains the form fields and - their respective values. - - All form fields, properly formatted - in a string. - - - - Returns the proper content information for - the file we are sending. - - The local path to - the file that should be sent. - All file headers, properly formatted - in a string. - - - - Creates the proper ending boundary for the - multipart upload. - - The ending boundary. - - - - Mainly used to turn the string into a byte - buffer and then write it to our IO stream. - - The stream to write to. - The data to place into the stream. - - - - Reads in the file a chunck at a time then - sends it to the output stream. - - The stream to write to. - The local path of the file to send. - - - - Allows you to specify the specific version - of HTTP to use for uploads. - The dot NET stuff currently does not allow - you to remove the continue-100 header - from 1.1 and 1.0 currently has a bug in it - where it adds the continue-100. - MS has sent a patch to remove the - continue-100 in HTTP 1.0. - - - - - Used to change the content type of the file - being sent. - Currently defaults to: text/xml. Other options - are text/plain or binary. - - - - - The string that defines the begining boundary - of our multipart transfer as defined in the - w3c specs. - This method also sets the Content and Ending - boundaries as defined by the w3c specs. - - - - - The string that defines the content boundary - of our multipart transfer as defined in the - w3c specs. - - - - - The string that defines the ending boundary - of our multipart transfer as defined in the - w3c specs. - - - - - The data returned to us after the transfer - is completed. - - - - - The web address of the recipient of the - transfer. - - - - - Allows us to determine the size of the buffer - used to send a piece of the file at a time - out the IO stream. - Defaults to 1024 * 10. - - - - - Allows us to specified the credentials used - for the transfer. - - - - - Allows us to specifiy the certificate to use - for secure communications. - - - - - Gets or sets a value indicating whether to - make a persistent connection to the - Internet resource. - - - - - Gets or sets a value indicating whether the - Expect100-Continue header should be sent. - - - - - Gets or sets a value indicating whether to - pipeline the request to the Internet resource. - - - - - Gets or sets a value indicating whether the - file can be sent in smaller packets. - - - - - Represents a EditorDropDownItem dropdown item from a custom editor dropdown - - - - - A strongly typed collection of EditorDropDownItem objects - - - - - Telerik RadFormDecorator - - - - - Get/Set the DecoratedControls enum of RadFormDecorator - - - - - Get/Set the ControlsToSkip enum of RadFormDecorator - a shortcut for faster fine-tuning of the decorated controls - - - - - Gets or sets whether decorated textboxes, textarea and fieldset elements will have rounded corners - - - - - Gets or sets the id (ClientID if a runat=server is used) of a html element whose children will be decorated - - - - - Gets The text box instance created of extracted from a cell after calls to AddControlsToContainer or LoadControlsFromContainer methods. - - - - - Gets The text box instance created of extracted from a cell after calls to AddControlsToContainer or LoadControlsFromContainer methods. - - - - - Gets the instace of the Style that would be applied to the TextBox control, when initializing in a TableCell. - - - - Gets or sets default path for the GridDateTimeColumnEditor images when EnableEmbeddedSkins is set to false. - A string containing the path for the grid images. The default is String.Empty. - - - - - - - - - - Gets or sets whether the column data can be filtered. The default value is - true. - - - A Boolean value, indicating whether the column can be - filtered. - - - - Gets or sets a whether the column data can be sorted. - - A boolean value, indicating whether the column data can - be sorted. - - - - - Gets or sets a string, representing a comma-separated enumeration of DataFields - from the data source, which will form the expression. - - - A string, representing a comma-separated enumeration of - DataFields from the data source, which will form the expression. - - - - - Gets or sets aggregate result. - - - - - - - - - Data class used for transferring rotator items from and to web services. - - - For information about the role of each property see the - RadRotatorItem class. - - - - - The HTML content of the rotator frame. Note that you do not need to use templates here - the HTML will be added to the page directly. - - - - - See RadRotatorItem.Visible. - - - - - See RadRotatorItem.CssClass. - - - - - RadRotator Control - - - - - Binds the rotator to a IEnumerable data source - - IEnumerable data source - - - - - - - - Specifies the type of rotator [how the rotator will render and what options the user will have for interacting with it on the client] - - - - Default: RotatorType.Buttons - - - - - Specifies possible directions for scrolling rotator items. - - - - Default: RotatorScrollDirection.Left | RotatorScrollDirection.Right - - - - - Specifies the speed in milliseconds for scrolling rotator items. - - - Default: 500 - - - - - Specifies the index of the item, which will be shown first when the rotator loads. - When set to 0 (default) - positions initial item to be visible in the rotator. - When set to -1 - positions the initial item just outside of the rotator viewport. - Any other positive value - the rotator starts with that particular item in the viewport. - - - Default: 0 - - - - - Specifies the time in milliseconds each frame will display in automatic scrolling scenarios. - - - Default: 2000 - - - - - Specifies the default rotator item width. - - - Default: Unit.Empty - - - - - Specifies the default rotator item height. - - - Default: Unit.Empty - - - - - Gets the settings for the web service used to populate items - - - An WebServiceSettings that represents the - web service used for populating items. - - - - Use the WebServiceSettings property to configure the web - service used to populate items on demand. - You must specify both Path and - Method - to fully describe the service. - - - In order to use the integrated support, the web service should have the following signature: - - - [ScriptService] - public class WebServiceName : WebService - { - [WebMethod] - public RadRotatorItemData[] WebServiceMethodName(int itemIndex, int itemCount) - { - List<RadRotatorItemData> result = new List<RadRotatorItemData>(); - RadRotatorItemData item; - for (int i = 0; i < itemCount; i++) - { - item = new RadRotatorItemData(); - item.Html = "test "+(itemIndex+i); - result.Add(item); - } - return result.ToArray(); - } - } - - - - - - - Gets or sets the height of the Web server control. The default height is 200 pixels. - - - - - Gets or sets the width of the Web server control. The default width is 200 pixels. - - - - - Gets or sets a value indicating whether a postback to the server automatically occurs when the user interacts with the control. - - - Setting this property to true will make Telerik RadRotator postback to the server - on item click. - - - The default value is false. - - - - - Gets or sets a value indicating whether to pause the rotator scrolling when the mouse is over a roatator item - - - The default value is true. This means the animation will be paused when the user hovers over a rotator item. - - - - - The name of the javascript function called when an item is clicked. - - - - - The name of the javascript function called after an item is clicked. - - - - - The name of the javascript function called when the mouse hovers over an item. - - - - - The name of the javascript function called after the mouse leaves an item. - - - - - The name of the javascript function called when an item is about to be shown. - - - - - The name of the javascript function called after an item has been shown. - - - - - The name of the javascript function called when the rotator is loaded on the client. The function - is called right before the automatic animation (if used) begins. - - - - - This class represents a item. - - - - - Gets the zero based index of the item. - - - - - A collection of RadRotatorItem objects in a - RadRotator control. - - - - - - Initializes a new instance of the RadRotatorItemCollection class. - - The parent Rotator control. - - - - Encapsulates the properties used for the RadRotator control buttons management. - - - - - this function tries to get the client id of a control in the same naming container - - the control id - the control to search in - the client id if the control is found, or the input parameter if the control does not exist - - - - The name of the javascript function called when the user clicks one of the control buttons. - - This event is raised only when the rotator is in Buttons mode! - - - - The name of the javascript function called when the mouse is over one of the control buttons. - - This event is raised only when the rotator is in ButtonsOver mode! - - - - The name of the javascript function called when the mouse leaves one of the control buttons. - - This event is raised only when the rotator is in ButtonsOver mode! - - - - Gets or sets the ISchedulerInfo object - that will be passed to the web service. - - - The ISchedulerInfo object - that will be passed to the web service. - - - You can replace this object with your own implementation of - ISchedulerInfo in order - to pass additional information to the Web Service. - - - - - Gets or sets the URI for the request that is about to be made by a RadScheduler. - - - The URI for the request that is about to be made by a RadScheduler. - - - This property contains the absolute URI for the request, as resolved - by RadScheduler. You might need to modify this URI to accommodate for - URL rewriters and other scenarios. - - - - - Gets a collection of header name/value pairs associated with the request. - - - A WebHeaderCollection containing - header name/value pairs associated with this request. - - - The Headers property contains a WebHeaderCollection - instance containing header information that RadScheduler sends with the request. - - - - - Gets or sets the network credentials that are sent to the host and used to authenticate the request. - - - An ICredentials containing the authentication credentials for the request. - The default is a null reference (Nothing in Visual Basic). - - - Typically, you would set this property to the credentials of the client on whose behalf the request is made. - - - - - Gets or sets a value indicating the resource key to match. - - - Resource key to match. - - - - - Gets or sets a value indicating the resource text to match. - - - Resource text to match. - - - - - Gets or sets a value indicating the resource type to match. - - - Resource type to match. - - - - - Gets or sets a value indicating the cascading style sheet (CSS) class - to render for appointments that use the matching resource. - - - The cascading style sheet (CSS) class to render for appointments - that use the matching resource. - - The default value is Empty. - - - You can define your own CSS class name or use some of the predefined class names: - - rsCategoryRed - rsCategoryBlue - rsCategoryOrange - rsCategoryGreen - - - - - - Specifies the resource population mode of a RadScheduler control when using Web Service data binding. - - - - - In manual mode RadScheduler will not request resources from the Web Service. - They can be populated from the code-behind of the ASP.NET page that hosts - the RadScheduler control. - - - This mode is useful when server-side requests from the server are undesirable - or forbidden (Medium Trust for example). - - - - - The resources will be populated from the server by issuing a request to - the Web Service. - - - The ResourcesPopulating - event will be raised. - - - - - The resources will be populated from the client by issuing a request to - the Web Service. - - - The ResourcesPopulating - client-side event will be raised. - Grouped views are not supported in this mode. - - - - - For internal use only. - - - - - - - - - - - - - - - Gets or sets the method name to be called to populate the appointments. - - - The method must be part of the web service specified through the - Path property. - - - - - Gets or sets the method name to be called to delete appointments. - - - The method must be part of the web service specified through the - Path property. - - - - - Gets or sets the method name to be called to insert appointments. - - - The method must be part of the web service specified through the - Path property. - - - - - Gets or sets the method name to be called to update appointments. - - - The method must be part of the web service specified through the - Path property. - - - - - Gets or sets the method name to be called to get the resources list. - - - The method must be part of the web service specified through the - Path property. - - - - - Gets or sets the method name to be called to create recurrence exceptions. - - - The method must be part of the web service specified through the - Path property. - - - - - Gets or sets the method name to be called to remove the recurrence exceptions of a given appointment. - - - The method must be part of the web service specified through the - Path property. - - - - - Gets or sets the resource population mode - to be used from RadScheduler. - - - The resource population mode - to be used from RadScheduler. The default value is - ClientSide - - - - Resources need to be populated from the server when using resource grouping. - Doing so also reduces the client-side initialization time. - - - This operation requires the WebPermission to be granted - for the Web Service URL. This permission is not granted by default in Medium Trust. - - - You can disable the population of the resources from the server and still use - client-side rendering for grouped views. To do so you need to set the - value to Manual and - populate the resources from the OnInit method of the page. - - - - - - For internal use only. - - - - - - - The WebServiceAppointmentController provides a facade over a object - and is used to call your provider from web services. - - - - - Instantiates a new based on the default provider configured - in web.config. - - - If there is no provider configured in the web.config file a will be thrown. - - - - - Instantiates a new by using the specified provider name. - - The name of the provider configured in web.config - - - - Instantiates a new based on the supplied - - The provider which will be used - - - XmlSchedulerProvider provider = new XmlSchedulerProvider(Server.MapPath("~/App_Data/data.xml"), true); - WebServiceAppointmentController controller = new WebServiceAppointmentController(provider); - - - Dim provider As New XmlSchedulerProvider(Server.MapPath("~/App_Data/data.xml"), True) - Dim controller As New WebServiceAppointmentController(provider) - - - - - - Gets the appointments corresponding to specified time period - - Contains the current time period - - - [WebMethod] - public IEnumerable<AppointmentData> GetAppointments(SchedulerInfo schedulerInfo) - { - return Controller.GetAppointments(schedulerInfo); - } - - - <WebMethod> _ - Public Function GetAppointments(schedulerInfo As SchedulerInfo) As IEnumerable(Of AppointmentData) - Return Controller.GetAppointments(schedulerInfo) - End Function - - - - - - Inserts the specified appointment and returns the available appointments. - - A object which contains the current time period. - A object which contains the appointment properties. - - - [WebMethod] - public IEnumerable<AppointmentData> InsertAppointment(SchedulerInfo schedulerInfo, AppointmentData appointmentData) - { - return Controller.InsertAppointment(schedulerInfo, appointmentData); - } - - - <WebMethod> _ - Public Function InsertAppointment(schedulerInfo As SchedulerInfo, appointmentData As AppointmentData) As IEnumerable(Of AppointmentData) - Return Controller.InsertAppointment(schedulerInfo, appointmentData) - End Function - - - - - - Updates the specified appointment and returns the available appointments. - - A object which contains the current time period. - A object which contains the appointment properties. - - - [WebMethod] - public IEnumerable<AppointmentData> UpdateAppointment(SchedulerInfo schedulerInfo, AppointmentData appointmentData) - { - return Controller.UpdateAppointment(schedulerInfo, appointmentData); - } - - - <WebMethod> _ - Public Function UpdateAppointment(schedulerInfo As SchedulerInfo, appointmentData As AppointmentData) As IEnumerable(Of AppointmentData) - Return Controller.UpdateAppointment(schedulerInfo, appointmentData) - End Function - - - - - - Creates a recurrence exception with the specified appointment data and returns the available appointments. - - A object which contains the current time period. - A object which contains the exception properties. - - - [WebMethod] - public IEnumerable<AppointmentData> CreateRecurrenceException(SchedulerInfo schedulerInfo, AppointmentData recurrenceExceptionData) - { - return Controller.CreateRecurrenceException(schedulerInfo, recurrenceExceptionData); - } - - - <WebMethod> _ - Public Function CreateRecurrenceException(schedulerInfo As SchedulerInfo, recurrenceExceptionData As AppointmentData) As IEnumerable(Of AppointmentData) - Return Controller.CreateRecurrenceException(schedulerInfo, recurrenceExceptionData) - End Function - - - - - - Removes all recurrence exceptions of the specified recurrence master and returns the available appointments. - - A object which contains the current time period. - A object which is the recurrence master. - - - [WebMethod] - public IEnumerable<AppointmentData> RemoveRecurrenceExceptions(SchedulerInfo schedulerInfo, AppointmentData masterAppointmentData) - { - return Controller.RemoveRecurrenceExceptions(schedulerInfo, masterAppointmentData); - } - - - <WebMethod> _ - Public Function RemoveRecurrenceExceptions(schedulerInfo As SchedulerInfo, masterAppointmentData As AppointmentData) As IEnumerable(Of AppointmentData) - Return Controller.RemoveRecurrenceExceptions(schedulerInfo, masterAppointmentData) - End Function - - - - - - Returns the resources of all appointments within the specified time period. - - The time period - - - - Deletes the specified appointment and returns the available appointments. - - A object which contains the current time period. - A which represents the apointment that shoud be deleted. - Specified wether to delete the recurring series if the specified appointment is recurrence master. - - - [WebMethod] - public IEnumerable<AppointmentData> DeleteAppointment(SchedulerInfo schedulerInfo, AppointmentData appointmentData, bool deleteSeries) - { - return Controller.DeleteAppointment(schedulerInfo, masterAppointmentData, deleteSeries); - } - - - <WebMethod> _ - Public Function DeleteAppointment(schedulerInfo As SchedulerInfo, appointmentData As AppointmentData, deleteSeries As Bool) As IEnumerable(Of AppointmentData) - Return Controller.DeleteAppointment(schedulerInfo, masterAppointmentData, deleteSeries) - End Function - - - - - - - - - - Gets the recurrence exception appointment that is about to be created. - - The recurrence exception appointment that is about to be created. - - - - Gets the master appointment to which the recurrence exception is about to be attached. - - The master appointment to which the recurrence exception is about to be attached. - - - - Gets the occurrence appointment that is about to be overriden by the recurrence exception. - - The occurrence appointment that is about to be overriden by the recurrence exception. - - - - The date of the recurrence exception that is being created by - the current Insert / Update operation pair. - - - - - A reference to the original appointment during an Update operation. - - - - - For internal use only. - - - - - - - For internal use only. - - - - - - - For internal use only. - - - - - - Represents settings for RadScheduler's multi-day view. - - - Represents settings for RadScheduler's week view. - - - - Gets or sets a value indicating whether the view is in read-only mode. - - - true if view should be read-only; false otherwise. The default value is false. - - - By default the user is able to insert, edit and delete appointments. Use the ReadOnly to disable the editing capabilities of RadScheduler. - - - - - Gets or sets a value indicating whether to render date headers for the current view. - - true if the date headers for the current view are rendered; otherwise, false. - - - - Gets or sets a value indicating whether to render a tab for the current view in the view chooser. - - true if a tab for the current view in the view chooser is rendered; otherwise, false. - - - - Gets or sets the resource to group by. - - The resource to group by. - - - - Gets or sets the resource grouping direction. - - - - - Gets or sets a value indicating whether to render resource headers for the current view. - - true if the resource headers for the current view are rendered; otherwise, false. - - - - Gets or sets the time used to denote the start of the day. - - - The time used to denote the start of the day. - - - - - Gets or sets the time used to denote the end of the day. - - - The time used to denote the end of the day. - - - - - Gets or sets the time used to denote the start of the work day. - - - The time used to denote the start of the work day. - - - The effect from this property is only visual. - - - - - Gets or sets the time used to denote the end of the work day. - - - The time used to denote the end of the work day. - - - The effect from this property is only visual. - - - - - Gets or sets a value indicating whether to render the hours column in day and week view. - - true if the hours column is rendered in day and week view; otherwise, false. - - - - - - - - Gets or sets the week header date format string. - - The week header date format string. - - For additional information, please read this - MSDN article. - - - - - Gets or sets the week column header date format string. - - The week column header date format string. - - For additional information, please read this - MSDN article. - - - - - - - - - Gets or sets the mult-day header date format string. - - The multi-day header date format string. - - For additional information, please read this - MSDN article. - - - - - Gets or sets the multi-day header column date format string. - - The multi-day column header date format string. - - For additional information, please read this - MSDN article. - - - - - Gets or sets a value indicating whether to render a tab for the current view in the view chooser. - - true if a tab for the current view in the view chooser is rendered; otherwise, false. - - - Represents settings for RadScheduler's day view. - - - - - - - - Gets or sets the day header date format string. - - The day header date format string. - - For additional information, please read this - MSDN article. - - - - - Not applicable in day view. - - - - Represents settings for RadScheduler's Month view. - - - - - - - - Gets or sets the RadScheduler's header date format string in Month View. - - The RadScheduler's header date format string in Month View. - - For additional information, please read this - MSDN article. - - - - - Gets or sets the column header date format string in Month View. - - The column header date format string in Month View. - - For additional information, please read this - MSDN article. - - - - - Gets or sets the day header date format string in Month View. - - The day header date format string in Month View. - - For additional information, please read this - MSDN article. - - - - - Gets or sets the first day of month header date format in Month View. - - The first day of month header date format in Month View. - - For additional information, please read this - MSDN article. - - - - - Gets or sets a value indicating the number of visible appointments per day in month view. - - - A number specifying the number of visible appointments per day. The default value is 2. - - - A link button navigating to the specific date will be rendered when - the number of appointments exceeds this value. - - - - - Gets or sets a value indicating whether the height of each row - should be adjusted to match the height of its content. - - - true if the height of each row should be adjusted to match the height of its content; - false if all rows should be with the same height. - The default value is false. - - - By default, all rows are rendered with the same height. - This property allows you to change this behaviour. - - - - - Gets or sets a value indicating the minimum row height in month view. - - - A number specifying the the minimum row height. The default value is 4. - - - This property is ignored when AdaptiveRowHeight - is set to true. - - - - - Specifies resource grouping direction in RadScheduler. - - - - Represents settings for the time line view. - - - - - - - - The starting time of the Timeline view. - - - - - The number of slots to display in timeline view. - - - - - The duration of each slot in timeline view. - - - - - Gets or sets the Timeline view header date format string. - - The Timeline view header date format string. - - For additional information, please read this - MSDN article. - - - - - Gets or sets the timeline column header date format string. - - The timeline column header date format string. - - For additional information, please read this - MSDN article. - - - - - Gets or sets the number of rows/columns each time label spans. - - - The number of rows/columns each time label spans. - The default value is 1 - - - - - Gets or sets a boolean value that specifies whether to - show an empty area at the end of each time slot that can - be used to insert appointments. - - - true, insert are should be shown; false otherwise. - The default value is true - - - - The insert area is not visible if the scheduler is in read-only mode or - AllowInsert is false. - - - If all time slots are full and this property is set to false, - the user will not be able to insert appointments. - - - - - - For internal use only. - - - - - - - For internal use only. - - - - - - - For internal use only. - - - - - - - Synchronize the height of all cells in the table. - - - - - Adds padding to the table cells, so they are at least hight. - - - - - Sycnhronize the height of the cells in the specified row. - - - - - Synchronizes the row heights of two tables with identical dimensions. - - - - - For internal use only. - - - - - - - For internal use only. - - - - - - - For internal use only. - - - - - - - For internal use only. - - - - - - - For internal use only. - - - - - - - For internal use only. - - - - - - - For internal use only. - - - - - - - For internal use only. - - - - - - - For internal use only. - - - - - - - For internal use only. - - - - - - - A list of the appointments that start in this time slot. - - - - - The control that represents this time slot. - - - - - The start time of the time slot. - - - - - The end time of the time slot. - - - - - The duration of the time slot. - - - - - The unique index of the time slot. - - - - - - - - - An optional CSS class name that will be rendered for the time slot. - - - - - The resource associated with the time slot. - - The resource associated with the time slot in grouped views, otherwise null. - - - - For internal use only. - - - - - - - For internal use only. - - - - - - - For internal use only. - - - - - - - For internal use only. - - - - - - - For internal use only. - - - - - - - For internal use only. - - - - - - - For internal use only. - - - - - - - For internal use only. - - - - - - - For internal use only. - - - - - - - For internal use only. - - - - - - - For internal use only. - - - - - - - For internal use only. - - - - - - - For internal use only. - - - - - - - For internal use only. - - - - - - - For internal use only. - - - - - - - For internal use only. - - - - - - - Defines the output compression mode of the Telerik.Web.UI.WebResource.axd handler. - - - - - The compression is disabled (raw content is output to the browser). - - - - - Compression is identified by the browser and its version. - - - - - Output is always compressed. - - - - - Gets or sets a value indicating whether Skin chooser should be rendered in run-time. - - - - - Gets or sets a value indicating whether skinning should be enabled or not. - - - - - "Specifies the skin that will be used by the control" - - - - - Specifies the skin manager persistance mode. - - - - - Gets a collection of TargetControl objects that allows for specifying the objects for which tooltips will be created on the client-side. - - - Gets a collection of TargetControl objects that allows for specifying the objects for which tooltips will be created on the client-side. - - - Use the TargetControls collection to programmatically control which objects should be tooltipified on the client-side. - - - - - Gets or sets a value indicating whether skinning should be enabled or not. - - - - - RadSliderItem class. - - - - Gets or sets the text caption for the slider item. - The text of the item. The default value is empty string. - - Use the Text property to specify the text to display for the - item. - - - - Gets or sets the value for the slider item. - The value of the item. The default value is empty string. - - Use the Value property to specify the value - - - - - Gets the RadSlider instance which contains the current item. - - - - - Gets the RadSlider instance which contains the current item. - - - - Gets or sets the selected state of the slider item. - The default value is true. - - Use the Selected property to determine whether the item is selected or not. - - - - Gets or sets the tooltip of the slider item. - - - - A collection of RadSliderItem objects in a - RadSlider control. - - - The RadSliderItemCollection class represents a collection of - RadSliderItem objects. - - - Use the indexer to programmatically retrieve a - single RadSliderItem from the collection, using array notation. - - - Use the Count property to determine the total - number of slider items in the collection. - - - Use the Add method to add items in the collection. - - - Use the Remove method to remove items from the - collection. - - - - - - - - Initializes a new instance of the RadSliderItemCollection class. - - The owner of the collection. - - - - Appends the specified RadSliderItem object to the end of the current RadSliderItemCollection. - - - The RadSliderItem to append to the end of the current RadSliderItemCollection. - - - - - Finds the first RadSliderItem with Text that - matches the given text value. - - - The first RadSliderItem that matches the - specified text value. - - The string to search for. - - - - Finds the first RadSliderItem with Value that - matches the given value. - - - The first RadSliderItem that matches the - specified value. - - The value to search for. - - - - Searches the items in the collection for a RadSliderItem which contains the specified attribute and attribute value. - - The name of the target attribute. - The value of the target attribute - The RadSliderItem that matches the specified arguments. Null (Nothing) is returned if no node is found. - - - - Determines whether the specified RadSliderItem object is in the current - RadSliderItemCollection. - - - The RadSliderItem object to find. - - - true if the current collection contains the specified RadSliderItem object; - otherwise, false. - - - - Appends the specified array of RadSliderItem objects to the end of the - current RadSliderItemCollection. - - - The array of RadSliderItem to append to the end of the current - RadSliderItemCollection. - - - - - Determines the index of the specified RadSliderItem object in the collection. - - - The RadSliderItem to locate. - - - The zero-based index of item within the current RadSliderItemCollection, - if found; otherwise, -1. - - - - - Inserts the specified RadSliderItem object in the current - RadSliderItemCollection at the specified index location. - - The zero-based index location at which to insert the RadSliderItem. - The RadSliderItem to insert. - - - - Removes the specified RadSliderItem object from the current - RadSliderItemCollection. - - - The RadSliderItem object to remove. - - - - - Removes the specified RadSliderItem object from the current - RadSliderItemCollection. - - - The zero-based index of the index to remove. - - - - - Gets the RadSliderItem object at the specified index in - the current RadSliderItemCollection. - - - The zero-based index of the RadSliderItem to retrieve. - - - The RadSliderItem at the specified index in the - current RadSliderItemCollection. - - - - - Specifies the visibility and position of scrollbars in a RadMultiPage control. - - - - - No scroll bars are displayed. Overflowing content will be visible. - - - - - Displays only a horizontal scroll bar. The scroll bar is always visible. - - - - - Displays only a vertical scroll bar. The scroll bar is always visible. - - - - - Displays both a horizontal and a vertical scroll bar. The scroll bars are always visible. - - - - - Displays, horizontal, vertical, or both scroll bars as necessary (the content overflows the RadMultiPage boundaries). - Otherwise, no scroll bars are shown. - - - - - No scroll bars are displayed. Overflowing content is clippet at RadMultiPage boundaries. - - - - - Provides data for the events of the RadMultiPage control. - - - - - Initializes a new instance of the RadMultiPageEventArgs class. - - - A RadPageView which represents a page view in the - RadMultiPage control. - - - - - Gets the referenced page view in the RadMultiPage control when the event is raised. - - - The referenced page view in the RadMultiPage control when the event is raised. - - - Use this property to programmatically access the page view referenced in the RadMultiPage control when the event is raised. - - - - - Represents the method that handles the event provided by the control. - - - - - For internal use only. - - - - - - - The RadPageView class represents a single page in the - RadMultiPage control. - - - - - Gets the RadMultiPage control which contains the current RadPageView - - - A RadMultiPage object which contains the current RadPageView. - Null (Nothing in VB.NET) is returned if the current RadPageView is not added in a RadMultiPage control. - - - - - Gets or sets a value indicating whether the current RadPageView is selected. - - - true if the current RadPageView is selected; otherwise - false. The default value is false. - - - Use the Selected property to select a RadPageView object. There can be only one selected - RadPageView at a time within a RadMultiPage control. - - - - - Gets the zero-based index of the current RadPageView object. - - - The zero-based index of the current RadPageView; -1 will be returned if the current RadPageView object is not added - in a RadMultiPage control. - - - - - A control which contains controls. Only one page view can be visible at a time. - - - RadMultiPage is usually used with RadTabStrip to create paged data entry forms. Use the - property to associate a RadMultiPage control with RadTabStrip. - - - - - Finds a RadPageView with the specified ID. - - The ID of the RadPageView - - A RadPageView with the specified ID. Null (Nothing) is returned if there is no - RadPageView with the specified ID. - - - - - Gets or sets the index of the selected RadMultiPage. - - - The index of the currently selected RadMultiPage. The default value is -1, - which means that no RadMultiPage is selected. - - - - - Gets or sets the value indicating whether to register the embedded JavaScript files or not. - - - - If EnableEmbeddedScripts is set to false you will have to register the needed JavaScript files by hand. - - - - - - Gets a RadPageViewCollection that represents the RadMultiPage - controls int the current RadMultiPage instance. - - - - - Gets or sets a value indicating whether to render only the currently selected RadMultiPage. - - - True if only the current RadMultiPage should be rendered; otherwise false. - The default value is false which means all pageviews will be rendered. - - - Use the RenderSelectedPageOnly to make the RadMultiPage control render only the selected RadMultiPage. - This can save output size because by default all pageviews are rendered. If RenderSelectedPageOnly is set to true - RadMultiPage will make a request to the server in order to change the selected pageview. - - - - - Gets or sets the visibility and position of scroll bars in the RadMultiPage control. - - - One of the values. The default value is None. - - - Use this property to customize the visibility and position of scroll bars. By default any overflowing content is visible. - - - - - Occurs when page views are added programmatically to the RadMultiPage control. It also occurs after postback when - the RadMultiPage control recreates its page views from ViewState. - - - The example below starts by defining a dynamic page view and adding a control (i.e. - Label) to the new page view. - - protected void Page_Load(object sender, System.EventArgs e) - { - if (!Page.IsPostBack) - { - PageView view = new RadPageView(); - view.ID = "dynamicPageView"; - RadMultiPage1.PageViews.Add(view); - } - } - - protected void RadMultiPage1_PageViewCreated(object sender, Telerik.Web.UI.RadMultiPageEventArgs e) - { - Label l = new Label(); - l.ID = "dynamicLabel"; - l.Text = "Programatically created label"; - e.PageView.Controls.Add(l); - } - - - Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) - If Not Page.IsPostBack Then - Dim view As PageView = New RadPageView() - view.ID = "dynamicPageView" - RadMultiPage1.PageViews.Add(view) - End If - End Sub - - Protected Sub RadMultiPage1_PageViewCreated(ByVal sender As Object, ByVal e As Telerik.Web.UI.RadMultiPageEventArgs) Handles RadMultiPage1.PageViewCreated - Dim l As New Label() - l.ID = "dynamicLabel" - l.Text = "Programatically created label" - e.PageView.Controls.Add(l) - End Sub - - - - Use this event when you need to create page views from code behind. Controls added dynamically should be created in - the PageViewCreated event handler. - - - - - Specifies the alignment of tabs within the RadTabStrip control. - - - - - The Tabs will be aligned to the left. - - - - - The Tabs will be centered in the middle. - - - - - The Tabs will be aligned to the right. - - - - - The Tabs will be justified. - - - - - Specifies the way tabs can be oriented - - - - - RadTabStrip is above the content (e.g. RadMultiPage). - Child tabs (if any) are shown below parent tabs. - - - - - RadTabStrip is below the content (e.g. RadMultiPage). - Child tabs (if any) are shown above parent tabs. - - - - - RadTabStrip is on the right side of the content (e.g. RadMultiPage). - Child tabs (if any) are shown on the left side of parent tabs. - - - - - RadTabStrip is on the left side of the content (e.g. RadMultiPage). - Child tabs (if any) are shown on the right side of parent tabs. - - - - - The position of the scroll buttons when the RadTabStrip.ScrollChildren - property is set to true. - - - - - The buttons are to the left of tabs. - - - - - The tabs are between the left and right scroll buttons. - - - - - The buttons are to the right of the tabs. - - - - - Provides data for the events of the RadTabStrip control. - - - - - Initializes a new instance of the - RadTabStripEventArgs class. - - - A RadTab which represents a tab in the - RadTabStrip control. - - - - - Gets the referenced tab in the RadTabStrip control when the event is raised. - - - The referenced tab in the RadTabStrip control when the event is raised. - - - Use this property to programmatically access the tab referenced in the RadTabStrip control when the event is raised. - - - - - Represents the method that handles the events provided by the control. - - - - - Defines properties that tab containers (RadTabStrip, - RadTab) should implement. - - - - - Gets the parent IRadTabContainer. - - - - - Gets the collection of child tabs. - - - A RadTabCollection which represents the child tabs of - the IRadTabContainer. - - - - - Gets or sets the index of the selected child tab. - - - The zero based index of the selected tab. The default value is -1 (no child tab is selected). - - - Use the SelectedIndex property to programmatically specify the selected - child tab in a IRadTabContainer (RadTabStrip or RadTab). - To clear the selection set the SelectedIndex property to -1. - - - - - Gets the selected child tab. - - - Returns the child tab which is currently selected. If no tab is selected - (the SelectedIndex property is -1) the SelectedTab - property will return null (Nothing in VB.NET). - - - - - Gets or sets a value indicating whether the children of the tab will be - scrollable. - - - true if the child tabs will be scrolled; otherwise - false. The default value is false. - - - - - Gets or sets a value indicating whether the tabstrip should scroll directly to - the next tab. - - - true if the tabstrip should scroll to the next (or previous) tab; otherwise false. - The default value is false. - - - - The position of the scroll buttons with regards to the tab band. - - This property is applicable when the - ScrollChildren property is set to - true; otherwise it is ignored. - - - One of the TabStripScrollButtonsPosition - enumeration values. The default value is Right. - - - - - Gets or sets the position of the scrollable band of tabs relative to the - beginning of the scrolling area. - - - This property is applicable when the - ScrollChildren property is set to - true; otherwise it is ignored. - - - An integer specifying the initial scrolling position (measured in pixels). The default value is 0 - (no offset from the default scrolling position). Use negative values to move the tabs to the left. - - - - - A collection of RadPageView objects in a - RadMultiPage control. - - - The RadPageViewCollection class represents a collection of - RadPageView objects. - - - Use the indexer to programmatically retrieve a - single RadPageView from the collection, using array notation. - - - Use the Count property to determine the total - number of RadPageView controls in the collection. - - - Use the Add method to add RadPageView controls to the collection. - - - Use the Remove method to remove RadPageView controls from the - collection. - - - - - - - - Initializes a new instance of the class. - - The owner of the collection. - - - - Appends the specified RadPageView to the collection. - - - The RadPageView to append to the collection. - - - - - Inserts the specified RadPageView object in the current - RadPageViewCollection at the specified index location. - - The zero-based index location at which to insert the RadPageView. - The RadPageView to insert. - - - - - - - - - - - - - - - - - - - - - - - - Removes the specified RadPageView from the collection. - - - The RadPageView to remove from the collection. - - - - - Determines the index of the specified RadPageView in the collection. - - - The zero-based index position of the specified RadPageView in the - collection. If the specified RadPageView is not found in the collection -1 is returned. - - - A RadPageView to search for in the collection. - - - - - Gets the RadPageView at the specified index in the - collection. - - - Use this indexer to get a RadPageView from the collection at - the specified index, using array notation. - - - The zero-based index of the RadPageView to retrieve from the - collection. - - - - - Defines the relationship between a data item and the tab it is binding to in a - control. - - - - - - - - - Specifies the exact value of the ChildGroupCssClass property of the - RadTab that will be created during the data binding. - - - - - Specifies the field, containing the ChildGroupCssClass property - value of the RadTab that will be created during - the data binding. - - - - - Specifies the exact value of the DisabledCssClass property of the - RadTab that will be created during the data binding. - - - - - Specifies the field, containing the DisabledCssClass property - value of the RadTab that will be created during - the data binding. - - - - - Specifies the exact value of the DisabledImageUrl property of the - RadTab that will be created during the data binding. - - - - - Specifies the field, containing the DisabledImageUrl property - value of the RadTab that will be created during - the data binding. - - - - - Specifies the exact value of the HoveredCssClass property of the - RadTab that will be created during the data binding. - - - - - Specifies the field, containing the HoveredCssClass property - value of the RadTab that will be created during - the data binding. - - - - - Specifies the exact value of the IsSeparator property of the - RadTab that will be created during the data binding. - - - - - Specifies the field, containing the IsSeparator property - value of the RadTab that will be created during - the data binding. - - - - - Specifies the exact value of the IsBreak property of the - RadTab that will be created during the data binding. - - - - - Specifies the field, containing the IsBreak property - value of the RadTab that will be created during - the data binding. - - - - - Specifies the exact value of the PerTabScrolling property of the - RadTab that will be created during the data binding. - - - - - Specifies the field, containing the PerTabScrolling property - value of the RadTab that will be created during - the data binding. - - - - - Specifies the exact value of the ScrollChildren property of the - RadTab that will be created during the data binding. - - - - - Specifies the field, containing the ScrollChildren property - value of the RadTab that will be created during - the data binding. - - - - - Specifies the exact value of the ScrollPosition property of the - RadTab that will be created during the data binding. - - - - - Specifies the field, containing the ScrollPosition property - value of the RadTab that will be created during - the data binding. - - - - - Specifies the exact value of the SelectedCssClass property of the - RadTab that will be created during the data binding. - - - - - Specifies the field, containing the SelectedCssClass property - value of the RadTab that will be created during - the data binding. - - - - - Specifies the exact value of the SelectedImageUrl property of the - RadTab that will be created during the data binding. - - - - - Specifies the field, containing the SelectedImageUrl property - value of the RadTab that will be created during - the data binding. - - - - - Specifies the field, containing the SelectedIndex property - value of the RadTab that will be created during - the data binding. - - - - - Specifies the exact value of the SelectedIndex property of the - RadTab that will be created during the data binding. - - - - - Specifies the exact value of the PageViewID property of the - RadTab that will be created during the data binding. - - - - - Specifies the field, containing the PageViewID property - value of the RadTab that will be created during - the data binding. - - - - - Specifies the exact value of the ScrollButtonsPosition property of the - RadTab that will be created during the data binding. - - - - - Specifies the field, containing the ScrollButtonsPosition property - value of the RadTab that will be created during - the data binding. - - - - - Represents a collection of objects. - - - - - Gets the object at the specified index from the collection. - - - The at the specified index in the collection. - - - The zero-based index of the to retrieve. - - - - A navigation control used to create tabbed interfaces. - - - The RadTabStrip control is used to display a list of tabs in a Web Forms - page and is often used in combination with a - RadMultiPage control for building tabbed - interfaces. The RadTabStrip control supports the following features: - - - Databinding that allows the control to be populated from various - datasources - Programmatic access to the RadTabStrip object model - which allows to dynamic creation of tabstrips, populate h tabs, set - properties. - Customizable appearance through built-in or user-defined skins. - -

Tabs

- - The RadTabStrip control is made up of tree of tabs represented - by RadTab objects. Tabs at the top level (level 0) are - called root tabs. A tab that has a parent tab is called a child tab. All root - tabs are stored in the Tabs collection. Child tabs are - stored in a parent tab's Tabs collection. - - - Each tab has a Text and a Value property. - The value of the Text property is displayed in the RadTabStrip control, - while the Value property is used to store any additional data about the tab, - such as data passed to the postback event associated with the tab. When clicked, a tab can - navigate to another Web page indicated by the NavigateUrl property. - -
-
- - - Initializes a new instance of the RadTabStrip class. - - - Use this constructor to create and initialize a new instance of the RadTabStrip - control. - - - The following example demonstrates how to programmatically create a RadTabStrip - control. - - void Page_Load(object sender, EventArgs e) - { - RadTabStrip RadTabStrip1 = new RadTabStrip(); - RadTabStrip1.ID = "RadTabStrip1"; - - if (!Page.IsPostBack) - { - //RadTabStrip persist its tab in ViewState (if EnableViewState is true). - //Hence tabs should be created only on initial load. - - RadTab sportTab = new RadTab("Sport"); - RadTabStrip1.Tabs.Add(sportTab); - - RadTab newsTab = new RadTab("News"); - RadTabStrip1.Tabs.Add(newsTab); - } - - PlaceHolder1.Controls.Add(RadTabStrip1); - } - - - Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Load - Dim RadTabStrip1 As RadTabStrip = New RadTabStrip() - RadTabStrip1.ID = "RadTabStrip1" - - If Not Page.IsPostBack Then - 'RadTabStrip persist its tab in ViewState (if EnableViewState is true). - 'Hence tabs should be created only on initial load. - - Dim sportTab As RadTab = New RadTab("Sport") - RadTabStrip1.Tabs.Add(sportTab) - - Dim newsTab As RadTab = New RadTab("News") - RadTabStrip1.Tabs.Add(newsTab) - End If - - PlaceHolder1.Controls.Add(RadTabStrip1) - End Sub - - - - - - Populates the RadTabStrip control from external XML file. - - - The newly added items will be appended after any existing ones. - - - The following example demonstrates how to populate RadTabStrip control - from XML file. - - private void Page_Load(object sender, EventArgs e) - { - if (!Page.IsPostBack) - { - RadTabStrip1.LoadContentFile("~/Data.xml"); - } - } - - - Private Sub Page_Load(sender As Object, e As EventArgs) Handles MyBase.Load - If Not Page.IsPostBack Then - RadTabStrip1.LoadContentFile("~/Data.xml") - End If - End Sub - - - The name of the XML file. - - - - Gets a linear list of all tabs in the RadTabStrip control. - - - An IList object containing - all tabs in the current RadTabStrip control. - - - - - Searches the RadTabStrip control for the first - RadTab whose NavigateUrl - property is equal to the specified value. - - - A RadTab whose NavigateUrl property is equal to the specifed - value. If a tab is not found, null (Nothing in Visual Basic) is returned. - - - The URL to search for. - - - - - Searches the RadTabStrip control for the first - RadTab whose Value property is equal - to the specified value. - - - A RadTab whose Value property is equal to the specifed - value. If a tab is not found, null (Nothing in Visual Basic) is returned. - - - The value to search for. - - - - - Searches the RadTabStrip control for the first - RadTab whose Value property is equal - to the specified value. - - - A RadTab whose Value property is equal to the specifed - value. If a tab is not found, null (Nothing in Visual Basic) is returned. - - - The value to search for. - - A Boolean indicating a case-sensitive or insensitive comparison (true indicates a case-insensitive comparison). - - - - Searches the RadTabStrip control for the first - RadTab whose Text property is equal to - the specified value. - - - A RadTab whose Text property is equal - to the specified value. If a tab is not found, null (Nothing in Visual Basic) is returned. - - The value to search for. - - - - Searches the RadTabStrip control for the first - RadTab whose Text property is equal to - the specified value. - - - A RadTab whose Text property is equal - to the specified value. If a tab is not found, null (Nothing in Visual Basic) is returned. - - The value to search for. - A Boolean indicating a case-sensitive or insensitive comparison (true indicates a case-insensitive comparison). - - - - Returns the first RadTab - that matches the conditions defined by the specified predicate. - The predicate should returns a boolean value. - - - The following example demonstrates how to use the FindTab method. - - void Page_Load(object sender, EventArgs e) - { - RadTabStrip1.FindTab(ItemWithEqualsTextAndValue); - } - private static bool ItemWithEqualsTextAndValue(RadTab tab) - { - if (tab.Text == tab.Value) - { - return true; - } - else - { - return false; - } - } - - - Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs) - RadTabStrip1.FindTab(ItemWithEqualsTextAndValue) - End Sub - Private Shared Function ItemWithEqualsTextAndValue(ByVal tab As RadTab) As Boolean - If tab.Text = tab.Value Then - Return True - Else - Return False - End If - End Function - - - The Predicate <> that defines the conditions of the element to search for. - - - - Gets a list of all client-side changes (adding a tab, removing a tab, changing a tab's property) which have occurred. - - - A list of objects which represent all client-side changes the user has performed. - By default the ClientChanges property returns empty list. Client-changes are recorded if and only if the client-side - methods trackChanges()/commitChanges() have been invoked. - - - You can use the ClientChanges property to respond to client-side modifications such as - - adding a new tab - removing existing tab - clearing the children of a tab or the control itself - changing a property of the tab - - The ClientChanges property is available in the first postback (ajax) request after the client-side modifications - have taken place. After this moment the property will return empty list. - - - The following example demonstrates how to use the ClientChanges property - - foreach (ClientOperation<RadTab> operation in RadTabStrip1.ClientChanges) - { - RadTab tab = operation.Item; - - switch (operation.Type) - { - case ClientOperationType.Insert: - //An tab has been inserted - operation.Item contains the inserted tab - break; - case ClientOperationType.Remove: - //An tab has been inserted - operation.Item contains the removed tab. - //Keep in mind the tab has been removed from the tabstrip. - break; - case ClientOperationType.Update: - UpdateClientOperation<RadTab> update = operation as UpdateClientOperation<RadTab> - //The "UpdateOperation" provides an additional property "PropertyName". This is the property whose value was changed from the client side. - break; - case ClientOperationType.Clear: - //All children of have been removed - operation.Item contains the parent tab whose children have been removed. If operation.Item is null then the root tabs have been removed. - break; - } - } - - - For Each operation As ClientOperation(Of RadTab) In RadTabStrip1.ClientChanges - Dim tab As RadTab = operation.Item - Select Case operation.Type - Case ClientOperationType.Insert - 'A tab has been inserted - operation.Item contains the inserted tab - Exit Select - Case ClientOperationType.Remove - 'A tab has been inserted - operation.Item contains the removed tab. - 'Keep in mind the tab has been removed from the tabstrip. - Exit Select - Case ClientOperationType.Update - Dim update As UpdateClientOperation(Of RadTab) = TryCast(operation, UpdateClientOperation(Of RadTab)) - 'The "UpdateOperation" provides an additional property "PropertyName". This is the property whose value was changed from the client side. - Exit Select - Case ClientOperationType.Clear - 'All children of have been removed - operation.Item contains the parent tab whose children have been removed. If operation.Item is Nothing then the root tabs have been removed. - Exist Select - End Select - Next - - - - - - Gets or sets a value indicating whether the immediate children of the RadTabStrip control will be - scrollable. - - - true if the child tabs will be scrollable; otherwise false. The default value is false. - - - - The position of the scroll buttons with regards to the tab band. - - This property is applicable when the - ScrollChildren property is set to - true; otherwise it is ignored. - - - One of the TabStripScrollButtonsPosition - enumeration values. The default value is Right. - - - - - Gets or sets the position of the scrollable band of tabs relative to the - beginning of the scrolling area. - - - This property is applicable when the ScrollChildren property is set to - true; otherwise it is ignored. - - - An integer specifying the initial scrolling position (measured in pixels). The default value is 0 - (no offset from the default scrolling position). Use negative values to move the tabs to the left. - - - - - Gets or sets a value indicating whether the tabstrip should scroll directly to - the next tab. - - - true if the tabstrip should scroll to the next (or previous) tab; otherwise false. - The default value is false. - - - By default tabs are scrolled smoothly. If you want the tabstrip to scroll directly - to the next (or previous) tab set this property to true. This - property is applicable when the ScrollChildren - property is set to true; otherwise it is ignored. - - - - - Gets or sets the index of the selected child tab. - - - The zero based index of the selected tab. The default value is -1 (no child tab is selected). - - - Use the SelectedIndex property to programmatically specify the selected - child tab in a IRadTabContainer (RadTabStrip or RadTab). - To clear the selection set the SelectedIndex property to -1. - - - The following example demonstrates how to programmatically select a tab by using - the SelectedIndex property. - - void Page_Load(object sender, EventArgs e) - { - if (!Page.IsPostBack) - { - RadTab newsTab = new RadTab("News"); - RadTabStrip1.Tabs.Add(newsTab); - - RadTabStrip1.SelectedIndex = 0; //This will select the "News" tab - - RadTab cnnTab = new RadTab("CNN"); - newsTab.Tabs.Add(cnnTab); - - RadTab nbcTab = new RadTab("NBC"); - newsTab.Tabs.Add(nbcTab); - - newsTab.SelectedIndex = 1; //This will select the "NBC" child tab of the "News" tab - } - } - - - Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Load - If Not Page.IsPostBack Then - Dim newsTab As RadTab = New RadTab("News") - RadTabStrip1.Tabs.Add(newsTab) - - RadTabStrip1.SelectedIndex = 0 'This will select the "News" tab - - Dim cnnTab As RadTab = New RadTab("CNN") - newsTab.Tabs.Add(cnnTab) - - Dim nbcTab As RadTab = New RadTab("NBC") - newsTab.Tabs.Add(nbcTab) - - newsTab.SelectedIndex = 1 'This will select the "NBC" child tab of the "News" tab - End If - End Sub - - - - - - Gets the selected child tab. - - - Returns the child tab which is currently selected. If no tab is selected - (the SelectedIndex property is -1) the SelectedTab - property will return null (Nothing in VB.NET). - - - - - Gets a RadTabCollection object that contains the root tabs of the current RadTabStrip control. - - - A RadTabCollection that contains the root tabs of the current RadTabStrip control. By default - the collection is empty (RadTabStrip has no children). - - - Use the Tabs property to access the child tabs of RadTabStrip. You can also use the Tabs property to - manage the root tabs. You can add, remove or modify tabs from the Tabs collection. - - - The following example demonstrates how to programmatically modify the properties of root tabs. - - RadTabStrip1.Tabs[0].Text = "Example"; - RadTabStrip1.Tabs[0].NavigateUrl = "http://www.example.com"; - - - RadTabStrip1.Tabs(0).Text = "Example" - RadTabStrip1.Tabs(0).NavigateUrl = "http://www.example.com" - - - - - Gets or sets the template for displaying all tabs in the control. - - An object implementing the ITemplateThe default value is a null reference (Nothing in - Visual Basic), which indicates that this property is not set. - - To specify unique display for specific tabs use the - property of the class. - - - - The following example demonstrates how to customize the appearance of all tabs - - <telerik:RadTabStrip runat="server" ID="RadTabStrip1"> - <TabTemplate> - <%# DataBinder.Eval(Container, "Text") %> - <img style="margin-left: 10px" src="Images/delete.gif" alt="delete"/> - </TabTemplate> - <Tabs> - <telerik:RadTab Text="Products"> - </telerik:RadTab> - <telerik:RadTab Text="Services"> - </telerik:RadTab> - <telerik:RadTab Text="Corporate"> - </telerik:RadTab> - </Tabs> - </telerik:RadTabStrip> - - - protected void Page_Load(object sender, System.EventArgs e) - { - if (!Page.IsPostBack) - { - //Required to evaluate the databinding expressions inside the template (<%# DataBinder.Eval)%> - RadTabStrip1.DataBind(); - } - } - - - Private Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles MyBase.Load - If Not Page.IsPostBack Then - RadTabStrip1.DataBind() - End If - End Sub - - - - - - Gets or sets a value indicating whether tabs should postback when clicked. - - - True if tabs should postback; otherwise false. The default value is false. - - - RadTabStrip will postback provided one of the following conditions is met: - - - The AutoPostBack property is set to true. - - - The user has subscribed to the TabClick event. - - - - - - - Gets a collection of objects that define the relationship - between a data item and the tab it is binding to. - - - - - Gets or sets a value that indicates whether child tabs are cleared before - data binding. - - - The AppendDataBoundTabs property allows you to add items to - the RadTabStrp control before data binding occurs. After data binding, the items - collection contains both the items from the data source and the previously added - items. - The value of this property is stored in view state. - - - True if child tabs should not be cleared before databinding; - otherwise false. The default value is false (child - items will be cleared before databinding). - - - - - Gets or sets the maximum number of levels to bind to the RadTabStrip control. - - - The maximum number of levels to bind to the RadTabStrip control. The default is -1, which binds all the levels in the data source to the control. - - - When binding the RadTabStrip control to a data source, use the MaxDataBindDepth - property to limit the number of levels to bind to the control. For example, setting this property to 2 binds only - the root tabs and their immediate children. All remaining records in the data source are ignored. - - - - - Gets or sets the field of the data source that provides the text content of the tabs. - - - A string that specifies the field of the data source that provides the text content of the tabs. - The default value is empty string. - - - Use the DataTextField property to specify the field of the data source (in most cases the name of the database column) - which provides values for the Text property of databound tabs. The DataTextField property is - taken into account only during data binding. - - - The following example demonstrates how to use the DataTextField. - - DataTable data = new DataTable(); - data.Columns.Add("MyText"); - - data.Rows.Add(new object[] {"Tab Text 1"}); - data.Rows.Add(new object[] {"Tab Text 2"}); - - RadTabStrip1.DataSource = data; - RadTabStrip1.DataTextField = "MyText"; //"MyText" column provides values for the Text property of databound tabs - RadTabStrip1.DataBind(); - - - Dim data As new DataTable(); - data.Columns.Add("MyText") - - data.Rows.Add(New Object() {"Tab Text 1"}) - data.Rows.Add(New Object() {"Tab Text 2"}) - - RadTabStrip1.DataSource = data - RadTabStrip1.DataTextField = "MyText" '"MyText" column provides values for the Text property of databound tabs - RadTabStrip1.DataBind() - - - - - - Gets or sets the field of the data source that provides the value of the tabs. - - - A string that specifies the field of the data source that provides the value of the tabs. - The default value is empty string. - - - Use the DataValueField property to specify the field of the data source (in most cases the name of the database column) - which provides the values for the Value property of databound tabs. The DataValueField property is - taken into account only during data binding. If the DataValueField property is not set the Value - property of databound tabs will have its default value - empty string. - - - The following example demonstrates how to use the DataValueField. - - DataTable data = new DataTable(); - data.Columns.Add("MyText"); - data.Columns.Add("MyValue"); - - data.Rows.Add(new object[] {"Tab Text 1", "Tab Value 1"}); - data.Rows.Add(new object[] {"Tab Text 2", "Tab Value 2"}); - - RadTabStrip1.DataSource = data; - RadTabStrip1.DataTextField = "MyText"; //"MyText" column provides values for the Text property of databound tabs - RadTabStrip1.DataValueField = "MyValue"; //"MyValue" column provides values for the Value property of databound tabs - RadTabStrip1.DataBind(); - - - Dim data As new DataTable(); - data.Columns.Add("MyText") - data.Columns.Add("MyValue") - - data.Rows.Add(New Object() {"Tab Text 1", "Tab Value 1"}) - data.Rows.Add(New Object() {"Tab Text 2", "Tab Value 2"}) - - RadTabStrip1.DataSource = data - RadTabStrip1.DataTextField = "MyText" '"MyText" column provides values for the Text property of databound tabs - RadTabStrip1.DataValueField = "MyValue" '"MyValue" column provides values for the Value property of databound tabs - RadTabStrip1.DataBind() - - - - - - Gets or sets the field of the data source that provides the URL to which tabs navigate. - - - A string that specifies the field of the data source that provides the URL to which tabs will navigate. - The default value is empty string. - - - Use the DataNavigateUrlField property to specify the field of the data source (in most cases the name of the database column) - which provides the values for the NavigateUrl property of databound tabs. - The DataNavigateUrlField property is taken into account only during data binding. If the DataNavigateUrlField property - is not set the NavigateUrl property of databound tabs will have its default value - empty string. - - - The following example demonstrates how to use the DataNavigateUrlField. - - DataTable data = new DataTable(); - data.Columns.Add("MyText"); - data.Columns.Add("MyUrl"); - - data.Rows.Add(new object[] {"Tab Text 1", "http://www.example.com/page1.aspx"}); - data.Rows.Add(new object[] {"Tab Text 2", "http://www.example.com/page2.aspx"}); - - RadTabStrip1.DataSource = data; - RadTabStrip1.DataTextField = "MyText"; //"MyText" column provides values for the Text property of databound tabs - RadTabStrip1.DataNavigateUrlField = "MyUrl"; //"MyUrl" column provides values for the NavigateUrl property of databound tabs - RadTabStrip1.DataBind(); - - - Dim data As new DataTable(); - data.Columns.Add("MyText") - data.Columns.Add("MyUrl") - - data.Rows.Add(New Object() {"Tab Text 1", "http://www.example.com/page1.aspx"}) - data.Rows.Add(New Object() {"Tab Text 2", "http://www.example.com/page2.aspx"}) - - RadTabStrip1.DataSource = data - RadTabStrip1.DataTextField = "MyText" '"MyText" column provides values for the Text property of databound tabs - RadTabStrip1.DataValueField = "MyUrl" '"MyUrl" column provides values for the NavigateUrl property of databound tabs - RadTabStrip1.DataBind() - - - - - - Gets or sets the field from the data source which is the "child" column in the - "parent-child" relationship used to databind the RadTabStrip - control. - - - A string that specifies the field of the data source that will be the "child" - column during databinding. The default is empty string. - - - RadTabStrip requires both DataFieldID and - DataFieldParentID properties to be set in order to be hierarchically databound. - - - The following example demonstrates how to use DataFieldID and DataFieldParentID. - - DataTable data = new DataTable(); - data.Columns.Add("MyText"); - data.Columns.Add("MyID", typeof(int)); - data.Columns.Add("MyParentID", typeof(int)); - - data.Rows.Add(new object[] {"Root Tab 1", 1, null}); - data.Rows.Add(new object[] {"Child Tab 1.1", 3, 1}); - data.Rows.Add(new object[] {"Root Tab 2", 2, null}); - data.Rows.Add(new object[] {"Child Tab 2.1", 4, 2}); - - RadTabStrip1.DataSource = data; - RadTabStrip1.DataTextField = "MyText"; //"MyText" column provides values for the Text property of databound tabs - RadTabStrip1.DataFieldID = "MyID"; //"MyID" column provides values for the "child" column in the relation. - RadTabStrip1.DataFieldParentID = "MyParentID"; //"MyParentID" column provides values for the "parent" column in the relation. - RadTabStrip1.DataBind(); - - - Dim data As New DataTable() - data.Columns.Add("MyText") - data.Columns.Add("MyID", GetType(Integer)) - data.Columns.Add("MyParentID", GetType(Integer)) - - data.Rows.Add(New Object() {"Root Tab 1", 1, Nothing}) - data.Rows.Add(New Object() {"Child Tab 1.1", 3, 1}) - data.Rows.Add(New Object() {"Root Tab 2", 2, Nothing}) - data.Rows.Add(New Object() {"Child Tab 2.1", 4, 2}) - - RadTabStrip1.DataSource = data - RadTabStrip1.DataTextField = "MyText" '"MyText" column provides values for the Text property of databound tabs - RadTabStrip1.DataFieldID = "MyID" '"MyID" column provides values for the "child" column in the relation. - RadTabStrip1.DataFieldParentID = "MyParentID" '"MyParentID" column provides values for the "parent" column in the relation. - RadTabStrip1.DataBind() - - - - - - Gets or sets the field from the data source which is the "parent" column in the - "parent-child" relationship used to databind the RadTabStrip - control. - - - A string that specifies the field of the data source that will be the "parent" - column during databinding. The default is empty string. - - - - RadTabStrip requires both DataFieldID and - DataFieldParentID properties to be set in order to be hierarchically databound. - - - The value of the column specified by DataFieldParentID must be null (Nothing) for root tabs. This is a requirement - for databinding RadTabStrip. - - - - The following example demonstrates how to use DataFieldID and DataFieldParentID. - - DataTable data = new DataTable(); - data.Columns.Add("MyText"); - data.Columns.Add("MyID", typeof(int)); - data.Columns.Add("MyParentID", typeof(int)); - - data.Rows.Add(new object[] {"Root Tab 1", 1, null}); - data.Rows.Add(new object[] {"Child Tab 1.1", 3, 1}); - data.Rows.Add(new object[] {"Root Tab 2", 2, null}); - data.Rows.Add(new object[] {"Child Tab 2.1", 4, 2}); - - RadTabStrip1.DataSource = data; - RadTabStrip1.DataTextField = "MyText"; //"MyText" column provides values for the Text property of databound tabs - RadTabStrip1.DataFieldID = "MyID"; //"MyID" column provides values for the "child" column in the relation. - RadTabStrip1.DataFieldParentID = "MyParentID"; //"MyParentID" column provides values for the "parent" column in the relation. - RadTabStrip1.DataBind(); - - - Dim data As New DataTable() - data.Columns.Add("MyText") - data.Columns.Add("MyID", GetType(Integer)) - data.Columns.Add("MyParentID", GetType(Integer)) - - data.Rows.Add(New Object() {"Root Tab 1", 1, Nothing}) - data.Rows.Add(New Object() {"Child Tab 1.1", 3, 1}) - data.Rows.Add(New Object() {"Root Tab 2", 2, Nothing}) - data.Rows.Add(New Object() {"Child Tab 2.1", 4, 2}) - - RadTabStrip1.DataSource = data - RadTabStrip1.DataTextField = "MyText" '"MyText" column provides values for the Text property of databound tabs - RadTabStrip1.DataFieldID = "MyID" '"MyID" column provides values for the "child" column in the relation. - RadTabStrip1.DataFieldParentID = "MyParentID" '"MyParentID" column provides values for the "parent" column in the relation. - RadTabStrip1.DataBind() - - - - - - Gets or sets the formatting string used to control how text to the tabstrip - control is displayed. - - - - Use the DataTextFormatString property to provide a custom display format for text of the tabs. - The data format string consists of two parts, separated by a colon, in the form { A: Bxx }. - For example, the formatting string {0:F2} would display a fixed point number with two decimal places. - - - The entire string must be enclosed in braces to indicate that it is a format string and not a literal string. - Any text outside the braces is displayed as literal text. - - - The value before the colon (A in the general example) specifies the parameter index in a zero-based list of parameters. - This value can only be set to 0. - - - - - - Gets the innermost selected tab in a hierarchical RadTabStrip control. - - - In hierarchical tabstrips this property returns the innermost selected - tab. - - - Returns the inner most selected child tab in hierarchical tabstrip scenarios. - Null (Nothing in VB.NET) if no tab is selected. - - - - - Gets or sets the name of the validation group to which this validation - control belongs. - - - The name of the validation group to which this validation control belongs. The - default is an empty string (""), which indicates that this property is not set. - - - This property works only when CausesValidation - is set to true. - - - - - - Gets or sets the URL of the page to post to from the current page when a tab - from the tabstrip is clicked. - - - The URL of the Web page to post to from the current page when a tab from the - tabstrip control is clicked. The default value is an empty string (""), which causes - the page to post back to itself. - - - - - Gets or sets the ID of the RadMultiPage control that - will be controlled by the current RadTabStrip control. - - - You should use different value depending on the following conditions: - - - Use the ID property of the RadMuitiPage control if the RadMultiPage control is in - the same INamingContainer (user control, page, content page, master page) as the current RadTabStrip control. - - - Use the UniqueID property of the RadMuitiPage control if the RadMultiPage - control is in a different INamingContainer (user control, page, content page, master page) than - the current RadTabStrip control. - - - - - The ID of the associated RadMultiPage. The default value is empty string. - - - The following example demonstrates how to associate a RadMultiPage - control with a RadTabStrip control through the - MultiPageID property. - - <telerik:RadTabStrip id="RadTabStrip1" runat="server" - MultiPageID="RadMultiPage1">
- <Tabs>
- <telerik:RadTab Text="Personal Details"></telerik:RadTab>
- <telerik:RadTab Text="Education"></telerik:RadTab>
- <telerik:RadTab Text="Computing Skills"></telerik:RadTab>
- </Tabs>
- </telerik:RadTabStrip>
-
- <telerik:RadMultiPage id="RadMultiPage1" - runat="server">
- .....
- </telerik:RadMultiPage>
-
-
-
- - - Gets the associated RadMultiPage control if the - MultiPageID property is set. - - - The RadMultiPage control associated with the - current RadTabStrip control. Will return null (Nothing in VB.NET) if the MultiPageID - is not set or a corresponding RadMultiPage control cannot be found - - - - - Gets or sets a value indicating whether the tabstrip should postback when the user clicks the currently selected tab. - - - True if the tabstrip should postback when the user clicks the currently selected tab; otherwise false. - The default value is false. - - - - - Gets or sets a value indicating the orientation of child tabs within the - RadTabStrip control. - - - One of the TabStripOrientation values. - The default value is HorizontalTopToBottom. - - - - Gets or sets the alignment of the tabs in the RadTabStrip control. - - One of the TabStripAlign enumeration values. The - default value is Left. - - - - - Gets or sets a value indicating whether the row of the selected tab should move - to the bottom. - - - true if the row containing the selected tab should be moved to - the bottom; otherwise false. The default value is - false. - - - Use the ReorderTabsOnSelect property to mimic the behavior of the - Windows tabstrip control. - - - - - Shows or hides the image at the base of the first level of tabs. - - - true if line is visible; - otherwise, false. The default value is false. - - - - - Gets or sets a value determining whether child tabs are unselected when a parent - tab is unselected. - - - true if child tabs are unselected when a parent tab is - unselected. false if the tabs persist their state even when hidden. - The default value is false. - - - - - Gets or sets a value indicating whether validation is performed when a tab within - the RadTabStrip control is selected. - - - true if validation is performed when a tab is selected; - otherwise, false. The default value is true. - - - By default, page validation is performed when a tab is selected. Page - validation determines whether the input controls associated with a validation - control on the page all pass the validation rules specified by the validation - control. You can specify or determine whether validation is performed on both the - client and the server when a tab is clicked by using the CausesValidation - property. To prevent validation from being performed, set the - CausesValidation property to false. - - - - - Gets or sets a value indicating the client-side event handler that is called - after selecting a tab. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - Use the OnClientTabSelected property to specify a JavaScript - function that will be executed after a tab is selected - either by left-clicking it - with a mouse or hitting enter after tabbing to that tab. - Two parameters are passed to the handler - - sender (the client-side RadTabStrip object) - - eventArgs with one property -
    -
  • tab - the instance of the selected tab
  • -
-
-
-
- - The following example demonstrates how to use the - OnClientTabSelected property. - - <script language="javascript">
- function ClientTabSelectedHandler(sender, eventArgs)
- {
- var tabStrip = sender;
- var tab = eventArgs.get_tab();
-
- alert("You have selected the " + tab.get_text() + " tab in the " + tabStrip.get_id() + - "tabstrip.");
- }
- </script>
- <telerik:RadTabStrip id="RadTabStrip1" runat="server" - OnClientTabSelected="ClientTabSelectedHandler">
- <Tabs>
- <telerik:RadTab Text="Personal Details"></telerik:RadTab>
- <telerik:RadTab Text="Education"></telerik:RadTab>
- <telerik:RadTab Text="Computing Skills"></telerik:RadTab>
- </Tabs>
- </telerik:RadTabStrip>
-
-
-
- - - Gets or sets a value indicating the client-side event handler that is called - before the browser context menu shows (after right-clicking an item). - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - Use the OnClientContextMenu property to specify a JavaScript - function that will be executed before the context menu shows after right clicking a - tab. - Two parameters are passed to the handler - - sender (the client-side RadTabStrip object) - - eventArgs with two properties -
    -
  • tab - the instance of the selected tab
  • -
  • domEvent - the browser DOM event
  • -
-
-
-
- - The following example demonstrates how to use the - OnClientContextMenu property. - - <script language="javascript">
- function OnContextMenuHandler(sender, eventArgs)
- {
- var tabStrip = sender;
- var tab = eventArgs.get_tab();
-
- alert("You have right-clicked the " + tab.get_text() + " tab in the " + tabStrip.get_id() + - "tabstrip.");
- }
- </script>
- <telerik:RadTabStrip id="RadTabStrip1" runat="server" - OnClientContextMenu="OnContextMenuHandler">
- <Tabs>
- <telerik:RadTab Text="Personal Details"></telerik:RadTab>
- <telerik:RadTab Text="Education"></telerik:RadTab>
- <telerik:RadTab Text="Computing Skills"></telerik:RadTab>
- </Tabs>
- </telerik:RadTabStrip>
-
-
-
- - - Gets or sets a value indicating the client-side event handler that is called - when the user double-clicks a tab. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - Use the OnClientDoubleClick property to specify a JavaScript - function that will be executed when the user double-clicks a tab. - - Two parameters are passed to the handler - - sender (the client-side RadTabStrip object) - - eventArgs with two properties -
    -
  • tab - the instance of the selected tab
  • -
  • domEvent - the browser DOM event
  • -
-
-
-
- - The following example demonstrates how to use the - OnClientDoubleClick property. - - <script language="javascript">
- function OnDoubleClickHandler(sender, eventArgs)
- {
- var tabStrip = sender;
- var tab = eventArgs.get_tab();
-
- alert("You have double-clicked the " + tab.get_text() + " tab in the " + tabStrip.get_id() + - "tabstrip.");
- }
- </script>
- <telerik:RadTabStrip id="RadTabStrip1" runat="server" - OnClientDoubleClick="OnDoubleClickHandler">
- <Tabs>
- <telerik:RadTab Text="Personal Details"></telerik:RadTab>
- <telerik:RadTab Text="Education"></telerik:RadTab>
- <telerik:RadTab Text="Computing Skills"></telerik:RadTab>
- </Tabs>
- </telerik:RadTabStrip>
-
-
-
- - - Gets or sets a value indicating the client-side event handler that is called just - prior to selecting a tab. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - Use the OnClientTabSelecting property to specify a - JavaScript function that will be executed prior to tab selecting - either by - left-clicking it with a mouse or hitting enter after tabbing to that tab. You can - cancel that event (prevent tab selecting) by seting the cancel property of the event argument to true. - Two parameters are passed to the handler - - sender (the client-side RadTabStrip object) - - eventArgs with one property -
    -
  • tab - the instance of the selected tab
  • -
  • cancel - whether to cancel the event
  • -
-
-
-
-
- - The following example demonstrates how to use the - OnClientTabSelecting property. - - <script language="javascript">
- function ClientTabSelectingHandler(sender, eventArgs)
- {
- var tabStrip = sender;
- var tab = eventArgs.get_tab();
-
- alert("You will be selecting the " + tab.get_text() + " tab in the " + tabStrip.get_id() + - " tabstrip.");
-
- if (tab.Text == "Education")
- {
- alert("Education cannot be selected");
- eventArgs.set_cancel(true);
- }
- }
- </script>
-
- <telerik:RadTabStrip id="RadTabStrip1" runat="server" - OnClientTabSelecting="ClientTabSelectedHandler">
- <Tabs>
- <telerik:RadTab Text="Personal Details"></telerik:RadTab>
- <telerik:RadTab Text="Education"></telerik:RadTab>
- <telerik:RadTab Text="Computing Skills"></telerik:RadTab>
- </Tabs>
- </telerik:RadTabStrip>
-
-
-
- - - Gets or sets a value indicating the client-side event handler that is called when - the mouse hovers a tab in the RadTabStrip control. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - Use the OnClientMouseOver property to specify a JavaScript - function that is called when the user hovers a tab with the mouse. - Two parameters are passed to the handler: - - sender (the client-side RadTabStrip object); - - eventArgs with two properties -
    -
  • tab - the instance of the tab that is being hovered
  • -
  • domEvent - the instance of the browser event.
  • -
-
-
-
- - The following example demonstrates how to use the - OnClientMouseOver property. - - <script language="javascript">
- function ClientMouseOverHandler(sender, eventArgs)
- {
- var tabStrip = sender;
- var tab = eventArgs.get_tab();
- var domEvent = eventArgs.get_domEvent();
-
- alert("You have just moved over the " + tab.get_text() + " tabs in the " + - tabStrip.get_id() + " tabstrip");
- alert("Mouse coordinates: " + domEvent.clientX + ":" + - domEvent.clientY);
- }
- </script>
-
- <telerik:RadTabStrip id="RadTabStrip1" runat="server" - OnClientMouseOver="ClientMouseOverHandler">
- <Tabs>
- <telerik:RadTab Text="Personal Details"></telerik:RadTab>
- <telerik:RadTab Text="Education"></telerik:RadTab>
- <telerik:RadTab Text="Computing Skills"></telerik:RadTab>
- </Tabs>
- </telerik:RadTabStrip>
-
-
-
- - - Gets or sets a value indicating the client-side event handler that is called when - the mouse leaves a tab in the RadTabStrip control. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - Use the OnClientMouseOut property to specify a JavaScript - function that is executed whenever the user moves the mouse - away from a particular tab in the RadTabStrip control. - Two parameters are passed to the handler: - - sender (the client-side RadTabStrip - object); - - eventArgs with two properties: -
    -
  • tab - the instance of the tab we are moving - away from;
  • -
  • domEvent - the instance of the browser - event.
  • -
-
-
-
- - The following example demonstrates how to use the OnClientMouseOut - property. - - <script language="javascript">
- function ClientMouseOutHandler(sender, eventArgs)
- {
- var tabStrip = sender;
- var tab = eventArgs.Tab;
- var domEvent = eventArgs.get_domEvent();
- alert("You have just moved out of " + tab.get_text() + " in - the " + tabStrip.get_id() + " tabstrip.");
- alert("Mouse coordinates: " + domEvent.clientX + ":" + - domEvent.clientY);
- }
- </script>
-
- <telerik:RadTabStrip id="RadTabStrip1" runat="server" - OnClientMouseOut="ClientMouseOutHandler">
- <Tabs>
- <telerik:RadTab Text="Personal Details"></telerik:RadTab>
- <telerik:RadTab Text="Education"></telerik:RadTab>
- <telerik:RadTab Text="Computing Skills"></telerik:RadTab>
- </Tabs>
- </telerik:RadTabStrip>
-
-
-
- - - Gets or sets a value indicating the client-side event handler that is called - after a tab is unselected (i.e. the user has selected another tab). - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - Use the OnClientTabUnSelected property to specify a - JavaScript function that is executed after a tab is - unselected. - Two parameters are passed to the handler: - - sender (the client-side RadTabStrip - object); - - eventArgs with one property: -
    -
  • tab - the instance of the tab which is - unselected;
  • -
-
-
-
- - The following example demonstrates how to use the OnClientMouseOut - property. - - <script language="javascript">
- function ClientTabUnSelectedHandler(sender, eventArgs)
- {
- var tabStrip = sender;
- var tab = eventArgs.get_tab();
-
- alert("You have unselected the " + tab.get_text() + " tab in the " + tabStrip.get_id() + - "tabstrip.");
- }
- </script>
-
- <telerik:RadTabStrip id="RadTabStrip1" runat="server" - OnClientTabUnSelected="ClientTabUnSelectedHandler">
- <Tabs>
- <telerik:RadTab Text="Personal Details"></telerik:RadTab>
- <telerik:RadTab Text="Education"></telerik:RadTab>
- <telerik:RadTab Text="Computing Skills"></telerik:RadTab>
- </Tabs>
- </telerik:RadTabStrip>
-
-
-
- - - Gets or sets the name of the javascript function called when the control is fully - initialized on the client side. - - - A string specifying the name of the javascript function called when the control - is fully initialized on the client side. The default value is empty string. - - - Use the OnClientLoad property to specify a JavaScript - function that is executed after the control is initialized on the client side. - A single parameter is passed to the handler, which is the - client-side RadTabStrip object. - - - The following example demonstrates how to use the OnClientLoad - property. - - <script language="javascript">
- function ClientTabstripLoad(tabstrip, eventArgs)
- {
- alert(tabstrip.get_id() + " is loaded.");
- }
- </script>
-
- <telerik:RadTabStrip id="RadTabStrip1" runat="server" - OnClientLoad="ClientTabstripLoad">
- <Tabs>
- <telerik:RadTab Text="Personal Details"></telerik:RadTab>
- <telerik:RadTab Text="Education"></telerik:RadTab>
- <telerik:RadTab Text="Computing Skills"></telerik:RadTab>
- </Tabs>
- </telerik:RadTabStrip>
-
-
-
- - Occurs when a tab is created. - - The TabCreated event is raised when an tab in the RadTabStrip control is created, - both during round-trips and at the time data is bound to the control. The TabCreated event is not raised for tabs - which are defined inline in the page or user control. - The TabCreated event is commonly used to initialize tab properties. - - - The following example demonstrates how to use the TabCreated event - to set the ToolTip property of each tab. - - protected void RadTabStrip1_TabCreated(object sender, Telerik.Web.UI.RadTabStripEventArgs e) - { - e.Tab.ToolTip = e.Tab.Text; - } - - - Sub RadTabStrip1_TabCreated(ByVal sender As Object, ByVal e As Telerik.Web.UI.RadTabStripEventArgs) Handles RadTabStrip1.TabCreated - e.Tab.ToolTip = e.Tab.Text - End Sub - - - - - Occurs when a tab is data bound. - - - The TabDataBound event is raised for each tab upon - databinding. You can retrieve the tab being bound using the event arguments. - The DataItem associated with the tab can be retrieved using - the DataItem property. - - The TabDataBound event is often used in scenarios when you - want to perform additional mapping of fields from the DataItem to their respective - properties in the Tab class. - - - The following example demonstrates how to map fields from the data item to - tab properties using the TabDataBound event. - - protected void RadTabStrip1_TabDataBound(object sender, Telerik.Web.UI.RadTabStripEventArgs e) - { - e.Tab.ImageUrl = "image" + (string)DataBinder.Eval(e.Tab.DataItem, "ID") + ".gif"; - e.Tab.NavigateUrl = (string)DataBinder.Eval(e.Tab.DataItem, "URL"); - } - - - Sub RadTabStrip1_TabDataBound(ByVal sender As Object, ByVal e As Telerik.Web.UI.RadTabStripEventArgs) Handles RadTabStrip1.TabDataBound - e.Tab.ImageUrl = "image" & DataBinder.Eval(e.Tab.DataItem, "ID") & ".gif" - e.Tab.NavigateUrl = CStr(DataBinder.Eval(e.Tab.DataItem, "URL")) - End Sub - - - - - - Occurs on the server when a tab in the RadTabStrip - control is clicked. - - - The following example demonstrates how to use the TabClick event to determine the clicked tab. - - protected void RadTabStrip1_TabClick(object sender, Telerik.Web.UI.RadTabStripEventArgs e) - { - Response.Write("Clicked tab is " + e.Tab.Text); - } - - - Sub RadTabStrip1_TabClick(ByVal sender As Object, ByVal e As Telerik.Web.UI.RadTabStripEventArgs) Handles RadTabStrip1.TabClick - Response.Write("Clicked tab is " & e.Tab.Text) - End Sub - - - - - Represents a tab in the RadTabStrip control. - - - The RadTabStrip control is made up of tabs. Tabs which are immediate children - of the tabstrip are root tabs. tabs which are children of root tabs are child tabs. - - - A tab usually stores data in two properties, the Text property and - the Value property. The value of the Text property is displayed - in the RadTabStrip control, and the Value - property is used to store additional data. - - To create tabs, use one of the following methods: - - - Use declarative syntax to define tabs inline in your page or user control. - - - Use one of the constructors to dynamically create new instances of the - RadTab class. These tabs can then be added to the - Tabs collection of another tab or tabstrip. - - - Data bind the RadTabStrip control to a data source. - - - - When the user clicks a tab, the RadTabStrip control can navigate - to a linked Web page, post back to the server or select that tab. If the - NavigateUrl property of a tab is set, the - RadTabStrip control navigates to the linked page. By default, a linked page - is displayed in the same window or frame. To display the linked content in a different - window or frame, use the Target property. - - - - - Initializes a new instance of the RadTab class. - - Use this constructor to create and initialize a new instance of the - RadTab class using default values. - - - The following example demonstrates how to add tabs to the - RadTabStrip control. - - RadTab tab = new RadTab(); - tab.Text = "News"; - tab.NavigateUrl = "~/News.aspx"; - - RadTabStrip1.Tabs.Add(tab); - - - Dim tab As New RadTab() - tab.Text = "News" - tab.NavigateUrl = "~/News.aspx" - - RadTabStrip1.Tabs.Add(tab) - - - - - - Initializes a new instance of the RadTab class with the - specified text data. - - - Use this constructor to create and initialize a new instance of the - RadTab class using the specified text. - - - The following example demonstrates how to add tabs to the - RadTabStrip control. - - RadTab tab = new RadTab("News"); - - RadTabStrip1.Tabs.Add(tab); - - - Dim tab As New RadTab("News") - - RadTabStrip1.Tabs.Add(tab) - - - - The text displayed for the tab. The Text property is initialized with the value - of this parameter. - - - - - Initializes a new instance of the RadTab class with the - specified text and value data. - - - - Use this constructor to create and initialize a new instance of the - RadTab class using the specified text and value. - - - - This example demonstrates how to add tabs to the - RadTabStrip control. - - RadTab tab = new RadTab("News", "NewsTabValue"); - - RadTabStrip1.Tabs.Add(tab); - - - Dim tab As New RadTab("News", "NewsTabValue") - - RadTabStrip1.Tabs.Add(tab) - - - - The text displayed for the tab. The Text property is initialized with the value - of this argument. - - - The value associated with the tab. The Value property is initialized with the value - of this parameter. - - - - - Selects recursively all parent tabs in the hierarchy. - - - Use this method to programmatically select all parents of the tab. Selected tabs - will be visible in the browser. - - - The following example demonstrates how to select the parents of the tab which - corresponds to the current URL. - - RadTab currentTab = RadTabStrip1.FindTabByUrl(Request.Url.PathAndQuery); - if (currentTab != null) - { - currentTab.SelectParents(); - } - - - Dim currentTab as RadTab = RadTabStrip1.FindTabByUrl(Request.Url.PathAndQuery) - - If Not currentTab Is Nothing Then - currentTab.SelectParents() - End If - - - - - - Gets or sets a value indicating whether the tab will behave as separator. - - true if the tab is separator; otherwise false. The default value is false. - - - Use separators to visually separate the tabs. You also need to specify the width - of the separator tab through the Width property. - - - - Gets or sets the template for displaying the tab. - - An object implementing the ITemplateThe default value is a null reference (Nothing in - Visual Basic), which indicates that this property is not set. - - To specify common display for all tabs use the - property of the control. - - - - The following example demonstrates how to customize the appearance of a specific tab using the - TabTemplate property - - <telerik:RadTabStrip ID="RadTabStrip1" runat="server"> - <Tabs> - <telerik:RadTab> - <TabTemplate> - Tab 1 <img src="Images/tabIcon.gif" alt="" /> - </TabTemplate> - </telerik:RadTab> - </Tabs> - </telerik:RadTabStrip> - - - - - - Gets the level of the current tab. - - - An integer representing the level of the tab. Root tabs are level 0 (zero). - - - - - Gets or sets a value indicating whether the tab is selected. - - - true if the tab is selected; otherwise false. - The default value is false. - - - Use the Selected property to determine whether the tab is currently selected - within its parent RadTabCollection. Setting the Selected - property to true will deselect the previously selected tab. - - - - - Gets the RadTabStrip instance which contains the current tab. - - - - - Gets or sets a value indicating whether clicking on the tab will postback. - - - true if the node should postback; otherwise false. - - - If you subscribe to the TabClick event all tabs - will postback. To prevent the current tab from initiating postback you can set the PostBack - property to false. - - - - Gets the data item that is bound to the tab - - An Object that represents the data item that is bound to the tab. The default value is null (Nothing in Visual Basic), - which indicates that the tab is not bound to any data item. The return value will always be null unless accessed within - a TabDataBound event handler. - - - This property is applicable only during data binding. Use it along with the - TabDataBound event to perform additional - mapping of fields from the data item to RadTab properties. - - - The following example demonstrates how to map fields from the data item to - RadTab properties. It assumes the user has subscribed to the - TabDataBound event. - - private void RadTabStrip1_TabDataBound(object sender, Telerik.Web.UI.RadTabStripEventArgs e) - { - e.Tab.ImageUrl = "image" + (string)DataBinder.Eval(e.Tab.DataItem, "ID") + ".gif"; - e.Tab.NavigateUrl = (string)DataBinder.Eval(e.Tab.DataItem, "URL"); - } - - - Sub RadTabStrip1_TabDataBound(ByVal sender As Object, ByVal e As Telerik.Web.UI.RadTabStripEventArgs) Handles RadTabStrip1.TabDataBound - e.Tab.ImageUrl = "image" & DataBinder.Eval(e.Tab.DataItem, "ID") & ".gif" - e.Tab.NavigateUrl = CStr(DataBinder.Eval(e.Tab.DataItem, "URL")) - End Sub - - - - - - Gets or sets a value indicating whether the children of the tab will be - scrollable. - - - true if the child tabs will be scrollable; otherwise false. The default value is false. - - - To enable scrolling of the child tabs the ScrollChildren property - must also be set to true. - - - - The position of the scroll buttons with regards to the tab band. - - This property is applicable when the - ScrollChildren property is set to - true; otherwise it is ignored. - - - One of the TabStripScrollButtonsPosition - enumeration values. The default value is Right. - - - - - Gets or sets the position of the scrollable band of tabs relative to the - beginning of the scrolling area. - - - This property is applicable when the - ScrollChildren property is set to - true; otherwise it is ignored. - - - An integer specifying the initial scrolling position (measured in pixels). The default value is 0 - (no offset from the default scrolling position). Use negative values to move the tabs to the left. - - - - - Gets or sets a value indicating whether the tabstrip should scroll directly to - the next tab. - - - true if the tabstrip should scroll to the next (or previous) tab; otherwise false. - The default value is false. - - - By default tabs are scrolled smoothly. If you want the tabstrip to scroll directly - to the next (or previous) tab set this property to true. This - property is applicable when the ScrollChildren - property is set to true; otherwise it is ignored. - - - - - Gets or sets the index of the selected child tab. - - - The zero based index of the selected tab. The default value is -1 (no child tab is selected). - - - Use the SelectedIndex property to programmatically specify the selected - child tab in a IRadTabContainer (RadTabStrip or RadTab). - To clear the selection set the SelectedIndex property to -1. - - - The following example demonstrates how to programmatically select a tab by using - the SelectedIndex property. - - void Page_Load(object sender, EventArgs e) - { - if (!Page.IsPostBack) - { - RadTab newsTab = new RadTab("News"); - RadTabStrip1.Tabs.Add(newsTab); - - RadTabStrip1.SelectedIndex = 0; //This will select the "News" tab - - RadTab cnnTab = new RadTab("CNN"); - newsTab.Tabs.Add(cnnTab); - - RadTab nbcTab = new RadTab("NBC"); - newsTab.Tabs.Add(nbcTab); - - newsTab.SelectedIndex = 1; //This will select the "NBC" child tab of the "News" tab - } - } - - - Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Load - If Not Page.IsPostBack Then - Dim newsTab As RadTab = New RadTab("News") - RadTabStrip1.Tabs.Add(newsTab) - - RadTabStrip1.SelectedIndex = 0 'This will select the "News" tab - - Dim cnnTab As RadTab = New RadTab("CNN") - newsTab.Tabs.Add(cnnTab) - - Dim nbcTab As RadTab = New RadTab("NBC") - newsTab.Tabs.Add(nbcTab) - - newsTab.SelectedIndex = 1 'This will select the "NBC" child tab of the "News" tab - End If - End Sub - - - - - - Gets the selected child tab. - - - Returns the child tab which is currently selected. If no tab is selected - (the SelectedIndex property is -1) the SelectedTab - property will return null (Nothing in VB.NET). - - - - - Gets the IRadTabContainer instance which contains the current tab. - - - The object which contains the tab. It might be an instance of the - RadTabStrip class or the RadTab - class depending on the hierarchy level. - - - The value is of the IRadTabContainer type which is - implemented by the RadTabStrip class and the - RadTab class. Use the Owner property when - recursively traversing tabs in the RadTabStrip control. - - - The following example demonstrates how to make a bread crumb trail out of - hierarchical RadTabStrip. - - void Page_Load(object sender, EventArgs e) - { - if (RadTabStrip1.SelectedIndex >= 0) - { - RadTab selected = RadTabStrip1.InnermostSelectedTab; - IRadTabContainer owner = selected.Owner; - string breadCrumbTrail = string.Empty; - while (owner != null) - { - breadCrumbTrail = " > " + owner.SelectedTab.Text + breadCrumbTrail; - owner = owner.Owner; - } - Label1.Text = breadCrumbTrail; - } - } - - - Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Load - If RadTabStrip1.SelectedIndex >= 0 Then - Dim selected As RadTab = RadTabStrip1.InnermostSelectedTab - Dim owner As IRadTabContainer = selected.Owner - Dim breadCrumbTrail As String = String.Empty - While Not owner Is Nothing - breadCrumbTrail = " > " & owner.SelectedTab.Text & breadCrumbTrail - owner = owner.Owner - End While - Label1.Text = breadCrumbTrail - End If - End Sub - - - - - - Gets a RadTabCollection object that contains the child tabs of the current tab. - - - A RadTabCollection that contains the child tabs of the current tab. By default - the collection is empty (the tab has no children). - - - Use the Tabs property to access the child tabs of the current tab. You can also use the Tabs property to - manage the children of the current tab. You can add, remove or modify tabs from the Tabs collection. - - - The following example demonstrates how to programmatically modify the properties of child tabs. - - RadTabStrip1.Tabs[0].Tabs[0].Text = "Example"; - RadTabStrip1.Tabs[0].Tabs[0].NavigateUrl = "http://www.example.com"; - - - RadTabStrip1.Tabs(0).Tabs(0).Text = "Example" - RadTabStrip1.Tabs(0).Tabs(0).NavigateUrl = "http://www.example.com" - - - - - - Gets or sets the Cascading Style Sheet (CSS) class applied when the tab is selected. - - - The CSS class applied when the tab is selected. The default value is empty string. - - - By default the visual appearance of selected tabs is defined in the skin CSS - file. You can use the SelectedCssClass property to specify unique - appearance for the current tab when it is selected. - - - - - Gets or sets the Cascading Style Sheet (CSS) class applied when the tab is disabled. - - - The CSS class applied when the tab is disabled. The default value is empty string. - - - By default the visual appearance of disabled tabs is defined in the skin CSS - file. You can use the DisabledCssClass property to specify unique - appearance for the tab when it is disabled. - - - - - Gets or sets the Cascading Style Sheet (CSS) class applied when the tab is hovered with the mouse. - - - The CSS class applied when the tab is hovered. The default value is empty string. - - - By default the visual appearance of hovered tabs is defined in the skin CSS - file. You can use the HoveredCssClass property to specify unique - appearance for the tab when it is hovered. - - - - - Gets or sets the Cascading Style Sheet (CSS) class applied to the HTML element - containing the child tabs. - - - The CSS class applied to the child tabs container. The default value is empty - string. - - - Tabs are rendered as LI (list item) HTML elements inside a - UL (unordered list). The CSS class specified by the - ChildGroupCssClass property is applied to the UL - tag. - - -

ASPX:

<telerik:RadTabStrip ID="RadTabStrip1" runat="server">
- <Tabs>
- <telerik:RadTab Text="News" ChildGroupCssClass="news">
- <Tabs>
- <telerik:RadTab Text="CNN" />
- <telerik:RadTab Text="NBC" />
- </Tabs>
- </telerik:RadTab>
- </Tabs>
- </telerik:RadTabStrip> -

HTML:

- - <li>News
- <ul class="news">
- <li>CNN</li>
- <li>NBC</li>
- </ul>
- </li> -
-
-
- - - Gets or sets a value indicating whether next tab will be displayed on a new - line. - - - true if the next tab should be displayed on a new line; otherwise false. - The default value is false. - - - Use the IsBreak property to create multi-row tabstrip. All tabs after the "break" - tab will be displayed on a new line. - - - - - Gets or sets the ID of the RadPageView in - a RadMultiPage that will be switched when the tab is - selected. - - - This property overrides the default relation between the page views within a - RadMultiPage and the tabs in a - RadTabStrip. By default a tab activates the page view - with the same index. - - - The ID of the RadPageView that will be - activated when the tab is selected. The default value is empty string. - - - - - Gets or sets the text displayed for the current tab. - - - The text displayed for the tab in the RadTabStrip control. The default is empty string. - - - Use the Text property to specify or determine the text that is displayed for the tab - in the RadTabStrip control. - - - - - Gets or sets custom (user-defined) data associated with the current tab. - - - A string representing the user-defined data. The default value is emptry string. - - - Use the Value property to associate custom data with a RadTab object. - - - - - Gets or sets the URL to navigate to when the current tab is clicked. - - - The URL to navigate to when the tab is clicked. The default value is empty string which means that - clicking the current tab will not navigate. - - - - By default clicking a tab will select it. If the tab has any child tabs they will be displayed. To make a tab - navigate to some designated URL you can use the NavigateUrl property. You can optionally set the - Target property to specify the window or frame in which to display the linked content. - - - Setting the NavigateUrl property will disable tab selection and as a result the - TabClick event won't be raised for the current tab. - - - - - - Gets or sets the URL to an image which is displayed next to the text of a tab. - - - The URL to the image to display for the tab. The default value is empty - string which means by default no image is displayed. - - - Use the ImageUrl property to specify a custom image that will be - displayed before the text of the current tab. - - - - The following example demonstrates how to specify the image to display for - the tab using the ImageUrl property. - - - <telerik:RadTabStrip id="RadTabStrip1" runat="server">
- <Tabs>
- <telerik:RadTabImageUrl="~/Img/inbox.gif" - Text="Index"></telerik:RadTab>
- <telerik:RadTabImageUrl="~/Img/outbox.gif" - Text="Outbox"></telerik:RadTab>
- <telerik:RadTabImageUrl="~/Img/trash.gif" - Text="Trash"></telerik:RadTab>
- <telerik:RadTabImageUrl="~/Img/meetings.gif" - Text="Meetings"></telerik:RadTab>
- </Tabs>
- </telerik:RadTabStrip> -
-
-
- - - Gets or sets the URL to an image which is displayed when the - user hovers the current tab with the mouse. - - - The URL to the image to display for the tab when the user hovers it with the mouse. The default value is empty - string which means the image specified via ImageUrl will be used. - - - - Use the HoveredImageUrl property to specify a custom image that will be - displayed when the user hovers the tab with the mouse. Setting the HoveredImageUrl - property required the ImageUrl property to be set beforehand. - - - If the HoveredImageUrl property is not set the value of the ImageUrl - will be used instead. - - - - - - Gets or sets the URL to an image which is displayed when the tab is selected. - - - The URL to the image to display when the tab is selected. The default value is empty - string which means the image specified via ImageUrl will be used. - - - - Use the SelectedImageUrl property to specify a custom image that will be - displayed when the current tab is selected. Setting the SelectedImageUrl - property required the ImageUrl property to be set beforehand. - - - If the SelectedImageUrl property is not set the value of the ImageUrl - will be used instead. - - - - - - Gets or sets the URL to an image which is displayed when the tab is disabled - (its Enabled property is set to false). - - - The URL to the image to display when the tab is disabled. The default value is empty - string which means the image specified via ImageUrl will be used. - - - - Use the DisabledImageUrl property to specify a custom image that will be - displayed when the current tab is disabled. Setting the DisabledImageUrl - property required the ImageUrl property to be set beforehand. - - - If the DisabledImageUrl property is not set the value of the ImageUrl - will be used instead. - - - - - - Gets or sets the target window or frame in which to display the Web page content associated with the current tab. - - - The target window or frame to load the Web page linked to when the tab is - selected. Values must begin with a letter in the range of a through z (case - insensitive), except for the following special values, which begin with an - underscore: - - - - _blank - Renders the content in a new window without frames. - - - _parent - Renders the content in the immediate frameset parent. - - - _self - Renders the content in the frame with focus. - - - _top - Renders the content in the full window without frames. - - - - The default value is empty string which means the linked resource will be loaded in the current window. - - - - Use the Target property to target window or frame in which to display the - Web page content associated with the current tab. The Web page is specified by - the NavigateUrl property. - - - If this property is not set, the Web page specified by the - NavigateUrl property is loaded in the current window. - - - The Target property is taken into consideration only when the NavigateUrl - property is set. - - - - The following example demonstrates how to use the Target property - - - <telerik:RadTabStrip id="RadTabStrip1" runat="server">
- <Tabs>
- <telerik:RadTab Text="News" NavigateUrl="~/News.aspx" - Target="_self" />
- <telerik:RadTab Text="External URL" NavigateUrl="http://www.example.com" - Target="_blank" />
- </Tabs>
- </telerik:RadTabStrip>
-
-
-
- - Gets the RadPageView activated when the tab is selected. - - The RadPageView that is activated when the tab is selected. - The default value is null (Nothing in VB.NET). - - - - - A collection of RadTab objects in a - RadTabStrip control. - - - The RadTabCollection class represents a collection of - RadTab objects. - - - Use the indexer to programmatically retrieve a - single RadTab from the collection, using array notation. - - - Use the Count property to determine the total - number of menu items in the collection. - - - Use the Add method to add tabs in the collection. - - - Use the Remove method to remove tabs from the - collection. - - - - - - - - Initializes a new instance of the RadTabCollection class. - - The owner of the collection. - - - - Appends the specified RadTab object to the end of the current RadTabCollection. - - - The RadTab to append to the end of the current RadTabCollection. - - - The following example demonstrates how to programmatically add tabs in a - RadTabStrip control. - - RadTab newsTab = new RadTab("News"); - RadTabStrip1.Tabs.Add(newsTab); - - - Dim newsTab As RadTab = New RadTab("News") - RadTabStrip1.Tabs.Add(newsTab) - - - - - Appends the specified array of RadTab objects to the end of the - current RadTabCollection. - - - The following example demonstrates how to use the AddRange method - to add multiple tabs in a single step. - - RadTab[] tabs = new RadTab[] { new RadTab("First"), new RadTab("Second"), new RadTab("Third") }; - RadTabStrip1.Tabs.AddRange(tabs); - - - Dim tabs() As RadTab = {New RadTab("First"), New RadTab("Second"), New RadTab("Third")} - RadTabStrip1.Tabs.AddRange(tabs) - - - - The array of RadTab o append to the end of the current - RadTabCollection. - - - - - Inserts the specified RadTab object in the current - RadTabCollection at the specified index location. - - The zero-based index location at which to insert the RadTab. - The RadTab to insert. - - - - Determines the index of the specified RadTab object in the collection. - - - The RadTab to locate. - - - The zero-based index of tab within the current RadTabCollection, - if found; otherwise, -1. - - - - - Determines whether the specified RadTab object is in the current - RadTabCollection. - - - The RadTab object to find. - - - true if the current collection contains the specified RadTab object; - otherwise, false. - - - - - Removes the specified RadTab object from the current - RadTabCollection. - - - The RadTab object to remove. - - - - - Removes the RadTab object at the specified index - from the current RadTabCollection. - - The zero-based index of the tab to remove. - - - - Searches the RadTabStrip control for the first - RadTab whose Value property is equal - to the specified value. - - - A RadTab whose Value property is equal to the specifed - value. If a tab is not found, null (Nothing in Visual Basic) is returned. - - - The value to search for. - - - - - Searches the RadTabStrip control for the first - RadTab whose Value property is equal - to the specified value. - - - A RadTab whose Value property is equal to the specifed - value. If a tab is not found, null (Nothing in Visual Basic) is returned. - - - The value to search for. - - A Boolean indicating a case-sensitive or insensitive comparison (true indicates a case-insensitive comparison). - - - - Searches the RadTabStrip control for the first - RadTab whose Text property is equal to - the specified value. - - - A RadTab whose Text property is equal - to the specified value. If a tab is not found, null (Nothing in Visual Basic) is returned. - - The value to search for. - - - - Searches the RadTabStrip control for the first - RadTab whose Text property is equal to - the specified value. - - - A RadTab whose Text property is equal - to the specified value. If a tab is not found, null (Nothing in Visual Basic) is returned. - - The value to search for. - A Boolean indicating a case-sensitive or insensitive comparison (true indicates a case-insensitive comparison). - - - - Returns the first RadTab - that matches the conditions defined by the specified predicate. - The predicate should returns a boolean value. - - - The following example demonstrates how to use the FindTab method. - - void Page_Load(object sender, EventArgs e) - { - RadTabStrip1.FindTab(ItemWithEqualsTextAndValue); - } - private static bool ItemWithEqualsTextAndValue(RadTab tab) - { - if (tab.Text == tab.Value) - { - return true; - } - else - { - return false; - } - } - - - Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs) - RadTabStrip1.FindTab(ItemWithEqualsTextAndValue) - End Sub - Private Shared Function ItemWithEqualsTextAndValue(ByVal tab As RadTab) As Boolean - If tab.Text = tab.Value Then - Return True - Else - Return False - End If - End Function - - - The Predicate <> that defines the conditions of the element to search for. - - - - Gets the RadTab object at the specified index in - the current RadTabCollection. - - - The zero-based index of the RadTab to retrieve. - - - The RadTab at the specified index in the - current RadTabCollection. - - - - - For internal use only. - - - - - - - Provides data for the ButtonDataBound event - of the RadToolBar control. - - - - - Initializes a new instance of the - RadToolBarButtonEventArgs class. - - - A RadToolBarItem which represents a button in the - RadToolBar control. - - - - - Gets the referenced button in the RadToolBar control when the - ButtonDataBound event is raised. - - - The referenced button in the RadToolBar control when the - ButtonDataBound event is raised. - - - Use this property to programmatically access the button referenced in the - RadToolBar control when the - ButtonDataBound event is raised. - - - - - Represents the method that handles the ButtonDataBound - event of a RadToolBar control. - - The source of the event. - A RadToolBarButtonEventArgs that - contains the event data. - - When you create a RadToolBarButtonEventHandler delegate, you identify the method that will - handle the event. To associate the event with your event handler, add an instance of the delegate to the - event. The event handler is called whenever the event occurs, unless you remove the delegate. - - - - - Provides data for the events of the RadToolBar control. - - - - - Initializes a new instance of the - RadToolBarEventArgs class. - - - A RadToolBarItem which represents an item in the - RadToolBar control. - - - - - Gets the referenced item in the RadToolBar control when the - event is raised. - - - The referenced item in the RadToolBar control when the event is raised. - - - Use this property to programmatically access the item referenced in the - RadToolBar control when the event is raised. - - - - - Represents the method that handles the events of a RadToolBar control. - - The source of the event. - A RadToolBarEventArgs that contains the event data. - - When you create a RadToolBarEventHandler delegate, you identify the method that will - handle the event. To associate the event with your event handler, add an instance of the delegate to the - event. The event handler is called whenever the event occurs, unless you remove the delegate. - - - - - Defines properties that must be implemented to allow a control to act like - a RadToolBarButton item in a RadToolBar. - - - - - Gets or sets a value, indicating if the item will perform a postback. - - - Used to indicate that an item should not perform a postback when - the containing RadToolBar performs postback through. - - - - Gets or sets the value associated with the toolbar item. - The value associated with the item. The default value is empty string. - - Use the Value property to specify or determine the value associated - with the item. - - - - Gets or sets the URL to link to when the item is clicked. - - The URL to link to when the item is clicked. The default value is empty - string. - - - Use the NavigateUrl property to specify the URL to link to when - the item is clicked. Use "~" (tilde) in front of an URL within the same ASP.NET - application. When specifying external URL do not forget the protocol (e.g. - "http://"). - - - - - Gets or sets the target window or frame to display the Web page content linked to - when the toolbar item is clicked. - - - The target window or frame to load the Web page linked to when the item is - selected. Values must begin with a letter in the range of a through z (case - insensitive), except for the following special values, which begin with an - underscore: - - - - _blank - Renders the content in a new window without - frames. - - - _parent - Renders the content in the immediate frameset - parent. - - - _self - Renders the content in the frame with focus. - - - _top - Renders the content in the full window without - frames. - - - The default value is empty string. - - - - Use the Target property to specify the frame or window that displays the - Web page linked to when the toolbar item is clicked. The Web page is specified by - setting the NavigateUrl property. - - If this property is not set, the Web page specified by the - NavigateUrl property is loaded in the current window. - - - - Gets or sets the template for displaying the item. - - A ITemplate implemented object that contains the template - for displaying the item. The default value is a null reference (Nothing in - Visual Basic), which indicates that this property is not set. - - - - - Gets or sets the command name associated with the toolbar item that is passed to the - ItemCommand event of the RadToolBar instance. - - - The command name of the toolbar item. The default value is an empty string. - - - - - Gets or sets an optional parameter passed to the Command event of the - RadToolBar instance along with the associated - CommandName - - - An optional parameter passed to the Command event of the - RadToolBar instance along with the associated - CommandName. The default value is an empty string. - - - - - Gets or sets a value indicating whether clicking the button causes page validation - to occur. - - - true if clicking the button causes page validation to occur; otherwise, false. - - - - - Gets or sets the URL of the Web page to post to from the current page when - the button control is clicked. - - - The URL of the Web page to post to from the current page when the button - control is clicked. - - - - - Gets or sets the name for the group of controls for which the button control - causes validation when it posts back to the server. - - - The name for the group of controls for which the button control causes validation - when it posts back to the server. - - - - Gets the RadToolBar instance which contains the item. - - Use this property to obtain an instance to the - RadToolBar object containing the item. - - - - - Gets or sets the text displayed for the current item. - - - The text an item in the RadToolBar control displays. The default is empty string. - - - Use the Text property to specify or determine the text an item displays displays - in the RadToolBar control. - - - - Gets or sets the path to an image to display for the item. - - The path to the image to display for the item. The default value is empty - string. - - - Use the ImageUrl property to specify the image for the item. If - the ImageUrl property is set to empty string no image will be - rendered. Use "~" (tilde) when referring to images within the current ASP.NET - application. - - - - - Gets or sets the path to an image to display when the user moves the - mouse over the item. - - - The path to the image to display when the user moves the mouse over the item. The - default value is empty string. - - - <telerik:RadToolBar id="RadToolBar1" runat="server">
- <Items>
- <telerik:RadToolBarButton ImageUrl="~/Img/inbox.gif" - HoveredImageUrl="~/Img/inboxOver.gif" Text="Index" />
- </Items>
- </telerik:RadToolBar>
-
-
- - - Gets or sets the Cascading Style Sheet (CSS) class applied when the user moves the mouse - over the toolbar item. - - - The CSS class applied when the user moves the mouse over the toolbar item. The default value is - String.Empty. - - - By default the visual appearance of a hovered toolbar items is defined in the skin CSS - file. You can use the HoveredCssClass property to specify unique - appearance for the toolbar item when it is hovered. - - - - - Gets or sets the Cascading Style Sheet (CSS) class applied when the toolbar item is - clicked. - - - The CSS class applied when the toolbar item is clicked. The default value is - String.Empty. - - - By default the visual appearance of clicked toolbar items is defined in the skin CSS - file. You can use the ClickedCssClass property to specify unique - appearance for the toolbar item when it is clicked. - - - - - Gets or sets the path to an image to display for the item when the user clicks it. - - - The path to the image to display when the user clicks the item. The default value - is empty string. - - - Use the ClickedImageUrl property to specify the image that will be - used when the user clicks the item. If the ClickedImageUrl - property is set to empty string the image specified by the ImageUrl - property will be used. Use "~" (tilde) when referring to images within the current - ASP.NET application. - - - - - Gets or sets the path to an image to display when the item is disabled. - - - The path to the image to display when the item is disabled. The - default value is empty string. - - - Use the DisabledImageUrl property to specify the image that will be - used when the item is disabled. If the DisabledImageUrl - property is set to empty string the image specified by the ImageUrl - property will be used. Use "~" (tilde) when referring to images within the current - ASP.NET application. - - - - - Gets or sets the Cascading Style Sheet (CSS) class applied when the toolbar item is - disabled. - - - The CSS class applied when the toolbar item is disabled. The default value is - String.Empty. - - - By default the visual appearance of disabled toolbar items is defined in the skin CSS - file. You can use the DisabledCssClass property to specify unique - appearance for the toolbar item when it is disabled. - - - - - Gets or sets the Cascading Style Sheet (CSS) class applied when the toolBar item is - focused after tabbing to it, or by using its AccessKey - - - The CSS class applied when the toolBar item is focused. The default value is - String.Empty. - - - By default the visual appearance of focused toolBar items is defined in the skin CSS - file. You can use the FocusedCssClass property to specify unique - appearance for the toolBar item when it is focused. - - - - - Gets or sets the path to an image to display when the user focuses the - item either by tabbing to it or by using the AccessKey - - - The path to the image to display when the user user focuses the - item either by tabbing to that it or by using the AccessKey. The - default value is empty string. - - - Use the FocusedImageUrl property to specify the image that will be - used when the item gets the focus after tabbing or using its AccessKey. - If the FocusedImageUrl property is set to empty string the image specified - by the ImageUrl property will be used. Use "~" (tilde) when referring to - images within the current ASP.NET application. - - - - - Gets or sets the position of the item image according to the item text. - - - The position of the item image according to the item text. The - default value is ToolBarImagePosition.Left. - - - - - Defines properties that toolbar button containers - (RadToolBarDropDown, - RadToolBarSplitButton) should implement. - - - - - Defines properties that toolbar item container (RadToolBar) - should implement - - - - Gets the collection of child items. - - A RadToolBarItemCollection that represents the child - items. - - - Use this property to retrieve the child items. You can also use it to - programmatically add or remove items. - - - - - Specifies the position of the image of an item within the RadToolBar - control according to the item text. - - - - - The image will be displayed to the left of the text - - - - - The image will be displayed to the right of the text - - - - - The image will be displayed above the text - - - - - The image will be displayed below the text - - - - Represents a single button in the RadToolBar class. - - - When the user clicks a toolbar button, the RadToolBar control can - either navigate to a linked Web page or simply post back to the server. If the - NavigateUrl property of a toolbar button is set, the - RadToolBar control navigates to the linked page. By default, - a linked page is displayed in the same window or frame as the RadToolBar - control. To display the linked content in a different window or frame, use the - Target property. - - - - - Represents a single item in the RadToolBar class. - - - The RadToolBar control is made up of a list of toolbar items - represented by RadToolBarItem objects (RadToolBarButton, - RadToolBarDropDown, - RadToolBarSplitButton). All toolbar items are stored - in the Items collection of the toolbar. - You can access the toolbar to which the item belongs - by using the ToolBar property. - - To create the toolbar items for a RadToolBar control, use one of the - following methods: - - Use declarative syntax to create static toolbar items. - Use a constructor to dynamically create new instances of either toolbar item classes - (RadToolBarButton, - RadToolBarDropDown, - RadToolBarSplitButton). These RadToolBarItem - objects can then be added to the Items collection of the - RadToolBar. - Bind the RadToolBar control to a data source. - - - Each toolbar item has a Text property. The Button items - (RadToolBarButton and - RadToolBarSplitButton) have a - Value property. The value of the - Text property is displayed in the RadToolBar - control, while the Value property is used to store any - additional data about the toolbar item. - - - - - Gets the RadToolBar instance which contains the item. - - Use this property to obtain an instance to the - RadToolBar object containing the item. - - - - - Gets or sets the text displayed for the current item. - - - The text an item in the RadToolBar control displays. The default is empty string. - - - Use the Text property to specify or determine the text an item displays displays - in the RadToolBar control. - - - - Gets or sets the path to an image to display for the item. - - The path to the image to display for the item. The default value is empty - string. - - - Use the ImageUrl property to specify the image for the item. If - the ImageUrl property is set to empty string no image will be - rendered. Use "~" (tilde) when referring to images within the current ASP.NET - application. - - - The following example demonstrates how to specify the image to display for - a button using the ImageUrl property. - - <telerik:RadToolBar id="RadToolBar1" - runat="server">
- <Items>
- <telerik:RadToolBarButton ImageUrl="~/Img/inbox.gif" Text="Index" - />
- <telerik:RadToolBarButton ImageUrl="~/Img/outbox.gif" Text="Outbox" - />
- </Items>
- </telerik:RadToolBar>
-
-
-
- - - Gets or sets the path to an image to display when the user moves the - mouse over the item. - - - The path to the image to display when the user moves the mouse over the item. The - default value is empty string. - - - <telerik:RadToolBar id="RadToolBar1" runat="server">
- <Items>
- <telerik:RadToolBarButton ImageUrl="~/Img/inbox.gif" - HoveredImageUrl="~/Img/inboxOver.gif" Text="Index" />
- </Items>
- </telerik:RadToolBar>
-
- - Use the HoveredImageUrl property to specify the image that will be - used when the user moves the mouse over the item. If the HoveredImageUrl - property is set to empty string the image specified by the ImageUrl - property will be used. Use "~" (tilde) when referring to images within the current - ASP.NET application. - -
- - - Gets or sets the Cascading Style Sheet (CSS) class applied when the user moves the mouse - over the toolbar item. - - - The CSS class applied when the user moves the mouse over the toolbar item. The default value is - String.Empty. - - - By default the visual appearance of a hovered toolbar items is defined in the skin CSS - file. You can use the HoveredCssClass property to specify unique - appearance for the toolbar item when it is hovered. - - - - - Gets or sets the Cascading Style Sheet (CSS) class applied when the toolbar item is - clicked. - - - The CSS class applied when the toolbar item is clicked. The default value is - String.Empty. - - - By default the visual appearance of clicked toolbar items is defined in the skin CSS - file. You can use the ClickedCssClass property to specify unique - appearance for the toolbar item when it is clicked. - - - - - Gets or sets the path to an image to display for the item when the user clicks it. - - - The path to the image to display when the user clicks the item. The default value - is empty string. - - - <telerik:RadToolBar id="RadToolBar1" runat="server">
- <Items>
- <telerik:RadToolBarDropDown ImageUrl="~/Img/inbox.gif" - ClickedImageUrl="~/Img/inboxClicked.gif" Text="DropDown1" > - <Items>
- <telerik:RadToolBarButton Text="Mail1" ClickedImageUrl="~/Img/mail1Clicked.gif" - /> - </Items>
- </telerik:RadToolBarDropDown>/
- </Items>
- </telerik:RadToolBar>
-
- - Use the ClickedImageUrl property to specify the image that will be - used when the user clicks the item. If the ClickedImageUrl - property is set to empty string the image specified by the ImageUrl - property will be used. Use "~" (tilde) when referring to images within the current - ASP.NET application. - -
- - - Gets or sets the path to an image to display when the item is disabled. - - - The path to the image to display when the item is disabled. The - default value is empty string. - - - <telerik:RadToolBar id="RadToolBar1" runat="server">
- <Items>
- <telerik:RadToolBarButton ImageUrl="~/Img/inbox.gif" - DisabledImageUrl="~/Img/inboxDisabled.gif" Text="Index" />
- </Items>
- </telerik:RadToolBar>
-
- - Use the DisabledImageUrl property to specify the image that will be - used when the item is disabled. If the DisabledImageUrl - property is set to empty string the image specified by the ImageUrl - property will be used. Use "~" (tilde) when referring to images within the current - ASP.NET application. - -
- - - Gets or sets the Cascading Style Sheet (CSS) class applied when the toolbar item is - disabled. - - - The CSS class applied when the toolbar item is disabled. The default value is - String.Empty. - - - By default the visual appearance of disabled toolbar items is defined in the skin CSS - file. You can use the DisabledCssClass property to specify unique - appearance for the toolbar item when it is disabled. - - - - - Gets or sets the Cascading Style Sheet (CSS) class applied when the toolBar item is - focused after tabbing to it, or by using its AccessKey - - - The CSS class applied when the toolBar item is focused. The default value is - String.Empty. - - - - <style type="text/css"> - .myFocusedCssClass .rtbText - { - font-weight:bold !important; - color:red !important; - } - </style> - <telerik:RadToolBar id="RadToolBar1" runat="server">
- <Items>
- <telerik:RadToolBarButton - FocusedCssClass="myFocusedCssClass" Text="Bold" />
- </Items>
- </telerik:RadToolBar>
-
- - By default the visual appearance of focused toolBar items is defined in the skin CSS - file. You can use the FocusedCssClass property to specify unique - appearance for the toolBar item when it is focused. - -
- - - Gets or sets the path to an image to display when the user focuses the - item either by tabbing to it or by using the AccessKey - - - The path to the image to display when the user user focuses the - item either by tabbing to that it or by using the AccessKey. The - default value is empty string. - - - <telerik:RadToolBar id="RadToolBar1" runat="server">
- <Items>
- <telerik:RadToolBarButton ImageUrl="~/Img/bold.gif" - FocusedImageUrl="~/Img/boldFocused.gif" Text="Bold" />
- </Items>
- </telerik:RadToolBar>
-
- - Use the FocusedImageUrl property to specify the image that will be - used when the item gets the focus after tabbing or using its AccessKey. - If the FocusedImageUrl property is set to empty string the image specified - by the ImageUrl property will be used. Use "~" (tilde) when referring to - images within the current ASP.NET application. - -
- - - Gets or sets the position of the item image according to the item text. - - - The position of the item image according to the item text. The - default value is ToolBarImagePosition.Left. - - - <telerik:RadToolBar id="RadToolBar1" runat="server">
- <Items>
- <telerik:RadToolBarButton ImageUrl="~/Img/bold.gif" - ImagePosition="Right" Text="Bold" />
- </Items>
- </telerik:RadToolBar>
-
-
- - - For internal use only - - - - - - Initializes a new instance of the RadToolBarButton class. - - Use this constructor to create and initialize a new instance of the - RadToolBarButton class using default values. - - - The following example demonstrates how to add items to - RadToolBar controls. - - RadToolBarButton button = new RadToolBarButton(); - button.Text = "Create New"; - button.CommandName = "CreateNew"; - button.ImageUrl = "~/ToolBarImages/CreateNew.gif"; - - RadToolBar1.Items.Add(button); - - - Dim button As New RadToolBarButton() - button.Text = "Create New" - button.CommandName = "CreateNew" - button.ImageUrl = "~/ToolBarImages/CreateNew.gif" - - RadToolBar1.Items.Add(button) - - - - - - Initializes a new instance of the RadToolBarButton class with the - specified text data. - - - - Use this constructor to create and initialize a new instance of the - RadToolBarButton class using the specified text. - - - - The following example demonstrates how to add items to - RadToolBar controls. - - RadToolBarButton button = new RadToolBarButton("Create New"); - button.CommandName = "CreateNew"; - button.ImageUrl = "~/ToolBarImages/CreateNew.gif"; - - RadToolBar1.Items.Add(button); - - - Dim button As New RadToolBarButton("Create New") - button.CommandName = "CreateNew" - button.ImageUrl = "~/ToolBarImages/CreateNew.gif" - - RadToolBar1.Items.Add(button) - - - - The text of the button. The Text property is set to the value - of this parameter. - - - - - Initializes a new instance of the RadToolBarButton class with the - specified text, checked state and group name data. - - - - Use this constructor to create and initialize a new instance of the - RadToolBarButton class using the specified text, - checked state and group name. - - - When this constructor used, the CheckOnClick property of the created - RadToolBarButton is automatically set to true. - - - - The following example demonstrates how to add items to - RadToolBar controls. - - RadToolBarButton alighLeftButton = new RadToolBarButton("Left", false, "Alignment"); - alighLeftButton.CommandName = "AlignLeft"; - alighLeftButton.ImageUrl = "~/ToolBarImages/AlignLeft.gif"; - RadToolBar1.Items.Add(alighLeftButton); - - RadToolBarButton alignCenterButton = new RadToolBarButton("Center", false, "Alignment"); - alignCenterButton.CommandName = "AlignCenter"; - alignCenterButton.ImageUrl = "~/ToolBarImages/AlignCenter.gif"; - RadToolBar1.Items.Add(alignCenterButton); - - RadToolBarButton alignRightButton = new RadToolBarButton("Right", false, "Alignment"); - alignRightButton.CommandName = "AlignRight"; - alignRightButton.ImageUrl = "~/ToolBarImages/AlignRight.gif"; - RadToolBar1.Items.Add(alignRightButton); - - - Dim alighLeftButton As RadToolBarButton = New RadToolBarButton("Left", False, "Alignment") - alighLeftButton.CommandName = "AlignLeft" - alighLeftButton.ImageUrl = "~/ToolBarImages/AlignLeft.gif" - RadToolBar1.Items.Add(alighLeftButton) - - Dim alignCenterButton As RadToolBarButton = New RadToolBarButton("Center", False, "Alignment") - alignCenterButton.CommandName = "AlignCenter" - alignCenterButton.ImageUrl = "~/ToolBarImages/AlignCenter.gif" - RadToolBar1.Items.Add(alignCenterButton) - - Dim alignRightButton As RadToolBarButton = New RadToolBarButton("Right", False, "Alignment") - alignRightButton.CommandName = "AlignRight" - alignRightButton.ImageUrl = "~/ToolBarImages/AlignRight.gif" - RadToolBar1.Items.Add(alignRightButton) - - - - The text of the button. The Text property is set to the value - of this parameter. - - - The checked state of the button. The Checked property is set to the value - of this parameter. - - - The group to which the button belongs. The Group property is set - to the value of this parameter. - - - - Creates a copy of the current RadToolBarButton object. - A RadToolBarButton which is a copy of the current one. - - Use the Clone method to create a copy of the current button. All - properties of the clone are set to the same values as the current ones. - - - - - Gets a reference to the owner of the RadToolBarButton. - - - The IToolBarItemContainer control (RadToolBar, - RadToolBarDropDown, - RadToolBarSplitButton) which holds the RadToolBarButton. - - - - Gets the data item that is bound to the button - - An Object that represents the data item that is bound to the button. The default value is null - (Nothing in Visual Basic), which indicates that the button is not bound to any data item. The - return value will always be null unless accessed within a - ButtonDataBound event handler. - - - This property is applicable only during data binding. Use it along with the - ButtonDataBound event to perform additional - mapping of fields from the data item to RadToolBarButton properties. - - - The following example demonstrates how to map fields from the data item to - RadToolBarButton properties. It assumes the user has subscribed to the - ButtonDataBound event. - - private void RadToolBar1_ButtonDataBound(object sender, Telerik.Web.UI.RadToolBarButtonEventArgs e) - { - e.Button.ImageUrl = "image" + (string)DataBinder.Eval(e.Button.DataItem, "ID") + ".gif"; - e.Button.NavigateUrl = (string)DataBinder.Eval(e.Button.DataItem, "URL"); - } - - - Sub RadToolBar1_ButtonDataBound(ByVal sender As Object, ByVal e As Telerik.Web.UI.RadToolBarButtonEventArgs) Handles RadToolBar1.ButtonDataBound - e.Button.ImageUrl = "image" & DataBinder.Eval(e.Button.DataItem, "ID") & ".gif" - e.Button.NavigateUrl = CStr(DataBinder.Eval(e.Button.DataItem, "URL")) - End Sub - - - - - - Gets or sets whether the button is separator. - - - - - Gets or sets whether the button has a check state. - - - - - Gets or sets if the button is checked. - - - The Checked property of the button depends on the - CheckOnClick property. If the - CheckOnClick property is set to - false, the Checked property will be ignored. - - When a button's Checked state is set to true, all the buttons that belong - to the same group in the RadToolBar get their Checked - state set to false. - - - - - - Gets or sets the group to which the button belongs. - - - The Group property of the button depends on the - CheckOnClick property. When several buttons - in the RadToolBar are assigned to the same group, checking one - of them will uncheck the one that is currently checked. If the - CheckOnClick property is set to - false, the Group property will be ignored. - - - - - Gets or sets the Cascading Style Sheet (CSS) class applied when the toolbar button is - checked. - - - The CSS class applied when the toolbar button is checked. The default value is - string.Empty. - - - By default the visual appearance of clicked toolbar buttons is defined in the skin CSS - file. You can use the ClickedCssClass property to specify unique - appearance for the toolbar button when it is clicked. - - - - - Gets or sets the path to an image to display for the button when its Checked state is "true". - - - The path to the image to display when its Checked state is "true". The default value - is empty string. - - - <telerik:RadToolBar id="RadToolBar1" runat="server">
- <Items>
- <telerik:RadToolBarButton ImageUrl="~/Img/alignLeft.gif" - CheckedImageUrl="~/Img/alignLeftChecked.gif" Text="Left" />
- <telerik:RadToolBarButton ImageUrl="~/Img/alignRight.gif" - CheckedImageUrl="~/Img/alignRightChecked.gif" Text="Right" - />
- </Items>
- </telerik:RadToolBar>
-
- - Use the CheckedImageUrl property to specify the image that will be - used when the button is checked. If the CheckedImageUrl - property is set to empty string the image specified by the ImageUrl - property will be used. Use "~" (tilde) when referring to images within the current - ASP.NET application. - -
- - - Gets or sets a value indicating if a checked button will get unchecked when clicked. - - - If a checked button will get unchecked when clicked. The default value is - false. - - - - Gets or sets the template for displaying the button. - - A ITemplate implemented object that contains the template - for displaying the item. The default value is a null reference (Nothing in - Visual Basic), which indicates that this property is not set. - - - The following template demonstrates how to add a Calendar control in a certain - ToolBar button. - ASPX: - <telerik:RadToolBar runat="server" ID="RadToolBar1"> -
- <Items> -
- <telerik:RadToolBarDropDown Text="Date"> -
- <Items> - <telerik:RadToolBarButton Text="Date"> -
- <ItemTemplate> -
- <asp:Calendar runat="server" ID="Calendar1" - /> -
- </ItemTemplate> -
- </telerik:RadToolBarDropButton> - </Items> -
- </telerik:RadToolBarDropDown> -
- </Items> -
- </telerik:RadToolBar> -
-
- - - Gets or sets a value indicating whether clicking on the button will - postback. - - - True if the toolbar button should postback; otherwise - false. By default all the items will postback provided the user - has subscribed to the ButtonClick event. - - - If you subscribe to the ButtonClick all toolbar - buttons will postback. To turn off that behavior you should set the - PostBack property to false. - - - - Gets or sets the value associated with the toolbar button. - The value associated with the button. The default value is empty string. - - Use the Value property to specify or determine the value associated - with the button. - - - - Gets or sets the URL to link to when the button is clicked. - - The URL to link to when the button is clicked. The default value is empty - string. - - - The following example demonstrates how to use the NavigateUrl - property - - <telerik:RadToolBar id="RadToolBar1" - runat="server">
- <Items>
- <telerik:RadToolBarButton Text="News" NavigateUrl="~/News.aspx" - />
- <telerik:RadToolBarButton Text="External URL" - NavigateUrl="http://www.example.com" />
- </Items>
- </telerik:RadToolBar>
-
-
- - Use the NavigateUrl property to specify the URL to link to when - the button is clicked. Use "~" (tilde) in front of an URL within the same ASP.NET - application. When specifying external URL do not forget the protocol (e.g. - "http://"). - -
- - - Gets or sets the target window or frame to display the Web page content linked to - when the toolbar button is clicked. - - - The target window or frame to load the Web page linked to when the button is - selected. Values must begin with a letter in the range of a through z (case - insensitive), except for the following special values, which begin with an - underscore: - - - - _blank - Renders the content in a new window without - frames. - - - _parent - Renders the content in the immediate frameset - parent. - - - _self - Renders the content in the frame with focus. - - - _top - Renders the content in the full window without - frames. - - - The default value is empty string. - - - - Use the Target property to specify the frame or window that displays the - Web page linked to when the toolbar button is clicked. The Web page is specified by - setting the NavigateUrl property. - - If this property is not set, the Web page specified by the - NavigateUrl property is loaded in the current window. - - - The following example demonstrates how to use the Target - property - ASPX: - <telerik:RadToolBar runat="server" ID="RadToolBar1"> - <Items> - <telerik:RadToolBarButton Target="_blank" - NavigateUrl="http://www.google.com" /> - </Items> - </telerik:RadToolBar> - - - - - Gets or sets the command name associated with the toolbar button that is passed to the - ItemCommand event of the RadToolBar instance. - - - The command name of the toolbar button. The default value is an empty string. - - - - - Gets or sets an optional parameter passed to the Command event of the - RadToolBar instance along with the associated - CommandName - - - An optional parameter passed to the Command event of the - RadToolBar instance along with the associated - CommandName. The default value is an empty string. - - - - - Gets or sets a value indicating whether validation is performed when - the RadToolBarButton is clicked - - - true if validation is performed when the RadToolBarButton - is clicked otherwise, false. The default value is true. - - - By default, page validation is performed when the button is clicked. Page - validation determines whether the input controls associated with a validation - control on the page all pass the validation rules specified by the validation - control. You can specify or determine whether validation is performed when the button is clicked - on both the client and the server by using the CausesValidation - property. To prevent validation from being performed, set the - CausesValidation property to false. - - - - - Gets or sets the name of the validation group to which the - RadToolBarButton belongs. - - - The name of the validation group to which this RadToolBarButton - belongs. The default is an empty string (""), which indicates that this property is not set. - - - This property works only when CausesValidation - is set to true. - - - - - - Gets or sets the URL of the page to post to from the current page when the - RadToolBarButton is clicked. - - - The URL of the Web page to post to from the current page when the - RadToolBarButton is clicked. The default value is an empty - string (""), which causes the page to post back to itself. - - - - - - - - - - - - - - - - - - - - Represents a dropdown in the RadToolBar class. - - - Initializes a new instance of the RadToolBarDropDown class. - - Use this constructor to create and initialize a new instance of the - RadToolBarDropDown class using default values. - - - The following example demonstrates how to add items to - RadToolBar controls. - - RadToolBarDropDown dropdown = new RadToolBarDropDown(); - dropdown.Text = "Manage"; - dropdown.ImageUrl = "~/ToolbarImages/Manage.gif"; - - RadToolBar1.Items.Add(dropdown); - - - Dim dropdown As New RadToolBarDropDown() - dropdown.Text = "Manage" - dropdown.ImageUrl = "~/ToolbarImages/Manage.gif" - - RadToolBar1.Items.Add(dropdown) - - - - - - Initializes a new instance of the RadToolBarDropDown class with the - specified text data. - - - - Use this constructor to create and initialize a new instance of the - RadToolBarDropDown class using the specified text. - - - - The following example demonstrates how to add items to - RadToolBar controls. - - RadToolBarDropDown dropdown = new RadToolBarDropDown("Manage"); - - RadToolBar1.Items.Add(dropdown); - - - Dim dropdown As New RadToolBarDropDown("Manage") - - RadToolBar1.Items.Add(dropdown) - - - - The text of the dropdown. The Text property is set to the value - of this parameter. - - - - - Gets a RadToolBarButtonCollection object that - contains the child buttons of the dropdown. - - - A RadToolBarButtonCollection that contains the - child buttons of the dropdown. By default the collection is empty (the dropdown has no buttons). - - - Use the Buttons property to access the child buttons of the dropdown. You can also use - the Buttons property to manage the children of the dropdown. You can add, - remove or modify buttons from the Buttons collection. - - - The following example demonstrates how to programmatically modify the properties of child buttons. - - manageDropDown.Buttons[0].Text = "Users"; - manageDropDown.Buttons[0].ImageUrl = "~/ToolbarImages/ManageUsers.gif"; - - - manageDropDown.Buttons[0].Text = "Users" - manageDropDown.Buttons[0].ImageUrl = "~/ToolbarImages/ManageUsers.gif" - - - - - - Gets or sets the width of the dropdown in pixels. - - - - - Gets or sets the height of the dropdown in pixels. - - - - - - - - Represents a splitbutton in the RadToolBar class. - - - Initializes a new instance of the RadToolBarSplitButton class. - - Use this constructor to create and initialize a new instance of the - RadToolBarSplitButton class using default values. - - - The following example demonstrates how to add items to - RadToolBar controls. - - RadToolBarSplitButton splitButton = new RadToolBarSplitButton(); - splitButton.Text = "News"; - splitButton.ImageUrl = "~/News.gif"; - - RadToolBar1.Items.Add(splitButton); - - - Dim splitButton As New RadToolBarSplitButton() - splitButton.Text = "News" - splitButton.ImageUrl = "~/News.gif" - - RadToolBar1.Items.Add(splitButton) - - - - - - Initializes a new instance of the RadToolBarSplitButton class with the - specified text data. - - - - Use this constructor to create and initialize a new instance of the - RadToolBarSplitButton class using the specified text. - - - - The following example demonstrates how to add items to - RadToolBar controls. - - RadToolBarSplitButton splitButton = new RadToolBarSplitButton("News"); - - RadToolBar1.Items.Add(splitButton); - - - Dim splitButton As New RadToolBarSplitButton("News") - - RadToolBar1.Items.Add(splitButton) - - - - The text of the split button. The Text property is set to the value - of this parameter. - - - - - Gets a RadToolBarButtonCollection object that - contains the child buttons of the split button. - - - A RadToolBarButtonCollection that contains the - child buttons of the split button. By default the collection is empty (the split button has - no buttons). - - - Use the Buttons property to access the child buttons of the split button. - You can also use the Buttons property to manage the children of the - current tab. You can add, remove or modify buttons from the Buttons collection. - - - The following example demonstrates how to programmatically modify the properties of child buttons. - - registerPurchaseSplitButton.Buttons[0].Text = "Cache Purchase"; - registerPurchaseSplitButton.Buttons[0].ImageUrl = "~/ToolBarImages/RegisterCachePurchase.gif"; - - registerPurchaseSplitButton.Buttons[1].Text = "Check Purchase"; - registerPurchaseSplitButton.Buttons[1].ImageUrl = "~/ToolBarImages/RegisterCheckPurchase.gif"; - - - registerPurchaseSplitButton.Buttons[0].Text = "Cache Purchase" - registerPurchaseSplitButton.Buttons[0].ImageUrl = "~/ToolBarImages/RegisterCachePurchase.gif" - - registerPurchaseSplitButton.Buttons[1].Text = "Check Purchase" - registerPurchaseSplitButton.Buttons[1].ImageUrl = "~/ToolBarImages/RegisterCheckPurchase.gif" - - - - - - Gets or sets the width of the dropdown in pixels. - - - - - Gets or sets the height of the dropdown in pixels. - - - - Gets or sets a value, indicating if the RadToolBarSplitButton will - use the DefaultButton behavior. - - A value, indicating if the RadToolBarSplitButton wll - use the DefaultButton behavior. The default value is true - - - Use the EnableDefaultButton property to set if - RadToolBarSplitButton will use the DefaultButton - behavior or not. When the DefaultButton behavior is used, the - RadToolBarSplitButton properties are ignored and the - properties of the last selected button are used instead. Use the EnableDefaultButton - property in conjunction with the DefaultButtonIndex property to - specify which of the RadToolBarSplitButton child buttons will - be used when the RadToolBar is initially displayed. - - - The following example demonstrates how to use the EnableDefaultButton - property - - <telerik:RadToolBar id="RadToolBar1" - runat="server">
- <Items>
- <telerik:RadToolBarSplitButton EnableDefaultButton="true" - DefaultButtonIndex="1"> - <Buttons>
- <telerik:RadToolBarButton ImageUrl="~/images/red.gif" Text="Red" /> - <telerik:RadToolBarButton ImageUrl="~/images/green.gif" Text="Green" /> - <telerik:RadToolBarButton ImageUrl="~/images/blue.gif" Text="Blue" /> - </Buttons>
- </telerik:RadToolBarSplitButton>/
- </Items>
- </telerik:RadToolBar>
-
-
-
- - Gets or sets the index of the button which properties will be used by default when the - EnableDefaultButton property set to true. - - The index of the button which properties will be used by default when the - EnableDefaultButton property set to true. - The default value is 0 - - - Use the DefaultButtonIndex property to specify the button - which properties RadToolBarSplitButton will use - when the RadToolBar is initially displayed. - - - The following example demonstrates how to use the DefaultButtonIndex - property - - <telerik:RadToolBar id="RadToolBar1" - runat="server">
- <Items>
- <telerik:RadToolBarSplitButton EnableDefaultButton="true" - DefaultButtonIndex="1"> - <Buttons>
- <telerik:RadToolBarButton ImageUrl="~/images/red.gif" Text="Red" /> - <telerik:RadToolBarButton ImageUrl="~/images/green.gif" Text="Green" /> - <telerik:RadToolBarButton ImageUrl="~/images/blue.gif" Text="Blue" /> - </Buttons>
- </telerik:RadToolBarSplitButton>/
- </Items>
- </telerik:RadToolBar>
-
-
-
- - Gets or sets the template for displaying the button. - - A ITemplate implemented object that contains the template - for displaying the button. The default value is a null reference (Nothing in - Visual Basic), which indicates that this property is not set. - - - The following template demonstrates how to add a Calendar control in a certain - ToolBar button. - ASPX: - <telerik:RadToolBar runat="server" ID="RadToolBar1"> -
- <Items> -
- <telerik:RadToolBarDropDown Text="Date"> -
- <Items> -
- <ItemTemplate> -
- <asp:Calendar runat="server" ID="Calendar1" - /> -
- </ItemTemplate> -
- </Items> -
- </telerik:RadToolBarDropDown> -
- </Items> -
- </telerik:RadToolBar> -
-
- - - Gets or sets a value indicating whether clicking on the button will - postback. - - - True if the toolbar split button should postback; otherwise - false. By default all the items will postback provided the user - has subscribed to the ButtonClick event. - - - If you subscribe to the ButtonClick all toolbar - buttons will postback. To turn off that behavior you should set the - PostBack property to false. - - - - Gets or sets the value associated with the toolbar split button. - The value associated with the button. The default value is empty string. - - Use the Value property to specify or determine the value associated - with the button. - - - - Gets or sets the URL to link to when the button is clicked. - - The URL to link to when the button is clicked. The default value is empty - string. - - - The following example demonstrates how to use the NavigateUrl - property - - <telerik:RadToolBar id="RadToolBar1" - runat="server">
- <Items>
- <telerik:RadToolBarSplitButton Text="News" NavigateUrl="~/News.aspx" - ImageUrl="~/Img/News.gif"> - <Buttons>
- <telerik:RadToolBarButton Text="Button1" /> - </Buttons>
- </telerik:RadToolBarSplitButton>/
- <telerik:RadToolBarButton Text="News" NavigateUrl="~/News.aspx" - />
- <telerik:RadToolBarButton Text="External URL" - NavigateUrl="http://www.example.com" />
- </Items>
- </telerik:RadToolBar>
-
-
- - Use the NavigateUrl property to specify the URL to link to when - the button is clicked. Use "~" (tilde) in front of an URL within the same ASP.NET - application. When specifying external URL do not forget the protocol (e.g. - "http://"). - -
- - - Gets or sets the target window or frame to display the Web page content linked to - when the toolbar button is clicked. - - - The target window or frame to load the Web page linked to when the button is - selected. Values must begin with a letter in the range of a through z (case - insensitive), except for the following special values, which begin with an - underscore: - - - - _blank - Renders the content in a new window without - frames. - - - _parent - Renders the content in the immediate frameset - parent. - - - _self - Renders the content in the frame with focus. - - - _top - Renders the content in the full window without - frames. - - - The default value is empty string. - - - - Use the Target property to specify the frame or window that displays the - Web page linked to when the toolbar button is clicked. The Web page is specified by - setting the NavigateUrl property. - - If this property is not set, the Web page specified by the - NavigateUrl property is loaded in the current window. - - - The following example demonstrates how to use the Target - property - ASPX: - <telerik:RadToolBar runat="server" ID="RadToolBar1"> - <Items> - <telerik:RadToolBarSplitButton Text="News" NavigateUrl="~/News.aspx" - Target="_blank" ImageUrl="~/Img/News.gif"> - <Buttons>
- <telerik:RadToolBarButton Text="Button1" /> - </Buttons>
- </telerik:RadToolBarSplitButton>/
- </Items> - </telerik:RadToolBar> -
-
- - - Gets or sets the command name associated with the toolbar button that is passed to the - ItemCommand event of the RadToolBar instance. - - - The command name of the toolbar button. The default value is an empty string. - - - - - Gets or sets an optional parameter passed to the Command event of the - RadToolBar instance along with the associated - CommandName - - - An optional parameter passed to the Command event of the - RadToolBar instance along with the associated - CommandName. The default value is an empty string. - - - - - Gets or sets a value indicating whether validation is performed when - the RadToolBarSplitButton is clicked - - - true if validation is performed when the - RadToolBarSplitButton is clicked otherwise, false. - The default value is true. - - - By default, page validation is performed when the button is clicked. Page - validation determines whether the input controls associated with a validation - control on the page all pass the validation rules specified by the validation - control. You can specify or determine whether validation is performed when the button is clicked - on both the client and the server by using the CausesValidation - property. To prevent validation from being performed, set the - CausesValidation property to false. - - - - - Gets or sets the name of the validation group to which the - RadToolBarSplitButton belongs. - - - The name of the validation group to which this RadToolBarSplitButton - belongs. The default is an empty string (""), which indicates that this property is not set. - - - This property works only when CausesValidation - is set to true. - - - - - - Gets or sets the URL of the page to post to from the current page when the - RadToolBarSplitButton is clicked. - - - The URL of the Web page to post to from the current page when the - RadToolBarSplitButton is clicked. The default value is an empty - string (""), which causes the page to post back to itself. - - - - - - - - - - - - - RadToolBar control class. - - - - - Populates the RadToolBar control from external XML file. - - - The newly added items will be appended after any existing ones. - - - The following example demonstrates how to populate RadToolBar control - from XML file. - - private void Page_Load(object sender, EventArgs e) - { - if (!Page.IsPostBack) - { - RadToolBar1.LoadContentFile("~/ToolBarData.xml"); - } - } - - - Private Sub Page_Load(sender As Object, e As EventArgs) Handles MyBase.Load - If Not Page.IsPostBack Then - RadToolBar1.LoadContentFile("~/ToolBarData.xml") - End If - End Sub - - - The name of the XML file. - - - - Gets a linear list of all toolbar items in the RadToolBar control. - - - An IList object containing - all items in the current RadToolBar control. - - - - - Gets a linear list of all toolbar buttons in the RadToolBar control, - which belong to the specified group - - The name of the group to search for. - An IList object containing - all the buttons in the current RadToolBar control, which belong to the specified group. - - - - - Gets the checked button which belongs to the specified group in the - RadToolBar control - - The name of the group to search for. - A RadToolBarButton object which - CheckOnClick and Checked properties are set to true. - - - - - Searches the RadToolBar control for the first - RadToolBarItem whose Text - property is equal to the specified value. - - - A RadToolBarItem whose Text - property is equal to the specified value. If an item is not found, null - (Nothing in Visual Basic) is returned. - - The value to search for. - - - - Searches the RadToolBar control for the first - RadToolBarItem whose Text - property is equal to the specified value. - - - A RadToolBarItem whose Text - property is equal to the specified value. If an item is not found, null - (Nothing in Visual Basic) is returned. - - The value to search for. - A Boolean indicating a case-sensitive or insensitive comparison (true indicates a case-insensitive comparison). - - - - Searches the RadToolBar control for the first - RadToolBarButton or - RadToolBarSplitButton which - Value - property is equal to the specified value. - - - A RadToolBarButton or - RadToolBarSplitButton which - Value - property is equal to the specified value. If an item is not found, null - (Nothing in Visual Basic) is returned. - - The value to search for. - - - - Searches the RadToolBar control for the first - RadToolBarButton or - RadToolBarSplitButton which - Value - property is equal to the specified value. - - - A RadToolBarButton or - RadToolBarSplitButton which - Value - property is equal to the specified value. If an item is not found, null - (Nothing in Visual Basic) is returned. - - The value to search for. - A Boolean indicating a case-sensitive or insensitive comparison (true indicates a case-insensitive comparison). - - - - Searches the RadToolBar control for the first - RadToolBarButton or - RadToolBarSplitButton which - NavigateUrl - property is equal to the specified value. - - - A RadToolBarButton or - RadToolBarSplitButton which - NavigateUrl - property is equal to the specified value. If an item is not found, null - (Nothing in Visual Basic) is returned. - - The url to search for. - - - - Searches the RadToolBar control for the first - IRadToolBarButton - CommandName - property is equal to the specified value. - - - A IRadToolBarButton which - CommandName - property is equal to the specified value. If an item is not found, null - (Nothing in Visual Basic) is returned. - - The commandName to search for. - - - - Returns the first RadToolBarItem - that matches the conditions defined by the specified predicate. - The predicate should returns a boolean value. - - - The following example demonstrates how to use the FindItem method. - - void Page_Load(object sender, EventArgs e) - { - RadToolBar1.FindItem(ItemWithEqualsTextAndValue); - } - private static bool ItemWithEqualsTextAndValue(RadToolBarItem item) - { - if (item.Text == item.Value) - { - return true; - } - else - { - return false; - } - } - - - Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs) - RadToolBar1.FindItem(ItemWithEqualsTextAndValue) - End Sub - Private Shared Function ItemWithEqualsTextAndValue(ByVal item As RadToolBarItem) As Boolean - If item.Text = item.Value Then - Return True - Else - Return False - End If - End Function - - - The Predicate <> that defines the conditions of the element to search for. - - - - Gets a list of all client-side changes (adding an item, removing an item, changing an item's property) which have occurred. - - - A list of objects which represent all client-side changes the user has performed. - By default the ClientChanges property returns empty list. Client-changes are recorded if and only if the client-side - methods trackChanges()/commitChanges() have been invoked. - - - You can use the ClientChanges property to respond to client-side modifications such as - - adding a new item - removing existing item - clearing the children of an item or the control itself - changing a property of the item - - The ClientChanges property is available in the first postback (ajax) request after the client-side modifications - have taken place. After this moment the property will return empty list. - - - The following example demonstrates how to use the ClientChanges property - - foreach (ClientOperation<RadToolBarItem> operation in RadToolBar1.ClientChanges) - { - RadToolBarItem item = operation.Item; - - switch (operation.Type) - { - case ClientOperationType.Insert: - //An item has been inserted - operation.Item contains the inserted item - break; - case ClientOperationType.Remove: - //An item has been inserted - operation.Item contains the removed item. - //Keep in mind the item has been removed from the toolbar. - break; - case ClientOperationType.Update: - UpdateClientOperation<RadToolBarItem> update = operation as UpdateClientOperation<RadToolBarItem> - //The "UpdateOperation" provides an additional property "PropertyName". This is the property whose value was changed from the client side. - break; - case ClientOperationType.Clear: - //All children of have been removed - operation.Item contains the parent item whose children have been removed. If operation.Item is null then the root items have been removed. - break; - } - } - - - For Each operation As ClientOperation(Of RadToolBarItem) In RadToolBar1.ClientChanges - Dim item As RadToolBarItem = operation.Item - Select Case operation.Type - Case ClientOperationType.Insert - 'An item has been inserted - operation.Item contains the inserted item - Exit Select - Case ClientOperationType.Remove - 'An item has been inserted - operation.Item contains the removed item. - 'Keep in mind the item has been removed from the toolbar. - Exit Select - Case ClientOperationType.Update - Dim update As UpdateClientOperation(Of RadToolBarItem) = TryCast(operation, UpdateClientOperation(Of RadToolBarItem)) - 'The "UpdateOperation" provides an additional property "PropertyName". This is the property whose value was changed from the client side. - Exit Select - Case ClientOperationType.Clear - 'All children of have been removed - operation.Item contains the parent item whose children have been removed. If operation.Item is Nothing then the root items have been removed. - Exist Select - End Select - Next - - - - - - Gets a collection of RadToolBarItem objects representing - the individual items within the RadToolBar. - - - A RadToolBarItemCollection that contains a collection of - RadToolBarItem objects representing - the individual items within the RadToolBar. - - - Use the Items collection to programmatically control the items in the - RadToolBar control. - - - The following example demonstrates how to declare a RadToolBar - with different items. - - <telerik:RadToolBar ID="RadToolBar1" runat="server"> - <Items> - <telerik:RadToolBarButton ImageUrl="~/ToolBarImages/CreateNew.gif" - Text="Create new" CommandName="CreateNew"/> - <telerik:RadToolBarButton IsSeparator="true" /> - <telerik:RadToolBarDropDown ImageUrl="~/ToolbarImages/Manage.gif" Text="Manage"> - <Buttons> - <telerik:RadToolBarButton ImageUrl="~/ToolbarImages/ManageUsers.gif" - Text="Users" /> - <telerik:RadToolBarButton ImageUrl="~/ToolbarImages/ManageOrders.gif" - Text="Orders" /> - </Buttons> - </telerik:RadToolBarDropDown> - <telerik:RadToolBarSplitButton ImageUrl="~/ToolBarImages/RegisterPurchase.gif" - Text="Register Purchase"> - <Buttons> - <telerik:RadToolBarButton ImageUrl="~/ToolBarImages/RegisterCachePurchase.gif" - Text="Cache Purchase" /> - <telerik:RadToolBarButton ImageUrl="~/ToolBarImages/RegisterCheckPurchase.gif" - Text="Check Purchase" /> - <telerik:RadToolBarButton ImageUrl="~/ToolBarImages/RegisterDirectBankPurchase.gif" - Text="Bank Purchase" /> - </Buttons> - </telerik:RadToolBarSplitButton> - </Items> - </telerik:RadToolBar> - - - - - - Gets or sets the direction in which to render the RadToolBar control. - - - One of the Orientation enumeration values. The default is Orientation.Horizontal. - - - Use the Orientation property to specify the direction in which to render the RadToolBar - control. The following table lists the available directions. - - - - Orientation - Description - - - Orientation.Horizontal - The RadToolBar control is rendered horizontally. - - - Orientation.Vertical - The RadToolBar control is rendered vertically. - - - - - - The following example demonstrates how to use the Orientation property - to display a vertical RadToolBar. - - <telerik:RadToolBar ID="RadToolBar1" runat="server"> - <Items> - <telerik:RadToolBarButton ImageUrl="~/ToolBarImages/CreateNew.gif" - Text="Create new" CommandName="CreateNew"/> - <telerik:RadToolBarButton IsSeparator="true" /> - <telerik:RadToolBarDropDown ImageUrl="~/ToolbarImages/Manage.gif" Text="Manage"> - <Buttons> - <telerik:RadToolBarButton ImageUrl="~/ToolbarImages/ManageUsers.gif" - Text="Users" /> - <telerik:RadToolBarButton ImageUrl="~/ToolbarImages/ManageOrders.gif" - Text="Orders" /> - </Buttons> - </telerik:RadToolBarDropDown> - <telerik:RadToolBarSplitButton ImageUrl="~/ToolBarImages/RegisterPurchase.gif" - Text="Register Purchase"> - <Buttons> - <telerik:RadToolBarButton ImageUrl="~/ToolBarImages/RegisterCachePurchase.gif" - Text="Cache Purchase" /> - <telerik:RadToolBarButton ImageUrl="~/ToolBarImages/RegisterCheckPurchase.gif" - Text="Check Purchase" /> - <telerik:RadToolBarButton ImageUrl="~/ToolBarImages/RegisterDirectBankPurchase.gif" - Text="Bank Purchase" /> - </Buttons> - </telerik:RadToolBarSplitButton> - </Items> - </telerik:RadToolBar> - - - - - Gets the settings for the animation played when a dropdown opens. - - An AnnimationSettings that represents the - expand animation. - - - - Use the ExpandAnimation property to customize the expand - animation of the RadToolBar dropdown items - - RadToolBarDropDown and - RadToolBarSplitButton. You can specify the - Type and - the Duration of the expand animation. - To disable expand animation effects you should set the - Type to - AnimationType.None.
- To customize the collapse animation you can use the - CollapseAnimation property. -
-
- - The following example demonstrates how to set the ExpandAnimation - of the RadToolBar dropdown items. - - ASPX: - - - <telerik:RadToolBar ID="RadToolBar1" runat="server"> - <ExpandAnimation Type="OutQuint" Duration="300" - /> - <Items> - <telerik:RadToolBarDropDown Text="Insert Html Element" > - <Buttons> - <telerik:RadToolBarButton Text="Image" /> - <telerik:RadToolBarButton Text="Editable Div element" /> - </Buttons> - </telerik:RadToolBarDropDown> - <telerik:RadToolBarSplitButton Text="Insert Form Element" > - <Buttons> - <telerik:RadToolBarButton Text="Button" /> - <telerik:RadToolBarButton Text="TextBox" /> - <telerik:RadToolBarButton Text="TextArea" /> - <telerik:RadToolBarButton Text="CheckBox" /> - <telerik:RadToolBarButton Text="RadioButton" /> - </Buttons> - </telerik:RadToolBarSplitButton> - </Items> - </telerik:RadToolBar> - - - void Page_Load(object sender, EventArgs e) - { - RadToolBar1.ExpandAnimation.Type = AnimationType.Linear; - RadToolBar1.ExpandAnimation.Duration = 300; - } - - - Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Load - RadToolBar1.ExpandAnimation.Type = AnimationType.Linear - RadToolBar1.ExpandAnimation.Duration = 300 - End Sub - - -
- - Gets the settings for the animation played when a dropdown closes. - - An AnnimationSettings that represents the - collapse animation. - - - - Use the CollapseAnimation property to customize the collapse - animation of the RadToolBar dropdown items - - RadToolBarDropDown and - RadToolBarSplitButton. You can specify the - Type and - the Duration of the collapse animation. - To disable collapse animation effects you should set the - Type to - AnimationType.None.
- To customize the expand animation you can use the - ExpandAnimation property. -
-
- - The following example demonstrates how to set the CollapseAnimation - of the RadToolBar dropdown items. - - ASPX: - - - <telerik:RadToolBar ID="RadToolBar1" runat="server"> - <CollapseAnimation Type="OutQuint" Duration="300" - /> - <Items> - <telerik:RadToolBarDropDown Text="Insert Html Element" > - <Buttons> - <telerik:RadToolBarButton Text="Image" /> - <telerik:RadToolBarButton Text="Editable Div element" /> - </Buttons> - </telerik:RadToolBarDropDown> - <telerik:RadToolBarSplitButton Text="Insert Form Element" > - <Buttons> - <telerik:RadToolBarButton Text="Button" /> - <telerik:RadToolBarButton Text="TextBox" /> - <telerik:RadToolBarButton Text="TextArea" /> - <telerik:RadToolBarButton Text="CheckBox" /> - <telerik:RadToolBarButton Text="RadioButton" /> - </Buttons> - </telerik:RadToolBarSplitButton> - </Items> - </telerik:RadToolBar> - - - void Page_Load(object sender, EventArgs e) - { - RadToolBar1.CollapseAnimation.Type = AnimationType.Linear; - RadToolBar1.CollapseAnimation.Duration = 300; - } - - - Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Load - RadToolBar1.CollapseAnimation.Type = AnimationType.Linear - RadToolBar1.CollapseAnimation.Duration = 300 - End Sub - - -
- - - Gets or sets the name of the validation group to which this validation - control belongs. - - - The name of the validation group to which this validation control belongs. The - default is an empty string (""), which indicates that this property is not set. - - - This property works only when CausesValidation - is set to true. - - - - - - Gets or sets the URL of the page to post to from the current page when a button item - from the RadToolBar control is clicked. - - - The URL of the Web page to post to from the current page when a tab from the - tabstrip control is clicked. The default value is an empty string (""), which causes - the page to post back to itself. - - - - - Gets or sets a value indicating whether validation is performed when a button item within - the RadToolBar control is clicked. - - - true if validation is performed when a button item is clicked; - otherwise, false. The default value is true. - - - By default, page validation is performed when a button item is clicked. Page - validation determines whether the input controls associated with a validation - control on the page all pass the validation rules specified by the validation - control. You can specify or determine whether validation is performed on both the - client and the server when a tab is clicked by using the CausesValidation - property. To prevent validation from being performed, set the - CausesValidation property to false. - - - - - Gets or sets a value indicating whether button items should postback when clicked. - - - True if button items should postback; otherwise false. The default - value is false. - - - RadToolBar will postback provided one of the following conditions is met: - - - The AutoPostBack property is set to true. - - - The user has subscribed to the ButtonClick event. - - - - - - - Gets or sets the name of the javascript function called when the control is fully - initialized on the client side. - - - A string specifying the name of the javascript function called when the control - is fully initialized on the client side. The default value is empty string. - - - Use the OnClientLoad property to specify a JavaScript - function that is executed after the control is initialized on the client side. - A single parameter is passed to the handler, which is the - client-side RadToolBar object. - - - The following example demonstrates how to use the OnClientLoad - property. - - <script language="javascript">
- function onClientToolBarLoad(toolBar, eventArgs)
- {
- alert(toolBar.get_id() + " is loaded.");
- }
- </script>
-
- <telerik:RadToolBar id="RadToolBar1" runat="server" - OnClientButtonClicking="onButtonClicking">
- <Items>
- <telerik:RadToolBarButton Text="Save"></telerik:RadToolBarButton>
- <telerik:RadToolBarButton Text="Load"></telerik:RadToolBarButton>
- <telerik:RadToolBarDropDown Text="Align">
- <Buttons>
- <telerik:RadToolBarButton Text="Left"></telerik:RadToolBarButton>
- <telerik:RadToolBarButton Text="Center"></telerik:RadToolBarButton>
- <telerik:RadToolBarButton Text="Right"></telerik:RadToolBarButton>
- </Buttons>
- </telerik:RadToolBarDropDown>
- <telerik:RadToolBarSplitButton Text="Apply Color (Red)">
- <Buttons>
- <telerik:RadToolBarButton Text="Red"></telerik:RadToolBarButton>
- <telerik:RadToolBarButton Text="Yellow"></telerik:RadToolBarButton>
- <telerik:RadToolBarButton Text="Blue"></telerik:RadToolBarButton>
- </Buttons>
- </telerik:RadToolBarSplitButton>
- </Items>
- </telerik:RadToolBar>
-
-
-
- - - Gets or sets a value indicating the client-side event handler that is called just - prior to clicking a toolbar button item (RadToolBarButton or RadToolBarSplitButton). - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - Use the OnClientButtonClicking property to specify a - JavaScript function that will be executed prior to button item clicking - either by - left-clicking it with the mouse or hitting enter after tabbing to that button. You can - cancel that event (prevent button clicking) by seting the cancel property of the event argument to true. - Two parameters are passed to the handler - - sender (the client-side RadToolBar object) - - eventArgs with three properties -
    -
  • item - the instance of the button item being clicked
  • -
  • cancel - whether to cancel the event
  • -
  • domEvent - the reference to the browser DOM event
  • -
-
-
-
-
- - The following example demonstrates how to use the - OnClientButtonClicking property. - - <script language="javascript">
- function clientButtonClicking(sender, eventArgs)
- {
- var toolBar = sender;
- var button = eventArgs.get_item();
-
- alert("You are clicking the '" + button.get_text() + "' button in the '" + toolBar.get_id() + - "' toolBar.");
-
- if (button.get_text() == "Right")
- {
- alert("Right alignment is not available");
- eventArgs.set_cancel(true);
- }
- }
- </script>
-
- <telerik:RadToolBar id="RadToolBar1" runat="server" - OnClientButtonClicking="clientButtonClicking">
- <Items>
- <telerik:RadToolBarButton Text="Left"></telerik:RadToolBarButton>
- <telerik:RadToolBarButton Text="Center"></telerik:RadToolBarButton>
- <telerik:RadToolBarButton Text="Right"></telerik:RadToolBarButton>
- <telerik:RadToolBarDropDown Text="Align">
- <Buttons>
- <telerik:RadToolBarButton Text="Left"></telerik:RadToolBarButton>
- <telerik:RadToolBarButton Text="Center"></telerik:RadToolBarButton>
- <telerik:RadToolBarButton Text="Right"></telerik:RadToolBarButton>
- </Buttons>
- </telerik:RadToolBarDropDown>
- <telerik:RadToolBarSplitButton Text="Right">
- <Buttons>
- <telerik:RadToolBarButton Text="Left"></telerik:RadToolBarButton>
- <telerik:RadToolBarButton Text="Center"></telerik:RadToolBarButton>
- <telerik:RadToolBarButton Text="Right"></telerik:RadToolBarButton>
- </Buttons>
- </telerik:RadToolBarSplitButton>
- </Items>
- </telerik:RadToolBar>
-
-
-
- - - Gets or sets a value indicating the client-side event handler that is called - after clicking a button item (RadToolBarButton or RadToolBarSplitButton). - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - Use the OnClientButtonClicked property to specify a JavaScript - function that will be executed after a button is clicked - either by left-clicking it - with the mouse or hitting enter after tabbing to that button item. - Two parameters are passed to the handler - - sender (the client-side RadToolBar object) - - eventArgs with two properties -
    -
  • item - the instance of the clicked button
  • -
  • domEvent - the reference to the browser DOM event
  • -
-
-
-
- - The following example demonstrates how to use the - OnClientButtonClicked property. - - <script language="javascript">
- function clientButtonClicked(sender, eventArgs)
- {
- var toolBar = sender;
- var button = eventArgs.get_item();
-
- alert(String.format("You clicked the '{0}' button in the '{1}' toolBar.", - button.get_text(), toolBar.get_id()));
- }
- </script>
- <telerik:RadToolBar id="RadToolBar1" runat="server" - OnClientButtonClicked="clientButtonClicked">
- <Items>
- <telerik:RadToolBarButton Text="Left"></telerik:RadToolBarButton>
- <telerik:RadToolBarButton Text="Center"></telerik:RadToolBarButton>
- <telerik:RadToolBarButton Text="Right"></telerik:RadToolBarButton>
- <telerik:RadToolBarDropDown Text="Align">
- <Buttons>
- <telerik:RadToolBarButton Text="Left"></telerik:RadToolBarButton>
- <telerik:RadToolBarButton Text="Center"></telerik:RadToolBarButton>
- <telerik:RadToolBarButton Text="Right"></telerik:RadToolBarButton>
- </Buttons>
- </telerik:RadToolBarDropDown>
- <telerik:RadToolBarSplitButton Text="Right">
- <Buttons>
- <telerik:RadToolBarButton Text="Left"></telerik:RadToolBarButton>
- <telerik:RadToolBarButton Text="Center"></telerik:RadToolBarButton>
- <telerik:RadToolBarButton Text="Right"></telerik:RadToolBarButton>
- </Buttons>
- </telerik:RadToolBarSplitButton>
- </Items>
- </telerik:RadToolBar>
-
-
- - - Gets or sets a value indicating the client-side event handler that is called just - prior to opening a toolbar dropdown item (RadToolBarDropDown or RadToolBarSplitButton). - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - Use the OnClientDropDownOpening property to specify a - JavaScript function that will be executed prior to dropdown item opening - either by - left-clicking it with the mouse or hitting the down arrow after tabbing to that item. You can - cancel that event (prevent dropdown opening) by seting the cancel property of the event argument to true. - Two parameters are passed to the handler - - sender (the client-side RadToolBar object) - - eventArgs with three properties -
    -
  • item - the instance of the dropdown item being opened
  • -
  • cancel - whether to cancel the event
  • -
  • domEvent - the reference to the browser DOM event (null if the event was initiated by - calling a client-side method such as dropDownItem.showDropDown();)
  • -
-
-
-
-
- - The following example demonstrates how to use the - OnClientDropDownOpening property. - - <script language="javascript">
- function clientDropDownOpening(sender, eventArgs)
- {
- var toolBar = sender;
- var dropDownItem = eventArgs.get_item();
-
- alert("You are opening the '" + dropDownItem.get_text() + "' dropDown in the '" + toolBar.get_id() + - "' toolBar.");
-
- if (dropDownItem.get_text() == "Align")
- {
- alert("Alignment is not available");
- eventArgs.set_cancel(true);
- }
- }
- </script>
-
- <telerik:RadToolBar id="RadToolBar1" runat="server" - OnClientDropDownOpening="clientDropDownOpening">
- <Items>
- <telerik:RadToolBarButton Text="Left"></telerik:RadToolBarButton>
- <telerik:RadToolBarButton Text="Center"></telerik:RadToolBarButton>
- <telerik:RadToolBarButton Text="Right"></telerik:RadToolBarButton>
- <telerik:RadToolBarDropDown Text="Align">
- <Buttons>
- <telerik:RadToolBarButton Text="Left"></telerik:RadToolBarButton>
- <telerik:RadToolBarButton Text="Center"></telerik:RadToolBarButton>
- <telerik:RadToolBarButton Text="Right"></telerik:RadToolBarButton>
- </Buttons>
- </telerik:RadToolBarDropDown>
- <telerik:RadToolBarSplitButton Text="Right">
- <Buttons>
- <telerik:RadToolBarButton Text="Left"></telerik:RadToolBarButton>
- <telerik:RadToolBarButton Text="Center"></telerik:RadToolBarButton>
- <telerik:RadToolBarButton Text="Right"></telerik:RadToolBarButton>
- </Buttons>
- </telerik:RadToolBarSplitButton>
- </Items>
- </telerik:RadToolBar>
-
-
-
- - - Gets or sets a value indicating the client-side event handler that is called after a - toolbar dropdown item (RadToolBarDropDown or RadToolBarSplitButton) is opened. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - Use the OnClientDropDownOpened property to specify a - JavaScript function that will be executed after a toolbar dropdown item - is opened - either by left-clicking it with the mouse or hitting the down arrow - after tabbing to that item. - Two parameters are passed to the handler - - sender (the client-side RadToolBar object) - - eventArgs with two properties -
    -
  • item - the instance of the dropdown item which is opened
  • -
  • domEvent - the reference to the browser DOM event (null if the event was initiated by - calling a client-side method such as dropDownItem.showDropDown())
  • -
-
-
-
-
- - The following example demonstrates how to use the - OnClientDropDownOpened property. - - <script language="javascript">
- function clientDropDownOpened(sender, eventArgs)
- {
- var toolBar = sender;
- var dropDownItem = eventArgs.get_item();
-
- alert("You just opened the '" + dropDownItem.get_text() + "' dropDown in the '" + toolBar.get_id() + - "' toolBar.");
-
- }
- </script>
-
- <telerik:RadToolBar id="RadToolBar1" runat="server" - OnClientDropDownOpened="clientDropDownOpened">
- <Items>
- <telerik:RadToolBarButton Text="Left"></telerik:RadToolBarButton>
- <telerik:RadToolBarButton Text="Center"></telerik:RadToolBarButton>
- <telerik:RadToolBarButton Text="Right"></telerik:RadToolBarButton>
- <telerik:RadToolBarDropDown Text="Align">
- <Buttons>
- <telerik:RadToolBarButton Text="Left"></telerik:RadToolBarButton>
- <telerik:RadToolBarButton Text="Center"></telerik:RadToolBarButton>
- <telerik:RadToolBarButton Text="Right"></telerik:RadToolBarButton>
- </Buttons>
- </telerik:RadToolBarDropDown>
- <telerik:RadToolBarSplitButton Text="Right">
- <Buttons>
- <telerik:RadToolBarButton Text="Left"></telerik:RadToolBarButton>
- <telerik:RadToolBarButton Text="Center"></telerik:RadToolBarButton>
- <telerik:RadToolBarButton Text="Right"></telerik:RadToolBarButton>
- </Buttons>
- </telerik:RadToolBarSplitButton>
- </Items>
- </telerik:RadToolBar>
-
-
-
- - - Gets or sets a value indicating the client-side event handler that is called just - prior to closing a toolbar dropdown item (RadToolBarDropDown or RadToolBarSplitButton). - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - Use the OnClientDropDownClosing property to specify a - JavaScript function that will be executed prior to dropdown item closing - either by - left-clicking an open dropdown with the mouse, hitting the ESC key when the dropdown or - a button in it is focused, or clicking a non-checkable button in the dropdown. You can - cancel that event (prevent dropdown closing) by seting the cancel property of the event argument to true. - Two parameters are passed to the handler - - sender (the client-side RadToolBar object) - - eventArgs with three properties -
    -
  • item - the instance of the dropdown item being closed
  • -
  • cancel - whether to cancel the event
  • -
  • domEvent - the reference to the browser DOM event (null if the event was initiated by - calling a client-side method such as dropDownItem.hideDropDown())
  • -
-
-
-
-
- - The following example demonstrates how to use the - OnClientDropDownClosing property. - - <script language="javascript">
- function clientDropDownClosing(sender, eventArgs)
- {
- var toolBar = sender;
- var dropDownItem = eventArgs.get_item();
-
- alert("You are about to close the '" + dropDownItem.get_text() + "' dropDown in the '" + toolBar.get_id() + - "' toolBar.");
-
- if (dropDownItem.get_text() == "Align")
- {
- alert("You cannot close the Align dropdown!");
- eventArgs.set_cancel(true);
- }
- }
- </script>
-
- <telerik:RadToolBar id="RadToolBar1" runat="server" - OnClientDropDownClosing="clientDropDownClosing">
- <Items>
- <telerik:RadToolBarButton Text="Left"></telerik:RadToolBarButton>
- <telerik:RadToolBarButton Text="Center"></telerik:RadToolBarButton>
- <telerik:RadToolBarButton Text="Right"></telerik:RadToolBarButton>
- <telerik:RadToolBarDropDown Text="Align">
- <Buttons>
- <telerik:RadToolBarButton Text="Left"></telerik:RadToolBarButton>
- <telerik:RadToolBarButton Text="Center"></telerik:RadToolBarButton>
- <telerik:RadToolBarButton Text="Right"></telerik:RadToolBarButton>
- </Buttons>
- </telerik:RadToolBarDropDown>
- <telerik:RadToolBarSplitButton Text="Right">
- <Buttons>
- <telerik:RadToolBarButton Text="Left"></telerik:RadToolBarButton>
- <telerik:RadToolBarButton Text="Center"></telerik:RadToolBarButton>
- <telerik:RadToolBarButton Text="Right"></telerik:RadToolBarButton>
- </Buttons>
- </telerik:RadToolBarSplitButton>
- </Items>
- </telerik:RadToolBar>
-
-
-
- - - Gets or sets a value indicating the client-side event handler that is called after a - toolbar dropdown item (RadToolBarDropDown or RadToolBarSplitButton) is closed. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - Use the OnClientDropDownClosed property to specify a - JavaScript function that will be executed after a toolbar dropdown item - is closed - either by left-clicking an open dropdown with the mouse, hitting - the ESC key when the dropdown or a button in it is focused, or clicking a - non-checkable button in the dropdown. - Two parameters are passed to the handler - - sender (the client-side RadToolBar object) - - eventArgs with two properties -
    -
  • item - the instance of the dropdown item which is closed
  • -
  • domEvent - the reference to the browser DOM event (null if the event was initiated by - calling a client-side method such as dropDownItem.hideDropDown())
  • -
-
-
-
-
- - The following example demonstrates how to use the - OnClientDropDownClosed property. - - <script language="javascript">
- function clientDropDownClosed(sender, eventArgs)
- {
- var toolBar = sender;
- var dropDownItem = eventArgs.get_item();
-
- alert("You just closed the '" + dropDownItem.get_text() + "' dropDown in the '" + toolBar.get_id() + - "' toolBar.");
-
- }
- </script>
-
- <telerik:RadToolBar id="RadToolBar1" runat="server" - OnClientDropDownClosed="clientDropDownClosed">
- <Items>
- <telerik:RadToolBarButton Text="Left"></telerik:RadToolBarButton>
- <telerik:RadToolBarButton Text="Center"></telerik:RadToolBarButton>
- <telerik:RadToolBarButton Text="Right"></telerik:RadToolBarButton>
- <telerik:RadToolBarDropDown Text="Align">
- <Buttons>
- <telerik:RadToolBarButton Text="Left"></telerik:RadToolBarButton>
- <telerik:RadToolBarButton Text="Center"></telerik:RadToolBarButton>
- <telerik:RadToolBarButton Text="Right"></telerik:RadToolBarButton>
- </Buttons>
- </telerik:RadToolBarDropDown>
- <telerik:RadToolBarSplitButton Text="Right">
- <Buttons>
- <telerik:RadToolBarButton Text="Left"></telerik:RadToolBarButton>
- <telerik:RadToolBarButton Text="Center"></telerik:RadToolBarButton>
- <telerik:RadToolBarButton Text="Right"></telerik:RadToolBarButton>
- </Buttons>
- </telerik:RadToolBarSplitButton>
- </Items>
- </telerik:RadToolBar>
-
-
-
- - - Gets or sets a value indicating the client-side event handler that is called - before the browser context menu shows (after right-clicking an item). - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - Use the OnClientContextMenu property to specify a JavaScript - function that will be executed before the context menu shows after right clicking an - item. - Two parameters are passed to the handler - - sender (the client-side RadToolBar object) - - eventArgs with two properties -
    -
  • item - the instance of the selected toolbar item
  • -
  • domEvent - the reference to the browser DOM event
  • -
-
-
-
- - The following example demonstrates how to use the - OnClientContextMenu property. - - <script language="javascript">
- function onContextMenuHandler(sender, eventArgs)
- {
- var toolBar = sender;
- var item = eventArgs.get_item();
-
- alert(String.format("You have right-clicked the {0} item in the {1} toolBar.", item.get_text(), toolBar.get_id());
- }
- </script>
- <telerik:RadToolBar id="RadToolBar1" runat="server" - OnClientContextMenu="onContextMenuHandler">
- <Items>
- <telerik:RadToolBarButton Text="Bold"></telerik:RadToolBarButton>
- <telerik:RadToolBarButton Text="Italic"></telerik:RadToolBarButton>
- <telerik:RadToolBarButton Text="Underline"></telerik:RadToolBarButton>
- </Items>
- </telerik:RadToolBar>
-
-
-
- - - Gets or sets a value indicating the client-side event handler that is called when - the mouse hovers an item in the RadToolBar control. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - Use the OnClientMouseOver property to specify a JavaScript - function that is called when the user hovers an item with the mouse. - Two parameters are passed to the handler: - - sender (the client-side RadToolBar object); - - eventArgs with two properties -
    -
  • item - the instance of the toolbar item that is being hovered
  • -
  • domEvent - the reference to the browser DOM event
  • -
-
-
-
- - The following example demonstrates how to use the - OnClientMouseOver property. - - <script language="javascript">
- function onClientMouseOver(sender, eventArgs)
- {
- var toolBar = sender;
- var item = eventArgs.get_item();
- var domEvent = eventArgs.get_domEvent();
-
- alert(String.format("You have just moved over the {0} item in the {1} toolBar", item.get_text(), toolBar.get_id());
- alert(String.format("Mouse coordinates: \n\nx = {0};\ny = {1}", domEvent.clientX, domEvent.clientY));
- }
- </script>
-
- <telerik:RadToolBar id="RadToolBar1" runat="server" - OnClientMouseOver="onClientMouseOver">
- <Items>
- <telerik:RadToolBarButton Text="Bold"></telerik:RadToolBarButton>
- <telerik:RadToolBarButton Text="Italic"></telerik:RadToolBarButton>
- <telerik:RadToolBarButton Text="Underline"></telerik:RadToolBarButton>
- </Items>
- </telerik:RadToolBar>
-
-
- - - Gets or sets a value indicating the client-side event handler that is called when - the mouse leaves an item in the RadToolBar control. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - Use the OnClientMouseOut property to specify a JavaScript - function that is executed whenever the user moves the mouse - away from a particular item in the RadToolBar control. - Two parameters are passed to the handler: - - sender (the client-side RadToolBar object); - - eventArgs with two properties: -
    -
  • item - the instance of the item which the mouse is moving - away from;
  • -
  • domEvent - the reference to the browser DOM event
  • -
-
-
-
- - The following example demonstrates how to use the OnClientMouseOut - property. - - <script language="javascript">
- function onClientMouseOut(sender, eventArgs)
- {
- var toolBar = sender;
- var item = eventArgs.get_item();
- var domEvent = eventArgs.get_domEvent(); - alert(String.format("You have just moved out of '{0}' item in the {1} toolBar.", - item.get_text(), toolBar.get_id()));
- alert(String.format("Mouse coordinates: \n\nx = {0}\ny = {1}", - domEvent.clientX, domEvent.clientY));
- }
- </script>
- <telerik:RadToolBar id="RadToolBar1" runat="server" - OnClientMouseOut="onClientMouseOut">
- <Items>
- <telerik:RadToolBarButton Text="Bold"></telerik:RadToolBarButton>
- <telerik:RadToolBarButton Text="Italic"></telerik:RadToolBarButton>
- <telerik:RadToolBarButton Text="Underline"></telerik:RadToolBarButton>
- </Items>
- </telerik:RadToolBar> -
-
-
-
- - - Gets or sets a value indicating the client-side event handler that is called just - prior to changing the state of a checkable RadToolBarButton. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - Use the OnClientCheckedStateChanging property to specify a - JavaScript function that will be executed prior to button checked state changing - either by - left-clicking a checkable button or pressing the ENTER key after tabbing to that button. You can - cancel that event (prevent button checked state changing) by seting the cancel property of the - event argument to true. - Two parameters are passed to the handler - - sender (the client-side RadToolBar object) - - eventArgs with three properties -
    -
  • item - the instance of the button which checked state is being changed
  • -
  • cancel - whether to cancel the event
  • -
  • domEvent - the reference to the browser DOM event (null if the event was initiated by - calling a client-side method such as button.toggle())
  • -
-
-
-
-
- - The following example demonstrates how to use the - OnClientCheckedStateChanging property. - - <script language="javascript">
- function clientCheckedStateChanging(sender, eventArgs)
- {
- var toolBar = sender;
- var button = eventArgs.get_item();
-
- alert(String.format("You are about to change the checked state of the '{0}' button in the '{1}' toolBar.", - button.get_text(), toolBar.get_id()));
-
- if (item.get_text() == "Left" && item.get_group() == "Align")
- {
- alert("You cannot change the checked state of the 'Align Left' button!");
- eventArgs.set_cancel(true);
- }
- }
- </script>
-
- <telerik:RadToolBar id="RadToolBar1" runat="server" - OnClientCheckedStateChanging="clientCheckedStateChanging">
- <Items>
- <telerik:RadToolBarButton Text="Left" CheckOnClick="true" Group="Align" ></telerik:RadToolBarButton>
- <telerik:RadToolBarButton Text="Center" CheckOnClick="true" Group="Align" ></telerik:RadToolBarButton>
- <telerik:RadToolBarButton Text="Right" CheckOnClick="true" Group="Align" ></telerik:RadToolBarButton>
- <telerik:RadToolBarDropDown Text="Align">
- <Buttons>
- <telerik:RadToolBarButton Text="Left" CheckOnClick="true" Group="Align" ></telerik:RadToolBarButton>
- <telerik:RadToolBarButton Text="Center" CheckOnClick="true" Group="Align" ></telerik:RadToolBarButton>
- <telerik:RadToolBarButton Text="Right" CheckOnClick="true" Group="Align" ></telerik:RadToolBarButton>
- </Buttons>
- </telerik:RadToolBarDropDown>
- <telerik:RadToolBarSplitButton Text="Reset">
- <Buttons>
- <telerik:RadToolBarButton Text="Left" CheckOnClick="true" Group="Align" ></telerik:RadToolBarButton>
- <telerik:RadToolBarButton Text="Center" CheckOnClick="true" Group="Align" ></telerik:RadToolBarButton>
- <telerik:RadToolBarButton Text="Right" CheckOnClick="true" Group="Align" ></telerik:RadToolBarButton>
- </Buttons>
- </telerik:RadToolBarSplitButton>
- </Items>
- </telerik:RadToolBar>
-
-
-
- - - Gets or sets a value indicating the client-side event handler that is called after a - RadToolBarButton is checked. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - Use the OnClientCheckedStateChanged property to specify a - JavaScript function that will be executed after a toolbar dropdown button - is checked - either by left-clicking a checkable button or pressing the ENTER - key after tabbing to that button. - Two parameters are passed to the handler - - sender (the client-side RadToolBar object) - - eventArgs with two properties -
    -
  • item - the instance of the button which is checked
  • -
  • domEvent - the reference to the browser DOM event (null if the event was initiated by - calling a client-side method such as button.toggle())
  • -
-
-
-
-
- - The following example demonstrates how to use the - OnClientCheckedStateChanged property. - - <script language="javascript">
- function clientCheckedStateChanged(sender, eventArgs)
- {
- var toolBar = sender;
- var button = eventArgs.get_item();
-
- alert(String.format("You just changed the checked state of the '{0}' button in the '{1}' toolBar.", - button.get_text(), toolBar.get_id()));
-
- }
- </script>
-
- <telerik:RadToolBar id="RadToolBar1" runat="server" - OnClientCheckedStateChanged="clientCheckedStateChanged">
- <Items>
- <telerik:RadToolBarButton Text="Left" CheckOnClick="true" Group="Align" ></telerik:RadToolBarButton>
- <telerik:RadToolBarButton Text="Center" CheckOnClick="true" Group="Align" ></telerik:RadToolBarButton>
- <telerik:RadToolBarButton Text="Right" CheckOnClick="true" Group="Align" ></telerik:RadToolBarButton>
- <telerik:RadToolBarDropDown Text="Align">
- <Buttons>
- <telerik:RadToolBarButton Text="Left" CheckOnClick="true" Group="Align" ></telerik:RadToolBarButton>
- <telerik:RadToolBarButton Text="Center" CheckOnClick="true" Group="Align" ></telerik:RadToolBarButton>
- <telerik:RadToolBarButton Text="Right" CheckOnClick="true" Group="Align" ></telerik:RadToolBarButton>
- </Buttons>
- </telerik:RadToolBarDropDown>
- <telerik:RadToolBarSplitButton Text="Reset">
- <Buttons>
- <telerik:RadToolBarButton Text="Left" CheckOnClick="true" Group="Align" ></telerik:RadToolBarButton>
- <telerik:RadToolBarButton Text="Center" CheckOnClick="true" Group="Align" ></telerik:RadToolBarButton>
- <telerik:RadToolBarButton Text="Right" CheckOnClick="true" Group="Align" ></telerik:RadToolBarButton>
- </Buttons>
- </telerik:RadToolBarSplitButton>
- </Items>
- </telerik:RadToolBar>
-
-
-
- - Occurs when a toolbar item is created. - - The ItemCreated event is raised when an item in the RadToolBar - control is created, both during round-trips and at the time data is bound to the control. - The ItemCreated event is not raised for items which are defined inline in the page or user control. - The ItemCreated event is commonly used to initialize item properties. - - - The following example demonstrates how to use the ItemCreated event - to set the ToolTip property of each item. - - protected void RadToolBar1_ItemCreated(object sender, Telerik.Web.UI.RadToolBarEventArgs e) - { - e.Item.ToolTip = e.Item.Text; - } - - - Sub RadToolBar1_ItemCreated(ByVal sender As Object, ByVal e As Telerik.Web.UI.RadToolBarEventArgs) Handles RadToolBar1.ItemCreated - e.Item.ToolTip = e.Item.Text - End Sub - - - - - Occurs when a button is data bound. - - - The ButtonDataBound event is raised for each button upon - databinding. You can retrieve the button being bound using the event arguments. - The DataItem associated with the button can be retrieved using - the DataItem property. - - The ButtonDataBound event is often used in scenarios when you - want to perform additional mapping of fields from the DataItem to their respective - properties in the RadToolBarButton class. - - - The following example demonstrates how to map fields from the data item to - button properties using the ButtonDataBound - event. - - protected void RadToolBar1_ButtonDataBound(object sender, Telerik.Web.UI.RadToolBarButtonEventArgs e) - { - e.Button.ImageUrl = "~/ToolBarImages/tool" + (string)DataBinder.Eval(e.Button.DataItem, "Text") + ".gif"; - e.Button.NavigateUrl = (string)DataBinder.Eval(e.Button.DataItem, "URL"); - } - - - Sub RadToolBar1_ButtonDataBound(ByVal sender As Object, ByVal e As Telerik.Web.UI.RadToolBarButtonEventArgs) Handles RadToolBar1.ButtonDataBound - e.Button.ImageUrl = "~/ToolBarImages/tool" & CStr(DataBinder.Eval(e.Button.DataItem, "Text")) & ".gif" - e.Button.NavigateUrl = CStr(DataBinder.Eval(e.Button.DataItem, "URL")) - End Sub - - - - - - Occurs on the server when a button or in the RadToolBar - control is clicked. - - - The following example demonstrates how to use the ButtonClick event to - determine the clicked button. - - protected void RadToolBar1_ButtonClick(object sender, Telerik.Web.UI.RadToolBarButtonEventArgs e) - { - Label1.Text = "Clicked button is " + e.Item.Text; - } - - - Sub RadToolBar1_ButtonClick(ByVal sender As Object, ByVal e As Telerik.Web.UI.RadToolBarButtonEventArgs) Handles RadToolBar1.ButtonClick - Label1.Text = "Clicked button is " & e.Item.Text; - End Sub - - - - - - For internal use only. - - - - - - - For internal use only. - - - - - - - - - - - - - - - For internal use only. - - - - - - - For internal use only. - - - - - - - - - - - Defines the filtering properties for a single column of the AutoFilter range. - - - - - Defines a single condition in a custom AutoFilter function. - - - - - Defines an AND condition in a custom AutoFilter function. - - - - - Defines an OR condition in a custom AutoFilter function. - - - - - Defines an AutoFilter range on the current worksheet. - - - - - Max value 3 - - - - - This is required - - - - - This element cannot have inner elements. - Use Cells property - - - - - This element cannot have attributes - - - - Represents the effects that can be used in an animation. - - - - Represents a ContextMenuTargettarget, specified - by the id of a server control. - - - - - An abstract class representing a target - which RadContextMenu will be attached to. - - - - - Gets or sets the ID of the server control RadContextMenu - will attach to. - - - - - Specifies that the RadContextMenu will be displayed - when a right-click on the entire page occurs. - - - - - Represents a ContextMenuTargettarget, specified - by client-side element id. - - - - - Gets or sets the ID of the element RadContextMenu - will attach to on the client. - - - - - Represents a ContextMenuTargettarget, specified - by element tagName. - - - - - Gets or sets the TagName of the elements RadContextMenu - will search and attach to on the client. - - - - - Represents a collection of objects. - - - - - Initializes a new instance of the ContextMenuTargetCollection class. - - The owner of the collection. - - - - Appends the specified ContextMenuTarget object to the end of the current ContextMenuTargetCollection. - - - The ContextMenuTarget to append to the end of the current ContextMenuTargetCollection. - - - - - Determines whether the specified ContextMenuTarget object is in the current - ContextMenuTargetCollection. - - - The ContextMenuTarget object to find. - - - true if the current collection contains the specified ContextMenuTarget object; - otherwise, false. - - - - - Copies the contents of the current ContextMenuTargetCollection into the - specified array of ContextMenuTarget objects. - - The target array. - The index to start copying from. - - - Appends the specified array of ContextMenuTarget objects to the end of the - current ContextMenuTargetCollection. - - - The array of ContextMenuTarget o append to the end of the current - ContextMenuTargetCollection. - - - - - Determines the index of the specified ContextMenuTarget object in the collection. - - - The ContextMenuTarget to locate. - - - The zero-based index of tab within the current ContextMenuTargetCollection, - if found; otherwise, -1. - - - - - Inserts the specified ContextMenuTarget object in the current - ContextMenuTargetCollection at the specified index location. - - The zero-based index location at which to insert the ContextMenuTarget. - The ContextMenuTarget to insert. - - - - Removes the specified ContextMenuTarget object from the current - ContextMenuTargetCollection. - - - The ContextMenuTarget object to remove. - - - - - Removes the ContextMenuTarget object at the specified index - from the current ContextMenuTargetCollection. - - The zero-based index of the tab to remove. - - - - Gets the ContextMenuTarget object at the specified index in - the current ContextMenuTargetCollection. - - - The zero-based index of the ContextMenuTarget to retrieve. - - - The ContextMenuTarget at the specified index in the - current ContextMenuTargetCollection. - - - - - This enumeration controls the expand behaviour of the items. - - - - - The default behaviour - all items are loaded in the intial request and expand is performed on the client, without server interaction - - - - - The child items are loaded from the web service specified by the RadMenu.WebServicePath and RadMenu.WebServiceMethod properties. - - - - - - - - - - - - - Represents a collection of objects. - - - - - Gets the object at the specified index from the collection. - - - The at the specified index in the collection. - - - The zero-based index of the to retrieve. - - - - - Defines the relationship between a data item and the menu item it is binding to in a - control. - - - - - - - - - Specifies the exact value of the ClickedCssClass property of the - RadMenuItem that will be created during the data binding. - - - - - Specifies the field, containing the ClickedCssClass property - value of the RadMenuItem that will be created during - the data binding. - - - - - Specifies the exact value of the DisabledCssClass property of the - RadMenuItem that will be created during the data binding. - - - - - Specifies the field, containing the DisabledCssClass property - value of the RadMenuItem that will be created during - the data binding. - - - - - Specifies the exact value of the DisabledImageUrl property of the - RadMenuItem that will be created during the data binding. - - - - - Specifies the field, containing the DisabledImageUrl property - value of the RadMenuItem that will be created during - the data binding. - - - - - Specifies the exact value of the ExpandedImageUrl property of the - RadMenuItem that will be created during the data binding. - - - - - Specifies the field, containing the ExpandedImageUrl property - value of the RadMenuItem that will be created during - the data binding. - - - - - Specifies the exact value of the ExpandedCssClass property of the - RadMenuItem that will be created during the data binding. - - - - - Specifies the field, containing the ExpandedCssClass property - value of the RadMenuItem that will be created during - the data binding. - - - - - Specifies the exact value of the ExpandMode property of the - RadMenuItem that will be created during the data binding. - - - - - Specifies the field, containing the ExpandMode property - value of the RadMenuItem that will be created during - the data binding. - - - - - Specifies the exact value of the FocusedCssClass property of the - RadPanelItem that will be created during the data binding. - - - - - Specifies the field, containing the FocusedCssClass property - value of the RadMenuItem that will be created during - the data binding. - - - - - Specifies the exact value of the IsSeparator property of the - RadMenuItem that will be created during the data binding. - - - - - Specifies the field, containing the IsSeparator property - value of the RadMenuItem that will be created during - the data binding. - - - - - For internal use only. - - - - - - - Data class used for transferring menu items from and to web services. - - - For information about the role of each property see the - RadMenuItem class. - - - - - See RadMenuItem.ExpandMode. - - - - - See RadMenuItem.NavigateUrl. - - - - - See RadMenuItem.PostBack. - - - - - See RadMenuItem.Target. - - - - - See RadMenuItem.IsSeparator. - - - - - See RadMenuItem.CssClass. - - - - - See RadMenuItem.DisabledCssClass. - - - - - See RadMenuItem.ExpandedCssClass. - - - - - See RadMenuItem.FocusedCssClass. - - - - - See RadMenuItem.ClickedCssClass. - - - - - See RadMenuItem.ImageUrl. - - - - - See RadMenuItem.HoveredImageUrl. - - - - - See RadMenuItem.ClickedImageUrl. - - - - - See RadMenuItem.DisabledImageUrl. - - - - - See RadMenuItem.ExpandedImageUrl. - - - - - Represents the different ways RadPanelbar behaves when an item is - expanded. - - - - More than one item can be expanded at a time. - - - - Only one item can be expanded at a time. Expanding another item collapses the - previously expanded one. - - - - - Only one item can be expanded at a time. The expanded area occupies the entire height of the RadPanelbar. - - - - The position of the image within a panel item. - - - The image is rendered leftmost. - - - The image is rendered rightmost. - - - - Initializes a new instance of the - RadMenuEventArgs class. - - - A RadMenuItem which represents an item in the - RadMenu control. - - - - - Gets the referenced RadMenuItem in the - RadMenu control when the event is raised. - - - The referenced item in the RadMenu control when - the event is raised. - - - Use this property to programmatically access the item referenced in the - RadMenu when the event is raised. - - - - - For internal use only. - - - - - - A navigation control used for building collapsible side-menu systems and Outlook-type panels. - - - The RadPanelBar control is used to display a list of items in a Web Forms - page and is often used control for building collapsible side-menu - interfaces. The RadPanelBar control supports the following features: - - - Databinding that allows the control to be populated from various - datasources - Programmatic access to the RadPanelBar object model - which allows to dynamic creation of panelbars, populate items, set - properties. - Customizable appearance through built-in or user-defined skins. - -

Items

- - The RadPanelBar control is made up of tree of items represented - by RadPanelItem objects. Items at the first level (level 0) are - called root items. A items that has a parent item is called a child item. All root - items are stored in the Items collection. Child items are - stored in a parent item's Items collection. - - - Each item has a Text and a Value property. - The value of the Text property is displayed in the RadPanelBar control, - while the Value property is used to store any additional data about the item, - such as data passed to the postback event associated with the item. When clicked, a item can - navigate to another Web page indicated by the NavigateUrl property. - -
-
- - - Defines properties that menu item containers (RadTreeView, - RadPanelItem) should implement - - - - Gets the parent IMenuItemContainer. - - - Gets the collection of child items. - - A RadPanelItemCollection that represents the child - items. - - - Use this property to retrieve the child items. You can also use it to - programmatically add or remove items. - - - - - Initializes a new instance of the RadPanelBar class. - - - Use this constructor to create and initialize a new instance of the RadPanelBar - control. - - - The following example demonstrates how to programmatically create a RadPanelBar - control. - - void Page_Load(object sender, EventArgs e) - { - RadPanelBar RadPanelBar1 = new RadPanelBar(); - RadPanelBar1.ID = "RadPanelBar1"; - - if (!Page.IsPostBack) - { - //RadPanelBar persist its item in ViewState (if EnableViewState is true). - //Hence items should be created only on initial load. - - PadPanelItem sportItem= new PadPanelItem("Sport"); - RadPanelBar1.Items.Add(sportItem); - - PadPanelItem newsItem = new PadPanelItem("News"); - RadPanelBar1.Items.Add(newsItem); - } - - PlaceHolder1.Controls.Add(newsItem); - } - - - Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Load - Dim RadPanelBar1 As RadPanelBar = New RadPanelBar() - RadPanelBar1.ID = "RadPanelBar1" - - If Not Page.IsPostBack Then - 'RadPanelBar persist its item in ViewState (if EnableViewState is true). - 'Hence items should be created only on initial load. - - Dim sportItem As PadPanelItem = New PadPanelItem("Sport") - RadPanelBar1.Items.Add(sportItem) - - Dim newsItem As PadPanelItem = New PadPanelItem("News") - RadPanelBar1.Items.Add(newsItem) - End If - - PlaceHolder1.Controls.Add(newsItem) - End Sub - - - - - - Populates the RadPanelBar control from external XML file. - - - The newly added items will be appended after any existing ones. - - - The following example demonstrates how to populate RadPanelBar control - from XML file. - - private void Page_Load(object sender, EventArgs e) - { - if (!Page.IsPostBack) - { - RadPanelBar1.LoadContentFile("~/RadPanelBar/Examples/panelbar.xml"); - } - } - - - Private Sub Page_Load(sender As Object, e As EventArgs) Handles MyBase.Load - If Not Page.IsPostBack Then - RadPanelBar1.LoadContentFile("~/RadPanelBar/Examples/panelbar.xml") - End If - End Sub - - - The name of the XML file. - - - - Searches the RadPanelbar control for the first - RadPanelItem with a Text property equal to - the specified value. - - - A RadPanelItem whose Text property is equal - to the specified value. - - - The method returns the first item matching the search criteria. If no item is - matching then null (Nothing in VB.NET) is - returned. - - The value to search for. - - - - Searches the RadPanelbar control for the first - RadPanelItem with a Text property equal to - the specified value. - - - A RadPanelItem whose Text property is equal - to the specified value. - - - The method returns the first item matching the search criteria. If no item is - matching then null (Nothing in VB.NET) is - returned. - - The value to search for. - A Boolean indicating a case-sensitive or insensitive comparison (true indicates a case-insensitive comparison). - - - - Searches the RadPanelbar control for the first - RadPanelItem with a Value property equal - to the specified value. - - - A RadPanelItem whose Value property is - equal to the specified value. - - - The method returns the first item matching the search criteria. If no item is - matching then null (Nothing in VB.NET) is - returned. - - The value to search for. - - - - Searches the RadPanelbar control for the first - RadPanelItem with a Value property equal - to the specified value. - - - A RadPanelItem whose Value property is - equal to the specified value. - - - The method returns the first item matching the search criteria. If no item is - matching then null (Nothing in VB.NET) is - returned. - - The value to search for. - A Boolean indicating a case-sensitive or insensitive comparison (true indicates a case-insensitive comparison). - - - - Searches the RadPanelbar control for the first - Item with a NavigateUrl - property equal to the specified value. - - - A RadPanelItem whose NavigateUrl - property is equal to the specified value. - - - The method returns the first Item matching the search criteria. If no Item is - matching then null (Nothing in VB.NET) is - returned. - - The value to search for. - - - - Returns the first RadPanelItem - that matches the conditions defined by the specified predicate. - The predicate should returns a boolean value. - - - The following example demonstrates how to use the FindItem method. - - void Page_Load(object sender, EventArgs e) - { - RadPanel1.FindItem(ItemWithEqualsTextAndValue); - } - private static bool ItemWithEqualsTextAndValue(RadPanelItem item) - { - if (item.Text == item.Value) - { - return true; - } - else - { - return false; - } - } - - - Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs) - RadPanel1.FindItem(ItemWithEqualsTextAndValue) - End Sub - Private Shared Function ItemWithEqualsTextAndValue(ByVal item As RadPanelItem) As Boolean - If item.Text = item.Value Then - Return True - Else - Return False - End If - End Function - - - The Predicate <> that defines the conditions of the element to search for. - - - - Gets a linear list of all items in the RadPanelBar - control. - - - An IList<RadPanelBarItem> containing all items (from all hierarchy - levels). - - - Use the GetAllItems method to obtain a linear collection of all - items regardless their place in the hierarchy. - - - The following example demonstrates how to disable all items within a - RadPanelBar control. - - void Page_Load(object sender, EventArgs e) - { - foreach (RadPanelBarItem item in RadPanelBar1.GetAllItems()) - { - item.Enabled = false; - } - } - - - Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Load - For Each childItem As RadPanelBarItem In RadPanelBar1.GetAllItems - childItem.Enabled = False - Next - End Sub - - - - - - This methods clears the selected items of the current RadPanelBar instance. Useful when you need to clear item selection after postback. - - - - - This methods collapses all expanded panel items - - - - - Raises the ItemClick event. - - - - - - Raises the ItemDataBound event. - - - - - - Raises the ItematCreated event. - - - - - - Gets a list of all client-side changes (adding an item, removing an item, changing an item's property) which have occurred. - - - A list of objects which represent all client-side changes the user has performed. - By default the ClientChanges property returns empty list. Client-changes are recorded if and only if the client-side - methods trackChanges()/commitChanges() have been invoked. - - - You can use the ClientChanges property to respond to client-side modifications such as - - adding a new item - removing existing item - clearing the children of an item or the control itself - changing a property of the item - - The ClientChanges property is available in the first postback (ajax) request after the client-side modifications - have taken place. After this moment the property will return empty list. - - - The following example demonstrates how to use the ClientChanges property - - foreach (ClientOperation<RadPanelItem> operation in RadToolBar1.ClientChanges) - { - RadPanelItem item = operation.Item; - - switch (operation.Type) - { - case ClientOperationType.Insert: - //An item has been inserted - operation.Item contains the inserted item - break; - case ClientOperationType.Remove: - //An item has been inserted - operation.Item contains the removed item. - //Keep in mind the item has been removed from the panelbar. - break; - case ClientOperationType.Update: - UpdateClientOperation<RadPanelItem> update = operation as UpdateClientOperation<RadPanelItem> - //The "UpdateOperation" provides an additional property "PropertyName". This is the property whose value was changed from the client side. - break; - case ClientOperationType.Clear: - //All children of have been removed - operation.Item contains the parent item whose children have been removed. If operation.Item is null then the root items have been removed. - break; - } - } - - - For Each operation As ClientOperation(Of RadPanelItem) In RadToolBar1.ClientChanges - Dim item As RadPanelItem = operation.Item - Select Case operation.Type - Case ClientOperationType.Insert - 'An item has been inserted - operation.Item contains the inserted item - Exit Select - Case ClientOperationType.Remove - 'An item has been inserted - operation.Item contains the removed item. - 'Keep in mind the item has been removed from the panelbar. - Exit Select - Case ClientOperationType.Update - Dim update As UpdateClientOperation(Of RadPanelItem) = TryCast(operation, UpdateClientOperation(Of RadPanelItem)) - 'The "UpdateOperation" provides an additional property "PropertyName". This is the property whose value was changed from the client side. - Exit Select - Case ClientOperationType.Clear - 'All children of have been removed - operation.Item contains the parent item whose children have been removed. If operation.Item is Nothing then the root items have been removed. - Exist Select - End Select - Next - - - - - - Gets a RadPanelItemCollection object that contains the root items of the current RadPanelBar control. - - - A RadPanelItemCollection that contains the root items of the current RadPanelBar control. By default - the collection is empty (RadPanelBar has no children). - - - Use the Items property to access the child items of RadPanelBar. You can also use the Items property to - manage the root items. You can add, remove or modify items from the Items collection. - - - The following example demonstrates how to programmatically modify the properties of root items. - - RadPanelBar1.Items[0].Text = "Example"; - RadPanelBar1.Items[0].NavigateUrl = "http://www.example.com"; - - - RadPanelBar1.Items(0).Text = "Example" - RadPanelBar1.Items(0).NavigateUrl = "http://www.example.com" - - - - - Gets the selected panel item. - - Returns the panel item which is currently selected. If no item is selected - the SelectedItem property will - return null (Nothing in VB.NET). - - - - - Gets or sets the template for displaying the items in - RadPanelBar. - - - A ITemplate implemented object that contains the template - for displaying panel items. The default value is a null reference (Nothing in - Visual Basic), which indicates that this property is not set. - The ItemTemplate property sets a template that will be used - for all panel items. - - To specify unique display for individual items use the - ItemTemplate property of the - RadPanelItem class. - - - - The following example demonstrates how to use the - ItemTemplate property to add a CheckBox for each item. - ASPX: - <telerik:RadPanelBar runat="server" ID="RadPanelBar1"> -
- <ItemTemplate> -
- <asp:CheckBox runat="server" - ID="CheckBox"></asp:CheckBox>
- <asp:Label runat="server" ID="Label1"
-
- Text='<%# DataBinder.Eval(Container, "Text") %>' - ></asp:Label> -
-
- </ItemTemplate> - <Items> -
- <telerik:RadPanelItem Text="News" /> - <telerik:RadPanelItem Text="Sports" /> - <telerik:RadPanelItem Text="Games" /> -
- </Items> -
- </telerik:RadPanelBar> -
-
- - - Gets of sets a value indicating the behavior of RadPanelbar when an item is - expanded. - - - One of the PanelBarExpandMode Enumeration - values. The default value is MultipleExpandedItems. - - - Use the ExpandMode property to specify the way RadPanelbar - should behave after an item is expanded. The available options are: - - MultipleExpandedItems (default) - More than one item can - be expanded at a time. - SingleExpandedItem - Only one item can be expanded at a - time. Expanding another item collapses the previously expanded one. - FullExpandedItem - Only one item can be expanded at a - time. The expanded area occupies the entire height of the RadPanelbar. The - Height property should be set in order - RadPanelbar to operate correctly in this mode. - - - - - - Gets or sets a value indicating whether all items can be collapsed. - This allows all the items to be collapsed even if the panelbar's ExpandMode is set to SingleExpandedItem or FullExpandedItem mode. - - - - - Gets or sets the URL of the page to post to from the current page when an item - from the panel is clicked. - - - The URL of the Web page to post to from the current page when an item from the - panel control is clicked. The default value is an empty string (""), which causes - the page to post back to itself. - - - - - Gets or sets the maximum number of levels to bind to the RadPanelBar control. - - - The maximum number of levels to bind to the RadPanelBar control. The default is -1, which binds all the levels in the data source to the control. - - - When binding the RadPanelBar control to a data source, use the MaxDataBindDepth - property to limit the number of levels to bind to the control. For example, setting this property to 2 binds only - the root panel items and their immediate children. All remaining records in the data source are ignored. - - - - - Gets or sets a value indicating whether the control would persists its state - between pages (expanded and selected items). - - - true if the control would persist its state; - false otherwise. The default value is false. - - - Use the PersistStateInCookie property to make - RadPanelbar persist its state between pages. This feature requires - browser cookies to be enabled. Also the ClientID and - ID properties of the RadPanelbar control must be - the same in all pages accessible via the control (and containing it). - Page1.aspx: - <radP:RadPanelbar ID="RadPanelbar1" > ... - </radP:RadPanelbar> - Page2.aspx - <radP:RadPanelbar ID="RadPanelbar1" > ... - </radP:RadPanelbar> - - - - - Specifies the name of the cookie which should be used when PersistStateInCookie is set to true. - - - If this property is not set the ClientID property will be used as the name of the cookie. - - - - Gets the settings for the animation played when an item opens. - - An AnnimationSettings that represents the - expand animation. - - - - Use the ExpandAnimation property to customize the expand - animation of RadPanelBar. You can specify the - Type, - Duration and the - To disable expand animation effects you should set the - Type to - AnimationType.None.
- To customize the collapse animation you can use the - CollapseAnimation property. -
-
- - The following example demonstrates how to set the ExpandAnimation - of RadPanelBar. - - ASPX: - - - <telerik:RadPanelBar ID="RadPanelBar1" runat="server"> - <ExpandAnimation Type="OutQuint" Duration="300" - /> - <Items> - <telerik:RadPanelBarItem Text="News" > - <Items> - <telerik:RadPanelBarItem Text="CNN" NavigateUrl="http://www.cnn.com" - /> - <telerik:RadPanelBarItem Text="Google News" NavigateUrl="http://news.google.com" - /> - </Items> - </telerik:RadPanelBarItem> - <telerik:RadPanelBarItem Text="Sport" > - <Items> - <telerik:RadPanelBarItem Text="ESPN" NavigateUrl="http://www.espn.com" - /> - <telerik:RadPanelBarItem Text="Eurosport" NavigateUrl="http://www.eurosport.com" - /> - </Items> - </telerik:RadPanelBarItem> - </Items> - - - </telerik:RadPanelBar> - - - void Page_Load(object sender, EventArgs e) - { - RadPanelBar1.ExpandAnimation.Type = AnimationType.Linear; - RadPanelBar1.ExpandAnimation.Duration = 300; - } - - - Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Load - RadPanelBar1.ExpandAnimation.Type = AnimationType.Linear - RadPanelBar1.ExpandAnimation.Duration = 300 - End Sub - - -
- - - Gets or sets a value indicating the timeout after which a panel item starts to - open. - - - An integer specifying the timeout measured in milliseconds. The default value is - 100 milliseconds. - - - Use the ExpandDelay property to delay item opening. - - To customize the timeout prior to item closing use the - CollapseDelay property. - - - - The following example demonstrates how to specify a half second (500 - milliseconds) timeout prior to item opening: - ASPX: - <telerik:RadPanelBar ID="RadPanelBar1" runat="server" - ExpandDelay="500" /> - - - - Gets the settings for the animation played when an item closes. - - An AnnimationSettings that represents the - collapse animation. - - - - Use the CollapseAnimation property to customize the expand - animation of RadPanelBar. You can specify the - Type, - Duration and the - items are collapsed.
- To disable expand animation effects you should set the - Type to - AnimationType.None. To customize the expand animation you can - use the ExpandAnimation property. -
-
- - The following example demonstrates how to set the - CollapseAnimation of RadPanelBar. - - ASPX: - - - <telerik:RadPanelBar ID="RadPanelBar1" runat="server"> - <CollapseAnimation Type="OutQuint" Duration="300" - /> - <Items> - <telerik:RadPanelBarItem Text="News" > - <Items> - <telerik:RadPanelBarItem Text="CNN" NavigateUrl="http://www.cnn.com" - /> - <telerik:RadPanelBarItem Text="Google News" NavigateUrl="http://news.google.com" - /> - </Items> - </telerik:RadPanelBarItem> - <telerik:RadPanelBarItem Text="Sport" > - <Items> - <telerik:RadPanelBarItem Text="ESPN" NavigateUrl="http://www.espn.com" - /> - <telerik:RadPanelBarItem Text="Eurosport" NavigateUrl="http://www.eurosport.com" - /> - </Items> - </telerik:RadPanelBarItem> - </Items> - - - </telerik:RadPanelBar> - - - - - - - void Page_Load(object sender, EventArgs e) - { - RadPanelBar1.CollapseAnimation.Type = AnimationType.Linear; - RadPanelBar1.CollapseAnimation.Duration = 300; - } - - - Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Load - RadPanelBar1.CollapseAnimation.Type = AnimationType.Linear - RadPanelBar1.CollapseAnimation.Duration = 300 - End Sub - - -
- - - Gets or sets a value indicating the timeout after which a panel item starts to - close. - - - An integer specifying the timeout measured in milliseconds. The default value is - 500 (half a second). - - - Use the CollapseDelay property to delay item closing. To - cause immediate item closing set this property to 0 (zero). - - To customize the timeout prior to item closing use the - ExpandDelay property. - - - - The following example demonstrates how to specify one second (1000 - milliseconds) timeout prior to item closing: - ASPX: - <telerik:RadPanelBar ID="RadPanelBar1" runat="server" - ClosingDelay="1000" /> - - - - - Occurs on the server when an item in the RadPanelBar control is - created. - - - The ItemCreated event is raised every time a new item is - added. - The ItemCreated event is not related to data binding and you - cannot retrieve the DataItem of the item in the event - handler. - The ItemCreated event is often useful in scenarios where you want - to initialize all items - for example setting the ToolTip of each - RadPanelBarItem to be equal to the Text property. - - - The following example demonstrates how to use the ItemCreated - event to set the ToolTip property of each item. - - private void RadPanelBar1_ItemCreated(object sender, Telerik.WebControls.RadPanelBarItemEventArgs e) - { - e.Item.ToolTip = e.Item.Text; - } - - - Sub RadPanelBar1_ItemCreated(ByVal sender As Object, ByVal e As Telerik.WebControls.RadPanelBarItemEventArgs) Handles RadPanelBar1.ItemCreated - e.Item.ToolTip = e.Item.Text - End Sub - - - - - - Occurs on the server when a panel item in the RadPanelBar - control is clicked. - - - - The panel will also postback if you navigate to a panel item - using the [panel item] key and then press [enter] on the panel item that is focused. The - instance of the clicked panel item is passed to the ItemClick event - handler - you can obtain a reference to it using the eventArgs.RadPanelBarItem property. - - - - - Occurs after a panel item is data bound. - - - The ItemDataBound event is raised for each panel item upon - databinding. You can retrieve the item being bound using the event arguments. - The DataItem associated with the item can be retrieved using - the DataItem property. - - The ItemDataBound event is often used in scenarios when - you want to perform additional mapping of fields from the DataItem - to their respective properties in the RadPanelBarItem class. - - - The following example demonstrates how to map fields from the data item to - RadPanelItem properties using the ItemDataBound - event. - - private void RadPanelBar1_ItemDataBound(object sender, Telerik.WebControls.RadPanelBarEventArgs e) - { - RadPanelBarItem item = e.RadPanelBarItem; - DataRowView dataRow = (DataRowView) e.Item.DataItem; - - item.ImageUrl = "image" + dataRow["ID"].ToString() + ".gif"; - item.NavigateUrl = dataRow["URL"].ToString(); - } - - - Sub RadPanelBar1_ItemDataBound(ByVal sender As Object, ByVal e As RadPanelBarEventArgs) Handles RadPanelBar1.ItemDataBound - Dim item As RadPanelBarItem = e.RadPanelBarItem - Dim dataRow As DataRowView = CType(e.Item.DataItem, DataRowView) - - item.ImageUrl = "image" + dataRow("ID").ToString() + ".gif" - item.NavigateUrl = dataRow("URL").ToString() - End Sub - - - - - - Gets or sets a value indicating the client-side event handler that is called - before the browser context panel shows (after right-clicking an item). - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - Use the OnClientContextMenu property to specify a JavaScript - function that will be executed before the context menu shows after right clicking an - item. - Two parameters are passed to the handler - - sender (the client-side RadPanelbar object) - - eventArgs with two properties -
    -
  • Item - the instance of the selected item
  • -
  • EventObject - the browser DOM event
  • -
-
-
-
- - The following example demonstrates how to use the - OnClientContextpanel property. - - <script language="javascript">
- function OnContextpanelHandler(sender, eventArgs)
- {
- var panelbar = sender;
- var item = eventArgs.Item;
-
- alert("You have right-clicked the " + item.Text + " item in the " + panelbar.ID + - "panelbar.");
- }
- </script>
- <radP:RadPanelbar id="RadPanelbar1" runat="server" - OnClientContextpanel="OnContextpanelHandler">
- <Items>
- <radP:RadPanelItem Text="Personal Details"></radP:RadPanelItem>
- <radP:RadPanelItem Text="Education"></radP:RadPanelItem>
- <radP:RadPanelItem Text="Computing Skills"></radP:RadPanelItem>
- </Items>
- </radP:RadPanelbar>
-
-
-
- - - This event is similar to OnClientItemFocus but fires only on - mouse click. - If specified, the OnClientItemClicking client-side event - handler is called before a panel item is clicked upon. Two parameters are passed to - the handler: - - sender, the panelbar client object; - eventArgs with one property, Item (the - instance of the panel item). - - The OnClientItemClicking event can be cancelled. To do so, - return False from the event handler. -
-
-
-
- - Gets or sets a value indicating the client-side event handler that is called when - a panel item is clicked. - - - <script type="text/javascript">
- function OnClientItemClickingHandler(sender, eventArgs)
- {
- if (eventArgs.Item.Text == "News")
- {
- return false; - }
- }
- </script>
- <radP:RadPanelbar ID="RadPanelbar1"
- runat="server"
- OnClientItemClicking="OnClientItemClickingHandler">
- ....
- </radP:RadPanelbar>
-
- - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - -
- - - Gets or sets a value indicating the client-side event handler that is called - after a panel item is clicked. - - - This event is similar to OnClientItemFocus but fires only on - mouse click. - If specified, the OnClientItemClicked client-side event - handler is called after a panel item is clicked upon. Two parameters are passed to - the handler: - - sender, the panelbar client object; - eventArgs with one property, Item (the - instance of the panel item). - - This event cannot be cancelled. - - - <script type="text/javascript">
- function OnClientItemClickedHandler(sender, eventArgs)
- {
- alert(eventArgs.Item.Text);
- }
- </script>
- <radP:RadPanelbar ID="RadPanelbar1"
- runat="server"
- OnClientItemClicked="OnClientItemClickedHandler">
- ....
- </radP:RadPanelbar> -
- - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - -
- - - Gets or sets a value indicating the client-side event handler that is called when - a panel item gets focus. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - <script type="text/javascript">
- function OnClientItemFocusHandler(sender, eventArgs)
- {
- alert(eventArgs.Item.Text);
- }
- </script>
- <radP:RadPanelbar ID="RadPanelbar1"
- runat="server"
- OnClientItemFocus="OnClientItemFocusHandler">
- ....
- </radP:RadPanelbar>
-
- - If specified, the OnClientItemFocus client-side event - handler is called when a panel item is selected using either the keyboard (the - [TAB] or arrow keys) or by clicking it. Two parameters are passed to the - handler: - - sender, the panelbar client object; - eventArgs with one property, Item (the - instance of the panel item). - - This event cannot be cancelled. - -
- - - Gets or sets a value indicating the client-side event handler that is called - after an item loses focus. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - If specified, the OnClientItemBlur client-side event handler - is called when a panel item loses focus as a result of the user pressing a key or - clicking elsewhere on the page. Two parameters are passed to the handler: - - sender, the panelbar client object; - eventArgs with one property, Item (the - instance of the panel item). - - This event cannot be cancelled. - - - <script type="text/javascript">
- function OnClientItemBlurHandler(sender, eventArgs)
- {
- alert(eventArgs.Item.Text);
- }
- </script>
- <radP:RadPanelbar ID="RadPanelbar1"
- runat="server"
- OnClientItemBlur="OnClientItemBlurHandler">
- ....
- </radP:RadPanelbar>
-
-
- - - Gets or sets a value indicating the client-side event handler that is called when - a group of child items expands. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - If specified, the OnClientItemOpen client-side event handler - is called when a group of child items opens. Two parameters are passed to the - handler: - - sender, the panelbar client object; - eventArgs with one property, Item (the - instance of the panel item). - - This event cannot be cancelled. - - - <script type="text/javascript">
- function OnClientItemExpandHandler(sender, eventArgs)
- {
- alert(eventArgs.Item.Text);
- }
- </script>
- <radP:RadPanelbar ID="RadPanelbar1"
- runat="server"
- OnClientItemExpand="OnClientItemExpandHandler">
- ....
- </radP:RadPanelbar>
-
-
- - - Gets or sets a value indicating the client-side event handler that is called when - a group of child items collapses. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - <script type="text/javascript">
- function OnClientItemCollapseHandler(sender, eventArgs)
- {
- alert(eventArgs.Item.Text);
- }
- </script>
- <radP:RadPanelbar ID="RadPanelbar1"
- runat="server"
- OnClientItemCollapse="OnClientItemCollapseHandler">
- ....
- </radP:RadPanelbar>
-
- - If specified, the OnClientItemClose client-side event - handler is called when a group of child items closes. Two parameters are passed to - the handler: - - sender, the panelbar client object; - eventArgs with one property, Item (the - instance of the panel item). - - This event cannot be cancelled. - -
- - - If specified, the OnClienLoad client-side event handler is - called after the panelbar is fully initialized on the client. - A single parameter - the panelbar client object - is passed to the - handler. - This event cannot be cancelled. - - - <script type="text/javascript">
- function OnClientLoadHandler(sender)
- {
- alert(sender.ID);
- }
- </script>
- <radP:RadPanelbar ID="RadPanelbar1"
- runat= "server"
- OnClientLoad= "OnClientLoadHandler">
- ....
- </radP:RadPanelbar>
-
- - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - Gets or sets a value indicating the client-side event handler that is called - after the RadPanelbar client-side object is initialized. - -
- - - Gets or sets a value indicating the client-side event handler that is called when - the mouse moves over a panel item in the RadPanelbar control. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - If specified, the - OnClientMouseOverclient-side event handler is - called when the mouse moves over a panel item. Two parameters are passed to - the handler: - - sender, the panelbar client object; - eventArgs with one property, Item (the - instance of the panel item). - - This event cannot be cancelled. - - - The following example demonstrates how to use the - OnClientMouseOver property. - -
- <script type="text/javascript">
- function OnClientMouseOverHandler(sender, eventArgs)
- {
- alert(eventArgs.Item.Text);
- }
- </script> -
-
- <radP:RadPanelbar ID="RadPanelbar1"
- runat= "server"
- OnClientMouseOver= "OnClientMouseOverHandler">
- ....
- </radP:RadPanelbar> -
-
-
-
- - - If specified, the OnClientMouseOut client-side event handler - is called when the mouse moves out of a panel item. Two parameters are passed to - the handler: - - sender, the panelbar client object; - eventArgs with one property, Item (the - instance of the panel item). - - This event cannot be cancelled. - - - Gets or sets a value indicating the client-side event handler that is called when - the mouse moves out of a panel item in the RadPanelbar control. - - - A string specifying the name of the JavaScript function that will handle the - event. The default value is empty string. - - - <script type="text/javascript">
- function OnClientMouseOutHandler(sender, eventArgs)
- {
- alert(eventArgs.Item.Text);
- }
- </script>
- <radP:RadPanelbar ID="RadPanelbar1"
- runat= "server"
- OnClientMouseOut= "OnClientMouseOutHandler">
- ....
- </radP:RadPanelbar>
-
-
- - Represents a item in the RadPanelBar control. - - - The RadPanelBar control is made up of items. Items which are immediate children - of the panelbar are root items. Items which are children of root items are child items. - - - A item usually stores data in two properties, the Text property and - the Value property. The value of the Text property is displayed - in the RadPanelBar control, and the Value property is used to store additional data. - - To create panel items, use one of the following methods: - - - Use declarative syntax to define items inline in your page or user control. - - - Use one of the constructors to dynamically create new instances of the - RadPanelItem class. These items can then be added to the - Items collection of another item or panelbar. - - - Data bind the RadPanelBar control to a data source. - - - - When the user clicks a panel item, the RadPanelBar control can navigate - to a linked Web page, post back to the server or select that item. If the - NavigateUrl property of a item is set, the - RadPanelBar control navigates to the linked page. By default, a linked page - is displayed in the same window or frame. To display the linked content in a different - window or frame, use the Target property. - - - - - Initializes a new instance of the RadPanelItem class. - - Use this constructor to create and initialize a new instance of the - RadPanelItem class using default values. - - - The following example demonstrates how to add items to - RadPanelBar controls. - - RadPanelItem item = new RadPanelItem(); - item.Text = "News"; - item.NavigateUrl = "~/News.aspx"; - - RadPanelbar1.Items.Add(item); - - - Dim item As New RadPanelItem() - item.Text = "News" - item.NavigateUrl = "~/News.aspx" - - RadPanelbar1.Items.Add(item) - - - - - - Initializes a new instance of the RadPanelItem class with the - specified text data. - - - - Use this constructor to create and initialize a new instance of the - RadPanelItem class using the specified text. - - - - The following example demonstrates how to add items to - RadPanelBar controls. - - RadPanelItem item = new RadPanelItem("News"); - - RadPanelbar1.Items.Add(item); - - - Dim item As New RadPanelItem("News") - - RadPanelbar1.Items.Add(item) - - - - The text of the item. The Text property is set to the value - of this parameter. - - - - - Expands all parent items so the item is visible. - - - - - Initializes a new instance of the RadPanelItem class with the - specified text and URL to navigate to. - - - - Use this constructor to create and initialize a new instance of the - RadPanelItem class using the specified text and URL. - - - - This example demonstrates how to add items to RadPanelBar - controls. - - RadPanelItem item = new RadPanelItem("News", "~/News.aspx"); - - RadPanelbar1.Items.Add(item); - - - Dim item As New RadPanelItem("News", "~/News.aspx") - - RadPanelbar1.Items.Add(item) - - - - The text of the item. The Text property is set to the value - of this parameter. - - - The url which the item will navigate to. The - NavigateUrl property is set to the value of this - parameter. - - - - Gets or sets a value indicating the position of the image within the item. - - One of the RadPanelItemImagePosition - Enumeration values. The default value is Left. - - - - Gets the RadPanelBar instance which contains the item. - - Use this property to obtain an instance to the - RadPanelBar object containing the item. - - - - - Gets the IRadPanelItemContainer instance which contains the current item. - - - The object which contains the item. It might be an instance of the - RadPanelBar class or the RadPanelItem - class depending on the hierarchy level. - - - The value is of the IRadPanelItemContainer type which is - implemented by the RadPanelBar class and the - RadPanelItem class. Use the Owner property when - recursively traversing items in the RadPanelBar control. - - - - - Sets or gets whether the item is separator. It also represents a logical state of - the item. Might be used in some applications for keyboard navigation to omit processing - items that are marked as separators. - - - - Gets or sets a value indicating whether the panel item is expanded. - - true if the panel item is expanded; otherwise, - false. The default is false. - - - - - Manages the item level of a particular Item instance. This property allows easy - implementation/separation of the panel items in levels. - - - - Gets or sets the height of the child item group. - - A Unit that represents the height of the child item group. The - default value is Empty. - - - If the total child group height exceeds the value specified with the - ChildGroupHeight property scrolling will be applied. - - - - - Gets or sets the Cascading Style Sheet (CSS) class applied to the element enclosing the child items. - - - The default value is empry string. - - - - - Gets or sets the Cascading Style Sheet (CSS) class applied when the panel item is - disabled. - - - The CSS class applied when the panel item is disabled. The default value is - "disabled". - - - By default the visual appearance of disabled panel items is defined in the skin CSS - file. You can use the DisabledCssClass property to specify unique - appearance for the panel item when it is disabled. - - - - - Gets or sets a value indicating whether clicking on the item will - postback. - - - True if the panel item should postback; otherwise - false. By default all the items will postback provided the user - has subscribed to the ItemClick event. - - - If you subscribe to the ItemClick all panel - items will postback. To turn off that behavior you should set the - PostBack property to false. - - - - - Gets or sets a value indicating whether clicking on the item will - collapse it. - - - False if the panel item should collapse; otherwise - True. - - - - Gets or sets a value indicating whether the item is selected. - - true if the item is selected; otherwise, false. The default is - false. - - - true if the item is selected; otherwise false. - The default value is false. - - - Use the Selected property to determine whether the item is currently selected. - - - - Gets or sets the text caption for the panel item. - The text of the item. The default value is empty string. - - This example demonstrates how to set the text of the item using the - Text property. - - <radP:RadPanelbar ID="RadPanelbar1" - runat="server">
- <Items>
- <radP:RadPanelItem Text="News" />
- <radP:RadPanelItem Text="News" />
- </Items>
- </radP:RadPanelbar>
-
-
- - Use the Text property to specify the text to display for the - item. - -
- - Gets or sets the URL to link to when the item is clicked. - - The URL to link to when the item is clicked. The default value is empty - string. - - - The following example demonstrates how to use the NavigateUrl - property - - <telerik:RadPanelBar id="RadPanelBar1" - runat="server">
- <Items>
- <telerik:RadPanelItem Text="News" NavigateUrl="~/News.aspx" - />
- <telerik:RadPanelItem Text="External URL" - NavigateUrl="http://www.example.com" />
- </Items>
- </telerik:RadPanelBar>
-
-
- - Use the NavigateUrl property to specify the URL to link to when - the item is clicked. Use "~" (tilde) in front of an URL within the same ASP.NET - application. When specifying external URL do not forget the protocol (e.g. - "http://"). - -
- - - Gets or sets the target window or frame to display the Web page content linked to - when the panel item is clicked. - - - The target window or frame to load the Web page linked to when the Item is - selected. Values must begin with a letter in the range of a through z (case - insensitive), except for the following special values, which begin with an - underscore: - - - - _blank - Renders the content in a new window without - frames. - - - _parent - Renders the content in the immediate frameset - parent. - - - _self - Renders the content in the frame with focus. - - - _top - Renders the content in the full window without - frames. - - - The default value is empty string. - - - - Use the Target property to specify the frame or window that displays the - Web page linked to when the panel item is clicked. The Web page is specified by - setting the NavigateUrl property. - - If this property is not set, the Web page specified by the - NavigateUrl property is loaded in the current window. - - - The following example demonstrates how to use the Target - property - ASPX: - <telerik:RadPanelBar runat="server" ID="RadPanelBar1"> - <Items> - <telerik:RadPanelItem Target="_blank" - NavigateUrl="http://www.google.com" /> - </Items> - </telerik:RadPanelBar> - - - - Gets or sets the value associated with the panel item. - The value associated with the item. The default value is empty string. - - Use the Value property to specify or determine the value associated - with the item. - - - - Gets or sets the data item represented by the item. - - An object representing the data item to which the Item is bound to. The - DataItem property will always return null when - accessed outside of ItemDataBound - event handler. - - - This property is applicable only during data binding. Use it along with the - ItemDataBound event to perform - additional mapping of fields from the data item to - RadPanelItem properties. - - - The following example demonstrates how to map fields from the data item to - %RadPanelItem properties. It assumes the user has subscribed to - the ItemDataBound:RadPanelbar.ItemDataBound - event.:RadPanelItem% - - private void RadPanelbar1_PanelItemDataBound(object sender, Telerik.WebControls.RadPanelbarEventArgs e) - { - RadPanelItem item = e.Item; - DataRowView dataRow = (DataRowView) e.Item.DataItem; - - item.ImageUrl = "image" + dataRow["ID"].ToString() + ".gif"; - item.NavigateUrl = dataRow["URL"].ToString(); - } - - - Sub RadPanel1_PanelItemDataBound(ByVal sender As Object, ByVal e As RadPanelbarEventArgs) Handles RadPanelbar1.ItemDataBound - Dim item As RadPanelItem = e.Item - Dim dataRow As DataRowView = CType(e.Item.DataItem, DataRowView) - - item.ImageUrl = "image" + dataRow("ID").ToString() + ".gif" - item.NavigateUrl = dataRow("URL").ToString() - End Sub - - - - - Gets or sets the template for displaying the item. - - A ITemplate implemented object that contains the template - for displaying the item. The default value is a null reference (Nothing in - Visual Basic), which indicates that this property is not set. - - To specify common display for all panel items use the - ItemTemplate property of the - RadPanelbar class. - - - - The following template demonstrates how to add a Calendar control in certain - panel item. - ASPX: - <radP:RadPanelbar runat="server" ID="RadPanelbar1"> -
- <Items> -
- <radP:RadPanelItem Text="Date"> -
- <Items> -
- <radP:RadPanelItem Text="SelectDate"> -
- <ItemTemplate> -
- <asp:Calendar runat="server" ID="Calendar1" - /> -
- </ItemTemplate> -
- </radP:RadPanelItem> -
- </Items> -
- </radP:RadPanelItem> -
- </Items> -
- </radP:RadPanelbar> -
-
- - Gets or sets the path to an image to display for the item. - - The path to the image to display for the item. The default value is empty - string. - - - Use the ImageUrl property to specify the image for the item. If - the ImageUrl property is set to empty string no image will be - rendered. Use "~" (tilde) when referring to images within the current ASP.NET - application. - - - - - Gets or sets a value specifying the URL of the image rendered when the node is hovered with the mouse. - - - If the HoveredImageUrl property is not set the ImageUrl property will be - used when the node is hovered. - - - - Gets or sets the path to an image to display for the item when it is disabled. - - The path to the image to display for the item. The default value is empty - string. - - - Use the DisabledImageUrl property to specify the image for the item when it is disabled. If - the DisabledImageUrl property is set to empty string no image will be - rendered. Use "~" (tilde) when referring to images within the current ASP.NET - application. - - - - Gets or sets the path to an image to display for the item when it is selected. - - The path to the image to display for the item. The default value is empty - string. - - - Use the SelectedImageUrl property to specify the image for the item when it is disabled. If - the SelectedImageUrl property is set to empty string no image will be - rendered. Use "~" (tilde) when referring to images within the current ASP.NET - application. - - - - Gets or sets the path to an image to display for the item when it is expanded. - - The path to the image to display for the item. The default value is empty - string. - - - Use the ExpandedImageUrl property to specify the image for the item when it is expanded. If - the ExpandedImageUrl property is set to empty string no image will be - rendered. Use "~" (tilde) when referring to images within the current ASP.NET - application. - - - - - - - - - Gets or sets the Cascading Style Sheet (CSS) class applied when the panel item is - clicked. - - - The CSS class applied when the panel item is clicked. The default value is - "clicked". - - - By default the visual appearance of clicked panel items is defined in the skin CSS - file. You can use the ClickedCssClass property to specify unique - appearance for the panel item when it is clicked. - - - - - Gets or sets the Cascading Style Sheet (CSS) class applied when the panel item is - selected. - - - The CSS class applied when the panel item is selected. The default value is - "selected". - - - By default the visual appearance of selected panel items is defined in the skin CSS - file. You can use the SelectedCssClass property to specify unique - appearance for the panel item when it is selected. - - - - - Gets or sets the Cascading Style Sheet (CSS) class applied when the panel item is - opened (its child items are visible). - - - The CSS class applied when the panel item is opened. The default value is - "expanded". - - - By default the visual appearance of opened panel items is defined in the skin CSS - file. You can use the ExpandedCssClass property to specify unique - appearance for the panel item when it is opened. - - - - - Gets or sets the Cascading Style Sheet (CSS) class applied when the panel item is - focused. - - - The CSS class applied when the panel item is focused. The default value is - "focused". - - - By default the visual appearance of focused panel items is defined in the skin CSS - file. You can use the FocusedCssClass property to specify unique - appearance for the panel item when it is focused. - - - - - Represents the simple binding between the property value of an object and the property value of a - RadPanelItem. - - - - - - - - - Specifies the exact value of the ChildGroupCssClass property of the - RadPanelItem that will be created during the data binding. - - - - - Specifies the field, containing the ChildGroupCssClass property - value of the RadPanelItem that will be created during - the data binding. - - - - - Specifies the exact value of the ChildGroupHeight property of the - RadPanelItem that will be created during the data binding. - - - - - Specifies the field, containing the ChildGroupHeight property - value of the RadPanelItem that will be created during - the data binding. - - - - - Specifies the exact value of the ClickedCssClass property of the - RadPanelItem that will be created during the data binding. - - - - - Specifies the field, containing the ClickedCssClass property - value of the RadPanelItem that will be created during - the data binding. - - - - - Specifies the exact value of the DisabledCssClass property of the - RadPanelItem that will be created during the data binding. - - - - - Specifies the field, containing the DisabledCssClass property - value of the RadPanelItem that will be created during - the data binding. - - - - - Specifies the exact value of the DisabledImageUrl property of the - RadPanelItem that will be created during the data binding. - - - - - Specifies the field, containing the DisabledImageUrl property - value of the RadPanelItem that will be created during - the data binding. - - - - - Specifies the exact value of the Expanded property of the - RadPanelItem that will be created during the data binding. - - - - - Specifies the field, containing the Expanded property - value of the RadPanelItem that will be created during - the data binding. - - - - - Specifies the exact value of the ExpandedImageUrl property of the - RadPanelItem that will be created during the data binding. - - - - - Specifies the field, containing the ExpandedImageUrl property - value of the RadPanelItem that will be created during - the data binding. - - - - - Specifies the exact value of the ExpandedCssClass property of the - RadPanelItem that will be created during the data binding. - - - - - Specifies the field, containing the ExpandedCssClass property - value of the RadPanelItem that will be created during - the data binding. - - - - - Specifies the exact value of the FocusedCssClass property of the - RadPanelItem that will be created during the data binding. - - - - - Specifies the field, containing the FocusedCssClass property - value of the RadPanelItem that will be created during - the data binding. - - - - - Specifies the exact value of the ImagePosition property of the - RadPanelItem that will be created during the data binding. - - - - - Specifies the field, containing the ImagePosition property - value of the RadPanelItem that will be created during - the data binding. - - - - - Specifies the exact value of the IsSeparator property of the - RadPanelItem that will be created during the data binding. - - - - - Specifies the field, containing the IsSeparator property - value of the RadPanelItem that will be created during - the data binding. - - - - - Specifies the exact value of the PreventCollapse property of the - RadPanelItem that will be created during the data binding. - - - - - Specifies the field, containing the PreventCollapse property - value of the RadPanelItem that will be created during - the data binding. - - - - - Specifies the exact value of the SelectedCssClass property of the - RadPanelItem that will be created during the data binding. - - - - - Specifies the field, containing the SelectedCssClass property - value of the RadPanelItem that will be created during - the data binding. - - - - - Specifies the exact value of the SelectedImageUrl property of the - RadPanelItem that will be created during the data binding. - - - - - Specifies the field, containing the SelectedImageUrl property - value of the RadPanelItem that will be created during - the data binding. - - - - - A collection of RadPanelItem objects in a - RadPanelBar control. - - - The RadPanelItemCollection class represents a collection of - RadPanelItem objects. - - - Use the indexer to programmatically retrieve a - single RadPanelItem from the collection, using array notation. - - - Use the Count property to determine the total - number of panel items in the collection. - - - Use the Add method to add items in the collection. - - - Use the Remove method to remove items from the - collection. - - - - - - - - Initializes a new instance of the RadPanelItemCollection class. - - The owner of the collection. - - - - Appends the specified RadPanelItem object to the end of the current RadPanelItemCollection. - - - The RadPanelItem to append to the end of the current RadPanelItemCollection. - - - The following example demonstrates how to programmatically add items in a - RadPanelBar control. - - RadPanelItem newsItem = new RadPanelItem("News"); - RadPanelBar1.Items.Add(newsItem); - - - Dim newsItem As RadPanelItem = New RadPanelItem("News") - RadPanelBar1.Items.Add(newsItem) - - - - - Appends the specified array of RadPanelItem objects to the end of the - current RadPanelItemCollection. - - - The following example demonstrates how to use the AddRange method - to add multiple items in a single step. - - RadPanelItem[] items = new RadPanelItem[] { new RadPanelItem("First"), new RadPanelItem("Second"), new RadPanelItem("Third") }; - RadPanelBar1.Items.AddRange(items); - - - Dim items() As RadPanelItem = {New RadPanelItem("First"), New RadPanelItem("Second"), New RadPanelItem("Third")} - RadPanelBar1.Items.AddRange(items) - - - - The array of RadPanelItem o append to the end of the current - RadPanelItemCollection. - - - - - Removes the specified RadPanelItem object from the current - RadPanelItemCollection. - - - The RadPanelItem object to remove. - - - - - Removes the RadPanelItem object at the specified index - from the current RadPanelItemCollection. - - The zero-based index of the item to remove. - - - - Determines the index of the specified RadPanelItem object in the collection. - - - The RadPanelItem to locate. - - - The zero-based index of item within the current RadPanelItemCollection, - if found; otherwise, -1. - - - - - Determines whether the specified RadPanelItem object is in the current - RadPanelItemCollection. - - - The RadPanelItem object to find. - - - true if the current collection contains the specified RadPanelItem object; - otherwise, false. - - - - - Inserts the specified RadPanelItem object in the current - RadPanelItemCollection at the specified index location. - - The zero-based index location at which to insert the RadPanelItem. - The RadPanelItem to insert. - - - - Searches all nodes for a RadPanelItem with a Text property - equal to the specified text. - - The text to search for - A RadPanelItem whose Text property equals to the specified argument. Null (Nothing) is returned when no matching node is found. - This method is not recursive. - - - - Searches all nodes for a RadPanelItem with a Value property - equal to the specified value. - - The value to search for - A RadPanelItem whose Value property equals to the specified argument. Null (Nothing) is returned when no matching node is found. - This method is not recursive. - - - - Searches the nodes in the collection for a RadPanelItem which contains the specified attribute and attribute value. - - The name of the target attribute. - The value of the target attribute - The RadPanelItem that matches the specified arguments. Null (Nothing) is returned if no node is found. - This method is not recursive. - - - - Returns the first RadPanelItem - that matches the conditions defined by the specified predicate. - The predicate should returns a boolean value. - - - The following example demonstrates how to use the FindItem method. - - void Page_Load(object sender, EventArgs e) - { - RadPanel1.FindItem(ItemWithEqualsTextAndValue); - } - private static bool ItemWithEqualsTextAndValue(RadPanelItem item) - { - if (item.Text == item.Value) - { - return true; - } - else - { - return false; - } - } - - - Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs) - RadPanel1.FindItem(ItemWithEqualsTextAndValue) - End Sub - Private Shared Function ItemWithEqualsTextAndValue(ByVal item As RadPanelItem) As Boolean - If item.Text = item.Value Then - Return True - Else - Return False - End If - End Function - - - The Predicate <> that defines the conditions of the element to search for. - - - - Searches the RadPanelbar control for the first - RadPanelItem with a Text property equal to - the specified value. - - - A RadPanelItem whose Text property is equal - to the specified value. - - - The method returns the first item matching the search criteria. If no item is - matching then null (Nothing in VB.NET) is - returned. - - The value to search for. - A Boolean indicating a case-sensitive or insensitive comparison (true indicates a case-insensitive comparison). - - - - Searches the RadPanelbar control for the first - RadPanelItem with a Value property equal - to the specified value. - - - A RadPanelItem whose Value property is - equal to the specified value. - - - The method returns the first item matching the search criteria. If no item is - matching then null (Nothing in VB.NET) is - returned. - - The value to search for. - A Boolean indicating a case-sensitive or insensitive comparison (true indicates a case-insensitive comparison). - - - - Gets the RadPanelItem object at the specified index in - the current RadPanelItemCollection. - - - The zero-based index of the RadPanelItem to retrieve. - - - The RadPanelItem at the specified index in the - current RadPanelItemCollection. - - - - - Telerik RadSpell - - - - - - - - - Gets the value that corresponds to this Web server control. This property is used primarily by control developers. - - - One of the enumeration values. - - - - Gets or sets the URL for the spell dialog handler - - the relative path for the spell dialog handler - - - - Gets or sets the location of a CSS file, that will be added in the dialog window. If you need to include - more than one file, use the CSS @import url(); rule to add the other files from the first. - This property is needed if you are using a custom skin. It allows you to include your custom skin - CSS in the dialogs, which are separate from the main page. - - - - - Gets or sets the location of a JavaScript file, that will be added in the dialog window. If you need to include - more than one file, you will need to combine the scripts into one first. - This property is needed if want to override some of the default functionality without loading the dialog - from an external ascx file. - - - - - Gets or sets an additional querystring appended to the dialog URL. - - A String, appended to the dialog URL - - - Gets or sets the value indicating whether the spell will allow adding custom words. - The default is true - - - - Gets or sets the URL which the AJAX call will be made to. Check the help for more information. - - - - Gets or sets the text of the button that will start the spellcheck. This property is localizable. - The default is Spell Check - - - Gets or sets the type of the button that will start the spellcheck. - The default is PushButton - - Values allowed: - PushButton/LinkButton/ImageButton/ - None. - Setting the value to None will not render a button. The only - way to start a spellcheck will be through the client-side API. - - - - Gets or sets the class of the client side text source object. - - A string containing the name of the JavaScript class. The - default is HtmlElementTextSource -- a built in implementation that obtains the - source from a HTML element. - - - The text source is a JavaScript object. It has to provide two methods: GetText() and SetText(newValue). - - - - <script type="text/javascript"> - function DifferentControlsSource() - { - this.GetText = function() - { - return document.getElementById('before').value; - } - - this.SetText = function(newValue) - { - document.getElementById('after').value = newValue; - } - } - </script> - - - - - - The ID of the control to check. - - - The ID can be both a server-side ID, or a client-side ID. RadSpell will find the - appropriate server control and use its ClientID to attach to it. - - - - - An array of IDs of the control to check. - - - The IDs can be server-side or client-side. RadSpell will find the - appropriate server control and use its ClientID to attach to it. - Note that you cannot mix server and client IDs in this list - use only one kind. - - - - - Gets or sets the fully qualified type name that will be used to store and read - the custom dictionary. - - - The type name must be fully qualified if the type is in a GAC-deployed assembly. - The type must implement the - ICustomDictionarySource - interface. - - - - spell1.CustomDictionarySourceTypeName = "RadSpellExtensions.CustomDictionarySource, RadSpellExtensions, Version=1.0.0.0, Culture=neutral, PublicKeyToken=b5e57ccb698eab8e"; - - - spell1.CustomDictionarySourceTypeName = "RadSpellExtensions.CustomDictionarySource, RadSpellExtensions, Version=1.0.0.0, Culture=neutral, PublicKeyToken=b5e57ccb698eab8e" - - - - - Gets or sets the suffix for the custom dictionary files. - The default is -Custom - - The filenames are formed with the following scheme: Language + CustomDictionarySuffix + - ".txt". Different suffixes can be used to create different custom dictionaries for - different users. - - - - Gets or sets the assembly qualified name of the SpellDialog type. - The default is string.Empty - - - Gets or sets the virtual path of the UserControl that represents the SpellDialog. - The default is string.Empty - - - Gets or sets the dictionary language used for spellchecking. - The default is en-US - - The language name is used to find a corresponding dictionary file. Spellchecking in - en-US will work only if a file en-US.TDF can be found inside the folder pointed to - by DictionaryPath. - - - - Gets or sets the path for the dictionary files. - The default is ~/RadControls/Spell/TDF/ - - This is the path that contains the TDF files, and the custom dictionary TXT - files. - - - - - Gets or sets a the edit distance. If you increase the value, the checking speed - decreases but more suggestions are presented. Applicable only in EditDistance mode. - - The default is 1 - - This property takes effect only if the - SpellCheckProvider property is set to - EditDistanceProvider. - - - - - Configures the spellchecker engine, so that it knows whether to skip URL's, email - addresses, and filenames and not flag them as erros. - - - - - Gets or sets a value indicating whether whether the ControlToCheck - property provides a client element ID or a server side control ID. - - The default is false. - - When true RadSpell will look for the server-side control and get - its ClientID. When false the - ControlToCheck property will be interpreted as a - client-side ID and will be used to attach to the target control. - - - - Gets or sets the localization language for the user interface. - - The localization language for the user interface. The default value is - en-US. - - - - - Gets a value indicating if the target control has been spellchecked. - - - Spellchecking the entire text by the client would set the property to - true on postback. - - The property is used by the SpellCheckValidator class. You can set it on the - client side with RadSpell's SetSpellChecked(false) on various events, say a - TEXTAREA's OnChange. - - - - Allows the use of a custom spell checking provider. It must implement the ISpellCheckProvider interface. - The default is PhoneticProvider - - - Specifies the spellchecking algorithm which will be used by RadSpell. - The default is PhoneticProvider - - - Gets or sets the supported languages. - - The supported languages will be displayed in a drop-down list, and the user can - select the language for spellchecking. - - - A string array containing the codes and names of the languages (code, name, code, - name...) - - - - <radS:RadSpell ID="spell1" - Runat="server" - ControlToCheck="textBox1" - SupportedLanguages="en-US,English,fr-FR,French"> - </radS:RadSpell> - - - - - - Gets or sets the value used to configure the spellchecker engine to ignore words containing: UPPERCASE, some - CaPitaL letters, numbers; or to ignore repeated words (very very) - - - - - Gets or sets the name of the client-side function that will be called when the - spell control is initialized on the page. - - - The function should accept two parameters: sender (the spell client object) and arguments. - - - - function onSpellLoad(sender, args) - { - log("spell: " + sender.get_id() + " ready."); - } - - - - - - Gets or sets the name of the client-side function that will be called when the - spell check starts. - - - The function should accept two parameters: sender (the spell client object) and arguments. - - - - function onCheckStarted(sender, args) - { - log("spell: " + sender.clientId + " started for: " + sender.targetControlId); - } - - - - - - Gets or sets the name of the client-side function that will be called when the - spell check is finished. - - - The function should accept two parameters: sender (the spell client object) and arguments. - - - - function onCheckFinished(sender, args) - { - log("spell: " + sender.clientId + " finished for: " + sender.targetControlId); - } - - - - - - Specifies the name of the client-side function that will be called when the user - cancels the spell check. - - - The function should accept two parameters: sender (the spell client object) and arguments. - - - - function onCheckCancelled(sender, args) - { - log("spell: " + sender.clientId + " cancelled for: " + sender.targetControlId); - } - - - - - - Specifies the name of the client-side function that will be called before the - spell check dialog closes. - - - The function should accept two parameters: sender (the dialog opener client object) and arguments. - - - - function onDialogClosed(sender, args) - { - alert("spell: " + sender.get_id()+ " dialog closed"); - } - - - - - Gets or sets the skin name for the control user interface. - A string containing the skin name for the control user interface. The default is string.Empty. - - - If this property is not set, the control will render using the skin named "Default". - If EnableEmbeddedSkins is set to false, the control will not render skin. - - - - - Gets or sets the value, indicating whether to render the skin CSS files during Ajax requests - - - If EnableAjaxSkinRendering is set to false you will have to register the needed control base CSS file by hand when adding/showing the control with Ajax. - - - - - Gets or sets the value, indicating whether to render links to the embedded client scripts or not. - - - If EnableEmbeddedScripts is set to false you will have to register the needed script files by hand. - - - - - Gets or sets the value, indicating whether to render links to the embedded skins or not. - - - If EnableEmbeddedSkins is set to false you will have to register the needed CSS files by hand. - - - - - Gets or sets the value, indicating whether to render the link to the embedded base stylesheet of the control or not. - - - If EnableEmbeddedBaseStylesheet is set to false you will have to register the needed control base CSS file by hand. - - - - - - This class is a container for the Spell Dialog UI - - - - - - - - - - - - - - - - - - - - - - - - - Gets or sets a string containing the localization language for the RadSpell Dialog - - - - - SpellCheckValidator validates a form based on a RadSpell control. It can be used to enforce spellchecking before form submission. - The ControlToValidate must be set to the ID of a RadSpell control. The RadSpell control should be separately set up with a control to check and other options. - - - - - A collection of RadToolBarButton objects in - RadToolBarDropDown and - RadToolBarSplitButton. - - - The RadToolBarButtonCollection class represents a collection of - RadToolBarButton objects. The RadToolBarButton objects - in turn represent buttons within a RadToolBarDropDown or - a RadToolBarSplitButton. - - - Use the indexer to programmatically retrieve a - single RadToolBarButton from the collection, using array notation. - - - Use the Count property to determine the total - number of buttons in the collection. - - - Use the Add method to add buttons to the collection. - - - Use the Remove method to remove buttons from the - collection. - - - - - - - A collection of RadToolBarItem objects in a - RadToolBar control. - - - The RadToolBarItemCollection class represents a collection of - RadToolBarItem objects. The RadToolBarItem objects - in turn represent items (buttons, dropdowns or split buttons) within a - RadToolBar control. - - Use the indexer to programmatically retrieve a - single RadToolBarItem from the collection, using array notation. - - - Use the Count property to determine the total - number of toolbar items in the collection. - - - Use the Add method to add toolbar items to the collection. - - - Use the Remove method to remove toolbar items from the - collection. - - - - - - - Initializes a new instance of the RadToolBarItemCollection class. - - The owner of the collection. - - - - Appends the specified RadToolBarItem object to the end of the - current RadToolBarItemCollection. - - - The RadToolBarItem to append to the end of the current - RadToolBarItemCollection. - - - The following example demonstrates how to programmatically add toolbar buttons in a - RadToolBar control. - - RadToolBarButton createNewButton = new RadToolBarButton("CreateNew"); - RadToolBar1.Items.Add(createNewButton); - - - Dim createNewButton As RadToolBarButton = New RadToolBarButton("CreateNew") - RadToolBar1.Items.Add(createNewButton) - - - - - - Searches the ToolBarItemCollection for the first - RadToolBarItem with a Text property equal to - the specified value. - - - A RadToolBarItem which Text property is equal - to the specified value. - - - The method returns the first item matching the search criteria. This method is not recursive. If no item is - matching then null (Nothing in VB.NET) is - returned. - - The value to search for. - - - - Searches the ToolBarItemCollection for the first button item - (RadToolBarButton or - RadToolBarSplitButton) with a - Value property equal - to the specified value. - - - A button item which Value property is - equal to the specified value. - - - The method returns the first item matching the search criteria. This method is not recursive. If no item is - matching then null (Nothing in VB.NET) is - returned. - - The value to search for. - - - - Searches the ToolBarItemCollection for the first - RadToolBarItem with a Text property equal to - the specified value. - - - A RadToolBarItem which Text property is equal - to the specified value. - - - The method returns the first item matching the search criteria. This method is not recursive. If no item is - matching then null (Nothing in VB.NET) is - returned. - - The value to search for. - A Boolean indicating a case-sensitive or insensitive comparison (true indicates a case-insensitive comparison). - - - - Searches the ToolBarItemCollection for the first button item - (RadToolBarButton or - RadToolBarSplitButton) with a - Value property equal - to the specified value. - - - A button item which Value property is - equal to the specified value. - - - The method returns the first item matching the search criteria. This method is not recursive. If no item is - matching then null (Nothing in VB.NET) is - returned. - - The value to search for. - A Boolean indicating a case-sensitive or insensitive comparison (true indicates a case-insensitive comparison). - - - - Searches the items in the collection for a RadToolBarItem which contains the specified attribute and attribute value. - - The name of the target attribute. - The value of the target attribute - The RadToolBarItem that matches the specified arguments. Null (Nothing) is returned if no node is found. - This method is not recursive. - - - - Returns the first RadToolBarItem - that matches the conditions defined by the specified predicate. - The predicate should returns a boolean value. - - - The following example demonstrates how to use the FindItem method. - - void Page_Load(object sender, EventArgs e) - { - RadToolBar1.FindItem(ItemWithEqualsTextAndValue); - } - private static bool ItemWithEqualsTextAndValue(RadToolBarItem item) - { - if (item.Text == item.Value) - { - return true; - } - else - { - return false; - } - } - - - Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs) - RadToolBar1.FindItem(ItemWithEqualsTextAndValue) - End Sub - Private Shared Function ItemWithEqualsTextAndValue(ByVal item As RadToolBarItem) As Boolean - If item.Text = item.Value Then - Return True - Else - Return False - End If - End Function - - - The Predicate <> that defines the conditions of the element to search for. - - - - Determines whether the specified RadToolBarItem object is in the current - RadToolBarItemCollection. - - - The RadToolBarItem object to find. - - - true if the current collection contains the specified - RadToolBarItem object; otherwise, false. - - - - - Appends the specified array of RadToolBarItem objects - to the end of the current RadToolBarItemCollection. - - - The following example demonstrates how to use the AddRange method - to add multiple items in a single step. - - RadToolBarItem[] items = new RadToolBarItem[] { new RadToolBarButton("Create New"), - new RadToolBarDropDown("Manage"), - new RadToolBarSplitButton("Register Purchase")}; - RadToolBar1.Items.AddRange(items); - - - Dim items() As RadToolBarItem = {New RadToolBarButton("Create New"), - New RadToolBarDropDown("Manage"), - New RadToolBarSplitButton("Register Purchase")} - RadToolBar1.Items.AddRange(items) - - - - The array of RadToolBarItem objects to append to the end of the current - RadToolBarItemCollection. - - - - - Determines the index of the specified RadToolBarItem object in - the collection. - - - The RadToolBarItem to locate. - - - The zero-based index of a toolbar item within the current - RadToolBarItemCollection, - if found; otherwise, -1. - - - - - Inserts the specified RadToolBarItem object in the current - RadToolBarItemCollection at the specified index location. - - The zero-based index location at which to insert the - RadToolBarItem. - The RadToolBarItem to insert. - - - - Removes the specified RadToolBarItem object from the current - RadToolBarItemCollection. - - - The RadToolBarItem object to remove. - - - - - Removes the RadToolBarItem object at the specified index - from the current RadToolBarItemCollection. - - The zero-based index of the item to remove. - - - - Gets the RadToolBarItem object at the specified index in - the current RadToolBarItemCollection. - - - The zero-based index of the RadToolBarItem to retrieve. - - - The RadToolBarItem at the specified index in the - current RadToolBarItemCollection. - - - - - Initializes a new instance of the - RadToolBarButtonCollection class. - - The owner of the collection. - - - - Appends the specified RadToolBarButton object to the end of the - current RadToolBarButtonCollection. - - - The RadToolBarButton to append to the end of the current - RadToolBarButtonCollection. - - - The following example demonstrates how to programmatically add toolbar buttons to a - RadToolBarDropDown. - - RadToolBarDropDown manageDropDown = new RadToolBarDropDown("Manage"); - - RadToolBarButton manageUsersButton = new RadToolBarButton("Users"); - manageDropDown.Buttons.Add(manageUsersButton); - - RadToolBarButton manageOrdersButton = new RadToolBarButton("Orders"); - manageDropDown.Buttons.Add(manageOrdersButton); - - RadToolBar1.Items.Add(manageDropDown); - - - Dim manageDropDown As RadToolBarDropDown = New RadToolBarDropDown("Manage") - - Dim manageUsersButton As RadToolBarButton = New RadToolBarButton("Users") - manageDropDown.Buttons.Add(manageUsersButton) - - Dim manageOrdersButton As RadToolBarButton = New RadToolBarButton("Orders") - manageDropDown.Buttons.Add(manageOrdersButton) - - RadToolBar1.Items.Add(manageDropDown) - - - - - - Searches the RadToolBarButtonCollection for the first - RadToolBarButton with a Text property equal to - the specified value. - - - A RadToolBarButton which Text property is equal - to the specified value. - - - The method returns the first item matching the search criteria. This method is not recursive. If no item is - matching then null (Nothing in VB.NET) is - returned. - - The value to search for. - - - - Searches the RadToolBarButtonCollection for the first - RadToolBarButton with a Value property equal - to the specified value. - - - A RadToolBarButton whose Value property is - equal to the specified value. - - - The method returns the first item matching the search criteria. This method is not recursive. If no item is - matching then null (Nothing in VB.NET) is - returned. - - The value to search for. - - - - Searches the items in the collection for a RadToolBarButton - which contains the specified attribute and attribute value. - - The name of the target attribute. - The value of the target attribute - The RadToolBarButton that matches the specified arguments. - Null (Nothing) is returned if no node is found. - This method is not recursive. - - - - Determines whether the specified RadToolBarButton object - is in the current RadToolBarButtonCollection. - - - The RadToolBarButton object to find. - - - true if the current collection contains the specified - RadToolBarButton object; otherwise, false. - - - - - Appends the specified array of RadToolBarButton objects - to the end of the current RadToolBarButtonCollection. - - - The following example demonstrates how to use the AddRange method - to add multiple buttons in a single step. - - RadToolBarDropDown manageDropDown = new RadToolBarDropDown("Manage"); - RadToolBarButton[] buttons = new RadToolBarButton[] { new RadToolBarButton("Users"), - new RadToolBarButton("Orders")}; - - manageDropDown.Buttons.AddRange(buttons); - - RadToolBar1.Items.Add(manageDropDown); - - - Dim manageDropDown As RadToolBarDropDown = New RadToolBarDropDown("Manage") - Dim buttons() As RadToolBarButton = {New RadToolBarButton("Users"), - New RadToolBarButton("Orders")} - - manageDropDown.Buttons.AddRange(buttons) - - RadToolBar1.Items.Add(manageDropDown) - - - - The array of RadToolBarButton objects to append to - the end of the current RadToolBarButtonCollection. - - - - - Determines the index of the specified RadToolBarButton object in - the collection. - - - The RadToolBarButton to locate. - - - The zero-based index of a toolbar button within the current - RadToolBarButtonCollection, - if found; otherwise, -1. - - - - - Inserts the specified RadToolBarButton object in the current - RadToolBarButtonCollection at the specified index location. - - The zero-based index location at which to insert the - RadToolBarButton. - The RadToolBarButton to insert. - - - - Removes the specified RadToolBarButton object from the current - RadToolBarButtonCollection. - - - The RadToolBarButton object to remove. - - - - - Removes the RadToolBarButton object at the specified index - from the current RadToolBarButtonCollection. - - The zero-based index of the button to remove. - - - - Gets the RadToolBarButton object at the specified index in - the current RadToolBarButtonCollection. - - - The zero-based index of the RadToolBarButton to retrieve. - - - The RadToolBarButton at the specified index in the - current RadToolBarButtonCollection. - - - - - - - - - - - - - - - - - Represents the animation settings like type and duration for the control. - - - - Gets or sets the duration in milliseconds of the animation. - - An integer representing the duration in milliseconds of the animation. - The default value is 450 milliseconds. - - - - - For internal use only. - - - - - - - A context menu control used with the control. - - - - The RadTreeViewContextMenu object is used to assign context menus to nodes. Use the - property to add context menus for a - object. - - - Use the property to assign specific context menu to a given . - - - - The following example demonstrates how to add context menus declaratively - - <telerik:RadTreeView ID="RadTreeView1" runat="server"> - <ContextMenus> - <telerik:RadTreeViewContextMenu ID="ContextMenu1"> - <Items> - <telerik:RadMenuItem Text="Menu1Item1"></telerik:RadMenuItem> - <telerik:RadMenuItem Text="Menu1Item2"></telerik:RadMenuItem> - </Items> - </telerik:RadTreeViewContextMenu> - <telerik:RadTreeViewContextMenu Skin="Outlook" ID="ContextMenu2"> - <Items> - <telerik:RadMenuItem Text="Menu2Item1"></telerik:RadMenuItem> - <telerik:RadMenuItem Text="Menu2Item2"></telerik:RadMenuItem> - </Items> - </telerik:RadTreeViewContextMenu> - </ContextMenus> - <Nodes> - <telerik:RadTreeNode Text="Node1" ContextMenuID="ContextMenu2"> - <Nodes> - <telerik:RadTreeNode Text="Node11" ContextMenuID="ContextMenu2"></telerik:RadTreeNode> - <telerik:RadTreeNode Text="Node12" ContextMenuID="ContextMenu2"></telerik:RadTreeNode> - </Nodes> - </telerik:RadTreeNode> - <telerik:RadTreeNode Text="Node2" ContextMenuID="ContextMenu2"> - <Nodes> - <telerik:RadTreeNode Text="Node21" ContextMenuID="ContextMenu2"></telerik:RadTreeNode> - <telerik:RadTreeNode Text="Node22" ContextMenuID="ContextMenu2"></telerik:RadTreeNode> - </Nodes> - </telerik:RadTreeNode> - </Nodes> - </telerik:RadTreeView> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - OnClientItemClicking is not available for RadTreeViewContextMenu. Use the OnClientContextMenuItemClicking property of RadTreeView instead. - - - - - OnClientItemClicked is not available for RadTreeViewContextMenu. Use the OnClientContextMenuItemClicked property of RadTreeView instead. - - - - - OnClientShowing is not available for RadTreeViewContextMenu. Use the OnClientContextMenuShowing property of RadTreeView instead. - - - - - OnClientShown is not available for RadTreeViewContextMenu. Use the OnClientContextMenuShown property of RadTreeView instead. - - - - - Provides a collection container that enables RadTreeView to maintain a list of its RadTreeViewContextMenus. - - - - - Initializes a new instance of the RadTreeViewContextMenuCollection class for the specified RadTreeView. - - The RadTreeView that the RadTreeViewContextMenuCollection is created for. - - - - Adds the specified RadTreeViewContextMenu object to the collection - - The RadTreeViewContextMenu to add to the collection - - - - Determines whether the specified RadTreeViewContextMenu is in the parent - RadTreeView's RadTreeViewContextMenuCollection object. - - The RadTreeViewContextMenu to search for in the collection - true if the specified RadTreeViewContextMenu exists in - the collection; otherwise, false. - - - - Copies the RadTreeViewContextMenu instances stored in the - RadTreeViewContextMenuCollection - object to an System.Array object, beginning at the specified index location in the System.Array. - - The System.Array to copy the RadTreeViewContextMenu instances to. - The zero-based relative index in array where copying begins - - - Appends the specified array of objects to the end of the - current . - - - The array of to append to the end of the current - . - - - - - Retrieves the index of a specified RadTreeViewContextMenu object in the collection. - - The RadTreeViewContextMenu - for which the index is returned. - The index of the specified RadTreeViewContextMenu - instance. If the RadTreeViewContextMenu is not - currently a member of the collection, it returns -1. - - - - Inserts the specified RadTreeViewContextMenu object - to the collection at the specified index location. - - The location in the array at which to add the RadTreeViewContextMenu instance. - The RadTreeViewContextMenu to add to the collection - - - - Removes the specified RadTreeViewContextMenu - from the parent RadTreeView's RadTreeViewContextMenuCollection - object. - - The RadTreeViewContextMenu to be removed - To remove a control from an index location, use the RemoveAt method. - - - - Removes a child RadTreeViewContextMenu, at the - specified index location, from the RadTreeViewContextMenuCollection - object. - - The ordinal index of the RadTreeViewContextMenu - to be removed from the collection. - - - - Gets a reference to the RadTreeViewContextMenu at the specified index location in the - RadTreeViewContextMenuCollection object. - - The location of the RadTreeViewContextMenu in the RadTreeViewContextMenuCollection - The reference to the RadTreeViewContextMenu. - - - - Represents the method that handles the ContextMenuItemClick - event of a RadTreeView control. - - The source of the event. - A RadTreeViewContextMenuEventArgs - that contains the event data. - - - The ContextMenuItemClick event is raised - when an item in the RadTreeViewContextMenu of the - RadTreeView control is clicked. - - - A click on a RadTreeViewContextMenu item of the - RadTreeView makes a postback only if an event handler is attached - to the ContextMenuItemClick event. - - - - The following example demonstrates how to display information about the clicked item in the - RadTreeViewContextMenu shown after a right-click - on a RadTreeNode. - - <%@ Page Language="C#" AutoEventWireup="true" %> - <%@ Register TagPrefix="Telerik" Namespace="Telerik.Web.UI" Assembly="Telerik.Web.UI" %> - - <script runat="server"> - void RadTreeView1_ContextMenuItemClick(object sender, RadTreeViewContextMenuEventArgs e) - { - lblInfo.Text = string.Format(@"You clicked on Menu Item {0}(""{1}"") of Node {2}(""{3}"")", - e.MenuItem.Index, e.MenuItem.Text, e.Node.Index, e.Node.Text); - } - </script> - - <html> - <body> - <form id="form1" runat="server"> - <Telerik:RadScriptManager ID="RadScriptManager1" runat="server"></Telerik:RadScriptManager> - <br /> - <asp:Label ID="lblInfo" style="border:solid 1px black; background-color:InfoBackground;font:normal 12px Courier New;" runat="server">Click on a context menu item to see the information for it.</asp:Label> - <br /> - <Telerik:RadTreeView ID="RadTreeView1" runat="server" OnContextMenuItemClick="RadTreeView1_ContextMenuItemClick"> - <ContextMenus> - <Telerik:RadTreeViewContextMenu ID="ContextMenu1"> - <Items> - <Telerik:RadMenuItem Text="Menu1Item1"></Telerik:RadMenuItem> - <Telerik:RadMenuItem Text="Menu1Item2"></Telerik:RadMenuItem> - </Items> - </Telerik:RadTreeViewContextMenu> - <Telerik:RadTreeViewContextMenu Skin="Outlook" ID="ContextMenu2"> - <Items> - <Telerik:RadMenuItem Text="Menu2Item1"></Telerik:RadMenuItem> - <Telerik:RadMenuItem Text="Menu2Item2"></Telerik:RadMenuItem> - </Items> - </Telerik:RadTreeViewContextMenu> - </ContextMenus> - <Nodes> - <Telerik:RadTreeNode Text="Node1" ContextMenuID="ContextMenu2"> - <Nodes> - <Telerik:RadTreeNode Text="Node11" ContextMenuID="ContextMenu2"></Telerik:RadTreeNode> - <Telerik:RadTreeNode Text="Node12" ContextMenuID="ContextMenu2"></Telerik:RadTreeNode> - </Nodes> - </Telerik:RadTreeNode> - <Telerik:RadTreeNode Text="Node2" ContextMenuID="ContextMenu2"> - <Nodes> - <Telerik:RadTreeNode Text="Node21" ContextMenuID="ContextMenu2"></Telerik:RadTreeNode> - <Telerik:RadTreeNode Text="Node22" ContextMenuID="ContextMenu2"></Telerik:RadTreeNode> - </Nodes> - </Telerik:RadTreeNode> - </Nodes> - </Telerik:RadTreeView> - - </form> - </body> - </html> - - - <%@ Page Language="VB" AutoEventWireup="true" %> - <%@ Register TagPrefix="Telerik" Namespace="Telerik.Web.UI" Assembly="Telerik.Web.UI" %> - - <script runat="server"> - Sub RadTreeView1_ContextMenuItemClick(ByVal sender as Object, ByVal e as RadTreeViewContextMenuEventArgs) - lblInfo.Text = String.Format("You clicked on Menu Item {0}(""{1}"") of Node {2}(""{3}"")", _ - e.MenuItem.Index, e.MenuItem.Text, e.Node.Index, e.Node.Text) - End Sub - </script> - - <html> - <body> - <form id="form1" runat="server"> - <Telerik:RadScriptManager ID="RadScriptManager1" runat="server"></Telerik:RadScriptManager> - <br /> - <asp:Label ID="lblInfo" style="border:solid 1px black; background-color:InfoBackground;font:normal 12px Courier New;" runat="server">Click on a context menu item to see the information for it.</asp:Label> - <br /> - <Telerik:RadTreeView ID="RadTreeView1" runat="server" OnContextMenuItemClick="RadTreeView1_ContextMenuItemClick"> - <ContextMenus> - <Telerik:RadTreeViewContextMenu ID="ContextMenu1"> - <Items> - <Telerik:RadMenuItem Text="Menu1Item1"></Telerik:RadMenuItem> - <Telerik:RadMenuItem Text="Menu1Item2"></Telerik:RadMenuItem> - </Items> - </Telerik:RadTreeViewContextMenu> - <Telerik:RadTreeViewContextMenu Skin="Outlook" ID="ContextMenu2"> - <Items> - <Telerik:RadMenuItem Text="Menu2Item1"></Telerik:RadMenuItem> - <Telerik:RadMenuItem Text="Menu2Item2"></Telerik:RadMenuItem> - </Items> - </Telerik:RadTreeViewContextMenu> - </ContextMenus> - <Nodes> - <Telerik:RadTreeNode Text="Node1" ContextMenuID="ContextMenu2"> - <Nodes> - <Telerik:RadTreeNode Text="Node11" ContextMenuID="ContextMenu2"></Telerik:RadTreeNode> - <Telerik:RadTreeNode Text="Node12" ContextMenuID="ContextMenu2"></Telerik:RadTreeNode> - </Nodes> - </Telerik:RadTreeNode> - <Telerik:RadTreeNode Text="Node2" ContextMenuID="ContextMenu2"> - <Nodes> - <Telerik:RadTreeNode Text="Node21" ContextMenuID="ContextMenu2"></Telerik:RadTreeNode> - <Telerik:RadTreeNode Text="Node22" ContextMenuID="ContextMenu2"></Telerik:RadTreeNode> - </Nodes> - </Telerik:RadTreeNode> - </Nodes> - </Telerik:RadTreeView> - - </form> - </body> - </html> - - - - - - Provides data for the ContextMenuItemClick - event of the RadTreeView control. This class cannot be inherited. - - - - The ContextMenuItemClick event is raised - when an item in the RadTreeViewContextMenu of the - RadTreeView control is clicked. - - - A click on a RadTreeViewContextMenu item of the - RadTreeView makes a postback only if an event handler is attached - to the ContextMenuItemClick event. - - - - The following example demonstrates how to display information about the clicked item in the - RadTreeViewContextMenu shown after a right-click - on a RadTreeNode. - - <%@ Page Language="C#" AutoEventWireup="true" %> - <%@ Register TagPrefix="Telerik" Namespace="Telerik.Web.UI" Assembly="Telerik.Web.UI" %> - - <script runat="server"> - void RadTreeView1_ContextMenuItemClick(object sender, RadTreeViewContextMenuEventArgs e) - { - lblInfo.Text = string.Format(@"You clicked on Menu Item {0}(""{1}"") of Node {2}(""{3}"")", - e.MenuItem.Index, e.MenuItem.Text, e.Node.Index, e.Node.Text); - } - </script> - - <html> - <body> - <form id="form1" runat="server"> - <Telerik:RadScriptManager ID="RadScriptManager1" runat="server"></Telerik:RadScriptManager> - <br /> - <asp:Label ID="lblInfo" style="border:solid 1px black; background-color:InfoBackground;font:normal 12px Courier New;" runat="server">Click on a context menu item to see the information for it.</asp:Label> - <br /> - <Telerik:RadTreeView ID="RadTreeView1" runat="server" OnContextMenuItemClick="RadTreeView1_ContextMenuItemClick"> - <ContextMenus> - <Telerik:RadTreeViewContextMenu ID="ContextMenu1"> - <Items> - <Telerik:RadMenuItem Text="Menu1Item1"></Telerik:RadMenuItem> - <Telerik:RadMenuItem Text="Menu1Item2"></Telerik:RadMenuItem> - </Items> - </Telerik:RadTreeViewContextMenu> - <Telerik:RadTreeViewContextMenu Skin="Outlook" ID="ContextMenu2"> - <Items> - <Telerik:RadMenuItem Text="Menu2Item1"></Telerik:RadMenuItem> - <Telerik:RadMenuItem Text="Menu2Item2"></Telerik:RadMenuItem> - </Items> - </Telerik:RadTreeViewContextMenu> - </ContextMenus> - <Nodes> - <Telerik:RadTreeNode Text="Node1" ContextMenuID="ContextMenu2"> - <Nodes> - <Telerik:RadTreeNode Text="Node11" ContextMenuID="ContextMenu2"></Telerik:RadTreeNode> - <Telerik:RadTreeNode Text="Node12" ContextMenuID="ContextMenu2"></Telerik:RadTreeNode> - </Nodes> - </Telerik:RadTreeNode> - <Telerik:RadTreeNode Text="Node2" ContextMenuID="ContextMenu2"> - <Nodes> - <Telerik:RadTreeNode Text="Node21" ContextMenuID="ContextMenu2"></Telerik:RadTreeNode> - <Telerik:RadTreeNode Text="Node22" ContextMenuID="ContextMenu2"></Telerik:RadTreeNode> - </Nodes> - </Telerik:RadTreeNode> - </Nodes> - </Telerik:RadTreeView> - - </form> - </body> - </html> - - - <%@ Page Language="VB" AutoEventWireup="true" %> - <%@ Register TagPrefix="Telerik" Namespace="Telerik.Web.UI" Assembly="Telerik.Web.UI" %> - - <script runat="server"> - Sub RadTreeView1_ContextMenuItemClick(ByVal sender as Object, ByVal e as RadTreeViewContextMenuEventArgs) - lblInfo.Text = String.Format("You clicked on Menu Item {0}(""{1}"") of Node {2}(""{3}"")", _ - e.MenuItem.Index, e.MenuItem.Text, e.Node.Index, e.Node.Text) - End Sub - </script> - - <html> - <body> - <form id="form1" runat="server"> - <Telerik:RadScriptManager ID="RadScriptManager1" runat="server"></Telerik:RadScriptManager> - <br /> - <asp:Label ID="lblInfo" style="border:solid 1px black; background-color:InfoBackground;font:normal 12px Courier New;" runat="server">Click on a context menu item to see the information for it.</asp:Label> - <br /> - <Telerik:RadTreeView ID="RadTreeView1" runat="server" OnContextMenuItemClick="RadTreeView1_ContextMenuItemClick"> - <ContextMenus> - <Telerik:RadTreeViewContextMenu ID="ContextMenu1"> - <Items> - <Telerik:RadMenuItem Text="Menu1Item1"></Telerik:RadMenuItem> - <Telerik:RadMenuItem Text="Menu1Item2"></Telerik:RadMenuItem> - </Items> - </Telerik:RadTreeViewContextMenu> - <Telerik:RadTreeViewContextMenu Skin="Outlook" ID="ContextMenu2"> - <Items> - <Telerik:RadMenuItem Text="Menu2Item1"></Telerik:RadMenuItem> - <Telerik:RadMenuItem Text="Menu2Item2"></Telerik:RadMenuItem> - </Items> - </Telerik:RadTreeViewContextMenu> - </ContextMenus> - <Nodes> - <Telerik:RadTreeNode Text="Node1" ContextMenuID="ContextMenu2"> - <Nodes> - <Telerik:RadTreeNode Text="Node11" ContextMenuID="ContextMenu2"></Telerik:RadTreeNode> - <Telerik:RadTreeNode Text="Node12" ContextMenuID="ContextMenu2"></Telerik:RadTreeNode> - </Nodes> - </Telerik:RadTreeNode> - <Telerik:RadTreeNode Text="Node2" ContextMenuID="ContextMenu2"> - <Nodes> - <Telerik:RadTreeNode Text="Node21" ContextMenuID="ContextMenu2"></Telerik:RadTreeNode> - <Telerik:RadTreeNode Text="Node22" ContextMenuID="ContextMenu2"></Telerik:RadTreeNode> - </Nodes> - </Telerik:RadTreeNode> - </Nodes> - </Telerik:RadTreeView> - - </form> - </body> - </html> - - - - - - Initializes a new instance of the RadTreeViewContextMenuEventArgs class. - - A RadTreeNode which represents a - node in the RadTreeView control. - - A RadMenuItem which represents an - item in the RadTreeViewContextMenu control. - - - - - Gets the referenced RadMenuItem in the - RadTreeViewContextMenu control - when the event is raised. - - - Use this property to programmatically access the item referenced in the - RadTreeViewContextMenu when the event is raised. - - - - - Gets the referenced RadTreeNode in the - RadTreeView control when the event is raised. - - - Use this property to programmatically access the item referenced in the - RadTreeNode when the event is raised. - - - - - Specifies the checked state of . - - - - - The is not checked - - - - - The is checked - - - - - The is in Indeterminate mode (some of its child nodes is not checked) - - - - - This enumeration controls the expand behaviour of the nodes. - - - - - The default behaviour - all nodes are loaded in the intial request and expand is performed on the client, without server interaction - - - - - Forces firing of the NodeExpand event - a postback occurs and developers can populate the node with its children in server side event handler - - - - - Forces firing of the NodeExpand event asyncronously from the client without postback - the NodeExpand event fires and child nodes added to the node collection are automatically transferred to the client without postback. - - - - - The child nodes are loaded from the web service specified by the RadTreeView.WebServicePath and RadTreeView.WebServiceMethod properties. - - - - - Specifies where the loading message is shown when Client-side load on demand is used. - - - - - If the node text is "Some Text", the text is changed to "(loading ...) Some Text" when child nodes are being loaded (Assuming the LoadingMessage property has been set to "(loading...)"; - - - - - If the node text is "Some Text", the text is changed to "Some Text (loading ...)" when child nodes are being loaded (Assuming the LoadingMessage property has been set to "(loading...)"; - - - - - The text is not changed and (loading ...)" when child nodes are being loaded (Assuming the LoadingMessage property has been set to "(loading...)"; - - - - - No loading text is displayed at all. - - - - - Specifies the position at which the user has dragged and dropped the source node(s) with regards to the - destination node. - - - - - The source node(s) is dropped over (onto) the destination node. - - - - - The source node(s) is dropped above (before) the destination node. - - - - - The source node(s) is dropped below (after) the destination node. - - - - - Provides data for the event of the control. - - - - - Initializes a new instance of the class. - - A list of objects representing the source (dragged) nodes. - A representing the destination node. - - A value representing the drop position of the - source node(s) with regards to the destination node. - - - - - Initializes a new instance of the class. - - A list of objects representing the source (dragged) nodes. - A string representing the id of the HTML element on which the source nodes are dropped. - - - - Gets the source (dragged) node. - - - A object representing the currently dragged node. The first dragged node is - returned if there is more than one dragged node. - - - - - Gets the destination node. - - - A object representing the destination node. - - - - - Gets all source (dragged) nodes. - - - A list of object representing the source nodes. - - - - - Gets or sets the position at which the user drops the source node(s) with regards to the destination nodes. - - - One of the enumeration values. - - - - - Gets or sets the ID of the HTML element on which the source node(s) is dropped. - - - A string representing the ID of the HTML element on which the source node(s) is dropped. - - - - - Provides data for the event of the control. - - - - - Provides data for the , , - , , - and - events of the control. - - - - - Initializes a new instance of the class. - - - A which represents a node in the control. - - - - - Gets the referenced node in the control when the event is raised. - - - The referenced node in the control when the event is raised. - - - Use this property to programmatically access the node referenced in the control when the event is raised. - - - - - Initializes a new instance of the class - - A object representing the node being edited. - A string representing the text entered by the user. - - - - Gets the text which the user entered during node editing. - - - - - Represents the method that handles the event provided by the control. - - - - - Represents the method that handles the event provided by the control. - - - - - Represents the method that handles the , , - , , - and - events provided by the control. - - - - - Data class used for transferring tree nodes from and to web services. - - - For information about the role of each property see the - class. - - - - - See RadTreeNode.ExpandMode. - - - - - See RadTreeNode.NavigateUrl. - - - - - See RadTreeNode.PostBack. - - - - - The CssClass of the RadTreeNode. - - - - - See RadTreeNode.DisabledCssClass. - - - - - See RadTreeNode.SelectedCssClass. - - - - - See RadTreeNode.ContentCssClass. - - - - - See RadTreeNode.HoveredCssClass. - - - - - See RadTreeNode.ImageUrl. - - - - - See RadTreeNode.HoveredImageUrl. - - - - - See RadTreeNode.DisabledImageUrl. - - - - - See RadTreeNode.ExpandedImageUrl. - - - - - See RadTreeNode.ContextMenuID. - - - - - Represents the simple binding between the property value of an object and the property value of a - RadTreeNode. - - - - - Specifies the exact value of the ContextMenuID property of the - RadTreeNode that will be created during the data binding. - - - - - Specifies the field, containing the ContextMenuID property - value of the RadTreeNode that will be created during - the data binding. - - - - - Specifies the exact value of the AllowDrag property of the - RadTreeNode that will be created during the data binding. - - - - - Specifies the field, containing the AllowDrag property - value of the RadTreeNode that will be created during - the data binding. - - - - - Specifies the exact value of the AllowDrop property of the - RadTreeNode that will be created during the data binding. - - - - - Specifies the field, containing the AllowDrop property - value of the RadTreeNode that will be created during - the data binding. - - - - - Specifies the exact value of the AllowEdit property of the - RadTreeNode that will be created during the data binding. - - - - - Specifies the field, containing the AllowEdit property - value of the RadTreeNode that will be created during - the data binding. - - - - - Specifies the exact value of the Category property of the - RadTreeNode that will be created during the data binding. - - - - - Specifies the field, containing the Category property - value of the RadTreeNode that will be created during - the data binding. - - - - - Specifies the exact value of the Checkable property of the - RadTreeNode that will be created during the data binding. - - - - - Specifies the field, containing the Checkable property - value of the RadTreeNode that will be created during - the data binding. - - - - - Specifies the exact value of the Checked property of the - RadTreeNode that will be created during the data binding. - - - - - Specifies the field, containing the Checked property - value of the RadTreeNode that will be created during - the data binding. - - - - - Specifies the exact value of the DisabledCssClass property of the - RadTreeNode that will be created during the data binding. - - - - - Specifies the field, containing the DisabledCssClass property - value of the RadTreeNode that will be created during - the data binding. - - - - - Specifies the exact value of the DisabledImageUrl property of the - RadTreeNode that will be created during the data binding. - - - - - Specifies the field, containing the DisabledImageUrl property - value of the RadTreeNode that will be created during - the data binding. - - - - - Specifies the exact value of the EnableContextMenu property of the - RadTreeNode that will be created during the data binding. - - - - - Specifies the field, containing the EnableContextMenu property - value of the RadTreeNode that will be created during - the data binding. - - - - - Specifies the exact value of the Expanded property of the - RadTreeNode that will be created during the data binding. - - - - - Specifies the field, containing the Expanded property - value of the RadTreeNode that will be created during - the data binding. - - - - - Specifies the exact value of the ExpandedImageUrl property of the - RadTreeNode that will be created during the data binding. - - - - - Specifies the field, containing the ExpandedImageUrl property - value of the RadTreeNode that will be created during - the data binding. - - - - - Specifies the exact value of the ExpandMode property of the - RadTreeNode that will be created during the data binding. - - - - - Specifies the field, containing the ExpandMode property - value of the RadTreeNode that will be created during - the data binding. - - - - - Specifies the exact value of the HoveredCssClass property of the - RadTreeNode that will be created during the data binding. - - - - - Specifies the field, containing the HoveredCssClass property - value of the RadTreeNode that will be created during - the data binding. - - - - - Specifies the exact value of the SelectedCssClass property of the - RadTreeNode that will be created during the data binding. - - - - - Specifies the field, containing the SelectedCssClass property - value of the RadTreeNode that will be created during - the data binding. - - - - - Specifies the exact value of the ContentCssClass property of the - RadTreeNode that will be created during the data binding. - - - - - Specifies the field, containing the ContentCssClass property - value of the RadTreeNode that will be created during - the data binding. - - - - - Specifies the exact value of the SelectedImageUrl property of the - RadTreeNode that will be created during the data binding. - - - - - Specifies the field, containing the SelectedImageUrl property - value of the RadTreeNode that will be created during - the data binding. - - - - - Defines the relationship between a data item and the menu item it is binding to in a - control. - - - - - Gets the object at the specified index in - the current . - - - The zero-based index of the to retrieve. - - - The at the specified index in the - current . - - - - - Represents the animation settings like type and duration for the control. - - - - Gets or sets the duration in milliseconds of the animation. - - An integer representing the duration in milliseconds of the animation. - The default value is 200 milliseconds - - - - - For internal use only. - - - - - - - For internal use only. - - - - - - - For internal use only. - - - - - - - Represents the method that will handle the event that has an - UploadedFileEventArgs event data. - - The RadUpload instance which fired the event. - An UploadedFileEventArgs that contain the event data. - - - - UploadedFileEventArgs is the base class for the RadUpload event data. - - - - Gets the currently processed UploadedFile. - - UploadedFile object that contains information about - the currently processed file. - - - The following example demonstrates how to use the - UploadedFile property to save a file in the - FileExists event. - - Private Sub RadUpload1_FileExists(ByVal sender As Object, ByVal e As WebControls.UploadedFileEventArgs) Handles RadUpload1.FileExists - Dim TheFile As Telerik.WebControls.UploadedFile = e.UploadedFile - - e.UploadedFile.SaveAs(Path.Combine(RadUpload1.TargetFolder, TheFile.GetName + "1" + TheFile.GetExtension)) - End Sub - - - private void RadUpload1_FileExists(object sender, Telerik.WebControls.UploadedFileEventArgs e) - { - Telerik.WebControls.UploadedFile TheFile = e.UploadedFile; - - TheFile.SaveAs(Path.Combine(RadUpload1.TargetFolder, TheFile.GetName() + "1" + TheFile.GetExtension())); - } - - - - - - Represents the method that will handle the custom validation event. - - The RadUpload instance which fired the event. - - A ValidateFileEventArgs that contain the - event data. - - - - - Provides data for the ValidatingFile - event of the RadUpload control. - - - - A ValidatingFileEventArgs is passed to the - ValidatingFile event handler to - provide event data to the handler. The - ValidatingFile event event is raised - when validation is performed on the server. This allows you to perform a custom - server-side validation routine on a file of a - RadUpload control. - - - - - - Gets or sets whether the value specified by - UploadedFile property passed - validation. - - - true to indicate that the value specified by the - UploadedFile property passed - validation; otherwise, false - - - - Once your validation routine finishes, use the IsValid - property to indicate whether the value specified by the - UploadedFile property - passed validation. This value determines whether the file from the - RadUpload control passed validation. - - - - This example demonstrates how to implement validation for filenames. - - Private Sub RadUpload1_ValidatingFile(ByVal sender As Object, ByVal e As WebControls.ValidateFileEventArgs) Handles RadUpload1.ValidatingFile - If e.UploadedFile.GetExtension.ToLower() = ".zip" Then - 'The zip files are not allowed for upload - e.IsValid = False - End If - End Sub - - - private void RadUpload1_ValidatingFile(object sender, ValidateFileEventArgs e) - { - if (e.UploadedFile.GetExtension().ToLower() == ".zip") - { - //The zip files are not allowed for upload - e.IsValid = false; - } - } - - - - - - Gets or sets whether the internal validation should continue validating the file - specified by the UploadedFile property. - - - false to indicate that the internal validation should validate - the file specified by the UploadedFile property; otherwise, - true - - - Once your validation routine finishes, use the SkipInternalValidation - property to skip the internal validation provided by the RadUpload - control. - - - This example demostrates how to implement custom validation for specific file type. - - - Private Sub RadUpload1_ValidatingFile(ByVal sender As Object, ByVal e As WebControls.ValidateFileEventArgs) Handles RadUpload1.ValidatingFile - If e.UploadedFile.GetExtension.ToLower = ".zip" Then - Dim maxZipFileSize As Integer = 10000000 '~10MB - If e.UploadedFile.ContentLength > maxZipFileSize Then - e.IsValid = False - End If - 'The zip files are not validated for file size, extension and mime type - e.SkipInternalValidation = True - End If - End Sub - - - private void RadUpload1_ValidatingFile(object sender, ValidateFileEventArgs e) - { - if (e.UploadedFile.GetExtension().ToLower() == ".zip") - { - int maxZipFileSize = 10000000; //~10MB - if (e.UploadedFile.ContentLength > maxZipFileSize) - { - e.IsValid = false; - } - //The zip files are not validated for file size, extension and content type - e.SkipInternalValidation = true; - } - } - - - MaxFileSize Property (Telerik.WebControls.RadUpload) - AllowedMimeTypes Property (Telerik.WebControls.RadUpload) - AllowedFileExtensions Property (Telerik.WebControls.RadUpload) - - - - Derives from HttpWorker request; Updates the current RadProgressContext - with upload progress information; - - - - - Stores a single request field - header data and body info (does not hold the entire body). - No boundary here. - - - - - Continuously fills the current request field member (header or body); - - The byte data of the current request field - Indicates if this is the last chunk of information - - - - Returns null if the header is not complete yet: - - - - - Records field information - - the raw byte array for the field (if the entire field is in the byte array, - this would include the header and the body) - indicates if this is the final part of the field body data (e.g., in terms - of the request parser - if the boundary is reached after this field) - - - - Contains only fields with complete headers - - - - - The most current field, which header is complete - - -
-