CMFCDesktopAlertWnd::Create

Creates and initializes the desktop alert window.

virtual BOOL Create(
    CWnd* pWndOwner,
    UINT uiDlgResID,
    HMENU hMenu = NULL,
    CPoint ptPos = CPoint(-1,-1),
    CRuntimeClass* pRTIDlgBar = RUNTIME_CLASS(CMFCDesktopAlertDialog)
);
virtual BOOL Create(
    CWnd* pWndOwner,
    CMFCDesktopAlertWndInfo& params,
    HMENU hMenu = NULL,
    CPoint ptPos = CPoint(-1,-1)
);

Parameters

  • [in] [out] pWndOwner
    Specifies the owner of the alert window. That owner will then receive all notifications for the desktop alert window. This value cannot be NULL.

  • [in] uiDlgResID
    Specifies the resource ID of the alert window.

  • [in] hMenu
    Specifies the menu that displays when the user clicks the menu button. If NULL, the menu button is not displayed.

  • [in] ptPos
    Specifies the initial position where the alert window is displayed, using screen coordinates. If this parameter is (-1, -1), the alert window is displayed in the lower-right corner of the screen.

  • [in] pRTIDlgBar
    Runtime class information for a custom dialog box class that covers the alert window's client area.

  • [in] params
    Specifies parameters that are used to create an alert window.

Return Value

TRUE if the alert window was created successfully; otherwise, FALSE.

Remarks

Call this method to create an alert window. The client area of the alert window contains a child dialog box that hosts all controls that are displayed to the user.

The first method overload creates an alert window that contains a child dialog box that is loaded from the application's resources. The first method overload can also specify runtime class information for a custom dialog box class.

The second method overload creates an alert window that contains default controls. You can specify which controls to display by modifying the CMFCDesktopAlertWndInfo Class.

Requirements

Header: afxDesktopAlertWnd.h

See Also

Reference

CMFCDesktopAlertWnd Class

Hierarchy Chart