RAD Studio VCL Reference
|
Specifies a text string that identifies the control to the user.
property Caption: TCaption;
__property TCaption Caption;
Use Caption to specify the text string that labels the control.
To underline a character in a Caption that labels a component, include an ampersand (&) before the character. This type of character is called an accelerator character. The user can then select the component by pressing Alt while typing the underlined character. To display an ampersand character in the caption, use two ampersands (&&).
C++ Examples:
/* The following code keeps the size of the label control constant, even though the length of the label’s caption changes. As a result, the caption of the label is probably too long to display in the label when the user clicks the button: */ void __fastcall TForm1::Button1Click(TObject *Sender) { Label1->AutoSize = false; Label1->Caption = "This string is too long to be the caption of this label"; }
/* This example requires a TPageControl populated by several TabSheets, a TEdit and a TButton. When the button is clicked, the caption of the active tab changes to that of the TEdit. These lines of code could also be written: PageControl1.ActivePage.Caption := Edit1.Text; This would make a TTabSheet variable unnecessary since PageControl1.->ActivePage is already of type TTabSheet. */ void __fastcall TForm1::Button1Click(TObject *Sender) { TTabSheet *sheet = PageControl1->ActivePage; sheet->Caption = Edit1->Text; }
/* This example creates a ToolBar and adds ToolButtons to it. Include ComCtlrs in the uses clause. */ #include <comctrls.hpp> #include <memory> void AddButtons(TToolBar *toolBar, TStringList *captions) { for (int i = 0; i < captions->Count; i++) { TToolButton *button = new TToolButton(toolBar); // The owner (toolBar) will clean this up. button->Parent = toolBar; button->Caption = captions->Strings[i]; if (button->Caption == "|") button->Style = tbsSeparator; else button->Style = tbsButton; } } TToolBar *myToolBar; void __fastcall TForm1::FormCreate(TObject *Sender) { myToolBar = new TToolBar(this); // The owner (this) will clean this up. myToolBar->Parent = this; // TStringList *captions = new TStringList(); std::auto_ptr<TStringList> captions(new TStringList()); captions->Add("New"); captions->Add("Save"); captions->Add("|"); captions->Add("Cut"); captions->Add("Copy"); captions->Add("Paste"); AddButtons(myToolBar, captions.get()); // delete captions; myToolBar->ShowCaptions = True; myToolBar->Height = 40; }
Delphi Examples:
{ The following code keeps the size of the label control constant, even though the length of the label’s caption changes. As a result, the caption of the label is probably too long to display in the label when the user clicks the button: } procedure TForm1.Button1Click(Sender: TObject); begin Label1.AutoSize := False; Label1.Caption := 'This string is too long to be the caption of this label'; end;
{ This example requires a TPageControl populated by several TabSheets, a TEdit and a TButton. When the button is clicked, the caption of the active tab changes to that of the TEdit. These lines of code could also be written: PageControl1.ActivePage.Caption := Edit1.Text; This would obviate the need for a TTabSheet variable since PageControl1.->ActivePage is already of type TTabSheet. } procedure TForm1.Button1Click(Sender: TObject); var sheet: TTabSheet; begin sheet := PageControl1.ActivePage; sheet.Caption := Edit1.Text; end;
{ This example creates a ToolBar and adds ToolButtons to it. Include ComCtlrs in the uses clause. } procedure AddButtons(ToolBar: TToolBar; Const ButtonCaptions: array of String); var I: Integer; begin for I := 0 to High(ButtonCaptions) do begin with TToolButton.Create(ToolBar) do begin Parent := ToolBar; Caption := ButtonCaptions[I]; if (ButtonCaptions[I] = '|') then Style := tbsSeparator else Style := tbsButton; end; end; end; procedure TForm1.FormCreate(Sender: TObject); begin ToolBar1 := TToolBar.Create(Self); ToolBar1.Parent := Self; AddButtons(ToolBar1, ['New', 'Save', '|', 'Cut', 'Copy', 'Paste']); ToolBar1.ShowCaptions := True; ToolBar1.Height := 40; end; procedure TForm1.FormDestroy(Sender: TObject); var I: Integer; begin for I := ToolBar1.ButtonCount - 1 downto 0 do ToolBar1.Buttons[I].Free; ToolBar1.Free; end;
Copyright(C) 2009 Embarcadero Technologies, Inc. All Rights Reserved.
|
What do you think about this topic? Send feedback!
|