Función GetBrushOrgEx (wingdi.h)

Artículo
03/08/2023

La función GetBrushOrgEx recupera el origen del pincel actual para el contexto de dispositivo especificado. Esta función reemplaza a la función GetBrushOrg .

Sintaxis

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

Parámetros

[in] hdc

Identificador del contexto del dispositivo.

[out] lppt

Puntero a una estructura POINT que recibe el origen del pincel, en coordenadas del dispositivo.

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 conjunto de coordenadas con valores entre 0 y 7, especificando 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 valor 7 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 valor 7 corresponde a la fila más baja. Cuando el sistema coloca el pincel al principio de cualquier operación de pintura, asigna el origen del pincel a la ubicación del área cliente de la ventana especificada por el origen del pincel. Por ejemplo, si el origen se establece en (2,3), el sistema asigna el origen del pincel (0,0) a la ubicación (2,3) en el área de cliente de la ventana.

Si una aplicación usa un pincel para rellenar los fondos de un elemento primario y una ventana secundaria con colores coincidentes, puede ser necesario establecer el origen del pincel después de pintar la ventana primaria, pero antes de pintar la ventana secundaria.

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

Requisito	Value
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