Funzione SetLayout (wingdi.h)

Articolo
08/27/2023

La funzione SetLayout modifica il layout di un contesto del dispositivo (DC).

Sintassi

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

Parametri

[in] hdc

Handle per il controller di dominio.

[in] l

Layout del controller di dominio. Questo parametro può essere uno o più dei valori seguenti.

Valore	Significato
LAYOUT_BITMAPORIENTATIONPRESERVED	Disabilita qualsiasi reflection durante le operazioni BitBlt e StretchBlt .
LAYOUT_RTL	Imposta il layout orizzontale predefinito da destra a sinistra.

Valore restituito

Se la funzione ha esito positivo, restituisce il layout precedente del controller di dominio.

Se la funzione ha esito negativo, restituisce GDI_ERROR.

Commenti

Il layout specifica l'ordine in cui viene visualizzato testo e grafica in una finestra o in un contesto del dispositivo. Il valore predefinito è a destra. La funzione SetLayout modifica questa opzione in modo da essere a destra a sinistra, ovvero lo standard nelle impostazioni cultura arabo ed ebraico.

Dopo aver selezionato il flag LAYOUT_RTL, i flag in genere che specificano destra o sinistra vengono invertito. Per evitare confusione, è consigliabile definire parole alternative per i flag standard, ad esempio quelli della tabella seguente.

Flag standard	Nome alternativo suggerito
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 non può modificare il disegno direttamente nei bit di un DIB.

Per altre informazioni, vedere "Layout finestra e mirroring" in Funzionalità della finestra.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wingdi.h (include Windows.h)
Libreria	Gdi32.lib
DLL	Gdi32.dll

Vedi anche

Funzioni del contesto del dispositivo

Panoramica dei contesti del dispositivo

GetLayout

Condividi tramite