Función SetBrushOrgEx (wingdi.h)
La función SetBrushOrgEx establece el origen del pincel que GDI asigna al siguiente pincel que una aplicación selecciona en el contexto de dispositivo especificado.
Sintaxis
BOOL SetBrushOrgEx(
[in] HDC hdc,
[in] int x,
[in] int y,
[out] LPPOINT lppt
);
Parámetros
[in] hdc
Identificador del contexto del dispositivo.
[in] x
Coordenada x, en unidades de dispositivo, del nuevo origen del pincel. Si este valor es mayor que el ancho del pincel, su valor se reduce mediante el operador modulus (ancho del pincel modXOrg).
[in] y
Coordenada y, en unidades de dispositivo, del nuevo origen del pincel. Si este valor es mayor que el alto del pincel, su valor se reduce mediante el operador modulus (alto del pincel modYOrg).
[out] lppt
Puntero a una estructura POINT que recibe el origen del pincel anterior.
Este parámetro puede ser NULL si no se requiere el origen del pincel anterior.
Valor devuelto
Si la función se realiza correctamente, el valor devuelto es distinto de cero.
Si la función no se realiza correctamente, el valor devuelto es cero.
Comentarios
Un pincel es un mapa de bits que el sistema utiliza para pintar los interiores de formas rellenadas.
El origen del pincel es un par de coordenadas que especifican la ubicación de un píxel en el mapa de bits. Las coordenadas de origen del pincel predeterminadas son (0,0). Para las coordenadas horizontales, el valor 0 corresponde a la columna situada más a la izquierda de píxeles; el ancho corresponde a la columna situada más a la derecha. Para las coordenadas verticales, el valor 0 corresponde a la fila superior de píxeles; el alto corresponde a la fila más baja.
El sistema realiza un seguimiento automático del origen de todos los contextos de dispositivo administrados por ventanas y ajusta sus pinceles según sea necesario para mantener una alineación de los patrones en la superficie. El origen del pincel que se establece con esta llamada es relativo a la esquina superior izquierda del área de cliente.
Una aplicación debe llamar a SetBrushOrgEx después de establecer el modo de extensión del mapa de bits en HALFTONE mediante SetStretchBltMode. Esto debe hacerse para evitar la desalineación del pincel.
El sistema realiza un seguimiento automático del origen de todos los contextos de dispositivo administrados por ventanas y ajusta sus pinceles según sea necesario para mantener una alineación de los patrones en la superficie.
Requisitos
| 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 |