IVsUIShell.FindToolWindow(UInt32, Guid, IVsWindowFrame) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
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.