Compartir a través de


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

Consulte también

Funciones de pincel

Información general sobre los pinceles

GetBrushOrgEx

PUNTO

SelectObject

SetStretchBltMode

UnrealizeObject