Compartilhar via


Classe CMiniFrameWnd

Representa uma janela do quadro de meia altura normalmente vista em torno de barras de ferramentas flutuantes.

Sintaxe

class CMiniFrameWnd : public CFrameWnd

Membros

Construtores públicos

Nome Descrição
CMiniFrameWnd::CMiniFrameWnd Constrói um objeto CMiniFrameWnd.

Métodos públicos

Nome Descrição
CMiniFrameWnd::Create Cria um objeto CMiniFrameWnd após a construção.
CMiniFrameWnd::CreateEx Cria um objeto CMiniFrameWnd (com opções adicionais) após a construção.

Comentários

Essas janelas com minimoldura{b>

Para usar um objeto CMiniFrameWnd, primeiro defina o objeto. Em seguida, chame a função membro Create para exibir a janela com minimoldura.

Para obter mais informações sobre como usar objetos CMiniFrameWnd, confira o artigo Barras de ferramentas de encaixe e flutuantes.

Hierarquia de herança

CObject

CCmdTarget

CWnd

CFrameWnd

CMiniFrameWnd

Requisitos

Cabeçalho: afxwin.h

CMiniFrameWnd::CMiniFrameWnd

Constrói um objeto CMiniFrameWnd, mas não cria a janela.

CMiniFrameWnd();

Comentários

Para criar a janela, chame CMiniFrameWnd::Create.

CMiniFrameWnd::Create

Cria a janela com minimoldura do Windows e a anexa ao objeto CMiniFrameWnd.

virtual BOOL Create(
    LPCTSTR lpClassName,
    LPCTSTR lpWindowName,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd = NULL,
    UINT nID = 0);

Parâmetros

lpClassName
Aponta para uma cadeia de caracteres terminada em nulo que nomeia a classe do Windows. O nome de classe pode ser qualquer nome registrado com a função global AfxRegisterWndClass. Se for NULL, a classe de janela será registrada para você pela estrutura. O MFC fornece à classe padrão os seguintes estilos e atributos:

  • Define o bit de estilo CS_DBLCLKS, que envia mensagens de clique duplo para o procedimento da janela quando o usuário clica duas vezes no mouse.

  • Define os bits de estilo CS_HREDRAW e CS_VREDRAW, que direcionam o conteúdo da área do cliente a ser redesenhado quando a janela muda de tamanho.

  • Define o cursor de classe para o IDC_ARROW padrão do Windows.

  • Define o pincel de plano de fundo da classe como NULL, para que a janela não apague a própria tela de fundo.

  • Define o ícone de classe como o ícone padrão do logotipo padrão de bandeira tremulando do Windows.

  • Define a janela como o tamanho e a posição padrão, conforme indicado pelo Windows.

lpWindowName
Aponta para uma cadeia de caracteres terminada em nulo que contém o nome da janela.

dwStyle
Especifica os atributos de estilo de janela. Eles podem incluir estilos de janela padrão e um ou mais dos seguintes estilos especiais:

  • MFS_MOVEFRAME Permite que a janela com minimoldura seja movida clicando em qualquer borda da janela, não apenas na legenda.

  • MFS_4THICKFRAME Desabilita o redimensionamento da janela com minimoldura.

  • MFS_SYNCACTIVE Sincroniza a ativação da janela com minimoldura para a ativação da respectiva janela pai.

  • MFS_THICKFRAME Permite que a janela com minimoldura seja dimensionada tão pequena quanto o conteúdo da área do cliente permite.

  • MFS_BLOCKSYSMENU Desabilita o acesso ao menu do sistema e ao menu de controle e converte-os em parte da legenda (barra de título).

Confira CWnd::Create para obter uma descrição dos possíveis valores de estilo de janela. A combinação típica usada para janelas com minimoldura é WS_POPUP|WS_CAPTION|WS_SYSMENU.

rect
Uma estrutura RECT que especifica as dimensões desejadas da janela.

pParentWnd
Aponta para a janela pai. Use NULL para janelas de nível superior.

Nid
Se a janela com minimoldura for criada como uma janela filho, esse será o identificador do controle filho; caso contrário, 0.

Valor de retorno

Diferente de zero se tiver êxito; caso contrário, 0.

Comentários

Create inicializa o nome da classe e o nome da janela e registra valores padrão para o estilo e o pai dela.

CMiniFrameWnd::CreateEx

Cria um objeto CMiniFrameWnd.

virtual BOOL CreateEx(
    DWORD dwExStyle,
    LPCTSTR lpClassName,
    LPCTSTR lpWindowName,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd = NULL,
    UINT nID = 0);

Parâmetros

dwExStyle
Especifica o estilo estendido do CMiniFrameWnd que está sendo criado. Aplique qualquer um dos estilos de janela estendida à janela.

lpClassName
Aponta para uma cadeia de caracteres terminada em nulo que nomeia a classe do Windows (uma estrutura WNDCLASS). O nome de classe pode ser qualquer nome registrado com a função global AfxRegisterWndClass ou qualquer um dos nomes de classe de controle predefinidos. Não pode ser NULL.

lpWindowName
Aponta para uma cadeia de caracteres terminada em nulo que contém o nome da janela.

dwStyle
Especifica os atributos de estilo de janela. Confira Estilos de Janela e CWnd::Criar para obter uma descrição dos valores possíveis.

rect
O tamanho e a posição da janela, nas coordenadas do cliente de pParentWnd.

pParentWnd
Aponta para o objeto de janela pai.

Nid
O identificador do pacote filho.

Valor de retorno

Retorna TRUE em caso de êxito. FALSE, em caso de falha.

Comentários

Os parâmetros CreateEx especificam o WNDCLASS, o estilo da janela e (opcionalmente) a posição inicial e o tamanho da janela. CreateEx também especifica o pai da janela (se houver) e a ID.

Quando CreateEx é executado, o Windows envia as mensagens WM_GETMINMAXINFO, WM_NCCREATE, WM_NCCALCSIZE e WM_CREATE para a janela.

Para estender o tratamento de mensagens padrão, derive uma classe de CMiniFrameWnd, adicione um mapa de mensagens à nova classe e forneça funções membro para as mensagens acima. Substitua OnCreate, por exemplo, para executar a inicialização necessária para uma nova classe.

Substitua outros manipuladores de mensagens OnMessage para adicionar mais funcionalidades à sua classe derivada.

Se o estilo WS_VISIBLE for fornecido, o Windows enviará à janela todas as mensagens necessárias para ativar e mostrar a janela. Se o estilo da janela especificar uma barra de título, o título da janela apontado pelo parâmetro lpszWindowName será exibido na barra de título.

O parâmetro dwStyle pode ser qualquer combinação de estilos de janela.

As janelas da caixa de ferramentas de paleta de estilo antigo não têm mais suporte. O estilo antigo, que não tinha um botão Fechar "X", tinha suporte ao executar um aplicativo MFC em versões anteriores do Windows, mas não tem mais suporte no Visual C++ para .NET. Agora há suporte apenas para o novo estilo de WS_EX_TOOLWINDOW; para obter uma descrição desse estilo, confira Estilos de Janela Estendidos.

Confira também

Classe CFrameWnd
Gráfico da hierarquia
Classe CFrameWnd