IVsUIShellOpenDocument.GetStandardEditorFactory(UInt32, Guid, String, Guid, String, IVsEditorFactory) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Gibt die Editorfactory zurück, die einem bestimmten Dokument zugeordnet ist (beispielsweise, ein Dateityp).
public:
int GetStandardEditorFactory(System::UInt32 dwReserved, [Runtime::InteropServices::Out] Guid % pguidEditorType, System::String ^ pszMkDocument, Guid % rguidLogicalView, [Runtime::InteropServices::Out] System::String ^ % pbstrPhysicalView, [Runtime::InteropServices::Out] Microsoft::VisualStudio::Shell::Interop::IVsEditorFactory ^ % ppEF);
public int GetStandardEditorFactory (uint dwReserved, out Guid pguidEditorType, string pszMkDocument, ref Guid rguidLogicalView, out string pbstrPhysicalView, out Microsoft.VisualStudio.Shell.Interop.IVsEditorFactory ppEF);
abstract member GetStandardEditorFactory : uint32 * Guid * string * Guid * string * IVsEditorFactory -> int
Public Function GetStandardEditorFactory (dwReserved As UInteger, ByRef pguidEditorType As Guid, pszMkDocument As String, ByRef rguidLogicalView As Guid, ByRef pbstrPhysicalView As String, ByRef ppEF As IVsEditorFactory) As Integer
Parameter
- dwReserved
- UInt32
[in] Reserviert für zukünftige Verwendung.
- pguidEditorType
- Guid
[in, out] GUID der Editorfactory, die zurückgegeben werden soll. Geben Sie einen Wert für oder an, um anzugeben, welche Editorfactory zurückgegeben werden soll pguidEditorType pszMkDocument . Kein Bereitstellen von Werten für beide Parameter.
- pszMkDocument
- String
[in] Zeichenfolgendarstellung des Monikerbezeichners des Dokuments im Projektsystem, beispielsweise der vollständige Pfad zur Datei. Geben Sie einen Wert für oder an, um anzugeben, welche Editorfactory zurückgegeben werden soll pszMkDocument pguidEditorType . Kein Bereitstellen von Werten für beide Parameter.
- rguidLogicalView
- Guid
[in] GUID, die die logische Ansicht identifiziert. Eine Liste der logischen Ansichts-GUIDS finden Sie unter der logischen Ansicht und der physischen Ansicht.
- pbstrPhysicalView
- String
vorgenommen Die physische Ansichts Zeichenfolge, die der Ansicht entspricht, die der über gebenden GUID der logischen Ansicht zugeordnet ist rguidLogicalView .
- ppEF
- IVsEditorFactory
[out, retval] Zeiger auf die IVsEditorFactory-Implementierung für den angeforderten Editor.
Gibt zurück
Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Bei einem Fehler wird ein Fehlercode zurückgegeben.
Hinweise
COM-Signatur
Aus vsshell. idl:
HRESULT IVsUIShellOpenDocument::GetStandardEditorFactory(
[in] DWORD dwReserved,
[in, out] GUID *pguidEditorType,
[in] LPCOLESTR pszMkDocument,
[in] REFGUID rguidLogicalView,
[out] BSTR *pbstrPhysicalView,
[out, retval] IVsEditorFactory **ppEF
);
Aufrufen IVsUIShellOpenDocument.GetStandardEditor , wenn Sie Programm gesteuert auf die zugrunde liegenden Dokument Daten eines Editors zugreifen müssen, aber das vollständige Editor Fenster nicht instanziiert werden muss. Zu diesem Zweck müssen Sie zuerst aufzurufen, IVsUIShellOpenDocument.GetStandardEditor um einen Zeiger auf die Editorfactory ( IVsEditorFactory ) zu erhalten. Anschließend können Sie den Befehl CreateEditorInstance .
Wenn Sie die Editorfactory nicht besitzen und die Editor-GUID (- pguidEditorType Parameter) nicht kennen, können Sie die Editor-GUID auf eine der folgenden Arten erhalten:
Wenn Sie den Editor zuvor instanziiert haben, können Sie den-Editor-GUID-Wert verwenden, der an den Fensterrahmen angefügt ist, den Sie nach der Ermittlung möglicherweise zwischengespeichert haben, indem Sie aufrufen GetProperty und den Wert VSFPROPID_guidEditorType für den-
propidParameter angeben.Wenn Sie einen Zeiger auf das Dokument Datenobjekt haben, können Sie aufrufen, GetGuidEditorType um auf die Editor-GUID zuzugreifen.
Wenn es Ihnen nicht möglich ist, die Editor-GUID anzugeben, geben Sie den Pfad zum Dokument ( pszMkDocument -Parameter) an, und die Umgebung bestimmt den entsprechenden Standard-Editor basierend auf der Dateierweiterung.