Funzione SetLayout (wingdi.h)

  • Articolo

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