UIHierarchy – rozhraní

Představuje standardní nástroje systému windows v integrované vývojové prostředí (IDE) používající hierarchické struktury dat, například Aplikaci Solution Explorer, Server Explorer, a Explorer makro.

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	Načtení objektu nejvyšší úrovně rozšiřitelnosti.
	Parent	Bezprostřední nadřízený objekt dostane UIHierarchy objektu.
	SelectedItems	Získá kolekce všech aktuálně vybrané položky.
	UIHierarchyItems	Získá kolekce představující podřízené položky.

Na začátek

Metody

	Název	Popis
	DoDefaultAction	V hierarchii jako by uživatel měl poklepali nebo stisknutí klávesy ENTER provede stejnou akci.
	GetItem	Získá položka určených danou cestu.
	SelectDown	Vybere uzel bezprostředně pod aktuálně zvoleného uzlu s ohledem na aktuální stav rozšíření ve stromu.
	SelectUp	Vybere uzel bezprostředně nad aktuálně zvoleného uzlu s ohledem na aktuální stav rozšíření ve stromu.

Na začátek

Poznámky

UIHierarchy Objekt poskytuje společné modelu objektu pro standardní nástroje systému windows současné hierarchických dat v zobrazení stromu. Můžete vybrat položky bez ohledu na to, zda stav rozšíření stromu zobrazuje položky. Výběrem položky, která není v aktuálním stromu rozšiřující způsobí stromu rozbalte položku zobrazit.

Získat tento objekt pomocí Window.Object na libovolné okno Nástroj standardní zobrazení stromu.

Protože UIHierarchy objekt představuje jakýkoli typ zobrazení okna stromu, je objekt okna. Jeho UIHierarchyItems Vlastnost Vrací kolekci nejvyšší úrovně uzlů v zadané okno. V Aplikaci Solution Explorer, existuje pouze jeden nejvyšší uzel, řešení. V Explorer makro, je také pouze jeden nejvyšší uzel, uzel makra. To znamená uzly projektu nejsou v okně UIHierarchyItems kolekce, ale spíše v kolekci uzlu nejvyšší úrovně.

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

• Použití GetItem Metoda přímého odkazu požadovaný uzel.

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

  Chcete-li procházet hlubší do uzlu vnoření, zachovat používání tohoto vzoru. Například chcete-li přejít do druhého uzlu v uzlu nejvyšší úrovně pomocí UIHierarchy.UIHierarchyItems.Item(1).UIHierarchyItems.Item(2).

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

Příklady

V tomto příkladu GetItem strategie metodu přístupu k uzlu v 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 v 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é

Odkaz

EnvDTE – obor názvů

Další zdroje

How to: Manipulate Tree Views by Using UIHierarchy