Função GetBrushOrgEx (wingdi.h)

Artigo
03/13/2024

A função GetBrushOrgEx recupera a origem do pincel atual para o contexto do dispositivo especificado. Essa função substitui a função GetBrushOrg .

Sintaxe

BOOL GetBrushOrgEx(
  [in]  HDC     hdc,
  [out] LPPOINT lppt
);

Parâmetros

[in] hdc

Um identificador para o contexto do dispositivo.

[out] lppt

Um ponteiro para uma estrutura POINT que recebe a origem do pincel, nas coordenadas do dispositivo.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero.

Comentários

Um pincel é um bitmap que o sistema usa para pintar os interiores de formas preenchidas.

A origem do pincel é um conjunto de coordenadas com valores entre 0 e 7, especificando o local de um pixel no bitmap. As coordenadas de origem do pincel padrão são (0,0). Para coordenadas horizontais, o valor 0 corresponde à coluna mais à esquerda de pixels; o valor 7 corresponde à coluna mais à direita. Para coordenadas verticais, o valor 0 corresponde à linha mais alta de pixels; o valor 7 corresponde à linha mais baixa. Quando o sistema posiciona o pincel no início de qualquer operação de pintura, ele mapeia a origem do pincel para o local na área de cliente da janela especificada pela origem do pincel. Por exemplo, se a origem for definida como (2,3), o sistema mapeará a origem do pincel (0,0) para o local (2,3) na área do cliente da janela.

Se um aplicativo usa um pincel para preencher as telas de fundo de uma janela pai e filho com cores correspondentes, pode ser necessário definir a origem do pincel depois de pintar a janela pai, mas antes de pintar a janela filho.

O sistema controla automaticamente a origem de todos os contextos de dispositivo gerenciados por janela e ajusta seus pincéis conforme necessário para manter um alinhamento de padrões na superfície.

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