WinThemeOpen

WinThemeOpen([alpha1[, int2]]) : handle

Theme öffnen

Details

• alpha1: Name des Themes (optional)
• int2:
  • Optionen (optional):
  • 0
  • _WinThemeOpenLock
  • _WinThemeOpenFirst
  • _WinThemeOpenLast
  • _WinThemeOpenNext
  • _WinThemeOpenPrev
• Resultat: handle Deskriptor des Theme -Objektes oder Fehlerwert > 0 Deskriptor des Theme -Objektes _ErrNameInvalid Es handelt sich nicht um ein vordefiniertes Theme oder der Theme-Name entspricht nicht den gültigen Konventionen. _ErrUnavailable Theme existiert nicht. _ErrLocked Das Theme wurde bereits von einem anderen Client gesperrt.
• Siehe: Verwandte Befehle , Theme , Blog

Der Befehl öffnet ein vordefiniertes oder ein in der Datenbank gespeichertes Theme und gibt einen Deskriptor vom Typ _HdlTheme zurück.

Der Name des zu ladenen Themes wird in (alpha1) angegeben. Es können Namen von vordefinierten oder in der Datenbank gespeicherten Themes angegeben werden:

• Beginnt der Name mit einem Unterstrich _, wird ein vordefiniertes Theme geöffnet. Es existieren drei vordefinierte Themes: '_OfficeBlue', '_OfficeDark' und '_WindowsColor'.
• Ist der Name eine leere Zeichenkette, dann wird das das Theme '_OfficeBlue' geöffnet.
• Bei der Angabe anderer Namen, wird das Theme aus der Datenbank geladen.

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

• 0 Das durch (alpha1) angegebene Theme wird geladen. Falls kein Theme mit diesem Name existiert, wird der Wert _ErrUnavailable zurückgegeben.
• _WinThemeOpenLock Lädt das Theme und sperrt es exklusiv. Dies ist die Voraussetzung, damit Theme-Eigenschaften geändert werden können. Soll ein Theme nicht geändert, sondern nur gelesen werden, kann die Option entfallen.
• _WinThemeOpenFirst Lädt das erste Theme (aufsteigend nach Theme-Name) aus der Datenbank. Ist kein Theme in der Datenbank vorhanden, wird der Fehlerwert _ErrUnavailable zurückgegeben.
• _WinThemeOpenLast Lädt das letzte Theme aus der Datenbank. Ist kein Theme in der Datenbank vorhanden, wird der Fehlerwert _ErrUnavailable zurückgegeben.
• _WinThemeOpenNext Lädt ausgehend vom angegebenen Namen (alpha1) das nächste Theme. Ist kein nächstes Theme vorhanden, wird der Fehlerwert _ErrUnavailable zurückgegeben.
• _WinThemeOpenPrev Lädt ausgehend vom angegebenen Namen (alpha1) das vorhergehende Theme. Ist kein vorhergehendes Theme vorhanden, wird der Fehlerwert _ErrUnavailable zurückgegeben.

Die Optionen _WinThemeOpenFirst, _WinThemeOpenLast, _WinThemeOpenNext und _WinThemeOpenPrev können mit der Option _WinThemeOpenLock kombiniert werden.

info

Ist eine Option außer 0 angegeben, bezieht sich diese auf ein Theme das in der Datenbank gespeichert ist. Die Optionen dürfen nicht für vordefinierte Themes angegeben werden.

Beim Erstellen eines Theme -Objektes wird die Eigenschaft ThemeBaseName auf das zugrundeliegende vordefinierte Theme gesetzt.

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

• _ErrNameInvalid: Es handelt sich nicht um ein vordefiniertes Theme oder der Theme-Name entspricht nicht den gültigen Konventionen.
• _ErrUnavailable: Theme existiert nicht.
• _ErrLocked: Das Theme wurde bereits von einem anderen Client gesperrt.

Mögliche Laufzeitfehler

• _ErrValueInvalid: In (int2) wurde eine unbekannte oder ungültige Option übergeben.