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

Článek
08/05/2016

Otevře zadaný editor.

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

Syntaxe

int OpenSpecificEditor(
    uint grfOpenSpecific,
    string pszMkDocument,
    [InAttribute] ref Guid rguidEditorType,
    string pszPhysicalView,
    [InAttribute] ref Guid rguidLogicalView,
    string pszOwnerCaption,
    IVsUIHierarchy pHier,
    uint itemid,
    IntPtr punkDocDataExisting,
    IServiceProvider pSPHierContext,
    out IVsWindowFrame ppWindowFrame
)

int OpenSpecificEditor(
    unsigned int grfOpenSpecific,
    String^ pszMkDocument,
    [InAttribute] Guid% rguidEditorType,
    String^ pszPhysicalView,
    [InAttribute] Guid% rguidLogicalView,
    String^ pszOwnerCaption,
    IVsUIHierarchy^ pHier,
    unsigned int itemid,
    IntPtr punkDocDataExisting,
    IServiceProvider^ pSPHierContext,
    [OutAttribute] IVsWindowFrame^% ppWindowFrame
)

abstract OpenSpecificEditor : 
        grfOpenSpecific:uint32 *
        pszMkDocument:string *
        rguidEditorType:Guid byref *
        pszPhysicalView:string *
        rguidLogicalView:Guid byref *
        pszOwnerCaption:string *
        pHier:IVsUIHierarchy *
        itemid:uint32 *
        punkDocDataExisting:nativeint *
        pSPHierContext:IServiceProvider *
        ppWindowFrame:IVsWindowFrame byref -> int

Function OpenSpecificEditor (
    grfOpenSpecific As UInteger,
    pszMkDocument As String,
    <InAttribute> ByRef rguidEditorType As Guid,
    pszPhysicalView As String,
    <InAttribute> ByRef rguidLogicalView As Guid,
    pszOwnerCaption As String,
    pHier As IVsUIHierarchy,
    itemid As UInteger,
    punkDocDataExisting As IntPtr,
    pSPHierContext As IServiceProvider,
    <OutAttribute> ByRef ppWindowFrame As IVsWindowFrame
) As Integer

Parametry

grfOpenSpecific
[v] Z hodnoty __VSOSPEFLAGS výčtu.

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] Jedinečný identifikátor typu editor.

pszPhysicalView
[v] Zobrazit fyzický název.Pokud null, volání prostředí MapLogicalView ve výrobě editor k určení fyzické zobrazení, která odpovídá logické zobrazení.V tomto případě null neurčuje primární zobrazení, ale spíše označuje, že neznáte zobrazení, které odpovídá logické zobrazení.

rguidLogicalView
[v] GUID identifikující logické zobrazení.Seznam identifikátorů GUID logické zobrazení viz zobrazení logické a fyzické.Pokud implementujete IVsMultiViewDocumentView na objekt zobrazení dokumentu, pak hodnota předaná do rguidLogicalView parametr určuje zobrazení, které je aktivováno při okna editor se zobrazí po vytvoření instance editoru.Zadáním logické zobrazení GUID volající InitializeEditorInstance mohou požadovat určité zobrazení, které odpovídá důvod volající žádá zobrazení.Volající by například zadat 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).To je často formuláře: "ProjectName-ItemName."

pHier
[v] Ukazatel IVsUIHierarchy rozhraní.

itemid
[v] Identifikátor zboží hierarchie uživatelského rozhraní pro zadaný editor.Další informace získáte v tématu VSITEMID.

punkDocDataExisting
[v] Ukazatel IUnknown rozhraní.

pSPHierContext
[v] Ukazatel IServiceProvide rozhraní.

ppWindowFrame
[out retval] Ukazatel IVsWindowFrame rozhraní.

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::OpenSpecificEditor(
   [in] VSOSPEFLAGS grfOpenSpecific,
   [in] LPCOLESTR pszMkDocument,
   [in] REFGUID rguidEditorType,
   [in] LPCOLESTR pszPhysicalView,
   [in] REFGUID rguidLogicalView,
   [in] LPCOLESTR pszOwnerCaption,
   [in] IVsUIHierarchy *pHier,
   [in] VSITEMID itemid,
   [in] IUnknown *punkDocDataExisting,
   [in] IServiceProvider *pSPHierContext,
   [out, retval] IVsWindowFrame **ppWindowFrame
);

Viz také

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

Zpátky na začátek

Sdílet prostřednictvím