4D Doc Center : Select RGB Color

Home

4D v14.3

Select RGB Color


Select RGB Color {( Standardfarbe {; Meldung} )} -> Funktionsergebnis

Parameter	Typ	Beschreibung
Standardfarbe	Lange Ganzzahl	Vorgegebene RGB Farbe
Meldung	Alpha	Titel des Auswahlfensters
Funktionsergebnis	Lange Ganzzahl	RGB Farbe

Beschreibung

Die Funktion Select RGB Color zeigt das Auswahlfenster für die Systemfarbe und gibt den RGB Wert der vom Benutzer gewählten Farbe zurück.

Das Auswahlfenster sieht folgendermaßen aus:

Macintosh	Windows

Mit dem optionalen Parameter Standardfarbe können Sie vorab eine Farbe im Fenster auswählen. Auf diese Weise können Sie z.B. die zuletzt vom Benutzer gesetzte Farbe abspeichern. In diesem Parameter übergeben Sie den Farbwert eines RGB-Formats. Weitere Informationen dazu finden Sie in der Beschreibung zum Befehl OBJECT SET RGB COLORS. Sie können auch eine Konstante unter dem Thema SET RGB COLORS verwenden.

Übergeben Sie keinen Parameter Standardfarbe oder den Wert 0 (Null), wird beim Öffnen des Dialogfensters die Farbe schwarz ausgewählt.
Mit dem optionalen Parameter Meldung können Sie den Titel des Systemfensters anpassen. Standardmäßig, also ohne diesen Parameter, lautet der Titel “Farben”.

Bestätigen dieses Dialogfensters hat je nach Plattform eine andere Auswirkung:

Klickt der Benutzer unter Windows auf die Schaltfläche OK, gibt die Funktion den Wert der gewählten Farbe im RGB-Format zurück und die Systemvariable wird auf 1 gesetzt. Klickt der Benutzer auf die Schaltfläche Abbrechen, gibt die Funktion -1 zurück und die Systemvariable OK wird auf 0 (Null) gesetzt.
Auf Mac OS lässt sich dieses Fenster nur über die Schließbox oder die Esc-Taste schließen. In beiden Fällen wird die Systemvariable OK auf 1 gesetzt, unabhängig, welche Aktion der Benutzer im Fenster ausgeführt hat. Die Funktion gibt den Wert der gewählten Farbe im RGB-Format zurück. Hat der Benutzer keine Farbe gewählt, wird der im Parameter Standardfarbe angegebene Wert zurückgegeben oder 0 (Null), wenn Standardfarbe nicht übergeben wurde.

Hinweis: Dieser Befehl darf weder auf dem Server Rechner, noch innerhalb eines Web Prozesses ausgeführt werden.