ControlBar#

Qualified name: delphivcl.ControlBar

class ControlBar#

Bases: CustomControl

TControlBar manages the layout of toolbar components. Use TControlBar as a docking site for toolbar components. Control bars contain child controls (usually TToolBar objects) that can be moved and resized independently. As with a cool bar, each child control resides on its own individual band that the user positions by dragging its sizing grip.

Tip: When docking TToolBar objects to a control bar, you may find it useful to use TToolDockObject. Note: If you want to use TActionToolBar on a TControlBar component, you should set the AutoSize property to False. When the AutoSize property is set to True (default), the TActionToolBar control wraps its controls and expands itself in size, accordingly. This does not allow the TActionToolBar component to display properly on a TControlBar component. When the AutoSize property is set to False, the TActionToolBar hides items on the end of the bar and displays a dropdown button that provides access to those items. The control displays in the proper size.

Methods

CanFocus

Indicates whether a control can receive focus.

SetFocus

Gives the input focus to the control.

Attributes

Action

Specifies the action associated with the control.

Align

Determines how the control aligns within its container (parent control).

AlignDisabled

Indicates child control realignment disabled.

AlignWithMargins

Specifies whether a control should be constrained by margins.

Anchors

Specifies how the control is anchored to its parent.

AutoDock

<Delphi property AutoDock of type TControlBar at 21141D08340>

AutoDrag

<Delphi property AutoDrag of type TControlBar at 21141D08410>

AutoSize

Specifies whether the control sizes itself automatically to accommodate its contents.

BevelEdges

Specifies which edges of the control are beveled.

BevelInner

Specifies the cut of the inner bevel.

BevelKind

Specifies the control's bevel style.

BevelOuter

Specifies the cut of the outer bevel.

BevelWidth

Specifies the width of the inner and outer bevels.

BiDiMode

Specifies the bidirectional mode for the control.

BorderWidth

Specifies the width of the control's border.

BoundsRect

Specifies the bounding rectangle of the control, expressed in the coordinate system of the parent control.

Brush

Determines the color and pattern used for painting the background of the control.

Canvas

Specifies the TCanvas object that presents a drawing surface for the control.

ClassName

Returns the TObject.ClassName

ClientHeight

Specifies the height of the control's client area in pixels.

ClientOrigin

Specifies the screen coordinates (in pixels) of the upper-left corner of a control's client area.

ClientRect

Specifies the size of a control's client area in pixels.

ClientWidth

Specifies the horizontal size of the control's client area in pixels.

Color

Specifies the background color of the control.

ComObject

Specifies the interface reference implemented by the component.

ComponentCount

Indicates the number of components owned by the component.

ComponentIndex

Indicates the position of the component in its owner's Components property array.

ComponentState

Describes the current state of the component, indicating when a component needs to avoid certain actions.

ComponentStyle

Governs the behavior of the component.

Components

<Delphi indexed property Components of type TComponent at 21141642500>

Constraints

Specifies the size constraints for the control.

ControlCount

Returns the count of contained controls

ControlState

Specifies the current state of a control at run time.

ControlStyle

Determines style characteristics of the control.

Controls

Returns an iterator over contained controls

CornerEdge

<Delphi property CornerEdge of type TControlBar at 21141D08C30>

CurrentPPI

Embarcadero Technologies does not currently have any additional information.

Cursor

Specifies the image used to represent the mouse pointer when it passes into the region covered by the control.

CustomHint

CustomHint is a custom hint for the control.

DesignInfo

Contains information used by the Form designer.

DockClientCount

Specifies the number of controls that are docked on the windowed control.

DockClients

<Delphi indexed property DockClients of type TWinControl at 211416EE520>

DockManager

Specifies the control's docking manager interface.

DockOrientation

DockOrientation specifies how the control is docked relative to other controls docked in the same parent.

DockSite

Specifies whether the control can be the target of drag-and-dock operations.

DoubleBuffered

Determines whether the control's image is rendered directly to the window or painted to an in-memory bitmap first.

DragCursor

Specifies the image used to represent the mouse pointer when the control is being dragged.

DragKind

