Interfaccia UIHierarchy

Rappresenta le finestre degli strumenti standard nell'(IDE) ambiente di sviluppo integrato che utilizzano tali strutture gerarchiche dei dati, ad esempio Esplora soluzioni, Esplora servere Esplora macro.

Spazio dei nomi:  EnvDTE
Assembly:  EnvDTE (in EnvDTE.dll)

Sintassi

'Dichiarazione
<GuidAttribute("72A2A2EF-C209-408C-A377-76871774ADB7")> _
Public Interface UIHierarchy

[GuidAttribute("72A2A2EF-C209-408C-A377-76871774ADB7")]
public interface UIHierarchy

[GuidAttribute(L"72A2A2EF-C209-408C-A377-76871774ADB7")]
public interface class UIHierarchy

[<GuidAttribute("72A2A2EF-C209-408C-A377-76871774ADB7")>]
type UIHierarchy =  interface end

public interface UIHierarchy

Il tipo UIHierarchy espone i seguenti membri.

Proprietà

	Nome	Descrizione
	DTE	Ottiene l'oggetto estensibilità di primo livello.
	Parent	Ottiene l'oggetto padre immediato di un oggetto UIHierarchy oggetto.
	SelectedItems	Ottiene una raccolta di tutti gli elementi attualmente selezionato.
	UIHierarchyItems	Ottiene una raccolta che rappresenta gli elementi figlio dell'elemento.

In alto

Metodi

	Nome	Descrizione
	DoDefaultAction	Nella gerarchia, eseguire la stessa azione come se l'utente ha fatto doppio clic o INVIO premuto.
	GetItem	Ottiene l'elemento definito dal percorso specificato.
	SelectDown	Selezionare il nodo sotto il nodo attualmente selezionato in relazione allo stato di espansione corrente della struttura ad albero.
	SelectUp	Selezionare il nodo immediatamente sopra il nodo attualmente selezionato in relazione allo stato di espansione corrente della struttura ad albero.

In alto

Note

UIHierarchy l'oggetto fornisce un modello a oggetti comune per le finestre degli strumenti standard che presentano i dati gerarchici in una visualizzazione struttura ad albero.È possibile selezionare gli elementi indipendentemente dal fatto che lo stato di espansione di l la struttura ad albero dell'elemento.Selezionare un elemento non viene visualizzato durante l'espansione corrente della struttura ad albero determina la struttura ad albero di controllo si espande per visualizzare l'elemento.

Si ottiene questo oggetto tramite Window.Object in qualsiasi finestra degli strumenti standard di visualizzazione struttura ad albero.

Poiché UIHierarchy l'oggetto rappresenta qualsiasi finestra di visualizzazione-tipo struttura ad albero, è un oggetto Window.Relativo UIHierarchyItems la proprietà restituisce la raccolta di nodi di livello superiore nella finestra specificata.in Esplora soluzioni, esiste un solo nodo di primo livello, la soluzione.in Esplora macro, è inoltre presente un solo nodo di primo livello, il nodo di macro.Ciò significa che i nodi di progetto non sono disponibili nella finestra UIHierarchyItems raccolta, ma piuttosto nella raccolta del nodo di primo livello.

Tenendo presente quanto sopra riportato, esistono due modi per accedere a un nodo specifico (UIHierarchyItem):

• utilizzare GetItem metodo per fare riferimento direttamente al nodo desiderato.

• utilizzo UIHierarchyItems.Item.UIHierarchyItems... (una raccolta//elemento… di raccoltamodello).

  Per spostarsi più in basso in un annidamento del nodo, continuare l'utilizzo di questo modello.Ad esempio, selezionare il secondo nodo sotto il nodo di primo livello, utilizzare UIHierarchy.UIHierarchyItems.Item(1).UIHierarchyItems.Item(2).

Seguenti esempi su come utilizzare entrambe le tecniche per accedere a un nodo di livello inferiore.

Esempi

In questo esempio viene utilizzato GetItem strategia del metodo per accedere a un nodo in un UIHierarchy.

Sub UIHierarchyExample1()
   'Reference the UIHierarchy, UIHierarchyItem, and OutputWindow objects.
   Dim UIH As UIHierarchy = _
     DTE.Windows.Item(Constants.vsWindowKindMacroExplorer).Object
   Dim samples As UIHierarchyItem = UIH.GetItem("Macros\Samples")
   Dim OWPane As OutputWindowPane = GetOutputWindowPane("List Macros")
   Dim file As UIHierarchyItem

   OWPane.Clear()
   For Each file In samples.UIHierarchyItems
      OWPane.OutputString(file.Name & _
        Microsoft.VisualBasic.Constants.vbCrLf)
      Dim macro As UIHierarchyItem
      For Each macro In file.UIHierarchyItems
         OWPane.OutputString("   " & macro.Name & _
           Microsoft.VisualBasic.Constants.vbCrLf)
      Next
   Next
End Sub

Function GetOutputWindowPane(ByVal Name As String, Optional ByVal show _
  As Boolean = True) As OutputWindowPane
   Dim win As Window = _
     DTE.Windows.Item(EnvDTE.Constants.vsWindowKindOutput)
   If show Then win.Visible = True
   Dim ow As OutputWindow = win.Object
   Dim owpane As OutputWindowPane
   Try
      owpane = ow.OutputWindowPanes.Item(Name)
   Catch e As System.Exception
      owpane = ow.OutputWindowPanes.Add(Name)
   End Try
   owpane.Activate()
   Return owpane
End Function

In questo esempio viene utilizzato UIHierarchyItems.Item.UIHierarchyItems strategia per accedere a un nodo in un UIHierarchy.

Sub UIHierarchyExample2()
   Dim UIH As UIHierarchy = _
     DTE.Windows.Item(Constants.vsWindowKindMacroExplorer).Object
     ' Set a reference to the "Samples" node in Macro Explorer. The 
     ' collections are one-based.
     Dim UIHItem As UIHierarchyItem = _
     UIH.UIHierarchyItems.Item(1).UIHierarchyItems.Item(2)
   Dim file As UIHierarchyItem
   Dim OWPane As OutputWindowPane = GetOutputWindowPane("List Macros")
   For Each file In UIHItem.UIHierarchyItems
      OWPane.OutputString(file.Name & _
        Microsoft.VisualBasic.Constants.vbCrLf)
      Dim macro As UIHierarchyItem
      For Each macro In file.UIHierarchyItems
         OWPane.OutputString("   " & macro.Name & _
           Microsoft.VisualBasic.Constants.vbCrLf)
      Next
   Next
End Sub

Vedere anche

Riferimenti

Spazio dei nomi EnvDTE

Altre risorse

Procedura: modificare le visualizzazioni ad albero mediante UIHierarchy