IVsUIShellOpenDocument.OpenSpecificEditor Metodo

Riferimento

Definizione

Spazio dei nomi:: Microsoft.VisualStudio.Shell.Interop

Assembly:: Microsoft.VisualStudio.Shell.Interop.dll

Assembly:: Microsoft.VisualStudio.Interop.dll

Pacchetto:: Microsoft.VisualStudio.Interop v17.12.40391

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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

Si applica a

Condividi tramite