Metoda IVsUIShellOpenDocument.InitializeEditorInstance — (UInt32, IntPtr, IntPtr, String, Guid, String, Guid, String, String, IVsUIHierarchy, UInt32, IntPtr, IServiceProvider, Guid, IVsWindowFrame)

Artykuł
08/06/2016

Inicjuje wystąpienie Edytor dokumentów.

Przestrzeń nazw: Microsoft.VisualStudio.Shell.Interop
Zestaw: Microsoft.VisualStudio.Shell.Interop (w Microsoft.VisualStudio.Shell.Interop.dll)

Składnia

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
Type: System.UInt32

[in] Flagi kontrolowanie inicjowania edytora. Aby uzyskać listę wartości wyliczenia, zobacz __VSIEIFLAGS. W przypadku określenia wartości IEI_DoNotLoadDocData dla tego parametru, następnie ta metoda nie podejmie próbę załadowania programu DocData przez wywołanie metody LoadDocData.

punkDocView
Type: System.IntPtr

[in] Wskaźnik do IUnknown interfejs obiektu danych dokumentu.

punkDocData
Type: System.IntPtr

[in] Wskaźnik do IUnknown interfejs obiektu danych dokumentu.

pszMkDocument
Type: System.String

[in] Ciąg formularza moniker Unikatowy identyfikator dokumentu w systemie projektu, na przykład Pełna ścieżka do pliku. W przypadku plików innych niż ten identyfikator jest często w postaci adresu URL.

rguidEditorType
Type: System.Guid

[in] Identyfikator GUID typu edytora.

pszPhysicalView
Type: System.String

[in] Nazwa widoku fizycznych.

rguidLogicalView
Type: System.Guid

[in] Identyfikator GUID widoku logicznym. Lista identyfikatorów GUID widok logiczny Zobacz widoku logicznej i fizycznej. W przypadku zastosowania IVsMultiViewDocumentView na obiekcie danych dokumentu, następnie wartość przekazywana do rguidLogicalView parametr określa widok jest aktywny, gdy zostanie wyświetlone okno edytora. Okno edytora jest wyświetlana, gdy zostanie uruchomiony Edytor. Określając widok logiczny identyfikatora GUID, obiekt wywołujący IVsUIShellOpenDocument::InitializeEditorInstance mogą żądać specjalny widok, który odpowiada Przyczyna obiekt wywołujący żąda widoku. Na przykład określić obiekt wywołujący LOGVIEWID_Debugging uzyskać odpowiednie do debugowania widok, widok lub LOGVIEWID_TextView uzyskać widok odpowiednie edytora tekstów (, który implementuje widoku IVsCodeWindow).

pszOwnerCaption
Type: System.String

[in] Podpis początkowy zdefiniowane przez właściciela dokumentu (projekt) dla okna dokumentu. Jest to często formatu: "NazwaProjektu — nazwa elementu."

pszEditorCaption
Type: System.String

[in] Podpis początkowy zdefiniowany przez Edytor dokumentów dotyczących okna dokumentu. Zazwyczaj jest to ciąg, ujęte w nawiasy kwadratowe (na przykład [Form]). Początkowa wartość tego parametru jest zwracany jako parametrem [out] w CreateEditorInstance metody.

pHier
Type: Microsoft.VisualStudio.Shell.Interop.IVsUIHierarchy

[in] Wskaźnik do IVsUIHierarchy interfejs projektu, który zawiera dokument.

itemid
Type: System.UInt32

[in] Identyfikator elementu hierarchii interfejsu użytkownika dokumentu w system projektu. Aby uzyskać więcej informacji, zobacz VSITEMID.

punkDocDataExisting
Type: System.IntPtr

[in] Wskaźnik do IUnknown interfejs dokumentu obiektu danych, jeśli dane dokumentu obiekt jest już istnieje w tabeli uruchomionego dokumentu.

pSPHierContext
Type: Microsoft.VisualStudio.OLE.Interop.IServiceProvider

[in] Dostawca usług określonego projektu. Aby uzyskać więcej informacji, zobacz IServiceProvider.

rguidCmdUI
Type: System.Guid

[in] Identyfikator GUID polecenia interfejsu użytkownika poleceń do wyświetlenia tego edytora.

ppWindowFrame
Type: Microsoft.VisualStudio.Shell.Interop.IVsWindowFrame

[out, retval] Ramki okna, który zawiera edytora. Aby uzyskać więcej informacji, zobacz IVsWindowFrame.

Wartość zwracana

Type: System.Int32

Jeśli metoda zakończy się pomyślnie, zwraca S_OK. Jeśli nie, zwraca kod błędu.

Uwagi

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

Edytory mogą być zainicjowane dokumentów opartych na plikach i dokumenty nie opartych na plikach. Ponieważ IVsUIShellOpenDocument.InitializeEditorInstance przyjmuje pszMkDocumentString jako parametr wejściowy, ta metoda obsługuje inicjowanie edytory opartych na plikach jak również innych niż opartych na plikach.

IVsUIShellOpenDocument.InitializeEditorInstance jest to funkcja pomocnika wywoływane przez CreateEditorInstance.InitializeEditorInstance wywołuje następujące metody w kolejności:

CreateDocumentWindow
LoadDocData (o nazwie, chyba że IEI_DoNotLoadDocData określona dla IVsUIShellOpenDocument::InitializeEditorInstance (grfIEI).
ActivateLogicalView (wywoływane tylko wtedy, gdy dane dokumentu obiekt implementuje IVsMultiViewDocumentView).

Zobacz też

Interfejs IVsUIShellOpenDocument
Przestrzeń nazw Microsoft.VisualStudio.Shell.Interop

Powrót do początku

Udostępnij za pośrednictwem