Método TextureBrush::TextureBrush(Image*,WrapMode,constRect&) (gdiplusbrush.h)
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 |