Função SetBrushOrgEx (wingdi.h)

Artigo
03/08/2023

A função SetBrushOrgEx define a origem do pincel que o GDI atribui ao próximo pincel que um aplicativo seleciona no contexto do dispositivo especificado.

Sintaxe

BOOL SetBrushOrgEx(
  [in]  HDC     hdc,
  [in]  int     x,
  [in]  int     y,
  [out] LPPOINT lppt
);

Parâmetros

[in] hdc

Um identificador para o contexto do dispositivo.

[in] x

A coordenada x, em unidades de dispositivo, da nova origem do pincel. Se esse valor for maior que a largura do pincel, seu valor será reduzido usando o operador modulus (largura do pincel nXOrgmod ).

[in] y

A coordenada y, em unidades de dispositivo, da nova origem do pincel. Se esse valor for maior que a altura do pincel, seu valor será reduzido usando o operador modulus (nYOrgmod brush height).

[out] lppt

Um ponteiro para uma estrutura POINT que recebe a origem do pincel anterior.

Esse parâmetro poderá ser NULL se a origem do pincel anterior não for necessária.

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 par de coordenadas que especificam 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; a largura corresponde à coluna mais à direita. Para coordenadas verticais, o valor 0 corresponde à linha mais alta de pixels; a altura corresponde à linha mais baixa.

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. A origem do pincel definida com essa chamada é relativa ao canto superior esquerdo da área do cliente.

Um aplicativo deve chamar SetBrushOrgEx depois de definir o modo de alongamento de bitmap como HALFTONE usando SetStretchBltMode. Isso deve ser feito para evitar o desalinhamento do pincel.

Requisitos


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