From Clomosy Docs

No edit summary
No edit summary
Line 1: Line 1:
The TclLabel component is used to output a user-modifiable text (it can of course also be modified by a program).
<div class="alert alert-ligth border border-3 border-primary-subtle rounded-5 p-4 shadow-sm" role="alert">
Tags display text. You place a label on a form when you need to define or annotate another component, such as an edit box, or when you want to add text to the form. The standard label component TclLabel is a windowless control. Tags typically display read-only static text that cannot be changed by the application user.<br>
function AddNewLabel(AComponent: TCLComponent; xName, xCaption: string): TclLabel;
</div>


AddNewLabel(xOwner:TComponent; xName,xCaption:String): TclLabel
<span style="color:blue"><b>AComponent</b></span> : The variable name of the defined component is written. Here you should write the component variable name of whatever your component will be in.<br>


<span style="color:blue">''TComponent''</span> : The variable name of the defined component is written. Here you should write the component variable name of whatever your component will be in.
<span style="color:blue"><b>xName</b></span> : The name of the defined label should be written.<br>


<span style="color:blue">''xName''</span> : The name of the defined label should be written.
<span style="color:blue"><b>xCaption</b></span> : You can enter the chart title here.<br>
 
<span style="color:blue">''xCaption''</span> : You can enter the chart title here.


It creates a text label used to provide explanations or information in the user interface. TclLabel is preferred for labeling other components on the form or providing information to the user. For example, explanations such as "Username" or "Password" can be displayed next to an input field.<br>


The features and usage are provided in the table below.<br>


<div class="table-responsive">
{| class="wikitable" style="border: 2px solid #c3d7e0"
{| class="wikitable" style="border: 2px solid #c3d7e0"
! style="background-color: #c3d7e0"| Feature !!style="background-color: #c3d7e0"| Use of !!style="background-color: #c3d7e0"|Definition  
! style="background-color: #c3d7e0"| Feature !!style="background-color: #c3d7e0"| Use of !!style="background-color: #c3d7e0"| Definition  
|-
|-
|TclLabel || Label1 : TclLabel;  || A variable belonging to the TclLabel class is created.
|TclLabel || Label1 : TclLabel;  || A variable belonging to the TclLabel class is created.
Line 33: Line 35:
|Caption ||Label1.Caption = 'Button Caption'; || It represents the text displayed on the component. The Caption specifies the textual label that the component presents to the user.
|Caption ||Label1.Caption = 'Button Caption'; || It represents the text displayed on the component. The Caption specifies the textual label that the component presents to the user.
|}
|}
</div>




'''Example:'''<br>


:'''TRObject Syntax'''
<b>Example</b><br>
  var
<pre>
    MyForm:TclForm;
var
    testLabel : TclLabel;
  MyForm:TclForm;
 
  testLabel : TclLabel;
  {
    MyForm = TclForm.Create(Self);
{
    testLabel= MyForm.AddNewLabel(MyForm,'testLabel','Test Label Caption');
  MyForm = TclForm.Create(Self);
    testLabel.StyledSettings = ssFamily;
  testLabel= MyForm.AddNewLabel(MyForm,'testLabel','Test Label Caption');
    testLabel.TextSettings.Font.Size=20;
  testLabel.StyledSettings = ssFamily;
    testLabel.Align = alCenter;
  testLabel.TextSettings.Font.Size=20;
    testLabel.Margins.Left= 50;
  testLabel.Align = alCenter;
    testLabel.Margins.Top= 10;  
  testLabel.Margins.Left= 50;
    testLabel.Height = 50;
  testLabel.Margins.Top= 10;  
    testLabel.Width = 150;
  testLabel.Height = 50;
   
  testLabel.Width = 150;
    MyForm.Run;
 
  }
  MyForm.Run;
}
</pre>


:'''Base Syntax'''
'''var'''
MyForm:TclForm;
testLabel : TclLabel;<br>
'''begin'''<br>
MyForm := TclForm.Create(Self);
testLabel:= MyForm.AddNewLabel(MyForm,'testLabel','Test Label Caption');
testLabel.StyledSettings := ssFamily;
testLabel.TextSettings.Font.Size:=20;
testLabel.Align := alCenter;
testLabel.Margins.Left:= 50;
testLabel.Margins.Top:= 10;
testLabel.Height := 50;
testLabel.Width := 150;<br>
MyForm.Run;<br>
'''end;'''


'''Output:'''<br>
<b>Output:</b><br>
[[File:Label.png|frameless|450px]]
[[File:Label.png|frameless|450px]]<br>


= See Also =
<h2> See Also </h2>
* [[Components]]
* [[Object Properties]]
* [[Object Properties]]
* [[AddNewEvent]]
* [[AddNewEvent]]

Revision as of 07:39, 7 November 2024

AComponent : The variable name of the defined component is written. Here you should write the component variable name of whatever your component will be in.

xName : The name of the defined label should be written.

xCaption : You can enter the chart title here.

It creates a text label used to provide explanations or information in the user interface. TclLabel is preferred for labeling other components on the form or providing information to the user. For example, explanations such as "Username" or "Password" can be displayed next to an input field.

The features and usage are provided in the table below.

Feature Use of Definition
TclLabel Label1 : TclLabel; A variable belonging to the TclLabel class is created.
AddNewLabel Label1 = MyForm.AddNewLabel(MyForm,'Label1','Test Label Caption'); A new TclLabel is added to the form.
Width Label1.Width = 150; Allows adjusting the width of the label.
Height Label1.Height = 50; Allows adjusting the height of the label.
Align Label1.Align = alTop; With the Align parameter, you can specify where you want our component to be aligned in the form. This parameter has multiple positioning properties. See the page to learn about these features.
Margins Label1.Margins.Left = 50; // Right, Top, Bottom With the Margins parameter, you can give margins at any scale from the right, left, bottom, top.
TclLabelMargins.png

TextSettings Label1.StyledSettings = ssFamily;
Label1.TextSettings.FontColor = clAlphaColor.clHexToColor('#8a067c');
Label1.TextSettings.Font.Size = 20;
Label1.TextSettings.Font.Style = [fsItalic]; //[fsItalic,fsUnderline]
Text formatting is performed in the component. To see the usage, see page.
Text Label1.Text = 'Label's Text'; It represents the text within the component. The text entered by the user or set by the program is managed through this property.
Caption Label1.Caption = 'Button Caption'; It represents the text displayed on the component. The Caption specifies the textual label that the component presents to the user.



Example

 var
   MyForm:TclForm;
   testLabel : TclLabel;
 
 {
   MyForm = TclForm.Create(Self);
   testLabel= MyForm.AddNewLabel(MyForm,'testLabel','Test Label Caption');
   testLabel.StyledSettings = ssFamily;
   testLabel.TextSettings.Font.Size=20;
   testLabel.Align = alCenter;
   testLabel.Margins.Left= 50;
   testLabel.Margins.Top= 10; 
   testLabel.Height = 50;
   testLabel.Width = 150;
   
   MyForm.Run;
 }


Output:
Label.png

See Also