SetProcessDefaultLayout-Funktion (winuser.h)

Artikel
03/09/2024

Ändert das Standardlayout, wenn Fenster ohne übergeordnetes Element oder Besitzer nur für den derzeit ausgeführten Prozess erstellt werden.

Syntax

BOOL SetProcessDefaultLayout(
  [in] DWORD dwDefaultLayout
);

Parameter

[in] dwDefaultLayout

Art: DWORD

Das Standardprozesslayout. Dieser Parameter kann 0 oder der folgende Wert sein.

Wert	Bedeutung
LAYOUT_RTL 0x00000001	Legt das horizontale Standardlayout auf rechts nach links fest.

Rückgabewert

Typ: BOOL

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Das Layout gibt an, wie Text und Grafiken gestaltet werden. der Standardwert ist von links nach rechts. Die SetProcessDefaultLayout-Funktion ändert das Layout in rechts nach links, was der Standard in arabischen und hebräischen Kulturen ist.

Nachdem das LAYOUT_RTL Flag ausgewählt wurde, werden Flags, die normalerweise rechts oder links angeben, umgekehrt. Um Verwirrung zu vermeiden, sollten Sie alternative Wörter für Standardflags definieren, z. B. die in der folgenden Tabelle.

Standardflagge	Vorgeschlagener alternativer Name
WS_EX_RIGHT	WS_EX_TRAILING
WS_EX_RTLREADING	WS_EX_REVERSEREADING
WS_EX_LEFTSCROLLBAR	WS_EX_LEADSCROLLBAR
ES_LEFT	ES_LEAD
ES_RIGHT	ES_TRAIL
EC_LEFTMARGIN	EC_LEADMARGIN
EC_RIGHTMARGIN	EC_TRAILMARGIN

Wenn Sie diese Funktion mit einem gespiegelten Fenster verwenden, beachten Sie, dass die SetProcessDefaultLayout-Funktion nicht den gesamten Prozess und alle darin erstellten Gerätekontexte (DCs) Spiegel. Es spiegelt nur die DCs des gespiegelten Fensters. Um einen beliebigen DC zu Spiegel, verwenden Sie die SetLayout-Funktion.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winuser.h (einschließlich Windows.h)
Bibliothek	User32.lib
DLL	User32.dll
APIs	ext-ms-win-ntuser-window-l1-1-3 (eingeführt in Windows 10, Version 10.0.10240)