SetLayout-Funktion (wingdi.h)

  • Artikel

Die SetLayout-Funktion ändert das Layout eines Gerätekontexts (DC).

Syntax

DWORD SetLayout(
  [in] HDC   hdc,
  [in] DWORD l
);

Parameter

[in] hdc

Ein Handle für den DC.

[in] l

Das DC-Layout. Dieser Parameter kann einen oder mehrere der folgenden Werte aufweisen.

Wert Bedeutung
LAYOUT_BITMAPORIENTATIONPRESERVED
 Deaktiviert alle Reflektionen während BitBlt - und StretchBlt-Vorgängen .
LAYOUT_RTL
 Legt das horizontale Standardlayout auf rechts nach links fest.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt sie das vorherige Layout des DC zurück.

Wenn die Funktion fehlschlägt, gibt sie GDI_ERROR zurück.

Hinweise

Das Layout gibt die Reihenfolge an, in der Text und Grafiken in einem Fenster oder einem Gerätekontext angezeigt werden. Der Standardwert ist von links nach rechts. Die SetLayout-Funktion ändert dies in rechts nach links, was der Standard in arabischen und hebräischen Kulturen ist.

Sobald das LAYOUT_RTL Flag ausgewählt ist, 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
 

SetLayout kann die Zeichnung nicht direkt in die Bits eines DIB ändern.

Weitere Informationen finden Sie unter Fensterlayout und Spiegelung in Fensterfeatures.

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 wingdi.h (einschließlich Windows.h)
Bibliothek Gdi32.lib
DLL Gdi32.dll

Weitere Informationen

Gerätekontextfunktionen

Übersicht über Gerätekontexte

GetLayout