IVsUIShellOpenDocument.OpenSpecificEditor Metodo

Definizione

Spazio dei nomi:

Microsoft.VisualStudio.Shell.Interop

Assembly:

Microsoft.VisualStudio.Interop.dll

Pacchetto:

Microsoft.VisualStudio.Interop v17.9.37000

Apre un editor specificato.

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

Parametri

grfOpenSpecific

UInt32

[in] Valori forniti dall'enumerazione __VSOSPEFLAGS.

pszMkDocument

String

[in] Formato stringa dell'identificatore di moniker univoco del documento nel sistema del progetto, ad esempio il percorso completo del file. In casi non di file, questo identificatore è spesso nel formato di URL.

rguidEditorType

Guid

[in] Identificatore univoco del tipo di editor.

pszPhysicalView

String

[in] Nome della visualizzazione fisica. Se null, l'ambiente chiama il metodo MapLogicalView(Guid, String) sulla factory dell'editor per determinare la visualizzazione fisica che corrisponde alla visualizzazione logica. In questo caso, null non specifica la visualizzazione primaria, bensì indica che non si conosce quale visualizzazione corrisponde alla visualizzazione logica.

rguidLogicalView

Guid

[in] GUID che identifica la visualizzazione logica. Per un elenco di GUID della visualizzazione logica, vedere Visualizzazione logica e Visualizzazione fisica. Se si implementa IVsMultiViewDocumentView nell'oggetto visualizzazione documento, il valore passato al rguidLogicalView parametro determina quale visualizzazione viene attivata quando viene visualizzata la finestra dell'editor quando viene creata un'istanza dell'editor. Specificando la visualizzazione logica GUID, il chiamante di InitializeEditorInstance(UInt32, IntPtr, IntPtr, String, Guid, String, Guid, String, String, IVsUIHierarchy, UInt32, IntPtr, IServiceProvider, Guid, IVsWindowFrame) può richiedere la visualizzazione specifica che corrisponde al motivo per cui il chiamante sta richiedendo la visualizzazione. Ad esempio, il chiamante specifica LOGVIEWID_Debugging per ottenere la visualizzazione appropriata per la visualizzazione di debug o LOGVIEWID_TextView per ottenere la visualizzazione appropriata per l'editor di testo (ovvero una visualizzazione che implementa IVsCodeWindow).

pszOwnerCaption

String

[in] Didascalia iniziale definita dal proprietario del documento (cioè il progetto) per la finestra del documento. È spesso del form: "ProjectName – ItemName".

pHier

IVsUIHierarchy

[in] Puntatore all'interfaccia IVsUIHierarchy.

itemid

UInt32

[in] Identificatore dell'elemento della gerarchia dell'interfaccia utente dell'editor specificato. Per ulteriori informazioni, vedere VSITEMID.

punkDocDataExisting

IntPtr

nativeint

[in] Puntatore all'interfaccia IUnknown.

pSPHierContext

IServiceProvider

[in] Puntatore all'interfaccia IServiceProvide.

ppWindowFrame

IVsWindowFrame

[out, retval)] Puntatore all'interfaccia IVsWindowFrame.

Restituisce

Int32

Se il metodo ha esito positivo, viene restituito S_OK. Se ha esito negativo, viene restituito un codice di errore.

Commenti

Firma COM

Da 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  
);