UIHierarchy – rozhraní

Představuje standardní nástroje systému windows v integrované vývojové prostředí (IDE) používající hierarchické struktury dat, jako 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	Získá bezprostřední nadřízený objekt UIHierarchy objektu.
	SelectedItems	Kolekce všech aktuálně vybrané položky získává.
	UIHierarchyItems	Získá kolekce představující podřízené položky.

Nahoru

Metody

	Název	Popis
	DoDefaultAction	V hierarchii provede stejné akce jako by uživatel měl poklepali nebo stisknutí klávesy ENTER.
	GetItem	Načte položky určená 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ě vybraný uzel s ohledem na aktuální stav rozšíření ve stromu.

Nahoru

Poznámky

UIHierarchy Objekt poskytuje společné objektový model pro standardní nástroje systému windows, které prezentovat data hierarchicky ve stromovém zobrazení.Můžete vybrat položky bez ohledu na to, zda stav rozšíření stromu zobrazuje položky.Výběrem položky, které není zobrazeno v aktuálním stromu rozšiřující způsobí stromu rozbalte položku zobrazit.

Získat tento objekt pomocí Window.Object v okně nástroje libovolné 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á, že 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 na 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 na druhý uzel uzlu nejvyšší úrovně, použijte 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é

Referenční dokumentace

EnvDTE – obor názvů

Další zdroje

Jak: manipulovat pomocí UIHierarchy zobrazení stromu