IVsUIShellOpenDocument.OpenSpecificEditor Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
);