Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Classe VisualTreeHelper

 

Data di pubblicazione: ottobre 2016

Implementa metodi di utilità che eseguono attività comuni che interessano i nodi in un struttura ad albero visuale.

Spazio dei nomi:   System.Windows.Media
Assembly:  PresentationCore (in PresentationCore.dll)

System.Object
  System.Windows.Media.VisualTreeHelper

public static class VisualTreeHelper

NomeDescrizione
System_CAPS_pubmethodSystem_CAPS_staticGetBitmapEffect(Visual)

Restituisce il BitmapEffect valore per l'oggetto specificato Visual.

System_CAPS_pubmethodSystem_CAPS_staticGetBitmapEffectInput(Visual)

Restituisce il BitmapEffectInput valore per l'oggetto specificato Visual.

System_CAPS_pubmethodSystem_CAPS_staticGetCacheMode(Visual)

Recupera la rappresentazione nella cache dell'oggetto specificato Visual.

System_CAPS_pubmethodSystem_CAPS_staticGetChild(DependencyObject, Int32)

Restituisce l'oggetto visivo figlio dall'indice specificato insieme all'interno di un elemento padre specificato.

System_CAPS_pubmethodSystem_CAPS_staticGetChildrenCount(DependencyObject)

Restituisce il numero di elementi figlio che contiene l'oggetto visivo specificato.

System_CAPS_pubmethodSystem_CAPS_staticGetClip(Visual)

Restituisce l'area di ritaglio dell'oggetto specificato Visual come un Geometry valore.

System_CAPS_pubmethodSystem_CAPS_staticGetContentBounds(Visual)

Restituisce il rettangolo delimitazione memorizzato nella cache per l'oggetto specificato Visual.

System_CAPS_pubmethodSystem_CAPS_staticGetContentBounds(Visual3D)

Restituisce il rettangolo delimitazione memorizzato nella cache per l'oggetto specificato Visual3D.

System_CAPS_pubmethodSystem_CAPS_staticGetDescendantBounds(Visual)

Restituisce l'unione di tutto il contenuto per tutti i discendenti di rettangoli di selezione di Visual, che include il contenuto del riquadro di Visual.

System_CAPS_pubmethodSystem_CAPS_staticGetDescendantBounds(Visual3D)

Restituisce l'unione di tutti i riquadri per tutti i discendenti dell'oggetto specificato del contenuto Visual3D, che include il contenuto del riquadro di Visual3D.

System_CAPS_pubmethodSystem_CAPS_staticGetDpi(Visual)

Ottiene le informazioni DPI in base a cui l'oggetto Visual viene misurato e viene eseguito il rendering.

System_CAPS_pubmethodSystem_CAPS_staticGetDrawing(Visual)

Restituisce il contenuto del disegno dell'oggetto specificato Visual.

System_CAPS_pubmethodSystem_CAPS_staticGetEdgeMode(Visual)

Restituisce la modalità di bordo dell'oggetto specificato Visual come un EdgeMode valore.

System_CAPS_pubmethodSystem_CAPS_staticGetEffect(Visual)

Ottiene un effetto bitmap per l'oggetto specificato Visual.

System_CAPS_pubmethodSystem_CAPS_staticGetOffset(Visual)

Restituisce l'offset del Visual.

System_CAPS_pubmethodSystem_CAPS_staticGetOpacity(Visual)

Restituisce l'opacità del Visual.

System_CAPS_pubmethodSystem_CAPS_staticGetOpacityMask(Visual)

Restituisce un Brush che rappresenta la maschera di opacità del valore di Visual.

System_CAPS_pubmethodSystem_CAPS_staticGetParent(DependencyObject)

Restituisce un valore DependencyObject che rappresenta il padre dell'oggetto visivo.

System_CAPS_pubmethodSystem_CAPS_staticGetTransform(Visual)

Restituisce un Transform valore per il Visual.

System_CAPS_pubmethodSystem_CAPS_staticGetXSnappingGuidelines(Visual)

Restituisce una raccolta delle linee guida per la coordinata x (verticale).

System_CAPS_pubmethodSystem_CAPS_staticGetYSnappingGuidelines(Visual)

Restituisce una raccolta delle linee guida per la coordinata Y (orizzontale).

System_CAPS_pubmethodSystem_CAPS_staticHitTest(Visual, HitTestFilterCallback, HitTestResultCallback, HitTestParameters)

Avvia un hit test sull'oggetto Visual specificato, con metodi HitTestFilterCallback e HitTestResultCallback definiti dal chiamante.

System_CAPS_pubmethodSystem_CAPS_staticHitTest(Visual, Point)

Restituisce l'oggetto Visual in primo piano di un hit test specificando Point.

System_CAPS_pubmethodSystem_CAPS_staticHitTest(Visual3D, HitTestFilterCallback, HitTestResultCallback, HitTestParameters3D)

Avvia un hit test sull'oggetto Visual3D specificato, con metodi HitTestFilterCallback e HitTestResultCallback definiti dal chiamante.

System_CAPS_pubmethodSystem_CAPS_staticSetRootDpi(Visual, DpiScale)

Aggiorna le informazioni sulla scala DPI di un elemento visivo. Può essere chiamato solo su un elemento visivo senza un padre.

I nodi nella struttura visiva possono essere Visual o Visual3D oggetti. Metodi specifici di un tipo di oggetto visivo sono tipizzati come Visual o Visual3D. Tuttavia, alcuni metodi di VisualTreeHelper classe può accettare un DependencyObject valore che rappresenta dei tipi di oggetto visivo.

WPFsupporta l'accesso a diverse strutture ad albero di oggetti. In primo luogo, questa viene esposto come un struttura ad albero visuale e albero logico. In alcuni casi, l'albero logico è una rappresentazione più utile degli elementi in un WPF applicazione, ma concettualmente dell'albero logico viene implementato un livello oltre la Visual classe. A differenza di struttura ad albero visuale, l'albero logico può rappresentare gli oggetti visivi di dati, ad esempio ListItem. Per ulteriori informazioni sull'albero logico, vedere alberi in WPF. L'albero logico è supportato anche da una classe di metodo di utilità simile, LogicalTreeHelper.

Nell'esempio seguente viene illustrato come enumerare tutti i discendenti di un oggetto visivo, ovvero una tecnica possibile che si desidera utilizzare se si desidera serializzare tutte le informazioni per il rendering di una gerarchia di oggetti visivi.

// Enumerate all the descendants of the visual object.
static public void EnumVisual(Visual myVisual)
{
    for (int i = 0; i < VisualTreeHelper.GetChildrenCount(myVisual); i++)
    {
        // Retrieve child visual at specified index value.
        Visual childVisual = (Visual)VisualTreeHelper.GetChild(myVisual, i);

        // Do processing of the child visual object.

        // Enumerate children of the child visual object.
        EnumVisual(childVisual);
    }
}

.NET Framework
Disponibile da 3.0
Silverlight
Disponibile da 2.0
Windows Phone Silverlight
Disponibile da 7.0

I membri statici pubblici ( Condiviso in Visual Basic) di questo tipo è thread safe. Non tutti i membri di istanza sono garantiti come thread safe.

Torna all'inizio
Mostra: