Vcl.ExtCtrls.TCustomColorBox.OnGetColors
Delphi
property OnGetColors: TGetColorsEvent read FOnGetColors write FOnGetColors;
C++
__property TGetColorsEvent OnGetColors = {read=FOnGetColors, write=FOnGetColors};
Inhaltsverzeichnis
Eigenschaften
Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
---|---|---|---|---|
event | public | Vcl.ExtCtrls.pas Vcl.ExtCtrls.hpp |
Vcl.ExtCtrls | TCustomColorBox |
Beschreibung
Wird ausgelöst, wenn das Steuerelement mit einer benutzerdefinierten Farbliste gefüllt wird.
Mit OnGetColors können Sie eine benutzerdefinierte Farbliste füllen, die in die TCustomColorBox-Farbliste platziert werden soll.
Das OnGetColors-Ereignis wird nur dann aufgerufen, wenn die Eigenschaft cbCustomColors in Style enthalten ist.
- Sender ist eine Instanz von TCustomColorBox.
- Items ist ein TStrings-Objekt mit einer Liste der in TCustomColorBox angezeigten Farben.
- Items.Strings enthält die Liste der Anzeigestrings für das Kombinationsfeld.
- Items.Objects enthält eine Liste der den Anzeigenamen (Items.Strings) zugeordneten TColor-Werte als TObject.
- Hinweis: Wenn dieses Ereignis ausgelöst wird, enthält Items alle in der Eigenschaft Style angegebenen Farben, wie z.B. cbStandard. Farben werden durch Bearbeitung dieser Items-Liste hinzugefügt, verschoben oder aus TCustomColorBox entfernt.
Codefragmente
Um dies zu verdeutlichen, fügt das folgende Codefragment der Dropdown-Farbliste drei benutzerdefinierte Farben hinzu. Betrachten Sie das folgende Szenario: Eine Anwendung hat ein TColorBox-Objekt und die Eigenschaft cbCustomColors ist auf True gesetzt (in der Eigenschaft Style).
In diesem Szenario können Sie die folgende OnGetColors-Ereignisbehandlungsroutine implementieren:
Delphi:
procedure TForm1.ColorBox1GetColors(Sender: TCustomColorBox; Items: TStrings);
begin
Items.AddObject('Custom Black', TObject(clBlack));
Items.AddObject('Custom White', TObject(clWhite));
Items.AddObject('Custom Red', TObject(clRed));
end;
C++Builder:
void __fastcall TForm1::ColorBox1GetColors(TCustomColorBox *Sender, TStrings *Items)
{
Items->Clear();
Items->AddObject("Custom Black", (TObject*) (clBlack));
Items->AddObject("Custom White", (TObject*) (clWhite));
Items->AddObject("Custom Red", (TObject*) (clRed));
}