IVsRunningDocumentTable4.GetDocumentHierarchyItem(UInt32, IVsHierarchy, UInt32) Méthode

Définition

Elle est fonctionnellement identique à GetDocumentInfo(UInt32, UInt32, UInt32, UInt32, String, IVsHierarchy, UInt32, IntPtr) l’appel et à la demande uniquement des données du document, mais cette méthode est plus facile à utiliser à partir du code managé. Il existe deux États en attente pour un document : RDT_PendingHierarchyInitialization : le projet qui possède le document n’a pas encore été chargé. Cela peut se produire uniquement pendant le chargement de solution asynchrone (ASL). Au fur et à mesure du chargement des projets individuels, les documents détenus par les projets sont mis à jour pour supprimer l’indicateur RDT_PendingHierarchyInitialization. Lorsque la solution est entièrement chargée, aucun document n’est dans cet État. RDT_PendingInitialization: Les données du document n’ont pas été chargées et la vue n’a pas été créée. Un document dans cet État peut également avoir RDT_PendingHierarchyInitialization, mais un document avec RDT_PendingHierarchyInitialization a toujours RDT_PendingInitialization. Les documents dans cet État sont appelés documents paresseux ou stub. Cette méthode provoque le chargement immédiat du projet qui possède un document différé, au lieu d’attendre son chargement normal. ainsi, au moment du retour de la méthode, le document n’a plus de RDT_PendingHierarchyInitialization. Elle n’entraîne pas le chargement du document lui-même. Vous devez d’abord appeler GetDocumentFlags(UInt32) et appeler GetDocumentHierarchyItem uniquement si le document n’a pas de RDT_PendingInitialization parmi ses indicateurs. Vous pouvez être averti que le document a été chargé en s’abonnant à des événements de table de document en cours d’exécution et en recherchant l' RDTA_DocumentInitialized indicateur dans OnAfterAttributeChange(UInt32, UInt32) ou OnAfterAttributeChangeEx(UInt32, UInt32, IVsHierarchy, UInt32, String, IVsHierarchy, UInt32, String) .

public:
 void GetDocumentHierarchyItem(System::UInt32 cookie, [Runtime::InteropServices::Out] Microsoft::VisualStudio::Shell::Interop::IVsHierarchy ^ % hierarchy, [Runtime::InteropServices::Out] System::UInt32 % itemID);
void GetDocumentHierarchyItem(unsigned int cookie, [Runtime::InteropServices::Out] Microsoft::VisualStudio::Shell::Interop::IVsHierarchy const & & hierarchy, [Runtime::InteropServices::Out] unsigned int & itemID);
public void GetDocumentHierarchyItem (uint cookie, out Microsoft.VisualStudio.Shell.Interop.IVsHierarchy hierarchy, out uint itemID);
abstract member GetDocumentHierarchyItem : uint32 *  *  -> unit
Public Sub GetDocumentHierarchyItem (cookie As UInteger, ByRef hierarchy As IVsHierarchy, ByRef itemID As UInteger)

Paramètres

cookie
UInt32

Cookie de document.

hierarchy
IVsHierarchy

à Hiérarchie du projet.

itemID
UInt32

à ID de l’élément.

S’applique à