UIHierarchy Arabirim

Verileri hiyerarşik ağaç gibi kullanmak standart aracı windows tümleşik geliştirme ortamında (IDE) temsil eden Çözüm Gezgini, Server Explorer, ve Macro Explorer.

Ad alanı:  EnvDTE
Derleme:  EnvDTE (EnvDTE.dll içinde)

Sözdizimi

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

UIHierarchy türü aşağıdaki üyeleri ortaya koyar.

Özellikler

	Ad	Açıklama
	DTE	Üst düzey bir geniþletilebilirlik nesnesi alır.
	Parent	Hemen üst nesnesi alır bir UIHierarchy nesne.
	SelectedItems	Tüm Seçili öğeleri koleksiyonu alır.
	UIHierarchyItems	Öğenin alt öğelerini temsil eden bir koleksiyon alır.

Üst

Yöntemler

	Ad	Açıklama
	DoDefaultAction	Kullanıcı çift veya ENTER tuşuna bastığınızda vardı sanki hiyerarşisinde aynı eylemi gerçekleştirir.
	GetItem	Yol belirlenen öğesini alır.
	SelectDown	Seçili düğüm ağacının geçerli genişletme durumuna göre hemen altındaki düğüm seçer.
	SelectUp	Seçili düğüm ağacının geçerli genişletme durumuna göre hemen üstündeki düğüm seçer.

Üst

Notlar

UIHierarchy Nesnesi verileri hiyerarşik bir ağaç görünümünde sunan standart araç pencereleri için genel bir nesne modeli sağlar.Olup öğe ağacı genişletme durumunu gösterir ne olursa olsun öğeleri seçebilirsiniz.Geçerli ağaç genişletmede gösterilmeyen bir öğenin seçilmesi, öğeyi gösterecek şekilde genişletilecek ağaç neden olur.

Bu nesneyi kullanarak elde Window.Object tüm standart ağaç görünümü araç penceresinde.

Çünkü UIHierarchy nesnesini temsil eden herhangi bir ağaç görünümü türü penceresi, bir Window nesnesi olur.Kendi UIHierarchyItems özelliği, belirtilen pencerede en üst düzey bir düğümler topluluğunu döndürür.İçinde Çözüm Gezgini, yalnızca tek bir üst düzey düğüm, çözüm yoktur.İçinde Macro Explorer, tek bir üst düzey düğümü, Macros düðümü de bulunmaktadır.Proje düğümlerini pencere içinde değildir yani UIHierarchyItems koleksiyonunda, ancak bunun yerine üst düzey düğümün koleksiyonu.

Bunu göz önünde pul, belirli bir düğümde erişmek için iki yol vardır (UIHierarchyItem):

• Kullanım GetItem doğrudan istenen düğüm başvurmak için yöntem.

• Kullanım UIHierarchyItems.Item.UIHierarchyItems... (bir koleksiyon/madde/koleksiyon... Desen).

  Bir düğüm iç içe içine daha derin gitmek için bu modeli kullanmaya devam.Örneğin, en üst düzey düğümü altındaki İkinci düğüm gezinmek için kullanın UIHierarchy.UIHierarchyItems.Item(1).UIHierarchyItems.Item(2).

Aşağıdaki iki teknik bir alt düzey düğüm erişmek için nasıl kullanılacağını örnekleridir.

Örnekler

Bu örnek kullanır GetItem bir UIHierarchy düğümünde erişme yöntemi stratejisi.

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

Bu örnek kullanır UIHierarchyItems.Item.UIHierarchyItems bir UIHierarchy düğümünde erişmek için strateji.

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

Ayrıca bkz.

Başvuru

EnvDTE Ad Alanı

Diğer Kaynaklar

Nasıl yapılır: UIHierarchy Kullanarak Ağaç Görünümlerini İşleme