UIHierarchy – rozhraní

Představuje standardní nástroj windows v integrovaném vývojovém prostředí (IDE), používající stromů hierarchických dat, jako například Průzkumník řešení, Server Explorer, a Průzkumník maker.

Obor názvů:  EnvDTE
Sestavení:  EnvDTE (v EnvDTE.dll)

Syntaxe

'Deklarace
<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 zveřejňuje následující členy.

Vlastnosti

	Název	Popis
	DTE	Získá objekt nejvyšší úrovně rozšiřitelnosti.
	Parent	Bezprostřední nadřízený objekt získá UIHierarchy objektu.
	SelectedItems	Získá kolekce všech aktuálně vybrané položky.
	UIHierarchyItems	Získá kolekci představující podřízené položky.

Nahoru

Metody

	Název	Popis
	DoDefaultAction	V hierarchii provede stejnou akci jako by měl uživatel poklepali nebo stisknutí klávesy ENTER.
	GetItem	Získá zboží určených danou cestu.
	SelectDown	Vybere uzel bezprostředně pod aktuálně vybraného uzlu, pokud jde o aktuální stavu rozbalení stromové struktuře.
	SelectUp	Vybere uzel přímo nad aktuálně vybraný uzel s ohledem na aktuální stav rozšíření stromové struktuře.

Nahoru

Poznámky

UIHierarchy Objekt poskytuje běžné objektový model pro standardní nástroje systému windows, které představují hierarchická data ve stromové struktuře.Můžete vybrat položky bez ohledu na to, zda budou zobrazeny položky stavu rozbalení stromové struktury.Výběrem položky, který není uveden v aktuálním rozšíření strom způsobuje stromu rozbalte položku zobrazit.

Tento objekt můžete získat pomocí Window.Object v okně Nástroj pro všechny standardní strom.

Vzhledem k tomu, UIHierarchy objekt představuje kteréhokoli okna stromové zobrazení typu, je objekt okna.Jeho UIHierarchyItems vlastnost vrací kolekci nejvyšší úrovně uzlů v zadané okno.V Průzkumník řešení, existuje pouze jeden uzel nejvyšší úrovně, řešení.V Průzkumník maker, je také pouze jeden nejvyšší uzel, uzel makra.To znamená, že uzly projektu nejsou v okně UIHierarchyItems kolekce, ale spíše v kolekci nejvyšší úrovně uzlů.

S tímto vědomím, existují dva způsoby přístupu konkrétním uzlu (UIHierarchyItem):

• Použití GetItem metoda přímého odkazu požadovaného uzlu.

• Použití UIHierarchyItems.Item.UIHierarchyItems... (kolekce/položky/kolekce... vzorek).

  Přejděte do uzlu vnořené hlouběji, nadále používat tento vzor.Například přechod k druhému uzlu nejvyšší úrovně v uzlu, použijte UIHierarchy.UIHierarchyItems.Item(1).UIHierarchyItems.Item(2).

Následují příklady použití obou metod pro přístup k nižší úrovni uzlu.

Příklady

V tomto příkladu GetItem metoda strategii přístupu k uzlu 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

V tomto příkladu UIHierarchyItems.Item.UIHierarchyItems strategie pro přístup k uzlu 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

Viz také

Referenční dokumentace

EnvDTE – obor názvů

Další zdroje

Postupy: Manipulace se zobrazeními stromu pomocí UIHierarchy