Specifies whether the control is being dragged normally or for docking.

DragMode

Specifies how the control initiates drag-and-drop or drag-and-dock operations.

DrawingStyle

<Delphi property DrawingStyle of type TControlBar at 21141D09040>

Enabled

Controls whether the control responds to mouse, keyboard, and timer events.

ExplicitHeight

Specifies the explicit vertical size of the control in pixels.

ExplicitLeft

Specifies the explicit horizontal pixel coordinate of the left edge of a component relative to its parent.

ExplicitTop

Specifies the explicit vertical pixel coordinate of the top edge of a component relative to its parent.

ExplicitWidth

Specifies the explicit horizontal size of the control in pixels.

Floating

Specifies whether the control is floating.

FloatingDockSiteClass

Specifies the class of the temporary control that hosts the control when it is floating.

Focused

Determines whether the control has input focus.

GradientDirection

<Delphi property GradientDirection of type TControlBar at 21141D091E0>

GradientEndColor

<Delphi property GradientEndColor of type TControlBar at 21141D092B0>

GradientStartColor

<Delphi property GradientStartColor of type TControlBar at 21141D09380>

Handle

Provides access to the underlying Windows screen object for the control.

HandleAllocated

Reports whether a screen object handle exists for the control.

Height

Specifies the vertical size of the control in pixels.

HelpContext

The HelpContext property contains the numeric context ID that identifies the Help topic for the control.

HelpKeyword

The HelpKeyword property contains the keyword string that identifies the Help topic for the control.

HelpType

Specifies whether the control's context-sensitive Help topic is identified by a context ID or by keyword.

Hint

Hint contains the text string that appears when the user moves the mouse over the control.

HostDockSite

Specifies the control in which the control is docked.

IsDrawingLocked

IsDrawingLocked property returns True when redrawing for this control is locked.

LRDockWidth

Specifies the width of the control when it is docked horizontally.

Left

Specifies the horizontal coordinate of the left edge of a component relative to its parent.

Margins

Specifies the margins of the control.

MouseInClient

Indicates whether the mouse pointer is currently in the client area of the control.

Name

Specifies the name of the component as referenced in code.

Observers

Indicates the TObservers object added to the TComponent.

OnAlignInsertBefore

<Delphi property OnAlignInsertBefore of type TControlBar at 21141D09FB0>

OnAlignPosition

<Delphi property OnAlignPosition of type TControlBar at 21141D0A080>

OnBandDrag

<Delphi property OnBandDrag of type TControlBar at 21141D0A150>

OnBandInfo

<Delphi property OnBandInfo of type TControlBar at 21141D0A220>

OnBandMove

<Delphi property OnBandMove of type TControlBar at 21141D0A2F0>

OnBandPaint

<Delphi property OnBandPaint of type TControlBar at 21141D0A3C0>

OnBeginBandMove

<Delphi property OnBeginBandMove of type TControlBar at 21141D0A490>

OnCanResize

<Delphi property OnCanResize of type TControlBar at 21141D0A630>

OnClick

<Delphi property OnClick of type TControlBar at 21141D0A700>

OnConstrainedResize

<Delphi property OnConstrainedResize of type TControlBar at 21141D0A7D0>

OnContextPopup

<Delphi property OnContextPopup of type TControlBar at 21141D0A8A0>

OnDblClick

<Delphi property OnDblClick of type TControlBar at 21141D0AB10>

OnDockDrop

<Delphi property OnDockDrop of type TControlBar at 21141D0A970>

OnDockOver

<Delphi property OnDockOver of type TControlBar at 21141D0AA40>

OnDragDrop

<Delphi property OnDragDrop of type TControlBar at 21141D0ABE0>

OnDragOver

<Delphi property OnDragOver of type TControlBar at 21141D0ACB0>

OnEndBandMove

<Delphi property OnEndBandMove of type TControlBar at 21141D0A560>

OnEndDock

<Delphi property OnEndDock of type TControlBar at 21141D0AD80>

OnEndDrag

<Delphi property OnEndDrag of type TControlBar at 21141D0AE50>

OnEnter

