TileBrush.Stretch TileBrush.Stretch TileBrush.Stretch TileBrush.Stretch Property

Definition

Ruft einen Wert ab, der angibt, wie der Inhalt des TileBrush so gestreckt wird, dass er in die Kacheln passt, oder legt diesen fest.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

Eigenschaftswert

Ein Wert, der angibt, wie der TileBrush-Inhalt entsprechend der Größe der Basiskachel gestreckt wird.A value that specifies how this TileBrush content is projected onto its base tile. Der Standardwert ist Fillsein.The default value is Fill.

Hinweise

Die Stretch -Eigenschaft akzeptiert die folgenden Werte, die die Stretch -Enumeration definiert:The Stretch property accepts the following values, which the Stretch enumeration defines:

  • None: Die TileBrush -Inhalt wird nicht gestreckt, um die Kachel auszufüllen.None: The TileBrush content does not stretch to fill the tile.

  • Uniform: Die TileBrush Inhalt wird skaliert, um die kacheldimensionen passen.Uniform: The TileBrush content is scaled to fit the tile dimensions. Das Seitenverhältnis des Inhalts wird jedoch beibehalten.However, the aspect ratio of the content is preserved.

  • UniformToFill: Die TileBrush Inhalt wird skaliert, sodass er vollständig den Ausgabebereich ausfüllt, jedoch die ursprünglichen Seitenverhältnisse beizubehalten behält.UniformToFill: The TileBrush content is scaled so that it completely fills the output area but preserves its original aspect ratio.

  • Fill: Die TileBrush Inhalt wird skaliert, um die Kachel zu passen.Fill: The TileBrush content is scaled to fit the tile. Da Höhe und Breite des Inhalts unabhängig voneinander skaliert werden, wird das ursprüngliche Seitenverhältnis des Inhalts möglicherweise nicht beibehalten.Because the content's height and width are scaled independently, the original aspect ratio of the content might not be preserved. D. h. die TileBrush Inhalt möglicherweise verzerrt wird, um die Ausgabekachel vollständig auszufüllen.That is, the TileBrush content might be distorted in order to completely fill the output tile.

Die folgende Abbildung zeigt die verschiedenen Stretch Einstellungen.The following image illustrates the different Stretch settings.

Unterschiedliche TileBrush-dehneinstellungenDifferent TileBrush Stretch settings
Unterschiedliche DehneinstellungenDifferent stretch settings

Beachten Sie, dass Sie angeben, dass die Abmessungen des TileBrush Inhalt mithilfe der Viewbox -Eigenschaft, die Sie angeben, die Position und Größe von der TileBrush Basiskachel mithilfe der Viewport Eigenschaft.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.

Viewbox-ClippingViewbox Clipping

TileBrush Inhalte werden nie abgeschnitten, um die Viewbox.TileBrush contents are never clipped to the Viewbox. Allerdings TileBrush Inhalt sind abgeschnitten werden, an den Rändern des der Viewport, die festlegt, dass die Größe der TileBrush Basiskachel.However, TileBrush contents are clipped to the edges of the Viewport, which sets the dimensions for the TileBrush base tile.

Die folgende Abbildung zeigt die Auswirkungen der verschiedenen Stretch Einstellungen auf einem TileBrush , bei dem ein Viewbox ist kleiner als die Viewport.The following illustration shows the effect of different Stretch settings on a TileBrush that has a Viewbox that is smaller than its Viewport. Die Teile des Bilds, das sich außerhalb befinden die Viewbox grau getönt werden.The parts of the image that are outside the Viewbox are tinted gray.

TileBrush mit unterschiedlichen dehneinstellungenTileBrush with different Stretch settings
TileBrush mit unterschiedlichen DehneinstellungenTileBrush with different Stretch settings

Informationen zur AbhängigkeitseigenschaftDependency Property Information

Feld "ID"Identifier field StretchProperty
Legen Sie auf der Metadaten-Eigenschaften trueMetadata properties set to true NoneNone

Gilt für:

Siehe auch