Classe CMiniFrameWnd

Representa uma janela de frames com meia altura normalmente vista em torno de barras de ferramentas flutuantes.

Sintaxe

class CMiniFrameWnd : public CFrameWnd

Membros

Construtores Públicos

Métodos Públicos

Observações

Estas janelas de mini-frame comportam-se como janelas normais, exceto que não têm botões de minimizar/maximizar ou menus e basta clicar um único clique no menu do sistema para as ignorar.

Para usar um CMiniFrameWnd objeto, defina primeiro o objeto. Depois chama a função Create member para mostrar a janela de mini-frame.

Para mais informações sobre como usar CMiniFrameWnd objetos, consulte o artigo Docking and Floating Toolbars.

Hierarquia de herança

CObject

CCmdTarget

CWnd

CFrameWnd

CMiniFrameWnd

Requerimentos

Cabeçalho: afxwin.h

CMiniFrameWnd::CMiniFrameWnd

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

CMiniFrameWnd();

Observações

Para criar a janela, chame CMiniFrameWnd::Create.

CMiniFrameWnd::Create

Cria a janela mini-frame do Windows e anexa-a ao CMiniFrameWnd objeto.

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 por null que nomeia a classe Windows. O nome da classe pode ser qualquer nome registado na função global AfxRegisterWndClass . Se for NULL, a classe janela será registada para ti pelo framework. O MFC atribui à classe padrão os seguintes estilos e atributos:

• Define o bit de estilo CS_DBLCLKS, que envia mensagens de duplo clique para o procedimento de janela quando o utilizador faz duplo clique no rato.

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

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

• Define o pincel de fundo da classe para NULL, para que a janela não apague o fundo.

• Define o ícone da classe para o ícone padrão do logótipo do Windows, com bandeira ondulante.

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

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

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

• MFS_MOVEFRAME Permite que a janela do mini-frame seja movida clicando em qualquer borda da janela, não apenas na legenda.

• MFS_4THICKFRAME Desativa o redimensionamento da janela da mini-moldura.

• MFS_SYNCACTIVE Sincroniza a ativação da janela mini-frame com a ativação da sua janela principal.

• MFS_THICKFRAME Permite que a janela do mini-frame seja dimensionada tão pequena quanto o conteúdo da área do cliente permitir.

• MFS_BLOCKSYSMENU Desativa o acesso ao menu do sistema e ao menu de controlo, convertendo-os para parte da legenda (barra de título).

Veja CWnd::Create para uma descrição dos possíveis valores de estilo de janela. A combinação típica usada para janelas de mini-estrutura é WS_POPUP|WS_CAPTION|WS_SYSMENU.

retângulo
Uma RECT estrutura que especifica as dimensões desejadas da janela.

pParentWnd
Aponta para a janela dos pais. Usa o NULL para janelas de topo.

nID
Se a janela mini-frame for criada como uma janela filha, este é o identificador do controlo filho; caso contrário, 0.

Valor de retorno

Não nulo se for bem-sucedido; caso contrário, 0.

Observações

Create inicializa o nome da classe e o nome da janela e regista valores predefinidos para o seu estilo e pai.

CMiniFrameWnd::CreateEx

Cria um CMiniFrameWnd objeto.

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 ser criado. Aplique qualquer um dos estilos de janelas estendidas à janela.

lpClassName
Aponta para uma cadeia de caracteres com terminação nula que nomeia a classe Windows (uma estrutura WNDCLASS ). O nome da classe pode ser qualquer nome registado na função global AfxRegisterWndClass ou qualquer um dos nomes pré-definidos da classe de controlo. Não pode ser NULL.

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

dwStyle
Especifica os atributos de estilo da janela. Consulte Estilos de Janelas e CWnd::Create para uma descrição dos valores possíveis.

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

pParentWnd
Aponta para o objeto janela principal.

nID
O identificador da janela filha.

Valor de retorno

Retorna VERDADEIRO em caso de sucesso, FALSO em caso de falha.

Observações

Os CreateEx parâmetros especificam a 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 existir) e o 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 padrão das mensagens, derive uma classe a partir de CMiniFrameWnd, adicione um mapa de mensagens à nova classe e forneça funções membros para as mensagens acima. Override OnCreate, por exemplo, para realizar a inicialização necessária para uma nova classe.

Substitua mais On manipuladores de mensagens de Mensagem para adicionar funcionalidades adicionais à sua classe derivada.

Se for dado o estilo WS_VISIBLE, o Windows envia à 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 é exibido na barra de título.

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

As janelas antigas da caixa de ferramentas Palette já não são suportadas. O estilo antigo, que não tinha o botão "X" de fechar, era suportado ao executar uma aplicação MFC em versões anteriores do Windows, mas já não é suportado no Visual C++.NET. Apenas o novo estilo WS_EX_TOOLWINDOW é agora suportado; para uma descrição deste estilo, veja Extended Window Styles.

Consulte também

Classe CFrameWnd
Gráfico de Hierarquia
Classe CFrameWnd