IVsUIShellOpenDocument.InitializeEditorInstance – metoda (UInt32, IntPtr, IntPtr, String, Guid, String, Guid, String, String, IVsUIHierarchy, UInt32, IntPtr, IServiceProvider, Guid, IVsWindowFrame)

Článek
08/05/2016

Inicializuje instanci editor dokumentu.

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

Syntaxe

int InitializeEditorInstance(
    uint grfIEI,
    IntPtr punkDocView,
    IntPtr punkDocData,
    string pszMkDocument,
    [InAttribute] ref Guid rguidEditorType,
    string pszPhysicalView,
    [InAttribute] ref Guid rguidLogicalView,
    string pszOwnerCaption,
    string pszEditorCaption,
    IVsUIHierarchy pHier,
    uint itemid,
    IntPtr punkDocDataExisting,
    IServiceProvider pSPHierContext,
    [InAttribute] ref Guid rguidCmdUI,
    out IVsWindowFrame ppWindowFrame
)

int InitializeEditorInstance(
    unsigned int grfIEI,
    IntPtr punkDocView,
    IntPtr punkDocData,
    String^ pszMkDocument,
    [InAttribute] Guid% rguidEditorType,
    String^ pszPhysicalView,
    [InAttribute] Guid% rguidLogicalView,
    String^ pszOwnerCaption,
    String^ pszEditorCaption,
    IVsUIHierarchy^ pHier,
    unsigned int itemid,
    IntPtr punkDocDataExisting,
    IServiceProvider^ pSPHierContext,
    [InAttribute] Guid% rguidCmdUI,
    [OutAttribute] IVsWindowFrame^% ppWindowFrame
)

abstract InitializeEditorInstance : 
        grfIEI:uint32 *
        punkDocView:nativeint *
        punkDocData:nativeint *
        pszMkDocument:string *
        rguidEditorType:Guid byref *
        pszPhysicalView:string *
        rguidLogicalView:Guid byref *
        pszOwnerCaption:string *
        pszEditorCaption:string *
        pHier:IVsUIHierarchy *
        itemid:uint32 *
        punkDocDataExisting:nativeint *
        pSPHierContext:IServiceProvider *
        rguidCmdUI:Guid byref *
        ppWindowFrame:IVsWindowFrame byref -> int

Function InitializeEditorInstance (
    grfIEI As UInteger,
    punkDocView As IntPtr,
    punkDocData As IntPtr,
    pszMkDocument As String,
    <InAttribute> ByRef rguidEditorType As Guid,
    pszPhysicalView As String,
    <InAttribute> ByRef rguidLogicalView As Guid,
    pszOwnerCaption As String,
    pszEditorCaption As String,
    pHier As IVsUIHierarchy,
    itemid As UInteger,
    punkDocDataExisting As IntPtr,
    pSPHierContext As IServiceProvider,
    <InAttribute> ByRef rguidCmdUI As Guid,
    <OutAttribute> ByRef ppWindowFrame As IVsWindowFrame
) As Integer

Parametry

grfIEI
[v] Příznaky řízení inicializace editoru.Seznam hodnot výčtu, viz __VSIEIFLAGS.Pokud zadáte hodnotu IEI_DoNotLoadDocData pro tento parametr, pak tato metoda není pokus o načtení vašeho DocData voláním LoadDocData.

punkDocView
[v] Ukazatel IUnknown rozhraní objektu data dokumentu.

punkDocData
[v] Ukazatel IUnknown rozhraní objektu data dokumentu.

pszMkDocument
[v] Řetězec formuláři zástupný název jedinečný identifikátor dokumentu v systému projektu, například úplná cesta k souboru.V případech jiných souborů tento identifikátor je často ve formě adresy URL.

rguidEditorType
[v]Identifikátor GUID typu editor.

pszPhysicalView
[v] Zobrazit fyzický název.

rguidLogicalView
[v] GUID identifikující logické zobrazení.Seznam identifikátorů GUID logické zobrazení viz zobrazení logické a fyzické.Pokud implementujete IVsMultiViewDocumentView na váš datový objekt dokumentu pak hodnota předaná do rguidLogicalView parametr určuje zobrazení, které je aktivováno při zobrazení okna editoru.Když je vytvořena v editoru, zobrazí se okno editoru.Zadáním logické zobrazení GUID volající IVsUIShellOpenDocument::InitializeEditorInstance mohou požadovat určité zobrazení, které odpovídá důvod volající žádá zobrazení.Například by určit volající LOGVIEWID_Debugging získat vhodné pro ladění zobrazení, zobrazení nebo LOGVIEWID_TextView získat vhodné pro textový editor zobrazení (zobrazení, která implementuje IVsCodeWindow).

pszOwnerCaption
[v] Počáteční titulek okna dokumentu definovány vlastník dokumentu (aplikace project).Je tento formát: "ProjectName-ItemName."

pszEditorCaption
[v] Počáteční titulek definován editor dokumentu pro okna dokumentu.Obvykle se jedná o řetězec uzavřený v hranatých závorkách (například [Form]).Počáteční hodnota tohoto parametru je vrácen jako parametr [out] v CreateEditorInstance metoda.

pHier
[v] Ukazatel IVsUIHierarchy rozhraní projektu, která obsahuje dokument.

itemid
[v] UI identifikátor zboží hierarchii dokumentu v systému Microsoft Office project.Další informace získáte v tématu VSITEMID.

punkDocDataExisting
[v] Ukazatel IUnknown rozhraní objektu data dokumentu, pokud data dokumentu objekt již existuje v tabulce spuštěné dokumentu.

pSPHierContext
[v] Poskytovatel metadat specifické pro daný projekt.Další informace naleznete v tématu IServiceProvider.

rguidCmdUI
[v] Identifikátor GUID uživatelského rozhraní příkaz příkazy zobrazení pro tento editor.

ppWindowFrame
[out retval] Rám okna, která obsahuje editor.Další informace naleznete v tématu IVsWindowFrame.

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::InitializeEditorInstance(
   [in] VSIEIFLAGS grfIEI,
   [in] IUnknown *punkDocView,
   [in] IUnknown *punkDocData,
   [in] LPCOLESTR pszMkDocument,
   [in] REFGUID rguidEditorType,
   [in] LPCOLESTR pszPhysicalView,
   [in] REFGUID rguidLogicalView,
   [in] LPCOLESTR pszOwnerCaption,
   [in] LPCOLESTR pszEditorCaption,
   [in] IVsUIHierarchy *pHier,
   [in] VSITEMID itemid,
   [in] IUnknown *punkDocDataExisting,
   [in] IServiceProvider *pSPHierContext,
   [in] REFGUID rguidCmdUI,
   [out, retval] IVsWindowFrame **ppWindowFrame
);

Pro dokumenty založené na souboru a soubor systémem než dokumenty můžete inicializovat editory.Protože IVsUIShellOpenDocument.InitializeEditorInstance trvá pszMkDocumentString jako vstupní parametr, tato metoda podporuje inicializaci editory souborů i jiných založené na souboru.

IVsUIShellOpenDocument.InitializeEditorInstancepomocná funkce volány je CreateEditorInstance.InitializeEditorInstancevolá následující metody v pořadí:

CreateDocumentWindow
LoadDocData(názvem IEI_DoNotLoadDocData pro IVsUIShellOpenDocument::InitializeEditorInstance (grfIEI).
ActivateLogicalView(volat pouze v případě, že data dokumentu objekt implementuje IVsMultiViewDocumentView).

Viz také

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

Zpátky na začátek

Sdílet prostřednictvím