IVsAsyncShellOpenDocument.OpenDocumentViaProjectWithSpecificAsync Méthode

Définition

Espace de noms:

Microsoft.VisualStudio.Shell.Interop

Assembly:

Microsoft.VisualStudio.Interop.dll

Paquet:

Microsoft.VisualStudio.Interop v17.9.37000

Recherche un projet spécifié pour ouvrir ce document.

public Microsoft.VisualStudio.Shell.Interop.IVsTask OpenDocumentViaProjectWithSpecificAsync (string documentMoniker, uint specificEditorFlags, Guid editorType, string? physicalView, Guid logicalView);

abstract member OpenDocumentViaProjectWithSpecificAsync : string * uint32 * Guid * string * Guid -> Microsoft.VisualStudio.Shell.Interop.IVsTask

Public Function OpenDocumentViaProjectWithSpecificAsync (documentMoniker As String, specificEditorFlags As UInteger, editorType As Guid, physicalView As String, logicalView As Guid) As IVsTask

Paramètres

documentMoniker

String

Forme de chaîne de l’identificateur de moniker unique du document dans le système de projet, par exemple, le chemin d’accès complet au fichier. En cas d'absence de fichier, cet identificateur se présente souvent sous la forme d'une URL.

specificEditorFlags

UInt32

Indicateurs dont les valeurs sont extraites de l’énumération __VSSPECIFICEDITORFLAGS.

editorType

Guid

Identificateur unique du type d’éditeur.

physicalView

String

Identificateur unique de la vue physique.

logicalView

Guid

Identifiant Guid la vue logique. La vue par défaut est VSConstants.LOGVIEWID_Primary et chaque éditeur doit prendre en charge cette vue.

Si l’éditeur implémente IVsMultiViewDocumentView sur l’objet d’affichage de document, la valeur passée à ActivateLogicalView(Guid), qui détermine quelle vue est activée lorsque la fenêtre de l’éditeur s’affiche.

En spécifiant la vue Guidlogique , vous pouvez demander la vue spécifique qui correspond à la raison pour laquelle vous demandez la vue. Par exemple, spécifiez VSConstants.LOGVIEWID_Debugging pour obtenir la vue appropriée pour déboguer, ou VSConstants.LOGVIEWID_TextView pour obtenir la vue appropriée pour l'éditeur de texte (autrement dit, une vue qui implémente IVsCodeWindow).

Retours

IVsTask

Tâche représentant l’opération ouverte. Le résultat de la tâche est un IVsAsyncOpenDocumentResult objet.

Remarques

La tâche retournée par cette méthode n’indique pas que la vue et les docdata du document ont été chargées. Consultez DocumentLoadTask pour plus d’informations.

Cette méthode est utilisée par les VSPackages qui ne sont pas des projets qui doivent ouvrir un document dans un éditeur spécifique, mais qui ne se soucient pas du projet qui ouvre le fichier. Pour appeler cette méthode à partir de votre VSPackage, vous devez savoir exactement quelle fabrique d’éditeur vous souhaitez et quelle fenêtre vous souhaitez que la fabrique de l’éditeur crée (autrement dit, la vue physique). L’affichage logique spécifié dans le logicalView paramètre vous permet également de spécifier l’onglet qui doit être affiché par l’éditeur si l’éditeur implémente IVsMultiViewDocumentView.

Cette méthode appelle OpenItem(UInt32, Guid, IntPtr, IVsWindowFrame). Si aucun projet ne peut traiter le fichier et que le projet Fichiers divers n’est pas déjà présent, l’environnement crée le projet Fichiers divers et réessaye.