IVsUIShellOpenDocument.OpenSpecificEditor Méthode

Définition

Ouvre un éditeur spécifié.

public:
 int OpenSpecificEditor(System::UInt32 grfOpenSpecific, System::String ^ pszMkDocument, Guid % rguidEditorType, System::String ^ pszPhysicalView, Guid % rguidLogicalView, System::String ^ pszOwnerCaption, Microsoft::VisualStudio::Shell::Interop::IVsUIHierarchy ^ pHier, System::UInt32 itemid, IntPtr punkDocDataExisting, Microsoft::VisualStudio::OLE::Interop::IServiceProvider ^ pSPHierContext, [Runtime::InteropServices::Out] Microsoft::VisualStudio::Shell::Interop::IVsWindowFrame ^ % ppWindowFrame);
public int OpenSpecificEditor (uint grfOpenSpecific, string pszMkDocument, ref Guid rguidEditorType, string pszPhysicalView, ref Guid rguidLogicalView, string pszOwnerCaption, Microsoft.VisualStudio.Shell.Interop.IVsUIHierarchy pHier, uint itemid, IntPtr punkDocDataExisting, Microsoft.VisualStudio.OLE.Interop.IServiceProvider pSPHierContext, out Microsoft.VisualStudio.Shell.Interop.IVsWindowFrame ppWindowFrame);
abstract member OpenSpecificEditor : uint32 * string * Guid * string * Guid * string * Microsoft.VisualStudio.Shell.Interop.IVsUIHierarchy * uint32 * nativeint * Microsoft.VisualStudio.OLE.Interop.IServiceProvider * IVsWindowFrame -> int
Public Function OpenSpecificEditor (grfOpenSpecific As UInteger, pszMkDocument As String, ByRef rguidEditorType As Guid, pszPhysicalView As String, ByRef rguidLogicalView As Guid, pszOwnerCaption As String, pHier As IVsUIHierarchy, itemid As UInteger, punkDocDataExisting As IntPtr, pSPHierContext As IServiceProvider, ByRef ppWindowFrame As IVsWindowFrame) As Integer

Paramètres

grfOpenSpecific
UInt32

[in] Valeurs issues de l'énumération __VSOSPEFLAGS.

pszMkDocument
String

[in] Format 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.

rguidEditorType
Guid

[in] Identificateur unique du type d'éditeur.

pszPhysicalView
String

[in] Nom de l'affichage physique. Si null, l'environnement appelle MapLogicalView(Guid, String) sur la fabrique d'éditeur pour déterminer la vue physique qui correspond à la vue logique. Dans ce cas, la valeur null ne spécifie pas la vue principale, mais indique plutôt que vous ne pouvez pas déterminer la vue correspondant à la vue logique.

rguidLogicalView
Guid

[in] GUID identifiant l'affichage logique. Pour obtenir une liste des GUID de vue logique, consultez Logical View et Physical View. Si vous implémentez IVsMultiViewDocumentView sur votre objet d’affichage de document, la valeur transmise au rguidLogicalView paramètre détermine quelle vue est activée lorsque la fenêtre de l’éditeur s’affiche lorsque l’éditeur est instancié. En spécifiant le GUID de la vue logique, l'appelant d'InitializeEditorInstance(UInt32, IntPtr, IntPtr, String, Guid, String, Guid, String, String, IVsUIHierarchy, UInt32, IntPtr, IServiceProvider, Guid, IVsWindowFrame) peut demander la vue spécifique qui correspond à la raison pour laquelle l'appelant demande la vue. Par exemple, l'appelant spécifie LOGVIEWID_Debugging pour obtenir la vue appropriée pour la vue de débogage, ou LOGVIEWID_TextView pour obtenir la vue appropriée pour l'éditeur de texte (autrement dit, une vue qui implémente IVsCodeWindow).

pszOwnerCaption
String

[in] Légende initiale définie par le propriétaire du document (autrement dit, le projet) de la fenêtre de document. Il s'agit souvent du format : « NomProjet – ItemName ».

pHier
IVsUIHierarchy

[in] Pointeur vers l'interface IVsUIHierarchy.

itemid
UInt32

[in] Identificateur d'élément de hiérarchie d'interface utilisateur pour l'éditeur spécifié. Pour plus d'informations, consultez VSITEMID.

punkDocDataExisting
IntPtr

nativeint

[in] Pointeur vers l'interface IUnknown.

pSPHierContext
IServiceProvider

[in] Pointeur vers l'interface IServiceProvide.

ppWindowFrame
IVsWindowFrame

[out, retval] Pointeur vers l'interface IVsWindowFrame.

Retours

Si la méthode réussit, retourne S_OK. En cas d'échec, retourne un code d'erreur.

Remarques

COM Signature

À partir de vsshell.idl :

HRESULT IVsUIShellOpenDocument::OpenSpecificEditor(  
   [in] VSOSPEFLAGS grfOpenSpecific,  
   [in] LPCOLESTR pszMkDocument,  
   [in] REFGUID rguidEditorType,  
   [in] LPCOLESTR pszPhysicalView,  
   [in] REFGUID rguidLogicalView,  
   [in] LPCOLESTR pszOwnerCaption,  
   [in] IVsUIHierarchy *pHier,  
   [in] VSITEMID itemid,  
   [in] IUnknown *punkDocDataExisting,  
   [in] IServiceProvider *pSPHierContext,  
   [out, retval] IVsWindowFrame **ppWindowFrame  
);  

S’applique à