Método TextureBrush::TextureBrush(Image*,WrapMode,REAL,REAL,REAL,REAL) (gdiplusbrush.h)

Crea un objeto TextureBrush basado en una imagen, un modo de ajuste y un conjunto de coordenadas que define.

Sintaxis

void TextureBrush(
  [in] Image    *image,
  [in] WrapMode wrapMode,
  [in] REAL     dstX,
  [in] REAL     dstY,
  [in] REAL     dstWidth,
  [in] REAL     dstHeight
);

Parámetros

[in] image

Tipo: Imagen*

Puntero a un objeto Image que contiene el mapa de bits de la imagen que se va a usar.

[in] wrapMode

Tipo: WrapMode

Elemento de la enumeración WrapMode que especifica cómo se usan copias repetidas de una imagen para mostrar un área cuando se pinta con este pincel de textura.

[in] dstX

Tipo: REAL

Coordenada más a la izquierda de la parte de la imagen que va a usar este pincel.

[in] dstY

Tipo: REAL

Coordenada superior de la parte de la imagen que va a usar este pincel.

[in] dstWidth

Tipo: REAL

Ancho del pincel y ancho de la parte de la imagen que va a usar el pincel.

[in] dstHeight

Tipo: REAL

Alto del pincel y alto de la parte de la imagen que va a usar el pincel.

Valor devuelto

None

Observaciones

Los parámetros dstX, dstY, dstWidth y dstHeight especifican un rectángulo. El tamaño del pincel se define mediante dstWidth y dstHeight. Los parámetros dstX y dstY no tienen ningún efecto en el tamaño o posición del pincel, el pincel siempre está orientado a (0, 0). Los parámetros dstX, dstY, dstWidth y dstHeight definen la parte de la imagen que va a usar el pincel.

Por ejemplo, supongamos que tiene una imagen almacenada en un objeto Image y que tiene 256 ×512 (ancho ×height) píxeles. A continuación, cree un objeto TextureBrush basado en esta imagen de la siguiente manera:

TextureBrush(&someImage, WrapModeTile, 12, 50, 100, 150)

El pincel tendrá un ancho de 100 unidades y un alto de 150 unidades. El pincel usará una parte rectangular de la imagen. Esta parte comienza en el píxel que tiene coordenadas (12, 50). El ancho y el alto de la parte son 100 y 150, respectivamente, medidos desde el píxel inicial.

Ahora supongamos que crea otro objeto TextureBrush basado en la misma imagen y especifica un rectángulo diferente:

TextureBrush(&someImage, WrapModeTile, 0, 0, 256, 512)

El pincel tendrá ancho y alto igual a 256 y 512, respectivamente. El pincel usará toda la imagen en lugar de una parte de ella porque el rectángulo especifica un píxel inicial en coordenadas (0, 0) y dimensiones idénticas a las de la imagen.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP, Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	gdiplusbrush.h (include Gdiplus.h)
Library	Gdiplus.lib
Archivo DLL	Gdiplus.dll