<Delphi property OnEnter of type TControlBar at 21141D0AF20>

OnExit

<Delphi property OnExit of type TControlBar at 21141D0AFF0>

OnGesture

<Delphi property OnGesture of type TControlBar at 21141D0B0C0>

OnGetSiteInfo

<Delphi property OnGetSiteInfo of type TControlBar at 21141D0B190>

OnMouseActivate

<Delphi property OnMouseActivate of type TControlBar at 21141D0B260>

OnMouseDown

<Delphi property OnMouseDown of type TControlBar at 21141D0B330>

OnMouseEnter

<Delphi property OnMouseEnter of type TControlBar at 21141D0B400>

OnMouseLeave

<Delphi property OnMouseLeave of type TControlBar at 21141D0B4D0>

OnMouseMove

<Delphi property OnMouseMove of type TControlBar at 21141D0B5A0>

OnMouseUp

<Delphi property OnMouseUp of type TControlBar at 21141D0B670>

OnPaint

<Delphi property OnPaint of type TControlBar at 21141D0B740>

OnResize

<Delphi property OnResize of type TControlBar at 21141D0B810>

OnStartDock

<Delphi property OnStartDock of type TControlBar at 21141D0B8E0>

OnStartDrag

<Delphi property OnStartDrag of type TControlBar at 21141D0B9B0>

OnUnDock

<Delphi property OnUnDock of type TControlBar at 21141D0BA80>

Owner

Indicates the component that is responsible for streaming and freeing this component.

Padding

Specifies the padding of a control.

Parent

Returns/Sets the Control Parent

ParentBackground

Determines whether the control uses its parent's theme background.

ParentColor

Specifies where a control looks for its color information.

ParentCtl3D

Determines where a component looks to determine whether it should have a three-dimensional look.

ParentCustomHint

Specifies where a control looks for its custom hint.

ParentDoubleBuffered

ParentDoubleBuffered defers the DoubleBuffered property of this component to the value of the parent's DoubleBuffered property.

ParentFont

Specifies where a control looks for its font information.

ParentShowHint

Specifies where a control looks to find out if its Help Hint should be shown.

ParentWindow

Reference to parent's underlying control.

Picture

<Delphi property Picture of type TControlBar at 21141D09860>

PixelsPerInch

Embarcadero Technologies does not currently have any additional information.

PopupMenu

Specifies the pop-up menu associated with the control.

RedrawDisabled

RedrawDisabled property returns True when redrawing for this control is locked.

RowSize

<Delphi property RowSize of type TControlBar at 21141D09A00>

RowSnap

<Delphi property RowSnap of type TControlBar at 21141D09AD0>

ScaleFactor

Embarcadero Technologies does not currently have any additional information.

ShowHint

ShowHint specifies whether to show the Help Hint when the mouse pointer moves over the control.

Showing

Indicates whether the control is showing on the screen.

StyleElements

Specifies the style elements that are used by the control.

StyleName

Embarcadero Technologies does not currently have any additional information.

TBDockHeight

Specifies the height of the control when it is docked vertically.

TabOrder

Indicates the position of the control in its parent's tab order.

TabStop

Determines whether the user can tab to a control.

Tag

Stores a NativeInt integral value as a part of a component.

Top

Specifies the Y coordinate of the upper-left corner of a control, relative to its parent or containing control in pixels.

Touch

Specifies the touch manager component associated with the control.

UndockHeight

Specifies the height of the control when it is floating.

UndockWidth

Specifies the width of the control when it is floating.

UseDockManager

Specifies whether the docking manager is used in drag-and-dock operations.

VCLComObject

Represents information used internally by components that support COM.

Visible

Specifies whether the component appears onscreen.

VisibleDockClientCount

Specifies the number of visible controls that are docked on the windowed control.

Width

Specifies the horizontal size of the control or form in pixels.

WindowProc

<Delphi property WindowProc of type TControl at 211418EC1C0>

Align#

