Partilhar via

Como definir o tamanho do bloco para um TileBrush

  • Artigo

Este exemplo mostra como definir o tamanho do bloco para um TileBrush. Por padrão, um TileBrush produz um único bloco que preenche completamente a área que você está pintando. Você pode substituir esse comportamento definindo as propriedades Viewport e ViewportUnits.

A propriedade Viewport especifica o tamanho do azulejo para um TileBrush. Por padrão, o valor da propriedade Viewport é relativo ao tamanho da área que está sendo pintada. Para que a propriedade Viewport especifique um tamanho de bloco absoluto, defina a propriedade ViewportUnits como Absolute.

Exemplo

O exemplo a seguir usa um ImageBrush, um tipo de TileBrush, para pintar um retângulo com azulejos. O exemplo define cada tile como 50 por cento por 50 por cento da área de saída (o retângulo). Como resultado, o retângulo é pintado com quatro projeções da imagem.

A ilustração a seguir mostra a saída que o exemplo produz:

Um retângulo com quatro cerejas demonstrando azulejos com um pincel de imagem. 


//
// Create an ImageBrush and set the size of each
// tile to 50% by 50% of the area being painted.
//
ImageBrush relativeTileSizeImageBrush = new ImageBrush();
relativeTileSizeImageBrush.ImageSource =
    new BitmapImage(new Uri(@"sampleImages\cherries_larger.jpg", UriKind.Relative));
relativeTileSizeImageBrush.TileMode = TileMode.Tile;

// Specify the size of the base tile.
// By default, the size of the Viewport is
// relative to the area being painted,
// so a value of 0.5 indicates 50% of the output
// area.
relativeTileSizeImageBrush.Viewport = new Rect(0, 0, 0.5, 0.5);

// Create a rectangle and paint it with the ImageBrush.
Rectangle relativeTileSizeExampleRectangle = new Rectangle();
relativeTileSizeExampleRectangle.Width = 200;
relativeTileSizeExampleRectangle.Height = 150;
relativeTileSizeExampleRectangle.Stroke = Brushes.LimeGreen;
relativeTileSizeExampleRectangle.StrokeThickness = 1;
relativeTileSizeExampleRectangle.Fill = relativeTileSizeImageBrush;

O próximo exemplo cria um ImageBrush, define seu Viewport como 0,0,25,25 e seu ViewportUnits como Absolutee o usa para pintar outro retângulo. Como resultado, o pincel produz blocos que têm uma largura de 25 pixels e uma altura de 25 pixels.

A ilustração a seguir mostra a saída que o exemplo produz:

Um retângulo com quarenta e oito cerejas demonstrando um TileBrush de azulejos com um visor. 


//
// Create an ImageBrush and set the size of each
// tile to 25 by 25 pixels.
//
ImageBrush absoluteTileSizeImageBrush = new ImageBrush();
absoluteTileSizeImageBrush.ImageSource =
     new BitmapImage(new Uri(@"sampleImages\cherries_larger.jpg", UriKind.Relative));
absoluteTileSizeImageBrush.TileMode = TileMode.Tile;

// Specify that the Viewport is to be interpreted as
// an absolute value.
absoluteTileSizeImageBrush.ViewportUnits = BrushMappingMode.Absolute;

// Set the size of the base tile. Had we left ViewportUnits set
// to RelativeToBoundingBox (the default value),
// each tile would be 25 times the size of the area being
// painted. Because ViewportUnits is set to Absolute,
// the following line creates tiles that are 25 by 25 pixels.
absoluteTileSizeImageBrush.Viewport = new Rect(0, 0, 25, 25);

// Create a rectangle and paint it with the ImageBrush.
Rectangle absoluteTileSizeExampleRectangle = new Rectangle();
absoluteTileSizeExampleRectangle.Width = 200;
absoluteTileSizeExampleRectangle.Height = 150;
absoluteTileSizeExampleRectangle.Stroke = Brushes.LimeGreen;
absoluteTileSizeExampleRectangle.StrokeThickness = 1;
absoluteTileSizeExampleRectangle.Fill = absoluteTileSizeImageBrush;

Os exemplos anteriores fazem parte de uma amostra maior. Para obter o exemplo completo, consulte ImageBrush Sample.

Embora este exemplo use a classe ImageBrush, as propriedades Viewport e ViewportUnits se comportam de forma idêntica para os outros objetos TileBrush, ou seja, para DrawingBrush e VisualBrush. Para obter mais informações sobre ImageBrush e os outros objetos TileBrush, consulte Pintura com imagens, desenhos e elementos visuais.

Ver também