Udostępnij za pośrednictwem


IVsUIShellOpenDocument.OpenSpecificEditor Metoda

Definicja

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

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

Dotyczy