TileBrush.Stretch Propriedade

Definição

Obtém ou define um valor que especifica como o conteúdo deste TileBrush é ampliado para se ajustar a seus blocos.Gets or sets a value that specifies how the content of this TileBrush stretches to fit its tiles.

public:
 property System::Windows::Media::Stretch Stretch { System::Windows::Media::Stretch get(); void set(System::Windows::Media::Stretch value); };
public System.Windows.Media.Stretch Stretch { get; set; }
member this.Stretch : System.Windows.Media.Stretch with get, set
Public Property Stretch As Stretch

Valor da propriedade

Um valor que especifica como este conteúdo TileBrush é projetado em seu bloco base.A value that specifies how this TileBrush content is projected onto its base tile. O valor padrão é Fill.The default value is Fill.

Comentários

A propriedade Stretch aceita os seguintes valores, que a enumeração Stretch define:The Stretch property accepts the following values, which the Stretch enumeration defines:

  • None: O conteúdo TileBrush não é alongado para preencher o bloco.None: The TileBrush content does not stretch to fill the tile.

  • Uniform: O conteúdo TileBrush é dimensionado para se ajustar às dimensões do bloco.Uniform: The TileBrush content is scaled to fit the tile dimensions. No entanto, a taxa de proporção do conteúdo é preservada.However, the aspect ratio of the content is preserved.

  • UniformToFill: O conteúdo TileBrush é dimensionado para que ele preencha completamente a área de saída, mas preserva sua taxa de proporção original.UniformToFill: The TileBrush content is scaled so that it completely fills the output area but preserves its original aspect ratio.

  • Fill: O conteúdo TileBrush é dimensionado para caber no bloco.Fill: The TileBrush content is scaled to fit the tile. Como a altura e a largura do conteúdo são dimensionadas de forma independente, a taxa de proporção original do conteúdo pode não ser preservada.Because the content's height and width are scaled independently, the original aspect ratio of the content might not be preserved. Ou seja, o conteúdo TileBrush pode estar distorcido para preencher completamente o bloco de saída.That is, the TileBrush content might be distorted in order to completely fill the output tile.

A imagem a seguir ilustra as diferentes configurações de Stretch.The following image illustrates the different Stretch settings.

Diferentes configurações de alongamento de TileBrushDifferent TileBrush Stretch settings
Configurações diferentes de alongamentoDifferent stretch settings

Observe que você especifica as dimensões do conteúdo TileBrush usando a propriedade Viewbox; Você especifica a posição e o tamanho do bloco base TileBrush usando a propriedade Viewport.Note that you specify the dimensions of TileBrush content by using the Viewbox property; you specify the position and size of the TileBrush base tile by using the Viewport property.

Recorte de ViewboxViewbox Clipping

o conteúdo de TileBrush nunca é recortado no Viewbox.TileBrush contents are never clipped to the Viewbox. No entanto, o conteúdo de TileBrush é recortado nas bordas do Viewport, que define as dimensões para o bloco base TileBrush.However, TileBrush contents are clipped to the edges of the Viewport, which sets the dimensions for the TileBrush base tile.

A ilustração a seguir mostra o efeito de diferentes configurações Stretch em um TileBrush que tem um Viewbox que é menor do que seu Viewport.The following illustration shows the effect of different Stretch settings on a TileBrush that has a Viewbox that is smaller than its Viewport. As partes da imagem que estão fora do Viewbox são cinza colorido.The parts of the image that are outside the Viewbox are tinted gray.

TileBrush com diferentes configurações de StretchTileBrush with different Stretch settings
TileBrush com diferentes configurações de StretchTileBrush with different Stretch settings

Informações da propriedade de dependênciaDependency Property Information

Campo de identificadorIdentifier field StretchProperty
Propriedades de metadados definidas como trueMetadata properties set to true NenhumNone

Aplica-se a

Veja também