Determines how the control aligns within its container (parent control). Use Align to align a control to the top, bottom, left, or right of a form or panel and have it remain there even if the size of the form, panel, or component that contains the control changes. When the parent is resized, an aligned control also resizes so that it continues to span the top, bottom, left, or right edge of the parent. For example, to use a panel component with various controls on it as a tool palette, change the panel’s Align value to alLeft. The value of alLeft for the Align property of the panel guarantees that the tool palette remains on the left side of the form and always equals the client height of the form. The default value of Align is alNone, which means a control remains where it is positioned on a form or panel.

Tip: If Align is set to alClient, the control fills the entire client area so that it is impossible to select the parent form by clicking it. In this case, select the parent by selecting the control on the form and pressing ESC, or by using the Object Inspector. Any number of child components within a single parent can have the same Align value, in which case they stack up along the edge of the parent. The child controls stack up in z-order. To adjust the order in which the controls stack up, drag the controls into their desired positions.

Note: To cause a control to maintain a specified relationship with an edge of its parent, but not necessarily lie along one edge of the parent, use the Anchors property instead.

Anchors#

Specifies how the control is anchored to its parent. Use Anchors to ensure that a control maintains its current position relative to an edge of its parent, even if the parent is resized. When its parent is resized, the control holds its position relative to the edges to which it is anchored. If a control is anchored to opposite edges of its parent, the control stretches when its parent is resized. For example, if a control has its Anchors property set to [akLeft, akRight], the control stretches when the width of its parent changes. Anchors is enforced only when the parent is resized. Thus, for example, if a control is anchored to opposite edges of a form at design time and the form is created in a maximized state, the control is not stretched because the form is not resized after the control is created.

Note: If a control should maintain contact with three edges of its parent (hugging one side of the parent and stretching the length of that side), use the Align property instead. Unlike Anchors, Align allows controls to adjust to changes in the size of other aligned sibling controls as well as changes to the parent’s size.

AutoDock#

<Delphi property AutoDock of type TControlBar at 21141D08340>

AutoDrag#

<Delphi property AutoDrag of type TControlBar at 21141D08410>

AutoSize#

Specifies whether the control sizes itself automatically to accommodate its contents. Use AutoSize to specify whether the control sizes itself automatically. When AutoSize is True, the control resizes automatically when its contents change. By default, AutoSize is False.

BevelEdges#

Specifies which edges of the control are beveled. Use BevelEdges to get or set which edges of the control are beveled. The BevelInner, BevelOuter, and BevelKind properties determine the appearance of the specified edges.

BevelInner#

Specifies the cut of the inner bevel. Use BevelInner to specify whether the inner bevel has a raised, lowered, or flat look. The inner bevel appears immediately inside the outer bevel. If there is no outer bevel (BevelOuter is bvNone), the inner bevel appears immediately inside the border.

BevelKind#

Specifies the control’s bevel style. Use BevelKind to modify the appearance of a bevel. BevelKind influences how sharply the bevel stands out. BevelKind, in combination with BevelWidth and the cut of the bevel specified by BevelInner or BevelOuter, can create a variety of effects. Experiment with various combinations to get the look you want.

BevelOuter#

Specifies the cut of the outer bevel. Use BevelOuter to specify whether the outer bevel has a raised, lowered, or flat look. The outer bevel appears immediately inside the border and outside the inner bevel.

BevelWidth#

Specifies the width of the inner and outer bevels. Use BevelWidth to specify the width, in pixels, of the inner and outer bevels.

BorderWidth#

Specifies the width of the control’s border. Use BorderWidth to get or set the width of the control’s border. Graphics or text drawn by the control is clipped to the area within the border.

CanFocus()#

Indicates whether a control can receive focus.

Canvas#

Specifies the TCanvas object that presents a drawing surface for the control. Use the properties of the TCanvas object to draw or paint on the surface of the control. Canvas encapsulates a Windows device context, providing all the tools and methods needed for drawing and painting. Canvas is a protected property that is usually redeclared as public in descendants of TCustomControl.

Color#

Specifies the background color of the control. Use Color to read or change the background color of the control. If a control’s Vcl.Controls.TControl.ParentColor property is True, then changing the Color property of the control’s parent automatically changes the Color property of the control. When the value of the Color property is changed, the control’s ParentColor property is automatically set to False. The Color of a TLabel is always the color of the background unless you set TLabel.Transparent to False.

