Método TextureBrush::SetWrapMode (gdiplusbrush.h)

Artículo
03/14/2023

El método TextureBrush::SetWrapMode establece el modo de ajuste de este pincel de textura.

Sintaxis

Status SetWrapMode(
  [in] WrapMode wrapMode
);

Parámetros

[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.

Valor devuelto

Tipo: Estado

Si el método se realiza correctamente, devuelve Ok, que es un elemento de la enumeración Status .

Si se produce un error en el método, devuelve uno de los otros elementos de la enumeración Status .

Comentarios

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 y especifica WrapModeClamp como modo de ajuste:

TextureBrush(&SomeImage, WrapModeClamp)

A continuación, pinta 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 ningún pinzamiento.

Ejemplos

En el ejemplo siguiente se crea un pincel de textura, se establece el modo de ajuste del pincel y se usa el pincel para rellenar un rectángulo.

VOID Example_SetWrapMode(HDC hdc)
{
   Graphics graphics(hdc);

   Image image(L"HouseAndTree.gif");
   TextureBrush textureBrush(&image);
   textureBrush.SetWrapMode(WrapModeTileFlipX);
   graphics.FillRectangle(&textureBrush, 0, 0, 400, 200);
}

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