Función SetLayout (wingdi.h)

  • Artículo

La función SetLayout cambia el diseño de un contexto de dispositivo (DC).

Sintaxis

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

Parámetros

[in] hdc

Identificador del controlador de dominio.

[in] l

Diseño del controlador de dominio. Este parámetro puede ser uno o más de los siguientes valores.

Valor Significado
LAYOUT_BITMAPORIENTATIONPRESERVED
 Deshabilita cualquier reflexión durante las operaciones BitBlt y StretchBlt .
LAYOUT_RTL
 Establece que el diseño horizontal predeterminado es de derecha a izquierda.

Valor devuelto

Si la función se ejecuta correctamente, devuelve el diseño anterior del controlador de dominio.

Si se produce un error en la función, devuelve GDI_ERROR.

Comentarios

El diseño especifica el orden en que el texto y los gráficos se muestran en una ventana o en un contexto de dispositivo. El valor predeterminado es de izquierda a derecha. La función SetLayout cambia esto para que sea de derecha a izquierda, que es el estándar en las referencias culturales árabe y hebreo.

Una vez seleccionada la marca de LAYOUT_RTL, se invierten las marcas que normalmente especifican a la derecha o a la izquierda. Para evitar confusiones, considere la posibilidad de definir palabras alternativas para las marcas estándar, como las de la tabla siguiente.

Marca estándar Nombre alternativo sugerido
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 no puede modificar el dibujo directamente en los bits de una DIB.

Para obtener más información, vea "Diseño de ventana y creación de reflejo" en Características de ventana.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado wingdi.h (incluye Windows.h)
Library Gdi32.lib
Archivo DLL Gdi32.dll

Consulte también

Funciones de contexto de dispositivo

Información general sobre contextos de dispositivo

GetLayout