Constraints#

Specifies the size constraints for the control. Use Constraints to specify the minimum and maximum width and height of the control. When Constraints contains maximum or minimum values, the control cannot be resized to violate those constraints.

Note: Constraints apply to the height of the form. However, the height of the form depends on how large Windows makes the title bar. For example, Windows XP uses much larger title bars than other windowing systems. To work around this, note the ClientHeight when you design your form and set the constraints in the FormCreate event. In the following example, ClientHeight is represented by x: Constraints.MinHeight?:= x + Height - ClientHeight. Warning: Do not set up constraints that conflict with the value of the Align or Anchors property. When these properties conflict, the response of the control to resize attempts is not well-defined.

ControlCount#

Returns the count of contained controls

Controls#

Returns an iterator over contained controls

CornerEdge#

<Delphi property CornerEdge of type TControlBar at 21141D08C30>

DockSite#

Specifies whether the control can be the target of drag-and-dock operations. Set DockSite to true to allow other controls to be docked to this windowed control.

Code Examples Docking (Delphi) Docking (C++)

DragCursor#

Specifies the image used to represent the mouse pointer when the control is being dragged. Use the DragCursor property to change the cursor image presented when the control is being dragged.

Note: To make a custom cursor available for the DragCursor property, see the Cursor property.

DragKind#

Specifies whether the control is being dragged normally or for docking. Use DragKind to get or set whether the control participates in drag-and-drop operations or drag-and-dock operations.

DragMode#

Specifies how the control initiates drag-and-drop or drag-and-dock operations. Use DragMode to control when the user can drag the control. Disable the drag-and-drop or drag-and-dock capability at run time by setting the DragMode property value to dmManual. Enable automatic dragging by setting DragMode to dmAutomatic. For more information about dmManual and dmAutomatic, see TDragMode.

DrawingStyle#

<Delphi property DrawingStyle of type TControlBar at 21141D09040>

Enabled#

Controls whether the control responds to mouse, keyboard, and timer events. Use Enabled to change the availability of the control to the user. To disable a control, set Enabled to False. Some disabled controls appear dimmed (for example: buttons, check boxes, labels), while others (container controls) simply lose their functionality without changing their appearance. If Enabled is set to False, the control ignores mouse, keyboard, and timer events. To re-enable a control, set Enabled to True.

Note: This property applies to all TControl descendants.

Focused#

Determines whether the control has input focus.

GradientDirection#

<Delphi property GradientDirection of type TControlBar at 21141D091E0>

GradientEndColor#

<Delphi property GradientEndColor of type TControlBar at 21141D092B0>

GradientStartColor#

<Delphi property GradientStartColor of type TControlBar at 21141D09380>

Handle#

Provides access to the underlying Windows screen object for the control.

HandleAllocated#

Reports whether a screen object handle exists for the control.

OnAlignInsertBefore#

<Delphi property OnAlignInsertBefore of type TControlBar at 21141D09FB0>

OnAlignPosition#

<Delphi property OnAlignPosition of type TControlBar at 21141D0A080>

OnBandDrag#

<Delphi property OnBandDrag of type TControlBar at 21141D0A150>

OnBandInfo#

<Delphi property OnBandInfo of type TControlBar at 21141D0A220>

OnBandMove#

<Delphi property OnBandMove of type TControlBar at 21141D0A2F0>

OnBandPaint#

<Delphi property OnBandPaint of type TControlBar at 21141D0A3C0>

OnBeginBandMove#

<Delphi property OnBeginBandMove of type TControlBar at 21141D0A490>

OnCanResize#

<Delphi property OnCanResize of type TControlBar at 21141D0A630>

OnClick#

<Delphi property OnClick of type TControlBar at 21141D0A700>

OnConstrainedResize#

<Delphi property OnConstrainedResize of type TControlBar at 21141D0A7D0>

OnContextPopup#

<Delphi property OnContextPopup of type TControlBar at 21141D0A8A0>

OnDblClick#

