IVsUIShell.FindToolWindow(UInt32, Guid, IVsWindowFrame) Método

Definição

Retorna o IVsWindowFrame ponteiro para a janela de ferramenta de instância única solicitada.

public:
 int FindToolWindow(System::UInt32 grfFTW, Guid % rguidPersistenceSlot, [Runtime::InteropServices::Out] Microsoft::VisualStudio::Shell::Interop::IVsWindowFrame ^ % ppWindowFrame);
public int FindToolWindow (uint grfFTW, ref Guid rguidPersistenceSlot, out Microsoft.VisualStudio.Shell.Interop.IVsWindowFrame ppWindowFrame);
abstract member FindToolWindow : uint32 * Guid * IVsWindowFrame -> int
Public Function FindToolWindow (grfFTW As UInteger, ByRef rguidPersistenceSlot As Guid, ByRef ppWindowFrame As IVsWindowFrame) As Integer

Parâmetros

grfFTW
UInt32

no Fornece critérios usados para encontrar uma janela de ferramentas no ambiente. Para obter mais informações, consulte __VSFINDTOOLWIN.

rguidPersistenceSlot
Guid

no Identificador exclusivo para uma janela de ferramenta criada usando CreateToolWindow(UInt32, UInt32, Object, Guid, Guid, Guid, IServiceProvider, String, Int32[], IVsWindowFrame) . O chamador desse método pode usar identificadores predefinidos que são mapeados para janelas de ferramentas se essas janelas de ferramentas forem conhecidas pelo chamador.

ppWindowFrame
IVsWindowFrame

fora Ponteiro para o IVsWindowFrame objeto que contém a janela de ferramentas.

Retornos

Int32

Se o método for bem-sucedido, retornará S_OK. Se falhar, retornará um código de erro.

Comentários

Assinatura COM

De VSShell. idl:

HRESULT IVsUIShell::FindToolWindow(  
   [in] VSFINDTOOLWIN grfFTW,  
   [in] REFGUID rguidPersistenceSlot,  
   [out] IVsWindowFrame **ppWindowFrame  
);  

Esse método requer que exista uma janela de ferramenta totalmente criada. Devido à criação atrasada de janelas de ferramentas, um quadro de janela válido pode existir, mas a janela pode ainda não ter sido criada. Se o quadro da janela não for preenchido com um objeto, o ambiente falhará e a rotina pai será responsável por concluir a criação da janela. No entanto, se você especificar um valor de FTW_fForceCreate para o grfFTW parâmetro, o ambiente tentará criar a janela de ferramentas para você. Se você especificar um valor de FTW_fFrameOnly , o ambiente retornará um ponteiro para o quadro da janela, mesmo que o quadro da janela não seja preenchido com um objeto. Use o FTW_fFrameOnly valor para definir uma propriedade no quadro da janela para uma janela de ferramenta, caso em que uma janela de ferramenta totalmente criada não é necessária.

Aplica-se a