wingdi.h


GetBrushOrgEx

Recupera el origen actual del pincel para el contexto de dispositivo especificado. Esta función reemplaza a , actualmente obsoleta.

Sintaxis

BOOL GetBrushOrgEx(
    HDC hdc,     // manipulador de contexto de dispositivo
    LPPOINT lppt // dirección de estructura de coordenadas
   );

Parámetros:

hdc: identifica el contexto de dispositivo.

lppt: puntero a una estructura POINT que recibirá el origen del pincel, en coordenadas de dispositivo.

Valor de retorno

Si la función tiene éxito, el valor de retorno es TRUE.

Si la función falla, el valor de retorno es FALSE. Para obtener más información sobre el error llamar a GetLastError.

Observaciones

Un pincel es un mapa de bits que Windows usa para pintar el interior de figuras cerradas.

Un origen de pincel es un juego de coordenadas con valores entre 0 y 7, que especifican la posición de un pixel del mapa de bits. El valor por defecto para el origen es (0,0). Para el valor horizontal, el valor 0 corresponde a la columna izquierda de pixels; el valor 7 corresponde a la columna derecha. Para el valor vertical, el valor 0 corresponde a la fila superior de pixels; el valor 7 corresponde a la fila inferior.

Cuando Windows coloca el pincel en cualquier operación de pintado, mapea el origen del pincel a la posición en el área de cliente de la ventana especificada por el origen del pincel. Por ejemplo, si el origen se pone en (2,3), Windows mapea el origen del pincel (0,0) a las coordenadas (2,3) del área de cliente de la ventana.

Si una aplicación usa un pincel rallado para rellenar los fondos de una ventana y de una ventana hija y es necesario que las tramas coincidan, será necesario fijar el origen de del pincel antes de pintar el fondo de la ventana hija.

Windows NT: El sistema operativo repasa automáticamente el origen de todos los contextos de dispositivo de las ventanas y ajusta sus pinceles de modo que se mantenga el alineamiento de patrones en la pantalla.

Windows 95: no está soportado el ajuste automático del origen de pinceles. Las aplicaciones deben usar las funciones UnrealizeObject, SetBrushOrgEx y SelectObject para alinear el pincel antes de usarlo.