Classe CWindowImpl

Fornece métodos para criar ou subclassificar uma janela.

Sintaxe

template <class T, class TBase = CWindow, class TWinTraits = CControlWinTraits>
class ATL_NO_VTABLE CWindowImpl : public CWindowImplBaseT<TBase, TWinTraits>

Parâmetros

T
A sua nova classe, derivada de CWindowImpl.

TBase
A classe base da tua turma. Por defeito, a classe base é CWindow.

TWinTraits
Uma classe de traços que define estilos para a tua janela. A predefinição é CControlWinTraits.

Membros

Métodos Públicos

Métodos CWindowImplBaseT

Métodos estáticos

Membros de Dados

Observações

Podes usar CWindowImpl para criar uma janela ou subclassar uma janela existente. O CWindowImpl procedimento janela utiliza um mapa de mensagens para direcionar mensagens aos manipuladores apropriados.

CWindowImpl::Create cria uma janela baseada na informação da classe da janela que é gerida pelo CWndClassInfo. CWindowImpl contém a macro DECLARE_WND_CLASS , o que significa CWndClassInfo que regista uma nova classe janela. Se quiseres superclassar uma classe janela existente, deriva a tua classe e CWindowImpl inclui a macro DECLARE_WND_SUPERCLASS . Neste caso, CWndClassInfo regista uma classe janela baseada numa classe existente mas que usa CWindowImpl::WindowProc. Por exemplo:

