IVsUIShellOpenDocument.OpenSpecificEditor Metoda

Definicja

Przestrzeń nazw:

Microsoft.VisualStudio.Shell.Interop

Zestaw:

Microsoft.VisualStudio.Interop.dll

Pakiet:

Microsoft.VisualStudio.Interop v17.9.37000

Otwiera określony edytor.

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

Parametry

grfOpenSpecific

UInt32

[in] Wartości pobrane z __VSOSPEFLAGS wyliczenia.

pszMkDocument

String

[in] Formularz ciągu unikatowego identyfikatora moniker dokumentu w systemie projektu, na przykład pełna ścieżka do pliku. W przypadkach niezwiązanych z plikami ten identyfikator jest często w postaci adresu URL.

rguidEditorType

Guid

[in] Unikatowy identyfikator typu edytora.

pszPhysicalView

String

[in] Nazwa widoku fizycznego. Jeśli null, środowisko wywołuje MapLogicalView(Guid, String) fabrykę edytora w celu określenia widoku fizycznego odpowiadającego widokowi logicznemu. W tym przypadku null nie określa widoku podstawowego, ale raczej wskazuje, że nie wiadomo, który widok odpowiada widokowi logicznemu.

rguidLogicalView

Guid

[in] Identyfikator GUID identyfikujący widok logiczny. Aby uzyskać listę identyfikatorów GUID widoku logicznego, zobacz Widok logiczny i Widok fizyczny. Jeśli zaimplementujesz IVsMultiViewDocumentView obiekt widoku dokumentu, wartość przekazana do parametru rguidLogicalView określa, który widok jest aktywowany po wyświetleniu okna edytora po utworzeniu wystąpienia edytora. Określając identyfikator GUID widoku logicznego, obiekt InitializeEditorInstance(UInt32, IntPtr, IntPtr, String, Guid, String, Guid, String, String, IVsUIHierarchy, UInt32, IntPtr, IServiceProvider, Guid, IVsWindowFrame) wywołujący może zażądać określonego widoku zgodnego z przyczyną, dla którego obiekt wywołujący żąda widoku. Na przykład obiekt wywołujący określi LOGVIEWID_Debugging, aby uzyskać widok odpowiedni dla widoku debugowania, lub LOGVIEWID_TextView uzyskać widok odpowiedni dla edytora tekstów (czyli widok implementujący IVsCodeWindow).

pszOwnerCaption

String

[in] Początkowa podpis zdefiniowana przez właściciela dokumentu (czyli projekt) dla okna dokumentu. Jest to często postać" "ProjectName — ItemName".

pHier

IVsUIHierarchy

[in] Wskaźnik do interfejsu IVsUIHierarchy .

itemid

UInt32

[in] Identyfikator elementu hierarchii interfejsu użytkownika dla określonego edytora. Aby uzyskać więcej informacji, zobacz VSITEMID.

punkDocDataExisting

IntPtr

nativeint

[in] Wskaźnik do interfejsu IUnknown .

pSPHierContext

IServiceProvider

[in] Wskaźnik do interfejsu IServiceProvide .

ppWindowFrame

IVsWindowFrame

[out, retval] Wskaźnik do interfejsu IVsWindowFrame .

Zwraca

Int32

Jeśli metoda powiedzie się, zwraca wartość S_OK. Jeśli nie powiedzie się, zwraca kod błędu.

Uwagi

Podpis COM

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