Skip to main content
A newer version of this page is available. .

NavBarControl Properties

Implements a side navigation UI found in MS Office or MS Explorer.
Name Description
AccessibilityObject Gets the AccessibleObject assigned to the control. Inherited from Control.
AccessibleDefaultActionDescription Gets or sets the default action description of the control for use by accessibility client applications. Inherited from Control.
AccessibleDescription Gets or sets the description of the control used by accessibility client applications. Inherited from Control.
AccessibleName Gets or sets the name of the control used by accessibility client applications. Inherited from Control.
AccessibleRole Gets or sets the accessible role of the control. Inherited from Control.
ActiveGroup Returns an object representing the currently active group.
ActiveGroupName This member supports the .NET Framework infrastructure and cannot be used directly from your code.
AllowDrop Gets or sets a value that specifies whether the XtraNavBar can accept data that an end-user drags onto it.
AllowGlyphSkinning Gets or sets whether all items within the current NavBarControl should paint their icons in the items’ foreground colors.
AllowHorizontalResizing Gets or sets whether a built-in resizer is enabled at the control’s right or left edge (depending on the control’s Dock setting) that allows an end-user to resize the control horizontally.
AllowHtmlString Gets or sets whether the group and item captions are formatted using HTML tags.
AllowSelectedLink Obsolete. This property is obsolete. Use the NavBarControl.LinkSelectionMode property instead.
Anchor Gets or sets the edges of the container to which a control is bound and determines how a control is resized with its parent. Inherited from Control.
Appearance Provides access to the properties that control the appearance of the NavBarControl’s elements.
AutoScrollOffset Gets or sets where this control is scrolled to in ScrollControlIntoView(Control). Inherited from Control.
AutoSize This property is not relevant for this class. Inherited from Control.
AvailableNavBarViews Provides access to the collection of BaseViewInfoRegistrator objects which contain information on painting corresponding Views.
BackColor Gets or sets the background color for the control. Inherited from Control.
BackgroundImage This property is not supported by the NavBarControl class.
BackgroundImageLayout This property is not supported by the NavBarControl class.
BindingContext Gets or sets the BindingContext for the control. Inherited from Control.
BorderStyle Gets or sets the border style of the NavBarControl.
Bottom Gets the distance, in pixels, between the bottom edge of the control and the top edge of its container’s client area. Inherited from Control.
Bounds Gets or sets the size and location of the control including its nonclient elements, in pixels, relative to the parent control. Inherited from Control.
CanEnableIme protected Gets a value indicating whether the ImeMode property can be set to an active value, to enable IME support. Inherited from Control.
CanFocus Gets a value indicating whether the control can receive focus. Inherited from Control.
CanRaiseEvents protected Determines if events can be raised on the control. Inherited from Control.
CanSelect Gets a value indicating whether the control can be selected. Inherited from Control.
Capture Gets or sets a value indicating whether the control has captured the mouse. Inherited from Control.
CausesValidation Gets or sets a value indicating whether the control causes validation to be performed on any controls that require validation when it receives focus. Inherited from Control.
CheckForIllegalCrossThreadCalls static Gets or sets a value indicating whether to catch calls on the wrong thread that access a control’s Handle property when an application is being debugged. Inherited from Control.
ClientRectangle Gets the rectangle that represents the client area of the control. Inherited from Control.
ClientSize Gets or sets the height and width of the client area of the control. Inherited from Control.
CompanyName Gets the name of the company or creator of the application containing the control. Inherited from Control.
Container Gets the IContainer that contains the Component. Inherited from Component.
ContainsFocus Gets a value indicating whether the control, or one of its child controls, currently has the input focus. Inherited from Control.
ContentButtonHint Gets or sets the content button’s hint.
ContextMenu Gets or sets the shortcut menu associated with the control. Inherited from Control.
ContextMenuStrip Gets or sets the ContextMenuStrip associated with this control. Inherited from Control.
Controls Gets the collection of controls contained within the control. Inherited from Control.
Created Gets a value indicating whether the control has been created. Inherited from Control.
CreateParams protected Gets the required creation parameters when the control handle is created. Inherited from Control.
Cursor Gets or sets a value specifying the cursor type used when the mouse pointer is over the control, but is not over a group caption or a link.
DataBindings Gets the data bindings for the control. Inherited from Control.
DefaultBackColor static Gets the default background color of the control. Inherited from Control.
DefaultCursor protected Gets or sets the default cursor for the control. Inherited from Control.
DefaultFont static Gets the default font of the control. Inherited from Control.
DefaultForeColor static Gets the default foreground color of the control. Inherited from Control.
DefaultImeMode protected Gets the default Input Method Editor (IME) mode supported by the control. Inherited from Control.
DefaultMargin protected Gets the space, in pixels, that is specified by default between controls. Inherited from Control.
DefaultMaximumSize protected Gets the length and height, in pixels, that is specified as the default maximum size of a control. Inherited from Control.
DefaultMinimumSize protected Gets the length and height, in pixels, that is specified as the default minimum size of a control. Inherited from Control.
DefaultPadding protected Gets the internal spacing, in pixels, of the contents of a control. Inherited from Control.
DesignMode protected Gets a value that indicates whether the Component is currently in design mode. Inherited from Component.
DeviceDpi Gets the DPI value for the display device where the control is currently being displayed. Inherited from Control.
DisplayRectangle Gets the rectangle that represents the display area of the control. Inherited from Control.
Disposing Gets a value indicating whether the base Control class is in the process of disposing. Inherited from Control.
Dock Gets or sets which control borders are docked to its parent control and determines how a control is resized with its parent. Inherited from Control.
DoubleBuffered protected Gets or sets a value indicating whether this control should redraw its surface using a secondary buffer to reduce or prevent flicker. Inherited from Control.
DragDropFlags Gets or sets a set of flags controlling the control’s behavior as it relates to link drag and drop operations.
EachGroupHasSelectedLink Obsolete. This property is obsolete. Use the NavBarControl.LinkSelectionMode property instead.
Enabled Gets or sets a value indicating whether the control can respond to user interaction. Inherited from Control.
Events protected Gets the list of event handlers that are attached to this Component. Inherited from Component.
ExplorerBarGroupInterval Gets or sets the interval (in pixels) between neighboring groups when any of the explorer views are applied.
ExplorerBarGroupOuterIndent Gets or sets the size of the horizontal indent (in pixels) between a group’s edges and the NavBarControl’s edges when any of the explorer views are applied.
ExplorerBarShowGroupButtons Gets or sets whether group expand buttons are visible within group headers (when any of the explorer bar views are applied. ).
ExplorerBarStretchLastGroup Gets or sets whether the last group in the Explorer Bar View is stretched to fill the NavBarControl.
FireDelayedSelectedLinkChangedEvent Gets whether the last added item link is selected and the NavBarControl.SelectedLinkChanged event fires as a result.
Focused Gets a value indicating whether the control has input focus. Inherited from Control.
Font Gets or sets the font of the text displayed by the control. Inherited from Control.
FontHeight protected Gets or sets the height of the font of the control. Inherited from Control.
ForeColor Gets or sets the foreground color of the control. Inherited from Control.
GroupBackgroundImage Specifies the image displayed as a background for groups.
Groups Gets a collection of objects representing groups of the NavBarControl.
GroupTextureBackgroundBrush Gets an object representing the brush used to fill a group’s background.
Handle Gets the window handle that the control is bound to. Inherited from Control.
HasChildren Gets a value indicating whether the control contains one or more child controls. Inherited from Control.
Height Gets or sets the height of the control. Inherited from Control.
HideGroupCaptions Gets or sets a value specifying whether group captions are visible.
HotTrackedGroup Gets an object representing the group over whose caption the mouse pointer rests.
HotTrackedGroupCursor Gets or sets a value specifying the cursor type used when a mouse pointer is over a group caption.
HotTrackedItemCursor Gets or sets a value specifying the cursor type used when a mouse pointer is over a group caption.
HotTrackedLink Gets an object representing the link over which the mouse pointer rests.
HtmlImages Gets or sets a collection of images that can be inserted into the group and item captions using HTML tags.
ImeMode Gets or sets the Input Method Editor (IME) mode of the control. Inherited from Control.
ImeModeBase protected Gets or sets the IME mode of a control. Inherited from Control.
InvokeRequired Gets a value indicating whether the caller must call an invoke method when making method calls to the control because the caller is on a different thread than the one the control was created on. Inherited from Control.
IsAccessible Gets or sets a value indicating whether the control is visible to accessibility applications. Inherited from Control.
IsDesignMode Gets a value indicating whether the control is currently in design mode.
IsDisposed Gets a value indicating whether the control has been disposed of. Inherited from Control.
IsHandleCreated Gets a value indicating whether the control has a handle associated with it. Inherited from Control.
IsLoading Gets a value indicating whether the control is being initialized.
IsMirrored Gets a value indicating whether the control is mirrored. Inherited from Control.
Items Gets the collection of items within the NavBarControl control.
LargeImages Gets or sets an object that serves as the source of large images used in the NavBarControl.
LayoutEngine Gets a cached instance of the control’s layout engine. Inherited from Control.
LayoutVersion Gets or sets the version of the control’s layout.
Left Gets or sets the distance, in pixels, between the left edge of the control and the left edge of its container’s client area. Inherited from Control.
LinkInterval Gets or sets the interval (in pixels) between neighboring links in a group.
LinkSelectionMode Gets or sets whether link selection is enabled and whether each group or only one group can contain a selected link simultaneously.
Location Gets or sets the coordinates of the upper-left corner of the control relative to the upper-left corner of its container. Inherited from Control.
LookAndFeel Provides access to the settings which control the NavBarControl’s look and feel.
Margin Gets or sets the space between controls. Inherited from Control.
MaximumSize Gets or sets the size that is the upper limit that GetPreferredSize(Size) can specify. Inherited from Control.
MenuManager Gets or sets an object that controls the look and feel of the control’s popup menus.
MinimumSize Gets or sets the minimal NavBarControl size.
ModifierKeys static Gets a value indicating which of the modifier keys (SHIFT, CTRL, and ALT) is in a pressed state. Inherited from Control.
MouseButtons static Gets a value indicating which of the mouse buttons is in a pressed state. Inherited from Control.
MousePosition static Gets the position of the mouse cursor in screen coordinates. Inherited from Control.
Name Gets or sets the name of the control. Inherited from Control.
NavigationPaneGroupClientHeight Gets or sets the default minimum height of the client area for the active group when the “NavigationPane” view is applied.
NavigationPaneMaxVisibleGroups Gets the maximum number of groups for which buttons are displayed within a NavBarControl when the “NavigationPane” view is applied.
NavigationPaneOverflowPanelUseSmallImages Gets or sets whether groups in the Overflow panel are represented by small or large icons.
NavPaneForm Gets the NavPane Form’s settings.
OptionsLayout Contains options that control how the NavBarControl‘s layout is stored to/restored from a stream, xml file or system registry.
OptionsNavPane Contains options that determine the appearance and behavior of the NavBarControl when the NavigationPane paint style is applied.
Padding Gets or sets padding within the control. Inherited from Control.
PaintAppearance Provides access to the appearance settings currently used to paint the NavBarControl’s elements.
PaintStyleKind Gets or sets the kind of the NavBarControl’s paint style.
PaintStyleName Gets or sets the name of the paint style applied to the NavBarControl.
Parent Gets or sets the parent container of the control. Inherited from Control.
PreferredSize Gets the size of a rectangular area into which the control can fit. Inherited from Control.
PressedGroup Gets an object representing the group whose caption is pressed.
PressedLink Gets an object representing the pressed link.
ProductName Gets the product name of the assembly containing the control. Inherited from Control.
ProductVersion Gets the version of the assembly containing the control. Inherited from Control.
PropagatingImeMode protected static Gets an object that represents a propagating IME mode. Inherited from Control.
RecreatingHandle Gets a value indicating whether the control is currently re-creating its handle. Inherited from Control.
Region Gets or sets the window region associated with the control. Inherited from Control.
RenderRightToLeft protected This property is now obsolete. Inherited from Control.
ResizeRedraw protected Gets or sets a value indicating whether the control redraws itself when resized. Inherited from Control.
Right Gets the distance, in pixels, between the right edge of the control and the left edge of its container’s client area. Inherited from Control.
RightToLeft Gets or sets a value indicating whether control’s elements are aligned to support locales using right-to-left fonts. Inherited from Control.
ScaleChildren protected Gets a value that determines the scaling of child controls. Inherited from Control.
ScaleImages Gets or sets whether icons are automatically stretched to match the current DPI settings of the user’s monitor.
ScrollMode Gets or sets a value that specifies when the NavBarControl’s content can be scrolled.
SelectedLink Gets or sets an object representing the selected link.
SelectLinkOnPress Gets or sets whether a link is selected on the MouseDown or MouseUp event.
SharedImageCollectionImageSizeMode Gets or sets the value that specifies how the display size of images is determined when the images are obtained from a SharedImageCollection.
ShowFocusCues protected Gets a value indicating whether the control should display focus rectangles. Inherited from Control.
ShowGroupHint Gets or sets a value specifying whether group hints are displayed.
ShowHintInterval Gets or sets the time interval after the mouse pointer stops over an element and before its hint is displayed.
ShowIcons Gets or sets whether link icons are shown.
ShowKeyboardCues protected Gets a value indicating whether the user interface is in the appropriate state to show or hide keyboard accelerators. Inherited from Control.
ShowLinkHint Gets or sets a value specifying whether link hints are displayed.
Site Gets or sets the site of the control. Inherited from Control.
Size Gets or sets the height and width of the control. Inherited from Control.
SkinExplorerBarViewScrollStyle Gets or sets how the control is scrolled when a skinning Explorer Bar View paint scheme is applied.
SmallImages Gets or sets an object that serves as the source of small images used in the NavBarControl.
State Gets a value indicating the control’s state.
StoreDefaultPaintStyleName This member supports the .NET Framework infrastructure and cannot be used directly from your code.
SuspendFormLayoutInAnimation This member supports the internal infrastructure, and is not intended to be used directly from your code.
TabIndex Gets or sets the tab order of the control within its container. Inherited from Control.
TabStop Gets or sets a value indicating whether a user can focus this control using the TAB key.
Tag Gets or sets the object that contains data about the control. Inherited from Control.
Text Gets or sets the text associated with this control. Inherited from Control.
ToolTipController Gets or sets the tooltip controller component that controls the appearance, position and the content of the hints displayed by the XtraNavBar control.
Top Gets or sets the distance, in pixels, between the top edge of the control and the top edge of its container’s client area. Inherited from Control.
TopLevelControl Gets the parent control that is not parented by another Windows Forms control. Typically, this is the outermost Form that the control is contained in. Inherited from Control.
UseWaitCursor Gets or sets a value indicating whether to use the wait cursor for the current control and all child controls. Inherited from Control.
View Gets or sets an object specifying the control’s paint style.
ViewName Gets or sets the name of the View that specifies the paint scheme.
Visible Gets or sets a value indicating whether the control and all its child controls are displayed. Inherited from Control.
Width Gets or sets the width of the control. Inherited from Control.
WindowTarget This property is not relevant for this class. Inherited from Control.
See Also