IVsUIShell.FindToolWindowEx – metoda (UInt32, Guid, UInt32, IVsWindowFrame)

Článek
08/05/2016

Vrátí IVsWindowFrame okna požadované instance jednoho nebo vícestupňové nástroj ukazatel.

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

Syntaxe

int FindToolWindowEx(
    uint grfFTW,
    [InAttribute] ref Guid rguidPersistenceSlot,
    uint dwToolWinId,
    out IVsWindowFrame ppWindowFrame
)

int FindToolWindowEx(
    unsigned int grfFTW,
    [InAttribute] Guid% rguidPersistenceSlot,
    unsigned int dwToolWinId,
    [OutAttribute] IVsWindowFrame^% ppWindowFrame
)

abstract FindToolWindowEx : 
        grfFTW:uint32 *
        rguidPersistenceSlot:Guid byref *
        dwToolWinId:uint32 *
        ppWindowFrame:IVsWindowFrame byref -> int

Function FindToolWindowEx (
    grfFTW As UInteger,
    <InAttribute> ByRef rguidPersistenceSlot As Guid,
    dwToolWinId As UInteger,
    <OutAttribute> ByRef ppWindowFrame As IVsWindowFrame
) As Integer

Parametry

grfFTW
[v] Obsahuje kritéria pro hledání okno nástroje v prostředí.Další informace naleznete v tématu __VSFINDTOOLWIN.

rguidPersistenceSlot
[v] Jedinečný identifikátor pro okno nástroj vytvořený pomocí CreateToolWindow.Volající tuto metodu můžete použít předdefinované identifikátory mapování na nástroje systému windows, pokud volající jsou známy tyto nástroje systému windows.

dwToolWinId
[v] Identifikátor okna požadovaný nástroj v okně nástroje multi instance.První výskyt více instancí nástroje okno má identifikátor 0, druhá instance má identifikátor jedna a podobně.

ppWindowFrame
[výstup] Ukazatel IVsWindowFrame rozhraní nástroje požadované okno

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 IVsUIShell::FindToolWindowEx(
   [in] VSFINDTOOLWIN grfFTW,
   [in] REFGUID rguidPersistenceSlot,
   [in] DWORD dwToolWinId,
   [out] IVsWindowFrame **ppWindowFrame
);

Tato metoda vyžaduje existenci zcela vytvořen nástroj okna.Z důvodu opožděné vytvoření nástroje systému windows může existovat platná okna, ale okno může mít ještě nebyl vytvořen.Pokud objekt není vyplněn rám okna prostředí selže a rutinní nadřazené je zodpovědný za dokončení vytváření okna.Však zadáte hodnotu FTW_fForceCreate pro grfFTW parametr, pak prostředí pokusí vytvořit okno nástroje.Pokud zadáte hodnotu FTW_fFrameOnly, prostředí i v případě, že objekt není naplněna rám okna vrátí ukazatel na rám okna.Použití FTW_fFrameOnly hodnotu nastavení vlastnosti na rám okna pro nástroj okno, v kterémžto případě zcela vytvořen nástroj okno není vyžadováno.

Viz také

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

Zpátky na začátek

Sdílet prostřednictvím