WinThemeSetOpen

obj -> WinThemeSetOpen(int1[, int2]) : handle

ThemeSet öffnen

Details

• obj: Deskriptor des Themes
• int1: Nummer des zu erstellenden oder zu öffnenden ThemeSets
• int2:
  • Optionen (optional):
  • 0
  • _WinThemeSetOpenCreate
• Resultat: handle Deskriptor des ThemeSets oder Fehlerwert > 0 Deskriptor des ThemeSets _ErrUnavailable Das ThemeSet mit der Nummer (int1) existiert nicht. _ErrExists Das ThemeSet mit der Nummer (int1) existiert bereits (bei Angabe von _WinThemeSetOpenCreate ).
• Siehe: Verwandte Befehle , Theme , ThemeSet , WinThemeOpen () , WinThemeSetDelete ()

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)).