Udostępnij za pośrednictwem

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

  • Artykuł

 

Zwraca IVsWindowFrame wskaźnik do okna żądanego narzędzia jednego wystąpienia.

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

Składnia

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
    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.

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::FindToolWindow(
   [in] VSFINDTOOLWIN grfFTW,
   [in] REFGUID rguidPersistenceSlot,
   [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 pełni utworzony narzędzia nie jest wymagane.

Zobacz też

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

Powrót do początku