Vcl.Buttons.TBitBtn.Glyph
Delphi
property Glyph: TBitmap read GetGlyph write SetGlyph stored IsCustom;
C++
__property Vcl::Graphics::TBitmap* Glyph = {read=GetGlyph, write=SetGlyph, stored=IsCustom};
Properties
Type | Visibility | Source | Unit | Parent |
---|---|---|---|---|
property | published | Vcl.Buttons.pas Vcl.Buttons.hpp |
Vcl.Buttons | TBitBtn |
Description
Specifies the bitmap that appears on the bitmap button.
Use the Open dialog box that appears as an editor in the Object Inspector to choose a bitmap file (with a .BMP extension) to use on the button, or specify a TBitmap object at runtime.
You can provide up to four images within a single bitmap. All images must be the same size and next to each other in a row. Bit buttons display one of these images depending on their state.
Image position | Button state | Description |
---|---|---|
First |
Up |
This image appears when the button is up (unselected). This image is also used when the button has focus (for example, if the user tabs to it); in this case, a focus rectangle is drawn around the button. If no other images exist in the bitmap, bit buttons also use this image for all other states. |
Second |
Disabled |
This image usually appears dimmed to indicate that the button can't be selected. |
Third |
Clicked |
This image appears when the button is clicked. The Up image reappears when the user releases the mouse button. |
Fourth |
Down |
This image appears when the button stays down (indicating that it remains selected). |
If only one image is present, bit buttons attempt to represent the other states by altering the image slightly for the different states, although the Down state is always the same as the Up state. If you aren't satisfied with the results, you can provide additional images in the bitmap.
If you have multiple images in a bitmap, you must specify the number of images that are in the bitmap with the Num Glyphs property.
Note: The lower left pixel of the bitmap is reserved for the "transparent" color. Any pixel in the bitmap which matches that lower left pixel will be transparent.