CMFCDesktopAlertWnd Class

Artículo
06/10/2015

La clase de CMFCDesktopAlertWnd implementa la funcionalidad de un cuadro de diálogo no modal que aparece en la pantalla para informar al usuario sobre un evento.

class CMFCDesktopAlertWnd : public CWnd

Members

Métodos públicos

Name	Descripción
CMFCDesktopAlertWnd::Create	Crea e inicializa la ventana de alerta de escritorio.
CMFCDesktopAlertWnd::GetAnimationSpeed	devuelve la velocidad de la animación.
CMFCDesktopAlertWnd::GetAnimationType	Devuelve el tipo de animación.
CMFCDesktopAlertWnd::GetAutoCloseTime	Devuelve el tiempo de espera de auto-cierre.
CMFCDesktopAlertWnd::GetCaptionHeight	Devuelve el alto de la leyenda.
CMFCDesktopAlertWnd::GetDialogSize
CMFCDesktopAlertWnd::GetLastPos	Devuelve la posición válida de la última ventana de alerta de escritorio respecto a la pantalla.
CMFCDesktopAlertWnd::GetTransparency	Devuelve el nivel de transparencia.
CMFCDesktopAlertWnd::HasSmallCaption	Determina si la ventana de alerta de escritorio se muestra con el pequeño leyenda.
CMFCDesktopAlertWnd::OnBeforeShow
CMFCDesktopAlertWnd::OnClickLinkButton	Llamado por el marco cuando el usuario hace clic en un botón de vínculo ubicado en el menú de alerta de escritorio.
CMFCDesktopAlertWnd::OnCommand	El marco de trabajo llama a esta función miembro cuando el usuario selecciona un elemento de un menú, cuando un control secundario envía un mensaje de notificación, o cuando se convierte una tecla de aceleración. (Reemplaza CWnd::OnCommand.)
CMFCDesktopAlertWnd::OnDraw
CMFCDesktopAlertWnd::ProcessCommand
CMFCDesktopAlertWnd::SetAnimationSpeed	establece la nueva velocidad de la animación.
CMFCDesktopAlertWnd::SetAnimationType	Establece el tipo de animación.
CMFCDesktopAlertWnd::SetAutoCloseTime	Establece el tiempo de espera de auto-cierre.
CMFCDesktopAlertWnd::SetSmallCaption	Cambia entre leyendas pequeñas y normales.
CMFCDesktopAlertWnd::SetTransparency	Establece el nivel de transparencia.

Comentarios

Una ventana de alerta de escritorio puede ser transparente, puede aparecer con efectos de animación, y puede desaparecer (después de un retraso especificado o cuando el usuario lo descarta haciendo clic en el botón cerrar).

Una ventana de alerta de escritorio puede contener también un diálogo predeterminado que a su vez contiene un icono, el texto del mensaje (una etiqueta), y un vínculo. Alternativamente, una ventana de alerta de escritorio puede contener un diálogo de los recursos de la aplicación.

Crea una ventana de alerta de escritorio en dos pasos. Primero, llame al constructor para crear el objeto de CMFCDesktopAlertWnd . En segundo lugar, llame a la función miembro de CMFCDesktopAlertWnd::Create para crear la ventana y para adjuntarla al objeto de CMFCDesktopAlertWnd .

El objeto de CMFCDesktopAlertWnd crea un cuadro de diálogo secundario especial que rellene el área cliente de la ventana de alerta de escritorio. el diálogo posee todos los controles que se colocan en él.

Para mostrar un cuadro de diálogo personalizado en la ventana emergente, siga estos pasos:

derive una clase de CMFCDesktopAlertDialog.
Cree una plantilla secundaria del cuadro de diálogo en los recursos.
Llame a CMFCDesktopAlertWnd::Create mediante el Id. de recurso de plantilla de cuadro de diálogo y un puntero a la información de la clase en tiempo de ejecución de la clase derivada.
Programar el cuadro de diálogo personalizado para controlar todas las notificaciones que proceden de los controles de hospedados, o programar los controles hospedados controlar estas notificaciones directamente.

Utilice las siguientes funciones para controlar el comportamiento de la ventana de alerta de escritorio:

Establezca la animación tipo llamando a CMFCDesktopAlertWnd::SetAnimationType. Inclusión válida de las opciones revela, entrega, y se desvanece.
Establezca la velocidad de fotograma animación llamando a CMFCDesktopAlertWnd::SetAnimationSpeed.
Establezca la transparencia de llamando a CMFCDesktopAlertWnd::SetTransparency.
Cambie el tamaño de la leyenda a pequeño llamando a CMFCDesktopAlertWnd::SetSmallCaption. El pequeño leyenda es 7 píxeles de alto.

Ejemplo

El ejemplo siguiente se muestra cómo utilizar varios métodos en la clase de CMFCDesktopAlertWnd para configurar un objeto de CMFCDesktopAlertWnd . El ejemplo muestra cómo establecer un tipo de animación, establece la transparencia de la ventana emergente, especifica que la ventana alerta muestra un pequeño leyenda, y establece el tiempo que cierre que transcurre antes de la ventana alerta automáticamente. El ejemplo también se muestra cómo crear e inicializar la ventana de alerta de escritorio. Este fragmento de código es parte de Ejemplo de demostración de alerta de escritorio.

    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));
        }
    }