class ATL_NO_VTABLE CMyWindow :
   OtherInheritedClasses
   public CComControl<CMyWindow>
          // CComControl derives from CWindowImpl
{
public:
   // 1. The NULL parameter means ATL will generate a
   //    name for the superclass
   // 2. The "EDIT" parameter means the superclass is
   //    based on the standard Windows Edit box
   DECLARE_WND_SUPERCLASS(NULL, _T("EDIT"))

   // Remainder of class declaration omitted

CWindowImpl Também suporta subclasse de janelas. O SubclassWindow método anexa uma janela existente ao CWindowImpl objeto e altera o procedimento da janela para CWindowImpl::WindowProc. Cada instância de CWindowImpl pode subclassificar uma janela diferente.

Além de CWindowImpl, o ATL fornece o CContainedWindow para criar uma janela contida noutro objeto.

O destruidor da classe base (~ CWindowImplRoot) garante que a janela desaparece antes de o objeto ser destruído.

CWindowImpl deriva de CWindowImplBaseT, que deriva de CWindowImplRoot, que deriva de TBase e CMessageMap.

Hierarquia de herança

CMessageMap

TBase

CWindowImplRoot

CWindowImplBaseT

CWindowImpl

Requerimentos

Cabeçalho: atlwin.h

CWindowImpl::Create

Cria uma janela baseada numa nova classe de janela.

HWND Create(
    HWND hWndParent,
    _U_RECT rect = NULL,
    LPCTSTR szWindowName = NULL,
    DWORD dwStyle = 0,
    DWORD dwExStyle = 0,
    _U_MENUorID MenuOrID = 0U,
    LPVOID lpCreateParam = NULL);

Parâmetros

hWndParent
[dentro] A maçaneta da janela dos pais ou proprietários.

retângulo
[dentro] Uma estrutura RECT que especifica a posição da janela. Podem RECT ser passados por ponteiro ou por referência.

szWindowName
[dentro] Especifica o nome da janela. O valor padrão é NULL.

dwStyle
[dentro] O estilo da janela. Este valor é combinado com o estilo fornecido pela classe de traços para a janela. O valor padrão dá à classe de traços controlo total sobre o estilo. Para uma lista de valores possíveis, veja CreateWindow no SDK do Windows.

dwExStyle
[dentro] O estilo janela estendida. Este valor é combinado com o estilo fornecido pela classe de traços para a janela. O valor padrão dá à classe de traços controlo total sobre o estilo. Para uma lista de valores possíveis, veja CreateWindowEx no SDK do Windows.

MenuOrID
[dentro] Para uma janela filha, o identificador da janela. Para uma janela de nível superior, um menu handler para a janela. O valor padrão é 0U.

lpCreateParam
[dentro] Um ponteiro para dados de criação de janelas. Para uma descrição completa, consulte a descrição do parâmetro final do CreateWindowEx.

Valor de retorno

Se for bem-sucedido, o handle para a janela recém-criada. Caso contrário, NULL.

Observações

Create primeiro regista a classe window se ainda não tiver sido registada. A janela recém-criada é automaticamente anexada ao CWindowImpl objeto.

Para usar uma classe de janela baseada numa classe de janela existente, derive a sua classe a partir de CWindowImpl e inclua a macro DECLARE_WND_SUPERCLASS . O procedimento de janela da classe window existente é guardado em m_pfnSuperWindowProc. Para mais informações, consulte a visão geral do CWindowImpl .

CWindowImpl::D efWindowProc

Chamado pelo WindowProc para processar mensagens não tratadas pelo mapa de mensagens.

LRESULT DefWindowProc(
    UINT uMsg,
    WPARAM wParam,
    LPARAM lParam);

LRESULT DefWindowProc();

Parâmetros

uMsg
[dentro] A mensagem enviada para a janela.

wParam
[dentro] Informação adicional específica da mensagem.

lParam
[dentro] Informação adicional específica da mensagem.

Valor de retorno

O resultado do processamento de mensagens.

Observações

Por defeito, DefWindowProc chama a função Win32 CallWindowPr para enviar a informação da mensagem para o procedimento da janela especificado em m_pfnSuperWindowProc.

A função sem parâmetros recupera automaticamente os parâmetros necessários da mensagem atual.

CWindowImpl::GetCurrentMessage

Devolve a mensagem atual, empacotada na MSG estrutura.

const MSG* GetCurrentMessage();

Valor de retorno

A mensagem atual.

CWindowImpl::GetWindowProc

Devolve WindowProc, o procedimento da janela atual.

virtual WNDPROC GetWindowProc();

Valor de retorno

O procedimento atual da janela.

Observações

Ignore este método para substituir o sistema da janela pelo seu próprio.

CWindowImpl::GetWndClassInfo

Chamado por Create para aceder à informação da classe janela.

static CWndClassInfo& GetWndClassInfo();

Valor de retorno

Uma instância estática de CWndClassInfo.

Observações

Por defeito, CWindowImpl obtém este método através da macro DECLARE_WND_CLASS , que especifica uma nova classe janela.

Para superclassar uma classe de janela existente, derive a sua classe a partir de CWindowImpl e inclua a macro DECLARE_WND_SUPERCLASS para sobrescrever GetWndClassInfo. Para mais informações, consulte a visão geral do CWindowImpl .

Além de usares os macros DECLARE_WND_CLASS e DECLARE_WND_SUPERCLASS, podes sobrescrever GetWndClassInfo com a tua própria implementação.

CWindowImpl::m_pfnSuperWindowProc

Dependendo da janela, aponta para um dos seguintes procedimentos de janela.

WNDPROC m_pfnSuperWindowProc;

Observações

CWindowImpl::D efWindowProc envia informação de mensagem para o procedimento janela guardado em m_pfnSuperWindowProc.

CWindowImpl::EmMensagemFinalT

Ligou depois de receber a última mensagem (normalmente WM_NCDESTROY).

virtual void OnFinalMessage(HWND hWnd);

Parâmetros

hWnd
[dentro] Uma maçaneta da janela a ser destruída.

Observações

A implementação padrão de OnFinalMessage não faz nada, mas podes sobrescrever esta função para gerir a limpeza antes de destruires uma janela. Se quiser eliminar automaticamente o seu objeto após a destruição da janela, pode chamar delete this; esta função.

CWindowImpl::SubclassWindow

Subclasse a janela identificada por hWnd e anexa-a ao CWindowImpl objeto.

BOOL SubclassWindow(HWND hWnd);

Parâmetros

hWnd
[dentro] A maçaneta da janela é subclassificada.

Valor de retorno

TRUE se a janela for subclassificada com sucesso; caso contrário, FALSO.

Observações

A janela subclasse agora usa CWindowImpl::WindowProc. O procedimento original da janela é guardado em m_pfnSuperWindowProc.

CWindowImpl::UnsubclassWindow

Destaca a janela subclassificada do CWindowImpl objeto e restaura o procedimento original da janela, guardado em m_pfnSuperWindowProc.

HWND UnsubclassWindow();

Valor de retorno

A maçaneta da janela anteriormente subclassificada.

CWindowImpl::WindowProc

Esta função estática implementa o procedimento da janela.

static LRESULT CALLBACK WindowProc(
    HWND hWnd,
    UINT uMsg,
    WPARAM wParam,
    LPARAM lParam);

Parâmetros

hWnd
[dentro] A maçaneta da janela.

uMsg
[dentro] A mensagem enviada para a janela.

wParam
[dentro] Informação adicional específica da mensagem.

lParam
[dentro] Informação adicional específica da mensagem.

Valor de retorno

O resultado do processamento de mensagens.

Observações

WindowProc usa o mapa de mensagens padrão (declarado com BEGIN_MSG_MAP) para direcionar mensagens aos manipuladores apropriados. Se necessário, WindowProc chama o DefWindowProc para processamento adicional de mensagens. Se a mensagem final não for tratada, WindowProc faz o seguinte:

• Realiza a dessubclasse se a janela fosse sem subclasse.

• Limpa m_hWnd.

• Liga para OnFinalMessage antes de a janela ser destruída.

Pode sobrescrever WindowProc para fornecer um mecanismo diferente para lidar com as mensagens.

Consulte também

BEGIN_MSG_MAP
Classe CComControl
Visão geral da classe