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

Artículo
03/16/2023

Crea un objeto TextureBrush basado en una imagen, un modo de ajuste y un rectángulo que define.

Sintaxis

void TextureBrush(
  [in]      Image        *image,
  [in]      WrapMode     wrapMode,
  [in, ref] const Rect & dstRect
);

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, ref] dstRect

Tipo: const Rect

Referencia a un rectángulo que define el tamaño de este pincel de textura y la parte de la imagen que va a usar este pincel de textura. Si el objeto Image se crea a partir de un metarchivo, el pincel usa toda la imagen, que se escala para ajustarse al tamaño del pincel.

Valor devuelto

None

Observaciones

El ancho y el alto de un pincel de textura se definen mediante el ancho y el alto del rectángulo dstRect . Un pincel de textura siempre está orientado a (0, 0). El punto superior izquierdo, el ancho y el alto del rectángulo especifican el punto inicial, el ancho y el alto de la parte de la imagen que va a usar un pincel de textura.

Cómo usa este constructor el rectángulo dstRect con imágenes que no son demetafile

Si las dimensiones del rectángulo dstRect son más pequeñas que las de la imagen en la que se basa el pincel, la imagen del pincel se recorta, es una parte de la imagen. Si las dimensiones del rectángulo dstRect son iguales a las de la imagen, la imagen del pincel es idéntica a la imagen. El rectángulo dstRect no debe incluir áreas fuera de las dimensiones de la imagen. Si lo hace, generará un comportamiento imprevisible o generará un error en tiempo de ejecución. Por ejemplo, supongamos que tiene una imagen de 256 ×256 píxeles y crea un objeto TextureBrush basado en esta imagen, pasando como parámetro dstRect . El pincel usará la parte inferior izquierda de la imagen. La esquina inferior izquierda de esta parte también es la esquina inferior izquierda de la imagen. Ahora supongamos que crea otro objeto TextureBrush basado en la misma imagen, pasando como parámetro dstRect . Tenga en cuenta que este rectángulo tiene su coordenada superior en 157 en lugar de 156. Este rectángulo extiende una unidad más allá del alto de la imagen y probablemente generará una infracción de acceso.

Cómo usa este constructor el rectángulo dstRect con imágenes de metarchivo

Si las dimensiones del rectángulo dstRect son diferentes de las de la imagen, la imagen del pincel se escala más pequeña o mayor según sea necesario para ajustarse al rectángulo. Por ejemplo, supongamos que tiene una imagen de metarchivo de 256 ×256 píxeles y crea un objeto TextureBrush , pasando como parámetro dstRect . La imagen del pincel incluirá toda la imagen del metarchivo, pero se escalará para ajustarse al pincel: se ajustará verticalmente y se estirará horizontalmente. Si las dimensiones del rectángulo son iguales a las de la imagen, la imagen del pincel es idéntica a la imagen.

Cómo usa este constructor el modo de ajuste

Un área que se extiende más allá de los límites del pincel se coloca en mosaico con copias repetidas del pincel. Un pincel de textura puede tener mosaicos alternativos volteados en una dirección determinada, según lo especificado por el modo de ajuste. Voltear tiene el efecto de revertir la imagen del pincel.

Requisitos


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