TSpeedButton.Caption property
String with the caption displayed for the control.
Declaration
property Caption:;Description
Gets caption as a text-string (GetText), or stores the new caption
(SetText). Shows flag if caption is stored
(IsCaptionStored).
By default, the Caption appears the same as the control
Name in the Object Inspector, and the developer needs to set it
explicitly to some new text.
The VCL implementation relies on the virtual Get/SetTextBuf to
exchange text between widgets and VCL. This means a lot of (unnecessary) text
copies.
The LCL uses strings for exchanging text (more efficient). To maintain VCL
compatibility, the virtual RealGet/SetText is introduced. These
functions interface with the LCLInterface.
The default Get/SetTextBuf implementation calls the
RealGet/SetText. As long as the Get/SetTextBuf isn't
overridden Get/SetText calls RealGet/SetText to avoid
PChar copying.
To keep things optimal, LCL implementations should always override RealGet/SetText. Get/SetTextBuf is only kept for compatibility.
Modified in LCL version 3.0 to allow a multi-line value to be entered in the Object Inspector at design-time.
See also
An experiment, built from development snapshots. Not the official Free Pascal or Lazarus documentation.