TileBrush.Stretch Proprietà

Definizione

Ottiene o imposta un valore che specifica il modo in cui il contenuto di TileBrush occupa interamente le proprie tessere.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

Valore della proprietà

Valore che specifica il modo in cui il contenuto di questa classe TileBrush viene proiettato sulla relativa tessera di base.A value that specifies how this TileBrush content is projected onto its base tile. Il valore predefinito è Fill.The default value is Fill.

Commenti

La proprietà Stretch accetta i valori seguenti, definiti dall'enumerazione Stretch:The Stretch property accepts the following values, which the Stretch enumeration defines:

  • None: Il contenuto TileBrush non viene esteso per riempire il riquadro.None: The TileBrush content does not stretch to fill the tile.

  • Uniform: Il contenuto TileBrush viene ridimensionato per adattarsi alle dimensioni del riquadro.Uniform: The TileBrush content is scaled to fit the tile dimensions. Tuttavia, vengono mantenute le proporzioni del contenuto.However, the aspect ratio of the content is preserved.

  • UniformToFill: Il contenuto TileBrush viene ridimensionato in modo da riempire completamente l'area di output, mantenendo tuttavia le proporzioni originali.UniformToFill: The TileBrush content is scaled so that it completely fills the output area but preserves its original aspect ratio.

  • Fill: Il contenuto TileBrush viene ridimensionato per adattarsi al riquadro.Fill: The TileBrush content is scaled to fit the tile. Poiché l'altezza e la larghezza del contenuto vengono ridimensionate in modo indipendente, è possibile che non vengano mantenute le proporzioni originali del contenuto.Because the content's height and width are scaled independently, the original aspect ratio of the content might not be preserved. Ovvero, il contenuto TileBrush potrebbe essere distorto in modo da riempire completamente il riquadro di output.That is, the TileBrush content might be distorted in order to completely fill the output tile.

Nell'immagine seguente vengono illustrate le diverse impostazioni Stretch.The following image illustrates the different Stretch settings.

TileBrush con impostazioni Stretch diverseDifferent TileBrush Stretch settings
Impostazioni Stretch diverseDifferent stretch settings

Si noti che è possibile specificare le dimensioni del contenuto TileBrush usando la proprietà Viewbox; è possibile specificare la posizione e le dimensioni della tessera di base TileBrush usando la proprietà 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.

Ritaglio ViewboxViewbox Clipping

i contenuti TileBrush non vengono mai ritagliati in Viewbox.TileBrush contents are never clipped to the Viewbox. Tuttavia, il contenuto TileBrush viene ritagliato ai bordi della Viewport, che imposta le dimensioni per la tessera di base TileBrush.However, TileBrush contents are clipped to the edges of the Viewport, which sets the dimensions for the TileBrush base tile.

Nella figura seguente viene illustrato l'effetto di diverse impostazioni Stretch in un TileBrush con un valore di Viewbox inferiore rispetto al Viewport.The following illustration shows the effect of different Stretch settings on a TileBrush that has a Viewbox that is smaller than its Viewport. Le parti dell'immagine che si trovano al di fuori del Viewbox sono colorate in grigio.The parts of the image that are outside the Viewbox are tinted gray.

TileBrush con impostazioni di estensione diverseTileBrush with different Stretch settings
TileBrush con impostazioni Stretch diverseTileBrush with different Stretch settings

Informazioni proprietà di dipendenzaDependency Property Information

Campo identificatoreIdentifier field StretchProperty
Proprietà dei metadati impostate su trueMetadata properties set to true nessunoNone

Si applica a

Vedi anche