WinThemeSetOpen

Dieser Befehl erstellt ein neues oder öffnet ein vorhandenes ThemeSet-Objekt eines Theme-Objektes (obj) und gibt einen Deskriptor vom Typ _HdlThemeSet zurück. Das ThemeSet enthält alle im Theme definierten Theme-Elemente und deren Eigenschaften.

In (obj) muss ein Theme-Objekt angegeben werden (siehe ``WinThemeOpen()). Im Argument (int1) wird eine eindeutige Nummer eines ThemeSets innerhalb des Themes angegeben.

Im Argument (int2) können folgende Optionen angegeben werden:

• 0

  Das durch (int1) angegebene ThemeSet wird geladen. Falls kein ThemeSet mit dieser Nummer im Theme (obj) existiert, wird der Wert _ErrUnavailable zurückgegeben.

• _WinThemeSetOpenCreate

  Das durch (int1) angegebene ThemeSet wird erstellt. Falls bereits ein ThemeSet mit dieser Nummer im Theme (obj) existiert, wird der Wert _ErrExists zurückgegeben.

Bei der Erstellung eines ThemeSet mit der Option _WinThemeSetOpenCreate enthalten die Eigenschaften zunächst Default-Werte. Dadurch wird definiert, dass die Eigenschaften des ThemeSets dieselben Werte enthalten, wie das Theme (obj) selber. Für die Default-Werte gibt es folgende Konstanten, die bei den Eigenschaften gesetzt oder gelesen werden können:

• _WinThemeIntNULL: Integer-Eigenschaften
• _WinThemeColorNULL: Farb-Eigenschaften
• _WinThemeFontNULL: Font-Eigenschaften

Außer einem Deskriptor auf ein ThemeSet können folgende Fehlerwerte von der Funktion zurückgegeben werden:

• _ErrUnavailable: Das ThemeSet mit der Nummer (int1) existiert nicht.
• _ErrExists: Das ThemeSet mit der Nummer (int1) existiert bereits (bei Angabe von _WinThemeSetOpenCreate).

info

Damit neue oder geänderte ThemeSets gespeichert werden, muss das jeweilige Theme mit ``WinThemeClose() und der Option _WinThemeCloseSave gespeichert werden.

Beispiel:

// ThemeSet mit Nummer 1 anlegen und Füll- sowie Textfarbe von Button-Objekten setzen
tThemeSet1 # tTheme->WinThemeSetOpen(1,_WinThemeSetOpenCreate);
tThemeSet1->wpThemeColFillNormal(_WinTypeButton) # _WinColBlack;
tThemeSet1->wpThemeColTextNormal(_WinTypeButton) # _WinColWhite;

Mögliche Laufzeitfehler

• _ErrHdlInvalid: Der Deskriptor (obj) ist ungültig oder kein Deskriptor eines Theme-Objektes.
• _ErrValueInvalid: Die angegebene ThemeSet-Nummer (int1) ist <=0 oder in (int2) wurde eine unbekannte oder ungültige Option übergeben.
• _ErrMemExhausted: Das ThemeSet konnte nicht allokiert werden (bei Angabe von _WinThemeSetOpenCreate in (int2)).