Interfejs UIHierarchy

Reprezentuje standardowe narzędzia systemu windows w zintegrowane środowisko programistyczne (IDE) używające hierarchiczne drzewa danych, takich jak Solution Explorer, Server Explorer, i Explorer makro.

Przestrzeń nazw:  EnvDTE
Zestaw:  EnvDTE (w EnvDTE.dll)

Składnia

'Deklaracja
<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

Typ UIHierarchy uwidacznia następujące elementy członkowskie.

Właściwości

	Nazwa	Opis
	DTE	Pobiera obiekt rozszerzeń najwyższego poziomu.
	Parent	Pobiera obiekt nadrzędny natychmiastowe UIHierarchy obiektu.
	SelectedItems	Pobiera jest kolekcją wszystkich aktualnie wybrane elementy.
	UIHierarchyItems	Pobiera kolekcja reprezentujące elementy podrzędne elementu.

Początek

Metody

	Nazwa	Opis
	DoDefaultAction	W hierarchii wykonuje tę samą akcję, tak jakby użytkownik miał dwukrotnym kliknięciu lub nacisnął klawisz ENTER.
	GetItem	Pobiera element wyznaczone przez podane ścieżki.
	SelectDown	Wybiera węzeł bezpośrednio poniżej zaznaczonego węzła w odniesieniu do bieżącego stanu rozwinięcia drzewa.
	SelectUp	Wybiera węzeł bezpośrednio nad aktualnie zaznaczonego węzła w odniesieniu do bieżącego stanu rozwinięcia drzewa.

Początek

Uwagi

UIHierarchy Obiekt udostępnia model obiektu, wspólne dla systemu windows standardowe narzędzie, które są dostępne w widoku drzewa hierarchicznego danych.Można wybrać elementy, niezależnie od tego, czy element widoczny stan rozszerzenia drzewa.Zaznaczenie elementu, który nie został wymieniony w bieżącym ekspansji drzewo powoduje drzewa rozwiń, aby wyświetlić element.

Ten obiekt można uzyskać przy użyciu Window.Object dla każdego okna Narzędzie standardowy widok drzewa.

Ponieważ UIHierarchy dowolnym oknie typ widoku drzewa reprezentuje obiekt, to obiekt Window.Jej UIHierarchyItems właściwość zwraca kolekcję węzłów najwyższego poziomu w określonego okna.W Solution Explorer, istnieje tylko jeden najwyższego poziomu węzła, roztwór.W Explorer makro, również jest tylko jeden węzeł najwyższego poziomu węzła makra.Oznacza to, że węzły projektów nie są w tym oknie UIHierarchyItems kolekcji, ale raczej w kolekcji węzła najwyższego poziomu.

Mając to na uwadze, istnieją dwa sposoby dostępu określonego węzła (UIHierarchyItem):

• Użycie GetItem metoda, aby bezpośrednio odwołać się żądany węzeł.

• Użycie UIHierarchyItems.Item.UIHierarchyItems... (kolekcja/elementu/pobierania... wzór).

  Aby poruszać się głębiej do zagnieżdżenia węzłów, zachować przy użyciu tego wzorca.Na przykład, aby przejść do drugiego węzła w węźle najwyższego poziomu, należy użyć UIHierarchy.UIHierarchyItems.Item(1).UIHierarchyItems.Item(2).

Poniżej podano przykłady użycia obu tych technikach dostępu węzeł niższego poziomu.

Przykłady

W poniższym przykładzie użyto GetItem strategia metoda uzyskiwania dostępu do węzła w 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

W poniższym przykładzie użyto UIHierarchyItems.Item.UIHierarchyItems strategii dostępu do węzła w 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

Zobacz też

Informacje

Przestrzeń nazw EnvDTE

Inne zasoby

Porady: manipulowanie widoków drzewa za pomocą UIHierarchy