Função SetLayout (wingdi.h)

  • Artigo

A função SetLayout altera o layout de um DC (contexto de dispositivo).

Sintaxe

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

Parâmetros

[in] hdc

Um identificador para o DC.

[in] l

O layout de DC. Esse parâmetro pode usar um dos valores a seguir.

Valor Significado
LAYOUT_BITMAPORIENTATIONPRESERVED
 Desabilita qualquer reflexão durante as operações BitBlt e StretchBlt .
LAYOUT_RTL
 Define o layout horizontal padrão para ser da direita para a esquerda.

Retornar valor

Se a função for bem-sucedida, ela retornará o layout anterior do DC.

Se a função falhar, ela retornará GDI_ERROR.

Comentários

O layout especifica a ordem na qual o texto e os elementos gráficos são revelados em uma janela ou em um contexto de dispositivo. O padrão é da esquerda para a direita. A função SetLayout altera isso para ser da direita para a esquerda, que é o padrão nas culturas árabe e hebraica.

Depois que o sinalizador LAYOUT_RTL é selecionado, os sinalizadores que normalmente especificam direita ou esquerda são invertidos. Para evitar confusão, considere definir palavras alternativas para sinalizadores padrão, como aqueles na tabela a seguir.

Sinalizador padrão Nome 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 não pode modificar o desenho diretamente nos bits de um DIB.

Para obter mais informações, consulte "Layout da janela e espelhamento" em Recursos de janela.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho wingdi.h (inclua Windows.h)
Biblioteca Gdi32.lib
DLL Gdi32.dll

Confira também

Funções de contexto do dispositivo

Visão geral dos contextos do dispositivo

Getlayout