Visual.TransformToDescendant(Visual) Metodo

Riferimento

Definizione

Spazio dei nomi:: System.Windows.Media

Assembly:: PresentationCore.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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

public:
 System::Windows::Media::GeneralTransform ^ TransformToDescendant(System::Windows::Media::Visual ^ descendant);

public System.Windows.Media.GeneralTransform TransformToDescendant (System.Windows.Media.Visual descendant);

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

Public Function TransformToDescendant (descendant As Visual) As GeneralTransform

Parametri

descendant: Visual

Oggetto Visual nel quale vengono trasformate le coordinate.

Restituisce

GeneralTransform

Valore di tipo GeneralTransform.

Eccezioni

ArgumentNullException

descendant è null.

ArgumentException

L’elemento visivo non è un predecessore dell’elemento visivo descendant.

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 TransformToDescendant 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.TransformToDescendant(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.TransformToDescendant(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.

Si applica a