Método IOleWindow::GetWindow (oleidl.h)

  • Artigo

Recupera um identificador para uma das janelas que participam da ativação in-loco (janela de objeto quadro, documento, pai ou in-loco).

Sintaxe

HRESULT GetWindow(
  [out] HWND *phwnd
);

Parâmetros

[out] phwnd

Um ponteiro para uma variável que recebe o identificador de janela.

Valor retornado

Esse método retorna S_OK com êxito. Outros valores retornados possíveis incluem o seguinte.

Código de retorno Descrição
E_FAIL
 O objeto é sem janelas.
E_INVALIDARG
 O valor fEnterMode especificado não é válido.
E_OUTOFMEMORY
 Não há memória suficiente disponível para esta operação.
E_UNEXPECTED
 Ocorreu um erro inesperado.

Comentários

Cinco tipos de janelas compõem a hierarquia do Windows. Quando um objeto está ativo no local, ele tem acesso a algumas ou a todas essas janelas.

Janela Descrição
Quadro A janela de main mais externa em que reside o menu main do aplicativo de contêiner.
Documento A janela que exibe o documento composto que contém o objeto inserido ao usuário.
Painel A subwindow da janela do documento que contém a exibição do objeto. Aplicável somente a aplicativos com janelas de painel dividido.
Parent A janela de contêiner que contém a exibição desse objeto. O aplicativo de objeto instala sua janela como um filho desta janela.
No local A janela que contém o objeto in-loco ativo. O aplicativo de objeto cria essa janela e a instala como um filho da janela do hatch, que é um filho da janela pai do contêiner.
 

Cada tipo de janela tem uma função diferente na arquitetura de ativação in-loco. No entanto, não é necessário empregar uma janela física separada para cada tipo. Muitos aplicativos de contêiner usam a mesma janela para o quadro, documento, painel e janelas pai.

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho oleidl.h

Confira também

Iolewindow