Método IOleWindow::GetWindow (oleidl.h)
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 |
|---|---|
|
O objeto é sem janelas. |
|
O valor fEnterMode especificado não é válido. |
|
Não há memória suficiente disponível para esta operação. |
|
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 |