Classe CMFCDesktopAlertWnd

Artigo
06/10/2015

A classe de CMFCDesktopAlertWnd implementa a funcionalidade de uma caixa de diálogo sem-modo que ele na tela para informar ao usuário sobre um evento.

class CMFCDesktopAlertWnd : public CWnd

Membros

Métodos públicos

Nome	Descrição
CMFCDesktopAlertWnd::Create	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 tempo limite de fechamento automático.
CMFCDesktopAlertWnd::GetCaptionHeight	Retorna a altura da barra de título.
CMFCDesktopAlertWnd::GetDialogSize
CMFCDesktopAlertWnd::GetLastPos	Retorna a posição válido da última 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 a legenda pequena.
CMFCDesktopAlertWnd::OnBeforeShow
CMFCDesktopAlertWnd::OnClickLinkButton	Chamado pela estrutura quando o usuário clica em um botão de link posicionado no menu alerta da área de trabalho.
CMFCDesktopAlertWnd::OnCommand	A estrutura chama essa função de membro quando o usuário seleciona um item do menu, quando um controle filho envia uma notificação, ou quando um pressionamento de teclas de aceleração ele é convertido. Overrides ( 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 tempo limite de fechamento automático.
CMFCDesktopAlertWnd::SetSmallCaption	Alterna entre e legendas pequenas normal.
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 pode desaparecer (após um atraso especificado ou quando o usuário demite 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, o 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 os recursos do aplicativo.

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

O objeto de CMFCDesktopAlertWnd cria uma caixa de diálogo filho especial que preenche a área cliente da janela de alerta da área de trabalho. A caixa de diálogo possui todos os controles que são posicionados em ele.

Para exibir uma caixa de diálogo personalizado na janela pop-up, siga estas etapas:

Derive uma classe de CMFCDesktopAlertDialog.
Crie um modelo filho da caixa de diálogo em recursos.
Chame CMFCDesktopAlertWnd::Create usando a ID de recurso do modelo da caixa de diálogo e um ponteiro para informações da classe de tempo de execução da classe derivada.
Programar a caixa de diálogo personalizada para tratar todas as notificações que vêm de controles hospedados, ou programar os controles hospedados diretamente para tratar essas notificações.

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

Defina o tipo de animação chamando CMFCDesktopAlertWnd::SetAnimationType. As opções válidos incluem desdobram-se, deslizam-se, e desvanecem-se.
Defina a velocidade de animação de quadro CMFCDesktopAlertWnd::SetAnimationSpeedchamando.
Defina a transparência em nível CMFCDesktopAlertWnd::SetTransparencychamando.
Alterar o tamanho da legenda pequena chamando CMFCDesktopAlertWnd::SetSmallCaption. A legenda pequena é 7 pixels.

Exemplo

O exemplo a seguir ilustra como usar vários métodos na classe de CMFCDesktopAlertWnd para configurar um objeto de CMFCDesktopAlertWnd . O exemplo a seguir mostra como definir um tipo de animação, defina a transparência de janela pop-up, especifica que a janela alerta exibe uma legenda pequena, e defina a hora que passa antes da janela alerta se encerra automaticamente. O exemplo também demonstra como criar e inicializar a janela de alerta da área de trabalho. Este trecho de código é parte de Alerta exemplo de demonstração da á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));
        }
    }