Classe CMFCDesktopAlertWnd

Artigo
08/25/2010

The CMFCDesktopAlertWnd classe implementa a funcionalidade de uma caixa de diálogo sem janela restrita que aparece na tela para informar ao usuário sobre um evento.

class CMFCDesktopAlertWnd : public CWnd

Membros

Métodos públicos

Nome	Descrição
CMFCDesktopAlertWnd::criar	Cria e inicializa a janela de alerta da área de trabalho.
CMFCDesktopAlertWnd::GetAnimationSpeed	Retorna a velocidade da animação.
CMFCDesktopAlertWnd::GetAnimationType	Retorna o tipo de animação.
CMFCDesktopAlertWnd::GetAutoCloseTime	Retorna o time limite de fechar automático.
CMFCDesktopAlertWnd::GetCaptionHeight	Retorna a altura da legenda.
CMFCDesktopAlertWnd::GetDialogSize
CMFCDesktopAlertWnd::GetLastPos	Retorna o último válido posição da janela de alerta da área de trabalho na tela.
CMFCDesktopAlertWnd::GetTransparency	Retorna o nível de transparência.
CMFCDesktopAlertWnd::HasSmallCaption	Determina se a janela de alerta da área de trabalho é exibida com o título pequeno.
CMFCDesktopAlertWnd::OnBeforeShow
CMFCDesktopAlertWnd::OnClickLinkButton	Chamado pela estrutura quando o usuário clica em um botão de link localizado no menu de alerta da área de trabalho.
CMFCDesktopAlertWnd::OnCommand	A estrutura chama esta função de membro quando o usuário seleciona um item de um menu, quando um controle filho envia uma mensagem de notificação ou quando um pressionamento de tecla aceleradora é traduzido.(Substitui CWnd::OnCommand.)
CMFCDesktopAlertWnd::OnDraw
CMFCDesktopAlertWnd::ProcessCommand
CMFCDesktopAlertWnd::SetAnimationSpeed	Define a nova velocidade da animação.
CMFCDesktopAlertWnd::SetAnimationType	Define o tipo de animação.
CMFCDesktopAlertWnd::SetAutoCloseTime	Define o time limite de fechar automático.
CMFCDesktopAlertWnd::SetSmallCaption	Alterna entre normais e pequenas legendas.
CMFCDesktopAlertWnd::SetTransparency	Define o nível de transparência.

Comentários

Uma janela de alerta da área de trabalho pode ser transparente, pode aparecer com efeitos de animação e ele pode desaparecer (após um intervalo especificado ou quando o usuário o descarte clicando no botão Fechar).

Uma janela de alerta da área de trabalho também pode conter uma caixa de diálogo padrão que por sua vez contém um ícone, texto da mensagem (um rótulo) e um link.Como alternativa, uma janela de alerta da área de trabalho pode conter uma caixa de diálogo personalizada dos recursos do aplicativo.

Você criar uma janela de alerta da área de trabalho em duas etapas.Primeiro, telefonar o construtor para construir o CMFCDesktopAlertWnd objeto. Segundo, telefonar o CMFCDesktopAlertWnd::criar função de membro para criar a janela e anexá-lo para o CMFCDesktopAlertWnd objeto.

The CMFCDesktopAlertWnd objeto cria uma caixa de diálogo especial filho que preenche a área de cliente da janela de alerta da área de trabalho. A caixa de diálogo é responsável por todos os controles que posicionado sobre ele.

Para exibir uma caixa de diálogo personalizada na janela pop-up, execute as seguintes etapas:

Derivar uma classe de CMFCDesktopAlertDialog.
Crie um modelo de caixa de diálogo filho nos recursos.
De telefonarCMFCDesktopAlertWnd::criar usando a ID de recurso de modelo de caixa de diálogo e um ponteiro para as informações de classe em tempo de execução da classe derivada.
A caixa de diálogo personalizada para lidar com todas as notificações provenientes de controles hospedados de programas ou programar os controles para manipular essas notificações diretamente hospedados.

Use as seguintes funções para controlar o comportamento da janela de alerta da área de trabalho:

conjunto o tipo de animação chamando CMFCDesktopAlertWnd::SetAnimationType. As opções válidas incluem desdobrar, slides e desaparecer.
conjunto a velocidade da animação quadro chamando CMFCDesktopAlertWnd::SetAnimationSpeed.
conjunto o nível de transparência chamando CMFCDesktopAlertWnd::SetTransparency.
Alterar o dimensionar da legenda para pequenas chamando CMFCDesktopAlertWnd::SetSmallCaption. A legenda pequena é 7 pixels de altura.

Exemplo

O exemplo a seguir ilustra como usar diversos métodos no CMFCDesktopAlertWnd classe para configurar uma CMFCDesktopAlertWnd objeto. O exemplo mostra como conjunto um tipo de animação, conjunto a transparência da janela pop-up, especificar que a janela alerta exibe uma legenda de pequena e conjunto o time decorrido antes que a janela de alerta será fechada automaticamente.O exemplo também demonstra como criar e inicializar a janela de alerta da área de trabalho.Neste trecho de código faz parte o Exemplo do DesktopAlertDemo: Aplicativo MFC de alerta de área de trabalho.

 CMFCDesktopAlertWnd* pPopup = new CMFCDesktopAlertWnd;

    // int m_nAnimation
    pPopup->SetAnimationType ((CMFCPopupMenu::ANIMATION_TYPE) m_nAnimation);
    
    // int m_nAnimationSpeed
    pPopup->SetAnimationSpeed (m_nAnimationSpeed);
    
    // int m_nTransparency
    pPopup->SetTransparency ((BYTE)m_nTransparency);
    
    // BOOL m_bSmallCaption
    pPopup->SetSmallCaption (m_bSmallCaption);

    // BOOL m_bAutoClose, int m_nAutoCloseTime
    pPopup->SetAutoCloseTime (m_bAutoClose ? m_nAutoCloseTime * 1000 : 0);

    // int m_nPopupSource
    if (m_nPopupSource == 0)
    {
        // int m_nVisualMngr
        // CPoint m_ptPopup
        // The this pointer points to a CDesktopAlertDemoDlg class which extends the CDialogEx class.
        if (m_nVisualMngr == 5) // MSN-style
        {
            pPopup->Create (this, IDD_DIALOG2, NULL, 
                m_ptPopup, RUNTIME_CLASS (CMSNDlg));
        }
        else
        {
            pPopup->Create (this, IDD_DIALOG1, 
                m_menuPopup.GetSubMenu (0)->GetSafeHmenu (), 
                m_ptPopup, RUNTIME_CLASS (CMyPopupDlg));
        }
    }