<Delphi property OnDblClick of type TControlBar at 21141D0AB10>

OnDockDrop#

<Delphi property OnDockDrop of type TControlBar at 21141D0A970>

OnDockOver#

<Delphi property OnDockOver of type TControlBar at 21141D0AA40>

OnDragDrop#

<Delphi property OnDragDrop of type TControlBar at 21141D0ABE0>

OnDragOver#

<Delphi property OnDragOver of type TControlBar at 21141D0ACB0>

OnEndBandMove#

<Delphi property OnEndBandMove of type TControlBar at 21141D0A560>

OnEndDock#

<Delphi property OnEndDock of type TControlBar at 21141D0AD80>

OnEndDrag#

<Delphi property OnEndDrag of type TControlBar at 21141D0AE50>

OnEnter#

<Delphi property OnEnter of type TControlBar at 21141D0AF20>

OnExit#

<Delphi property OnExit of type TControlBar at 21141D0AFF0>

OnGesture#

<Delphi property OnGesture of type TControlBar at 21141D0B0C0>

OnGetSiteInfo#

<Delphi property OnGetSiteInfo of type TControlBar at 21141D0B190>

OnMouseActivate#

<Delphi property OnMouseActivate of type TControlBar at 21141D0B260>

OnMouseDown#

<Delphi property OnMouseDown of type TControlBar at 21141D0B330>

OnMouseEnter#

<Delphi property OnMouseEnter of type TControlBar at 21141D0B400>

OnMouseLeave#

<Delphi property OnMouseLeave of type TControlBar at 21141D0B4D0>

OnMouseMove#

<Delphi property OnMouseMove of type TControlBar at 21141D0B5A0>

OnMouseUp#

<Delphi property OnMouseUp of type TControlBar at 21141D0B670>

OnPaint#

<Delphi property OnPaint of type TControlBar at 21141D0B740>

OnResize#

<Delphi property OnResize of type TControlBar at 21141D0B810>

OnStartDock#

<Delphi property OnStartDock of type TControlBar at 21141D0B8E0>

OnStartDrag#

<Delphi property OnStartDrag of type TControlBar at 21141D0B9B0>

OnUnDock#

<Delphi property OnUnDock of type TControlBar at 21141D0BA80>

ParentBackground#

Determines whether the control uses its parent’s theme background. If ParentBackground is True, the control uses the parent’s theme background to draw its own background. If ParentBackground is False, the control uses its own properties, such as Color, to draw its background. ParentBackground has no effect unless XP themes are enabled.

ParentColor#

Specifies where a control looks for its color information. To have a control use the same color as its parent control, set ParentColor to True. If ParentColor is False, the control uses its own Color property. Set ParentColor to True for all controls to ensure that all the controls on a form have a uniform appearance. For example, if ParentColor is True for all controls in a form, changing the background color of the form to gray causes all the controls on the form to also have a gray background. When the value of a control’s Color property changes, ParentColor becomes False automatically.

ParentCtl3D#

Determines where a component looks to determine whether it should have a three-dimensional look. ParentCtl3D is provided for backwards compatibility. It has no effect on 32-bit versions of Windows or NT 4.0 and later. ParentCtl3D determines whether the control uses its parent’s Ctl3D property.

ParentFont#

Specifies where a control looks for its font information. To have a control use the same font as its parent control, set ParentFont to true. If ParentFont is false, the control uses its own Font property. Many controls default ParentFont to true so that all the controls in a form or other container present a uniform appearance. When the value of a control’s Font property changes, ParentFont becomes false automatically. When ParentFont is true for a form, the form uses the default font. Currently, the default font is Tahoma 8 pt.

ParentShowHint#

Specifies where a control looks to find out if its Help Hint should be shown. Use ParentShowHint to ensure that all the controls on a form either uniformly show their Help Hints or uniformly do not show them. If ParentShowHint is True, the control uses the ShowHint property value of its parent. If ParentShowHint is False, the control uses the value of its own ShowHint property. To provide Help Hints only for selected controls on a form, set the ShowHint property for those controls that should have Help Hints to True, and ParentShowHint becomes False automatically.

