Vcl.Buttons.TBitBtn.Glyph

From RAD Studio API Documentation
Jump to: navigation, search

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.

See Also

Code Examples