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
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 On
Message 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.