IVsUIShellOpenDocument.IsSpecificDocumentViewOpen – metoda (IVsUIHierarchy, UInt32, String, Guid, String, UInt32, IVsUIHierarchy, UInt32, IVsWindowFrame, Int32)

Článek
08/05/2016

Určuje, zda je zobrazení zadaný dokument otevřít.

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

Syntaxe

int IsSpecificDocumentViewOpen(
    IVsUIHierarchy pHierCaller,
    uint itemidCaller,
    string pszMkDocument,
    [InAttribute] ref Guid rguidEditorType,
    string pszPhysicalView,
    uint grfIDO,
    out IVsUIHierarchy ppHierOpen,
    out uint pitemidOpen,
    out IVsWindowFrame ppWindowFrame,
    out int pfOpen
)

int IsSpecificDocumentViewOpen(
    IVsUIHierarchy^ pHierCaller,
    unsigned int itemidCaller,
    String^ pszMkDocument,
    [InAttribute] Guid% rguidEditorType,
    String^ pszPhysicalView,
    unsigned int grfIDO,
    [OutAttribute] IVsUIHierarchy^% ppHierOpen,
    [OutAttribute] unsigned int% pitemidOpen,
    [OutAttribute] IVsWindowFrame^% ppWindowFrame,
    [OutAttribute] int% pfOpen
)

abstract IsSpecificDocumentViewOpen : 
        pHierCaller:IVsUIHierarchy *
        itemidCaller:uint32 *
        pszMkDocument:string *
        rguidEditorType:Guid byref *
        pszPhysicalView:string *
        grfIDO:uint32 *
        ppHierOpen:IVsUIHierarchy byref *
        pitemidOpen:uint32 byref *
        ppWindowFrame:IVsWindowFrame byref *
        pfOpen:int byref -> int

Function IsSpecificDocumentViewOpen (
    pHierCaller As IVsUIHierarchy,
    itemidCaller As UInteger,
    pszMkDocument As String,
    <InAttribute> ByRef rguidEditorType As Guid,
    pszPhysicalView As String,
    grfIDO As UInteger,
    <OutAttribute> ByRef ppHierOpen As IVsUIHierarchy,
    <OutAttribute> ByRef pitemidOpen As UInteger,
    <OutAttribute> ByRef ppWindowFrame As IVsWindowFrame,
    <OutAttribute> ByRef pfOpen As Integer
) As Integer

Parametry

pHierCaller
[v] Předaný identifikátor volajícího hierarchie jako ukazatel volajícího IVsUIHierarchy provedení.Tento parametr je používán prostředí provádění IsSpecificDocumentViewOpen Pokud volající Určuje hodnotu pro IDO_ActivateIfOpen grfIDO parametr..

itemidCaller
[v] UI hierarchie položky identifikátor volajícího.S IDO_ActivateIfOpen.Další informace získáte v tématu VSITEMID.

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 editor factory.Tato hodnota v kombinaci s pszPhysicalView se používá k vytvoření jedinečný identifikátor zobrazení zadaného dokumentu.

pszPhysicalView
[v] Zobrazit fyzické řetězec.Tato hodnota v kombinaci s rguidEditorType, slouží k vytvoření jedinečný identifikátor zobrazení zadaného dokumentu.

grfIDO
[v] Příznaky, které určují, jaké akce jsou prováděny u otevřeného dokumentu.Seznam hodnot naleznete v tématu __VSIDOFLAGS.

ppHierOpen
[výstup] Pokud pfOpen je true, pak je tento parametr ukazatel na IVsUIHierarchy provádění IVsHierarchy , vlastní zobrazení.Pokud pfOpen je false, pak je tento parametr null.

pitemidOpen
[výstup] Pokud je pfOpen true, pak je tento parametr ukazatel na identifikátor položky uživatelského rozhraní hierarchie otevřít dokument, který je představován zadané zobrazení.Pokud pfOpen je false, pak je tento parametr null.Další informace získáte v tématu VSITEMID.

ppWindowFrame
[výstup] Pokud je pfOpen true, pak je tento parametr ukazatel na IVsWindowFrame obsahující zadané zobrazení.

pfOpen
[out retval] true při zobrazení zadaného dokumentu.falsePokud zobrazení zadaný dokument není otevřen.

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::IsSpecificDocumentViewOpen(
   [in] IVsUIHierarchy *pHierCaller,
   [in] VSITEMID itemidCaller,
   [in] LPCOLESTR pszMkDocument,
   [in] REFGUID rguidEditorType,
   [in] LPCOLESTR pszPhysicalView,
   [in] VSIDOFLAGS grfIDO,
   [out] IVsUIHierarchy **ppHierOpen,
   [out] VSITEMID *pitemidOpen,
   [out] IVsWindowFrame **ppWindowFrame,
   [out, retval] BOOL *pfOpen
);

IsSpecificDocumentViewOpentrvá pár hierarchie/ID tématu jako vstup, který identifikuje volajícího, který chce vědět, zda je otevřen v zobrazení.Tato metoda zobrazení zadaný dokument je otevřen v IDE, porovná tuto dvojici hierarchie/ID tématu hierarchie/ID tématu dvojice, která má aktuálně otevřeného dokumentu (to znamená vlastnící hierarchie) k určení, zda jsou různé hierarchie.

Pokud má jinou hierarchii zobrazit dokument otevřít a implementuje hierarchie IVsSupportItemHandoff, pak bude IVsUIShellOpenDocument::IsSpecificDocumentViewOpen provádění volání v hierarchii IVsSupportItemHandoff provádění a průchody dvojice hierarchie/ID tématu pro volající hierarchie (pHierCaller/itemidCaller).Dokument pak předána volající hierarchie.Pokud je v hierarchii neimplementuje IVsSupportItemHandoff, následující text se zobrazí okno se zprávou, "otevření dokumentu v jiném projektu.", zobrazení dokumentu nejsou převedeny do hierarchie volajícího a existující zobrazení dokumentu dojde k posunu v rámci hierarchie vlastnící.

Viz také

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

Zpátky na začátek

Sdílet prostřednictvím