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

Artículo
08/24/2023

Crea un objeto TextureBrush basado en una imagen y un modo de ajuste. El tamaño del pincel tiene como valor predeterminado el tamaño de la imagen, por lo que el pincel usa toda la imagen.

Sintaxis

void TextureBrush(
  [in] Image    *image,
  [in] WrapMode wrapMode
);

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

Opcional. Elemento de la enumeración WrapMode que especifica cómo se usan las copias repetidas de una imagen para crear mosaicos de un área cuando se pinta con este pincel de textura. El valor predeterminado es WrapModeTile.

Valor devuelto

Ninguno

Observaciones

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. Por ejemplo, si el modo de ajuste se especifica como WrapModeTileFlipX, el pincel se voltea sobre una línea paralela al eje y.

El pincel de textura siempre está orientado a (0, 0). Si el modo de ajuste se especifica como WrapModeClamp, no hay ningún área fuera del pincel en mosaico. Por ejemplo, supongamos que crea un pincel de textura, especificando WrapModeClamp como modo de ajuste:

TextureBrush(&SomeImage, WrapModeClamp)

A continuación, pintará un área con el pincel. Si el tamaño del pincel tiene una altura de 50 y el área pintada es un rectángulo con su esquina superior izquierda en (0, 50), no verá copias repetidas del pincel (sin mosaico).

El modo de ajuste predeterminado para un pincel de textura es WrapModeTile, que no especifica ningún volteo del icono y sin sujeción.

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