Navigation: TextEd > Extension and Scripts > Dialogs >

TColorDialog

 

 

 

 

TColorDialog displays a modal color-selection dialog.

 

The TColorDialog component displays a Windows dialog box for selecting colors. The dialog does not appear at runtime until it is activated by a call to the Execute method. When the user selects a color and clicks OK, the dialog closes and the selected color is stored in the Color property.


 


Properties and methods



 

constructor Create(TComponent AOwner);

Creates and initializes a color-selection dialog.

 

Ex.

TColorDialog clDlg = TColorDialog.Create(form);


 

function bool Execute;

Displays the dialog box. Execute returns true when the user makes a selection and clicks OK, and returns false when the user closes the dialog without making a selection.

 

Ex.

TColorDialog clDlg = TColorDialog.Create(form);

clDlg.Color = clGreen;

if (clDlg.Execute) {

   panel.Color = clDlg.Color;

}

clDlg.Free;


 

procedure Free;

Destroys an object and frees its associated memory, if necessary.


 

property TColor Color;

Returns the selected color. When the user selects a color in the dialog box and clicks OK, the selected color becomes the value of the Color property. To make a default color of choice appear in the dialog when it opens, assign a value to Color.


 


Usage



 

TForm f;
TButton b;
 
/////////////////////////////////////
// Open a color dialog and change
// the form background color to
// the selected color.
/////////////////////////////////////
void btnClick(TObject Sender) {
   TColorDialog colorDlg = TColorDialog.Create(f);
   colorDlg.Color = clGreen;
   if (colorDlg.Execute) {
      f.Color = colorDlg.Color;
   }
   colorDlg.Free;
}
 
// Main procedure
{
   // Create a new window (form)
   f = new TForm(nil);
   f.Caption = "Change window color";
   f.Position = poScreenCenter;
   f.Width = 200;
   f.Height = 100;
   
   // Add a button to the window
   b = new TButton(f);
   b.Name = "btnColor";
   b.Parent = f;
   b.SetBounds(20, 50, 75, 25);
   b.Anchors = akLeft+akTop;
   b.Caption = "Color...";
 
   // When the user click on the button the 
   // function btnClick is executed
   b.OnClick = &btnClick; 
   
   // Show the window
   f.ShowModal;
   f.Free;
}


 


 


 


 

 

 

 

Copyright © 2024 Rickard Johansson