Note: Enable or disable all Help Hints for the entire application using the ShowHint property of the application object.

ParentWindow#

Reference to parent’s underlying control.

Picture#

<Delphi property Picture of type TControlBar at 21141D09860>

PopupMenu#

Specifies the pop-up menu associated with the control. Assign a value to PopupMenu to make a pop-up menu appear when the user selects the control and clicks the right mouse button. If the TPopupMenu’s AutoPopup property is True, the pop-up menu appears automatically. If the menu’s AutoPopup property is False, display the menu with a call to its Popup method from the control’s OnContextPopup event handler.

RowSize#

<Delphi property RowSize of type TControlBar at 21141D09A00>

RowSnap#

<Delphi property RowSnap of type TControlBar at 21141D09AD0>

SetFocus()#

Gives the input focus to the control.

ShowHint#

ShowHint specifies whether to show the Help Hint when the mouse pointer moves over the control. ShowHint determines whether the Help Hint appears for the control. The Help Hint is the value of the TControl.Hint property. The Help Hint appears in a box just beneath the control when the mouse pointer moves over the control. To enable Help Hints for a particular control, two conditions must be satisfied:

The application’s ShowHint property must be True. Either the control’s own ShowHint property must be True, or the control’s ParentShowHint property must be True and its parent’s ShowHint property must be True. For example, imagine a check box within a group box. If the ShowHint property of the group box is True and the ParentShowHint property of the check box is True, but the ShowHint property of the check box is False, the check box still displays its Help Hint. Changing the ShowHint value automatically sets the ParentShowHint property to False.

Showing#

Indicates whether the control is showing on the screen.

TabOrder#

Indicates the position of the control in its parent’s tab order. TabOrder is the order in which child windows are visited when the user presses the Tab key. The control with the TabOrder value of 0 is the control that has the focus when the form first appears. Initially, the tab order is always the order in which the controls were added to the form. The first control added to the form has a TabOrder value of 0, the second is 1, the third is 2, and so on. Change this by changing the TabOrder property. Each control has a unique tab-order value within its parent. If you change the TabOrder property value of one control to be the same as the value of a second control, the TabOrder value for all the other controls changes. For example, suppose a control is sixth in the tab order. If you change the control’s TabOrder property value to 3 (making the control fourth in the tab order), the control that was originally fourth in the tab order now becomes fifth, and the control that was fifth becomes sixth. Assigning TabOrder a value greater than the number of controls contained in the parent control moves the control to the end of the tab order. The control does not take on the assigned value of TabOrder, but instead is given the number that assures the control is the last in the tab order.

Note: TabOrder is meaningful only if the TabStop property is True and if the control has a parent. (The TabOrder property of a form is not used unless the form is the child of another form.) A control with a TabOrder of -1 has no parent, and therefore cannot be reached by pressing the Tab key. To remove a parented control from the Tab order, set its TabStop property to False.

TabStop#

Determines whether the user can tab to a control. Use the TabStop to allow or disallow access to the control using the Tab key. If TabStop is True, the control is in the tab order. If TabStop is False, the control is not in the tab order and the user cannot press the TAB key to move to the control.

Note: TabStop is not meaningful for a form unless the form assigns another form to be its parent.

Touch#

Specifies the touch manager component associated with the control. Use the Touch property to access gesturing options associated with a control. Touch specifies a class of type TTouchManager. Touch is used to:

Associate a TGestureManager. (TGestureManager manages all the gestures that can be used by the control.) Select the standard, interactive, or custom gestures to associate with the control. (You can also connect each gesture to an action; see Assigning Actions to Gestures.) Specify a set of options for interactive or tablet gestures.

Visible#

Specifies whether the component appears onscreen. Use the Visible property to control the visibility of the control at run time. If Visible is True, the control appears. If Visible is False, the control is not visible. Calling the Show method sets the control’s Visible property to True. Calling the Hide method sets it to False. For TCustomForm descendants, the Show and ShowModal methods set Visible to True and bring the form to the front of all open windows. For TTabSheet descendants, Visible does not control the visibility of the control at run time. For more information, see the description of the TabVisible property.