TextureBrush::TextureBrush(Image*,constRect&,constImageAttributes*) (gdiplusbrush.h)
Crea un objeto TextureBrush basado en una imagen, un rectángulo que define y un conjunto de propiedades de imagen.
Sintaxis
void TextureBrush(
[in] Image *image,
[in, ref] const Rect & dstRect,
[in] const ImageAttributes *imageAttributes
);
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, ref] dstRect
Tipo: 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.
[in] imageAttributes
Tipo: ImageAttributes*
Opcional. Puntero a un objeto ImageAttributes que contiene propiedades de la imagen. El valor predeterminado es NULL.
Valor devuelto
None
Observaciones
El ancho y alto del rectángulo dstRect definen el ancho y el alto de un pincel de textura. 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 nometafile
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 el 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 el 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.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 |