FrameworkElement.LayoutTransform FrameworkElement.LayoutTransform FrameworkElement.LayoutTransform FrameworkElement.LayoutTransform Property

Definizione

Recupera o imposta una trasformazione grafica da applicare all'elemento quando viene eseguito il layout.Gets or sets a graphics transformation that should apply to this element when layout is performed.

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

Valore della proprietà

Trasformazione che dovrà essere utilizzata da questo elemento.The transform this element should use. Il valore predefinito è Identity.The default is Identity.

Esempi

Nell'esempio seguente viene illustrato come applicare un LayoutTransform oggetto a un elemento.The following example shows how to apply a LayoutTransform to an element. Nell'esempio viene creata un'istanza Button di e viene ospitata in Gridun elemento padre.The example creates an instance of Button and hosts it within a parent Grid. Viene inoltre utilizzata la LayoutTransform proprietà per applicare un RotateTransform oggetto a Button.It also uses the LayoutTransform property to apply a RotateTransform to the Button.


Button^ btn2 = gcnew Button();
btn2->Background = Brushes::LightCoral;
btn2->Content = "RotateTransform";
btn2->LayoutTransform = gcnew RotateTransform(45, 25, 25);
Grid::SetRow(btn2, 0);
Grid::SetColumn(btn2, 1);
grid1->Children->Add(btn2);


Button btn2 = new Button();
btn2.Background = Brushes.LightCoral;
btn2.Content = "RotateTransform";
btn2.LayoutTransform = new RotateTransform(45, 25, 25);
Grid.SetRow(btn2, 0);
Grid.SetColumn(btn2, 1);
grid1.Children.Add(btn2);


Dim btn2 As New Button()
btn2.Background = Brushes.LightCoral
btn2.Content = "RotateTransform"
btn2.LayoutTransform = New RotateTransform(45, 25, 25)
Grid.SetRow(btn2, 0)
Grid.SetColumn(btn2, 1)
grid1.Children.Add(btn2)


<Button Grid.Row="0" Grid.Column="1" Background="LightCoral" Content="RotateTransform Applied">
  <Button.LayoutTransform>
    <RotateTransform CenterX="25" CenterY="25" Angle="45" />
  </Button.LayoutTransform>
</Button>

Commenti

Diversamente da RenderTransform, LayoutTransform avrà effetto sui risultati del layout.In contrast to RenderTransform, LayoutTransform will affect results of layout.

L'impostazione di una trasformazione fornisce potenti funzionalità di ridimensionamento e rotazione.Setting a transform provides powerful capabilities of scaling and rotating. Tuttavia, LayoutTransform TranslateTransform ignora le operazioni.However, LayoutTransform ignores TranslateTransform operations. Questo perché il comportamento del sistema di layout per gli elementi figlio FrameworkElement di un oggetto corregge automaticamente eventuali offset nella posizione di un elemento ridimensionato o ruotato nel layout e nel sistema di coordinate dell'elemento padre.This is because the layout system behavior for child elements of a FrameworkElement auto-corrects any offsets to the position of a scaled or rotated element into the layout and coordinate system of the parent element.

LayoutTransformpuò comportare una riduzione delle prestazioni dell'applicazione se viene richiamata in uno scenario che non richiede un passaggio completo da parte del sistema di layout.LayoutTransform can lead to poor application performance if you invoke it in a scenario that does not require a full pass by the layout system. Quando si applica un LayoutTransform oggetto Children alla raccolta di Panel, attiva un nuovo passaggio dal sistema di layout e impone la rimisurazione e la disposizione di tutti gli oggetti sullo schermo.When you apply a LayoutTransform to the Children collection of the Panel, it triggers a new pass by the layout system and forces all on-screen objects to be remeasured and rearranged. Se si sta aggiornando l'applicazione interfaccia utenteuser interface (UI)completa, questa funzionalità potrebbe essere esattamente ciò che è necessario.If you are updating the complete application interfaccia utenteuser interface (UI), this functionality might be exactly what you need. Tuttavia, se non è necessario un passaggio di layout completo, utilizzare la RenderTransform proprietà che non richiama il sistema di layout e pertanto è in genere una scelta migliore per questo scenario.However, if you do not need a full layout pass, use the RenderTransform property, which does not invoke the layout system, and therefore, is typically a better choice for this scenario.

Scenari di esempio LayoutTransform in cui sarebbe utile includere: ruotare elementi come i componenti di menu da orizzontale a verticale o viceversa, ridimensionare gli elementi (zoom avanti) sullo stato attivo, fornendo il comportamento di modifica e così via.Example scenarios where LayoutTransform would be useful include: rotating elements such as menu components from horizontal to vertical or vice versa, scaling elements (zooming in) on focus, providing editing behavior, etc.

Informazioni proprietà di dipendenzaDependency Property Information

Campo identificatoreIdentifier field LayoutTransformProperty
Proprietà dei metadati impostate sutrueMetadata properties set to true AffectsMeasure

Si applica a

Vedi anche