Sdílet prostřednictvím


IVsUIShellOpenDocument.GetStandardEditorFactory – metoda (UInt32, Guid, String, Guid, String, IVsEditorFactory)

 

Vrátí editor factory, spojené s určitým dokumentem (například typ souboru).

Obor názvů:   Microsoft.VisualStudio.Shell.Interop
Sestavení:  Microsoft.VisualStudio.Shell.Interop (v Microsoft.VisualStudio.Shell.Interop.dll)

Syntaxe

int GetStandardEditorFactory(
    uint dwReserved,
    ref Guid pguidEditorType,
    string pszMkDocument,
    [InAttribute] ref Guid rguidLogicalView,
    out string pbstrPhysicalView,
    out IVsEditorFactory ppEF
)
int GetStandardEditorFactory(
    unsigned int dwReserved,
    Guid% pguidEditorType,
    String^ pszMkDocument,
    [InAttribute] Guid% rguidLogicalView,
    [OutAttribute] String^% pbstrPhysicalView,
    [OutAttribute] IVsEditorFactory^% ppEF
)
abstract GetStandardEditorFactory : 
        dwReserved:uint32 *
        pguidEditorType:Guid byref *
        pszMkDocument:string *
        rguidLogicalView:Guid byref *
        pbstrPhysicalView:string byref *
        ppEF:IVsEditorFactory byref -> int
Function GetStandardEditorFactory (
    dwReserved As UInteger,
    ByRef pguidEditorType As Guid,
    pszMkDocument As String,
    <InAttribute> ByRef rguidLogicalView As Guid,
    <OutAttribute> ByRef pbstrPhysicalView As String,
    <OutAttribute> ByRef ppEF As IVsEditorFactory
) As Integer

Parametry

  • dwReserved
    [v] Vyhrazeno pro budoucí použití.
  • pguidEditorType
    [v, out] Identifikátor GUID editor výroby, které mají být vráceny.Chcete-li označit, které editor výroby by měla být vrácena, zadejte hodnotu pro pguidEditorType nebo pszMkDocument.Nelze zadat hodnoty pro oba parametry.
  • pszMkDocument
    [v] Řetězec formuláři zástupný název identifikátor dokumentu v systému projektu, například úplná cesta k souboru.Chcete-li označit, které editor výroby by měla být vrácena, zadejte hodnotu pro pszMkDocument nebo pguidEditorType.Nelze zadat hodnoty pro oba parametry.
  • rguidLogicalView
    [v] GUID identifikující logické zobrazení.Seznam identifikátorů GUID logické zobrazení viz zobrazení logické a fyzické.
  • pbstrPhysicalView
    [výstup] Předaný řetězec fyzické zobrazení, zobrazení, který je přidružen k logické zobrazení identifikátoru GUID odpovídající rguidLogicalView.
  • ppEF
    [out retval] Ukazatel IVsEditorFactory provedení pro požadovaný editor.

Vrácená hodnota

Type: System.Int32

Pokud metoda uspěje, vrací S_OK.Pokud se nezdaří, vrátí kód chyby.

Poznámky

Podpis COM

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

Volání IVsUIShellOpenDocument.GetStandardEditor Pokud potřebujete k programovému přístupu podkladového dokumentu editor, ale není nutné okno úplné editoru vytvořit instanci.Chcete-li to provést, musíte nejprve volat IVsUIShellOpenDocument.GetStandardEditor k získání ukazatele na výrobě editor (IVsEditorFactory).Jakmile to, můžete volat CreateEditorInstance.

Pokud nevlastníte editor factory a tedy neznáte editor GUID (pguidEditorType parametr), editor GUID můžete získat následujícími způsoby:

  • Pokud konkretizaci editoru před můžete použít hodnotu identifikátoru GUID editoru připojených k rám okna, může mít v mezipaměti po stanovení voláním GetProperty a zadáte hodnotu pro VSFPROPID_guidEditorType propid parametr.

  • Máte-li ukazatel na data objektu dokumentu, můžete volat GetGuidEditorType přístup k editoru GUID.

Pokud není možné určit identifikátor GUID editor, zadejte cestu k dokumentu (pszMkDocument parametr) a prostředí určuje odpovídající standardní editor založený na příponu souboru.

Viz také

IVsUIShellOpenDocument – rozhraní
Microsoft.VisualStudio.Shell.Interop – obor názvů

Zpátky na začátek