Visual.TransformToVisual(Visual) Metodo

Definizione

Spazio dei nomi:

System.Windows.Media

Assembly:

PresentationCore.dll

Restituisce una funzione di trasformazione utilizzabile per trasformare le coordinate dall'oggetto Visual all’oggetto visivo specificato.

public:
 System::Windows::Media::GeneralTransform ^ TransformToVisual(System::Windows::Media::Visual ^ visual);

public System.Windows.Media.GeneralTransform TransformToVisual (System.Windows.Media.Visual visual);

member this.TransformToVisual : System.Windows.Media.Visual -> System.Windows.Media.GeneralTransform

Public Function TransformToVisual (visual As Visual) As GeneralTransform

Parametri

visual

Visual

Oggetto Visual nel quale vengono trasformate le coordinate.

Restituisce

GeneralTransform

Valore di tipo GeneralTransform.

Eccezioni

ArgumentNullException

visual è null.

InvalidOperationException

Gli oggetti visivi non sono correlati.

Esempio

Nell'esempio di markup seguente viene illustrato un TextBlock oggetto contenuto all'interno di un StackPanel oggetto .

<StackPanel Name="myStackPanel" Margin="8">
  <TextBlock Name="myTextBlock" Margin="4" Text="Hello, world" />
</StackPanel>

Nell'esempio di codice seguente viene illustrato come utilizzare il TransformToVisual metodo per recuperare l'offset dell'oggetto StackPanel rispetto al relativo elemento figlio TextBlock. I valori di offset sono contenuti all'interno del valore restituito GeneralTransform .

// Return the general transform for the specified visual object.
GeneralTransform generalTransform1 = myStackPanel.TransformToVisual(myTextBlock);

// Retrieve the point value relative to the child.
Point currentPoint = generalTransform1.Transform(new Point(0, 0));

' Return the general transform for the specified visual object.
Dim generalTransform1 As GeneralTransform = myStackPanel.TransformToVisual(myTextBlock)

' Retrieve the point value relative to the child.
Dim currentPoint As Point = generalTransform1.Transform(New Point(0, 0))

L'offset tiene conto dei Margin valori per tutti gli oggetti. In questo caso, X è -4 e Y è -4. I valori di offset sono valori negativi perché l'oggetto padre è un offset negativo rispetto al relativo oggetto figlio.

Commenti

I TransformToAncestor metodi e TransformToDescendant possono essere usati anche per restituire una trasformazione per un oggetto visivo.