[Overview][Types][Classes][Procedures and functions][Variables][Index] | Reference for unit 'Buttons' (#lcl)

# TBitBtn

[Properties (by Name)] [Methods (by Name)] [Events (by Name)]

A Button with a small image attached

## Declaration

Source position: buttons.pp line 192

`type TBitBtn = class(TCustomBitBtn)`
`published`
`property Action;` |  | The action to be associated with this control
`property Align;` |  | Used to align the control to the top, bottom, left or right of its client.
`property Anchors;` |  | The set of anchor definitions for this control
`property AutoSize;` |  | Whether auto-size is to be used
`property BidiMode;`
`property BorderSpacing;` |  | Determines the border spacing for this control
`property Cancel;` |  | Is this the Cancel button? (default setting is False)
`property Caption;` |  | Caption - the text-string appearing on the Control, usually used to identify its function
`property Color;` |  | Determine the colour for the current control
`property Constraints;` |  | Determine Constraints (max and min height and width) for this control
`property Default;` |  | Is this the Default button? (default setting is False)
`property Enabled;` |  | Whether the control is Enabled (read/write). If not, it usually appears 'greyed-out'
`property Font;` |  | The font to be used for text in this control (read/write).
`property Glyph;` |  | The BitMap Glyph to be displayed on the button
`property GlyphShowMode;`
`property Kind;` |  | What kind of BitButton? Custom, OK, Cancel, Yes, No etc
`property Layout;` |  | Layout of button - Glyph at top, bottom, left or right
`property Margin;` |  | The margin to be left around glyphs
`property ModalResult;` |  | Determines whether the button closes its modal parent form.
`property NumGlyphs;` |  | The number of glyphs for display
`property OnChangeBounds;` |  | Event handler for a change in bounds of the control
`property OnClick;` |  | Event Handler for mouse click
`property OnContextPopup;`
`property OnDragDrop;`
`property OnDragOver;`
`property OnEndDrag;`
`property OnEnter;` |  | OnEnter - event handler for when the mouse enters the control, and the control receives focus
`property OnExit;` |  | OnExit - event handler for when the mouse leaves the control and it loses focus
`property OnKeyDown;` |  | OnKeyDown - event handler for instance when key is down while control has focus
`property OnKeyPress;` |  | OnKeyPress - event controller for a key being pressed while the control has focus. To properly handle national chars use UTF8KeyPress instead.
`property OnKeyUp;` |  | OnKeyUp - event handler for instance when a key is up (not pressed) while the control has focus
`property OnMouseDown;` |  | Event handler for when a mouse button is pressed down
`property OnMouseEnter;`
`property OnMouseLeave;`
`property OnMouseMove;` |  | Event handler for mouse movement within the current control
`property OnMouseUp;` |  | Event handler for when the mouse button is released, ie "up"
`property OnResize;` |  | Event Handler for resize of control
`property OnStartDrag;`
`property OnUTF8KeyPress;` |  | UTF8KeyPress - event controller for a key being pressed while the control has focus.
`property ParentBidiMode;`
`property ParentFont;` |  | ParentFont - should the control use the same font as the parent? Default is true
`property ParentShowHint;` |  | ParentShowHint - does the control adopt the same hinting behaviour as its parent? Default is true
`property PopupMenu;` |  | PopupMenu - a context-sensitive menu that pops up when the right mouse button is clicked over this control
`property ShowHint;` |  | Flag to determine: Is hint to be displayed for this control?
`property Spacing;` |  | The spacing around the BitButton
`property TabOrder;` |  | The place this control occupies in the list of tabs
`property TabStop;` |  | Is the control in the sequence of controls accessed by successive presses of the Tab key?
`property Visible;` |  | Visible - can the control be seen?
`end;`

## Inheritance

`TBitBtn` |  | A Button with a small image attached
`TCustomBitBtn` |  | TCustomBitBtn - the ancestor class for TBitBtn.
`TCustomButton` |  | TCustomButton - the base class for TButton and TBitBtn
`TButtonControl` |  | TButtonControl : ancestor class for several Button (including Radio Button) and Check Box classes
`TWinControl`
`TControl`
`TLCLComponent` |  | TLCLComponent - base class for LCL components
`TComponent,IUnknown,IInterfaceComponentReference`
`TPersistent`
`TObject`

## Description

Bit Button: a push button control on a toolbar causing a particular action to be executed. It often displays a glyph or small graphic to denote its function.

## See also

HowToUseStdCtrls |  | How to use StdCtrls, ComCtrls or ExtCtrls

The latest version of this document can be found at lazarus-ccr.sourceforge.net.