IVsUIShellOpenDocument.OpenSpecificEditor Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Открывает указанный редактор.
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
Параметры
- grfOpenSpecific
- UInt32
[in] Значения, взятые из перечисления __VSOSPEFLAGS.
- pszMkDocument
- String
[in] Строковый формат уникального идентификатора моникера документа в системе проектов, например полный путь к файлу. В случаях, когда документ не является файлом, этот идентификатор часто имеет вид URL-адреса.
- rguidEditorType
- Guid
[in] Уникальный идентификатор типа редактора.
- pszPhysicalView
- String
[in] Имя физического представления. Если null
, среда вызывает MapLogicalView(Guid, String) на фабрике редактора, чтобы определить физическое представление, соответствующее логическому представлению. В этом случае null
не задает первичное представление, а указывает, что неизвестно, какое представление соответствует логическому представлению.
- rguidLogicalView
- Guid
[in] Идентификатор GUID, определяющий логическое представление. Список идентификаторов GUID логических представлений см. в разделе с описанием логических и физических представлений. При реализации IVsMultiViewDocumentView в объекте представления документа значение, передаваемое в rguidLogicalView
параметр , определяет, какое представление активируется при отображении окна редактора при создании экземпляра редактора. С помощью идентификаторов GUID логических представлений, вызывающий объект InitializeEditorInstance(UInt32, IntPtr, IntPtr, String, Guid,
String, Guid, String, String, IVsUIHierarchy, UInt32, IntPtr,
IServiceProvider, Guid, IVsWindowFrame) может запросить определенное представление, соответствующее причине запроса такого представления. Например, вызывающая сторона должна указать LOGVIEWID_Debugging для получения представления, подходящего для отладки, или LOGVIEWID_TextView для получения представления, подходящего для текстового редактора (т. е. представления, которое реализует IVsCodeWindow).
- pszOwnerCaption
- String
[in] Начальный заголовок, определенный владельцем документа (проектом) для окна документа. Часто имеет следующий формат: "Имя проекта – имя элемента".
- pHier
- IVsUIHierarchy
[in] Указатель на интерфейс IVsUIHierarchy.
- itemid
- UInt32
[in] Идентификатор элемента иерархии пользовательского интерфейса для указанного редактора. Дополнительные сведения см. в разделе VSITEMID
.
- punkDocDataExisting
-
IntPtr
nativeint
[in] Указатель на интерфейс IUnknown
.
- pSPHierContext
- IServiceProvider
[in] Указатель на интерфейс IServiceProvide
.
- ppWindowFrame
- IVsWindowFrame
[out, retval] Указатель на интерфейс IVsWindowFrame.
Возвращаемое значение
Если метод завершается успешно, возвращает значение S_OK. В противном случае функция возвращает код ошибки.
Комментарии
Сигнатура COM
Из 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
);