Udostępnij za pośrednictwem

Metoda IVsUIShell.FindToolWindowEx — (UInt32, Guid, UInt32, IVsWindowFrame)

  • Artykuł

 

Zwraca IVsWindowFrame wskaźnik dla żądanego instance jednego lub kilku okna narzędzia.

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

Składnia

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

    [in] Zawiera kryteria używane do znajdowania okno narzędzia w środowisku. Aby uzyskać więcej informacji, zobacz __VSFINDTOOLWIN.

  • rguidPersistenceSlot
    Type: System.Guid

    [in] Unikatowy identyfikator utworzony przy użyciu okna narzędzia CreateToolWindow. Obiekt wywołujący tej metody można użyć wstępnie zdefiniowane identyfikatory, które mapowania okna narzędzi, jeśli te okna narzędzi są znane do obiektu wywołującego.

  • dwToolWinId
    Type: System.UInt32

    [in] Identyfikator okno żądanego narzędzia w oknie narzędzia multi wystąpienia. Pierwsze wystąpienie okna narzędzia wielu wystąpień ma identyfikator zero, drugie wystąpienie ma identyfikator co i tak dalej.

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

Ta metoda wymaga istnienia okna narzędzia pełni utworzony. Z powodu opóźnionego tworzenie okien narzędzi prawidłowym zakresem okienka może istnieć, ale okno może nie utworzono jeszcze. Jeśli ramki okna nie jest wypełniony obiekt środowiska nie powiedzie się i procedury nadrzędny jest odpowiedzialny za zakończenie tworzenia okna. Jednak w przypadku określenia wartości FTW_fForceCreate dla grfFTW parametru, a następnie środowiska próbuje utworzyć okna narzędzia. Jeśli określono wartość FTW_fFrameOnly, a następnie środowiska zwraca wskaźnik do ramki okna, nawet jeśli obiektu nie jest wypełniony ramki okna. Użyj FTW_fFrameOnly wartość do ustawienia właściwości na ramki okna dla okna narzędzi, w tym przypadku okno narzędzia pełni utworzony nie jest wymagana.

Zobacz też

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

Powrót do początku