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

Článek
08/05/2016

Vrátí IVsWindowFrame ukazatel myši na požadovaný nástroj jedné instance okna.

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

Syntaxe

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

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

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

Function FindToolWindow (
    grfFTW As UInteger,
    <InAttribute> ByRef rguidPersistenceSlot As Guid,
    <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.

ppWindowFrame
[výstup] Ukazatel IVsWindowFrame objekt obsahující okno nástroje.

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::FindToolWindow(
   [in] VSFINDTOOLWIN grfFTW,
   [in] REFGUID rguidPersistenceSlot,
   [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ě plně vytvořené nástrojem 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