Función SetBrushOrgEx (wingdi.h)

Artículo
03/08/2023

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.

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