FrameworkElement.LayoutTransform Proprietà

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 a un elemento.The following example shows how to apply a LayoutTransform to an element. Nell'esempio viene creata un'istanza di Button e viene ospitata in un Gridpadre.The example creates an instance of Button and hosts it within a parent Grid. USA inoltre la proprietà LayoutTransform per applicare una RotateTransform al 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 dalla RenderTransform, LayoutTransform influirà 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 ignora le operazioni di TranslateTransform.However, LayoutTransform ignores TranslateTransform operations. Questo perché il comportamento del sistema di layout per gli elementi figlio di un FrameworkElement 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.

LayoutTransform può causare un calo delle prestazioni dell'applicazione se viene richiamato 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 alla raccolta Children della Panel, viene attivato un nuovo passaggio dal sistema di layout e tutti gli oggetti sullo schermo verranno rimisurati e ridisposti.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 aggiorna l'applicazione completa interfaccia utenteuser interface (UI), 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 proprietà RenderTransform, che non richiama il sistema di layout e, pertanto, rappresenta in genere la 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.

Gli scenari di esempio in cui LayoutTransform sarebbero utili includono: rotazione di elementi come i componenti di menu da orizzontale a verticale o viceversa, ridimensionamento di elementi (zoom avanti) sullo stato attivo, specifica del 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 su trueMetadata properties set to true AffectsMeasure

Si applica a

Vedi anche