IVsUIShellOpenDocument.GetStandardEditorFactory(UInt32, Guid, String, Guid, String, IVsEditorFactory) Methode

Definition

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

Int32

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- propid Parameter 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.

Gilt für