NGWS SDK Documentation  

This is preliminary documentation and subject to change.
To comment on this topic, please send us email at ngwssdk@microsoft.com. Thanks!

ToolBar Properties

The properties of the ToolBar class are listed below. For a complete list of ToolBar class members, see the ToolBar Members topic.

Public:

AccessibilityObject (inherited from RichControl) The Accessibility Object for this RichControl
AccessibleDefaultActionDescription (inherited from RichControl) The default action description of the control
AccessibleDescription (inherited from RichControl) The accessible description of the control
AccessibleHelpProvider (inherited from RichControl) The help provider for this RichControl
AccessibleName (inherited from RichControl) The accessible name of the control
AccessibleRole (inherited from RichControl) The accessible role of the control
AllowDrop (inherited from RichControl) The allowDrop property. If allowDrop is set to true then this control will allow drag and drop operations and events to be used.
AllowTransparency (inherited from RichControl) Determines if the control should be allowed to have the opacity adjusted. This is primarily a performance optimization, in that you can always set the opacity to any value, and that will force AllowTransparency to true. However, setting the opacity to any given value will switch the control into layered mode. By setting the AllowTransparency property to false the control will actually switch out of layered mode, which provides better performance if you don't intend to adjust the opacity.
Anchor (inherited from RichControl) The current value of the anchor property. The anchor property determines which edges of the control are anchored to the container's edges.
Appearance Indicates what special appearance characteristics the ToolBar will have. Examples would be normal or a non-3D flat appearance.
AutoSize Indicates whether or not the ToolBar control will try and maintain it's own size based on image size, or whether it will just honour any size.
BackColor [To be supplied.]
BackgroundImage (inherited from RichControl) The background image of the control.
BindingManager (inherited from RichControl) [To be supplied.]
Bindings (inherited from RichControl) Retrieves the bindings for this control.
BorderStyle The kind of border around this control.
Bottom (inherited from Control) The bottom coordinate of this control.
Bounds (inherited from Control) The bounds of this control. This is the window coordinates of the control in parent client coordinates.
Buttons The collection of buttons belonging to the toolbar.
ButtonSize The size of a button in the ToolBar. If this is not set, the ToolBar control computes this value on it's own.
CanFocus (inherited from Control) Checks if this control can receive focus. The result is true if the control has a handle and if it and all of its parent controls are both visible and enabled.
CanSelect (inherited from Control) Checks if this control can be selected. The result is true if the control is contained in a form and if all of its parent controls are both visible and enabled.
Capture (inherited from Control) If this control has captured the mouse then this will return true.
CausesValidation (inherited from Control) Indicates whether entering this control causes validation on the controls requiring validation. This is set to false usually for things like the Help button, etc...
ClientRectangle (inherited from Control) The client rect of the control.
ClientSize (inherited from Control) The size of the clientRect.
CompanyName (inherited from RichControl) Retrieves the company name of this specific component.
ContainsFocus (inherited from Control) Indicates whether the control or one of its children currently has the system focus.
ContextMenu (inherited from RichControl) The contextMenu associated with this control. The contextMenu will be shown when the user right clicks the mouse on the control.
Controls (inherited from Control) Collection of child controls.
Created (inherited from Control) Returns true if the control has been created.
Cursor (inherited from RichControl) Retrieves the cursor that will be displayed when the mouse is over this control.
DisplayRectangle (inherited from Control) Returns the client rect of the display area of the control. For the base control class, this is identical to getClientRect. However, inheriting controls may want to change this if their client area differs from their display area.
Disposed (inherited from Control) Indicates that the control has been disposed, and is no longer a valid Windows control even though the object instance is still alive.
Disposing (inherited from Control) Indicates that the control is in the process of being beendisposed, and is no longer a valid Windows control even though the object instance is still alive.
Divider Indicates whether the ToolBar will display a visual divider at the top of it's surface. This can help distinguish the ToolBar from adjacent controls, such as Menus, etc.
Dock Sets the way in which this ToolBar is docked to its parent. We need to override this to ensure autoSizing works correctly
DropDownArrows Indicates if little down arrows will show up next to buttons whose style is DropDownButton.
Enabled (inherited from Control) The current enabled state of this control.
Focused (inherited from Control) Returns true if this control has focus.
Font (inherited from RichControl) Retrieves the current font for this control. This will be the font used by default for painting and text in the control.
ForeColor [To be supplied.]
Handle (inherited from Control) The HWND handle that this control is bound to. If the handle has not yet been created, this will force handle creation.
HandleCreated (inherited from Control) Whether or not this control has a handle associated with it.
Height (inherited from Control) The height of this control
ImageList Returns the ImageList control that has all the main images for this ToolBar.
ImageSize The method return the size of the images within the toolbar's image list.
IMEMode (inherited from RichControl) Specifies a value that determines the IME (Input Method Editor) status of the object when that object is selected.
InvokeRequired (inherited from RichControl) Determines if the caller must call invoke when making method calls to this control. Controls in WinForms are bound to a specific thread, and are not thread safe. Therefore, if you are calling a control's method from a different thread, you must use the control's invoke method to marshal the call to the proper thread. This function can be used to determine if you must call invoke, which can be handy if you don't know what thread owns a control. There are five functions on a control that are safe to call from any thread: GetInvokeRequired, Invoke, BeginInvoke, EndInvoke and CreateGraphics. For all other metohd calls, you should use one of the invoke methods.
IsAccessible (inherited from RichControl) Indicates whether or not this control is an accessible control i.e. whether it should be visible to accessibility applications.
Left (inherited from Control) The left coordinate of this control.
Location (inherited from Control) The location of this control.
Opacity (inherited from RichControl) Determines the opacity of the control. This can only be set on top level controls. Opacity requires Windows 2000 or later, and is ignored on earlier operating systems.
Parent (inherited from Control) The parent of this control.
ProductName (inherited from RichControl) Retrieves the product name of this specific component.
ProductVersion (inherited from RichControl) Retrieves the product version of this specific component.
RecreatingHandle (inherited from Control) This is true if the control is currently recreating its handle.
Region (inherited from RichControl) The Region associated with this control. (defines the outline/silhouette/boundary of control)
Right (inherited from Control) The right coordinate of this control.
RightToLeft (inherited from RichControl) This is used for international applications where the language is written from RightToLeft. When this property is true, control placement and text will be from right to left.
ShowToolTips Indicates whether or not the ToolBar will show tooltips for each button. The text of the tip is controlled by the get/setToolTipText methods on the ToolBarButton object.
Site (inherited from RichControl) [To be supplied.]
Size (inherited from Control) The size of this control.
TabIndex (inherited from Control) The tab index of this control. A tab index may consist of any valid integer number greater than or equal to zero. If more than one control on the same parent control has the same tab index, the z-order of the controls will be used to determine the order to pick the controls.
TabStop [To be supplied.]
Text [To be supplied.]
TextAlign Indicates whether the text will be replaced with regards the image in the buttons. They can be placed underneath, or to the right of an image in the button.
Top (inherited from Control) Top coordinate of this control.
TopLevel (inherited from Control) true if this control is a top level window, meaning that it has no parent.
TopLevelControl (inherited from Control) The top level control that contains this control. This doesn't have to be the same as the value returned from getForm since forms can be parented to other controls.
Visible (inherited from Control) Controls whether the control is visible.
Width (inherited from Control) The width of this control.
WindowTarget (inherited from Control) The target of Win32 window messages.
Wrappable ToolBar buttons can optionally "wrap" to the next line when the ToolBar becomes too narrow to include all buttons on the same line. Wrapping occurs on separation and nongroup boundaries. This controls whether this is turned on.

Protected:

CreateParams (inherited from RichControl) [To be supplied.]
CreateThreadId (inherited from Control) Retrieves the Win32 thread ID of the thread that created the handle for this control. If the control's handle hasn't been created yet, this method will return the current thread's ID.
FontHeight (inherited from RichControl) [To be supplied.]
InternalHandle (inherited from Control) Returns the current value of the handle. This may be zero if the handle has not been created.
ParkingFormHandle (inherited from RichControl) [To be supplied.]
RenderRightToLeft (inherited from RichControl) [To be supplied.]
RichParent (inherited from RichControl) [To be supplied.]
WindowText (inherited from Control) The current text of the Window; if the window has not yet been created, stores it in the control. If the window has been created, stores the text in the underlying win32 control. This property should be used whenever you want to get at the win32 control's text. For all other cases, use the Text property- but note that this is overridable, and any of your code that uses it will use the overridden version in controls that subclass your own.

See Also

ToolBar Class | System.WinForms Namespace