Função SetBrushOrgEx (wingdi.h)
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.
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
| 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 |