TN001: registro da classe Window

Esta nota descreve as rotinas MFC que registram as WNDCLASSes especiais necessárias pelo Microsoft Windows. Atributos específicos WNDCLASS usados por MFC e Windows são discutidos.

O problema

Os atributos de um objeto CWnd, como um HWND identificador em Windows, são armazenados em dois lugares: o objeto de janela e o WNDCLASS. O nome do WNDCLASS é passado para funções gerais de criação de janela, como CWnd::Create e CFrameWnd::Create no parâmetro lpszClassName .

Isso WNDCLASS deve ser registrado por meio de um dos quatro meios:

Campos WNDCLASS

A WNDCLASS estrutura consiste em vários campos que descrevem uma classe de janela. A tabela a seguir mostra os campos e especifica como eles são usados em um aplicativo MFC:

Campo Descrição
lpfnWndProc window proc, deve ser um AfxWndProc
cbClsExtra não usado (deve ser zero)
Cbwndextra não usado (deve ser zero)
hInstance preenchido automaticamente com AfxGetInstanceHandle
Hicon ícone para janelas de quadro, confira abaixo
Hcursor cursor para quando o mouse estiver sobre a janela, confira abaixo
Hbrbackground cor da tela de fundo, veja abaixo
lpszMenuName não usado (deve ser NULL)
Lpszclassname nome da classe, veja abaixo

WNDCLASSes fornecidos

As versões anteriores do MFC (antes do MFC 4.0) forneceram várias classes de janela predefinidas. Essas classes de janela não são mais fornecidas por padrão. Os aplicativos devem ser usados AfxRegisterWndClass com os parâmetros apropriados.

Se o aplicativo fornecer um recurso com a ID do recurso especificada (por exemplo, AFX_IDI_STD_FRAME), o MFC usará esse recurso. Caso contrário, ele usará o recurso padrão. Para o ícone, o ícone de aplicativo padrão é usado e, para o cursor, o cursor de seta padrão é usado.

Dois ícones dão suporte a aplicativos MDI com tipos de documento único: um ícone para o aplicativo principal, o outro ícone para janelas de documento/MDIChild icônicos. Para vários tipos de documentos com ícones diferentes, você deve registrar es adicionais WNDCLASSou usar a função CFrameWnd::LoadFrame .

CFrameWnd::LoadFrame registrará uma WNDCLASS ID de ícone que você especificar como o primeiro parâmetro e os seguintes atributos padrão:

  • estilo de classe: CS_DBLCLKS | CS_HREDRAW | CS_VREDRAW;

  • ícone AFX_IDI_STD_FRAME

  • cursor de seta

  • COLOR_WINDOW cor da tela de fundo

Os valores de cor de plano de fundo e cursor para o CMDIFrameWnd não são usados, pois a área do cliente da CMDIFrameWnd janela MDICLIENT é completamente coberta. A Microsoft não incentiva a subclasse da janela MDICLIENT , portanto, use as cores padrão e os tipos de cursor quando possível.

Controles de subclasse e superclasse

Se você subclasse ou superclasse um controle Windows (por exemplo, CButton), sua classe obtém automaticamente os WNDCLASS atributos fornecidos na implementação Windows desse controle.

A função AfxRegisterWndClass

O MFC fornece uma função auxiliar para registrar uma classe de janela. Dado um conjunto de atributos (estilo de classe de janela, cursor, pincel de plano de fundo e ícone), um nome sintético é gerado e a classe de janela resultante é registrada. Por exemplo,

const char* AfxRegisterWndClass(UINT nClassStyle,
    HCURSOR hCursor,
    HBRUSH hbrBackground,
    HICON hIcon);

Essa função retorna uma cadeia de caracteres temporária do nome da classe de janela registrada gerada. Para obter mais informações sobre essa função, consulte AfxRegisterWndClass.

A cadeia de caracteres retornada é um ponteiro temporário para um buffer de cadeia de caracteres estático. Ela é válida até a próxima chamada para AfxRegisterWndClass. Se você quiser manter essa cadeia de caracteres por perto, armazene-a em uma variável CString , como neste exemplo:

CString strWndClass = AfxRegisterWndClass(CS_DBLCLK, ...);

...
CWnd* pWnd = new CWnd;
pWnd->Create(strWndClass, ...);

...

AfxRegisterWndClassgerará um CResourceException se a classe de janela não tiver sido registrada (por causa de parâmetros inválidos ou fora de Windows memória).

Funções RegisterClass e AfxRegisterClass

Se você quiser fazer algo mais sofisticado do que o que AfxRegisterWndClass fornece, pode chamar a API RegisterClass Windows ou a função AfxRegisterClassMFC. As CWndfunções , CFrameWnd e CMDIChildWndCreate tomam um nome de cadeia de caracteres lpszClassName para a classe de janela como o primeiro parâmetro. Você pode usar qualquer nome de classe de janela registrado, independentemente do método usado para registrá-lo.

É importante usar AfxRegisterClass (ou AfxRegisterWndClass) em uma DLL no Win32. O Win32 não cancela automaticamente as classes registradas por uma DLL, portanto, você deve cancelar explicitamente as classes quando a DLL for encerrada. Ao usar AfxRegisterClass em vez disso RegisterClass , isso é tratado automaticamente para você. AfxRegisterClass mantém uma lista de classes exclusivas registradas pela DLL e as cancelará automaticamente quando a DLL for encerrada. Ao usar RegisterClass em uma DLL, você deve garantir que todas as classes não sejam registradas quando a DLL for encerrada (em sua função DllMain ). Não fazer isso pode causar RegisterClass falha inesperada quando outro aplicativo cliente tentar usar sua DLL.

Confira também

Notas técnicas por número
Notas técnicas por categoria