Interfejs IVsHierarchy

 

Zapewnia zarządzanie hierarchii dla VSPackages, który implementuje hierarchie projektu.

Przestrzeń nazw:   Microsoft.VisualStudio.Shell.Interop
Zestaw:  Microsoft.VisualStudio.Shell.Interop (w Microsoft.VisualStudio.Shell.Interop.dll)

Składnia

[ComConversionLossAttribute]
[InterfaceTypeAttribute(1)]
[GuidAttribute("59B2D1D0-5DB0-4F9F-9609-13F0168516D6")]
public interface IVsHierarchy

[ComConversionLossAttribute]
[InterfaceTypeAttribute(1)]
[GuidAttribute("59B2D1D0-5DB0-4F9F-9609-13F0168516D6")]
public interface class IVsHierarchy

[<ComConversionLossAttribute>]
[<InterfaceTypeAttribute(1)>]
[<GuidAttribute("59B2D1D0-5DB0-4F9F-9609-13F0168516D6")>]
type IVsHierarchy = interface end

<ComConversionLossAttribute>
<InterfaceTypeAttribute(1)>
<GuidAttribute("59B2D1D0-5DB0-4F9F-9609-13F0168516D6")>
Public Interface IVsHierarchy

Metody

	Nazwa	Opis
	AdviseHierarchyEvents(IVsHierarchyEvents, UInt32)	Ustanawia klienta powiadomienia o zdarzeniach hierarchii bez hierarchii implementacja IConnectionPointContainer.
	Close()	Zamyka i czyści hierarchii, gdy środowisko określa jest już używana.
	GetCanonicalName(UInt32, String)	Zwraca unikatowy, nazwa ciągu dla elementu w hierarchii. Używany dla trwałości obszaru roboczego, takich jak Uzupełnij położenia okien.
	GetGuidProperty(UInt32, Int32, Guid)	Pobiera właściwości, których wartości są identyfikatorów GUID.
	GetNestedHierarchy(UInt32, Guid, IntPtr, UInt32)	Tworzy węzeł w danej hierarchii jako skrót do środka innej hierarchii.
	GetProperty(UInt32, Int32, Object)	Pobiera właściwości danego węzła lub poziomu hierarchii.
	GetSite(IServiceProvider)	Pobiera dostawcy usług, z którego można uzyskać dostęp do usług.
	ParseCanonicalName(String, UInt32)	Zwraca identyfikator elementu hierarchii podanej nazwy kanonicznej.
	QueryClose(Int32)	Określa, czy można zamknąć danej hierarchii.
	SetGuidProperty(UInt32, Int32, Guid)	Ustawia właściwości, których wartości są identyfikatorów GUID.
	SetProperty(UInt32, Int32, Object)	Ustawia właściwości określonego węzła lub poziomu hierarchii.
	SetSite(IServiceProvider)	Ustawia dostawcę usługi, z którego można uzyskać dostęp do usług.
	UnadviseHierarchyEvents(UInt32)	Wyłącza klienta powiadomienia o zdarzeniach hierarchii bez konieczności, aby zaimplementować hierarchii IConnectionPointContainer.
	Unused0()	Dodaje nowe metody bez konieczności ponownego kompilowania lub przerywania zgodność binarny.
	Unused1()	Dodaje nowe metody bez konieczności ponownego kompilowania lub przerywania zgodność binarny.
	Unused2()	Dodaje nowe metody bez konieczności ponownego kompilowania lub przerywania zgodność binarny.
	Unused3()	Dodaje nowe metody bez konieczności ponownego kompilowania lub przerywania zgodność binarny.
	Unused4()	Dodaje nowe metody bez konieczności ponownego kompilowania lub przerywania zgodność binarny.

Metody rozszerzenia

	Nazwa	Opis
	EnumImportingProjects()	Wylicza wszystkie projekty są importowane zasobów współużytkowanych należących do danej hierarchii udostępnionego projektu zasoby.(Zdefiniowane przez: SharedProjectUtilities).
	EnumOwningProjectsOfSharedAssets()	Udostępnione zasoby projektów, właścicielem i zarządzanie nimi zasobów współużytkowanych zaimportowanych przez danego projektu.(Zdefiniowane przez: SharedProjectUtilities).
	GetActiveProjectContext()	Pobiera kontekst aktywnego projektu.(Zdefiniowane przez: SharedProjectUtilities).
	GetSharedItemsImportFullPaths()	Pobiera pełne ścieżki "Shared.items" importowanych danego projektu.(Zdefiniowane przez: SharedProjectUtilities).
	IsCapabilityMatch(String)	Przeciążone. Sprawdza, czy danego projektu spełniają wymagania wskazane w wyrażeniu AppliesTo.(Zdefiniowane przez: PackageUtilities).
	IsProjectImportingSharedAssets()	Określa, czy dany projekt importuje zasobów współużytkowanych.(Zdefiniowane przez: SharedProjectUtilities).
	IsSharedAssetsProject()	Określa, czy projekt danego projektu zasoby udostępnione.(Zdefiniowane przez: SharedProjectUtilities).
	SetActiveProjectContext(IVsHierarchy)	Ustawia kontekst aktywnego projektu.(Zdefiniowane przez: SharedProjectUtilities).

Uwagi

IVsHierarchy Interfejs jest interfejsem generic do hierarchii węzłów.Każdy węzeł, łącznie z węzła głównego, może mieć właściwości dowolnego skojarzonego z nim.Każdy węzeł w obiekcie hierarchii jest identyfikowany przy użyciu pliku cookie (VSITEMID), która wskazuje określonego węzła.Ten plik cookie jest niewidoczne dla konsumenta, z IVsHierarchy, i zazwyczaj jest wskaźnik do niektórych prywatnych danych obsługiwane przez implementację hierarchii.

A VSITEMID jest DWORD unikatowo identyfikuje węzeł w hierarchii.Itemids z jednego IVsHierarchy nie może być przekazana do innej hierarchii.Należy również zauważyć, że itemids ograniczony okres istnienia, jak wskazane przez zdarzenia wywoływane przez hierarchię, aby utrzymać się na itemids długich czasów trwania będzie wymagać albo zatonięcia tych zdarzeń lub konwersji nr przedmiotu w formie kanonicznej, otoka.

Element w hierarchii może być węzła typu liść, kontener z innych zapasów lub łącze do innej hierarchii za pomocą GetNestedHierarchy.

IVsHierarchy Interfejs nie jest używany tylko dla hierarchii projektów.Na przykład Server Explorer implementuje okna IVsHierarchy interfejsu, aby wyświetlić jego hierarchii nie jest hierarchii projektów.

Brak czasu, kiedy jest przydatna do kwerendy hierarchii o różnych węzłów wirtualne, takie jak samej hierarchii lub zaznaczone węzły w hierarchii.Gdzie takie wirtualnego węzły są potencjalnie interesu, jedną z wstępnie zdefiniowanych VSITEMID wartości mogą być przekazywane.

Środowisko widoków projektu jako hierarchii, to znaczy w drzewie węzłów, w których węzły są elementy projektu.Każdy węzeł również ma zestaw skojarzonych z nimi właściwości i zapewnia zarządzanie hierarchii dla VSPackages, który implementuje hierarchie projektu.

Uwagi dotyczące implementacji:

Wdrożone przez VSPackages, że Tworzenie własnej hierarchii projektów.

Uwagi dotyczące wywoływania:

Wywołana przez środowisko i ustawiania właściwości hierarchii.

Zobacz też

Przestrzeń nazw Microsoft.VisualStudio.Shell.Interop

Powrót do początku