Version

Items Class

Primary collection of Toolbar items belonging to the UltraWebToolbar element.
Syntax
'Declaration
 
Public Class Items 
   Inherits KeyedObjectCollectionBase
public class Items : KeyedObjectCollectionBase 
Remarks

The items constituting the UltraWebToolbar may be of varied types, including: TBarButton, TBButtonGroup, TBLabel, TBSeparator, TBTextBox, and TBCustom wrappers around any additional System.Web.UI.Control.

All of these supported types, except for TBCustom, are derived from the base class, TBObject. The TBCustom type is derived from WebControl permitting it to act as a host (container) of other ASP.NET controls.

The Items collection offers both integer-based indexing of its contents, as well as Key-based retrieval. For the most flexible and robust applications, developers are encouraged to assign a unique Key to each item added to the collection and then use FromKey or a related method (i.e., FromKeyIButton, et al.) to lookup items.

When creating dynamic instances of Toolbar items, developers must add the item to it's eventual collection before making property settings on the item. Certain complex properties (such as the DefaultStyle) may not properly persist in viewstate across postbacks when they are attached to a Toolbar item before it has been included in a collection attached to the server control (as the Items is attached). The act of adding an item to this collection, precisely because it is in direct contact with the UltraWebToolbar element, is what triggers tracking of viewstate for these properties.

Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

See Also