SECSplashWnd Class

class SECSplashWnd: public CWnd

The SECSplashWnd class is derived from the CWnd class. It gives a ready to use splash window for your applications. SECSplashWnd implements a self initializing and destroying splash window. To use the splash window, the developer creates the bitmap and then creates an instance of SECSplashWnd. The splash window self destructs after a specified duration or if/when the user presses the mouse button on the splash window.

Defined in: SECSPLSH.H

Comments

The SPLASH51 sample in the \SAMPLES\TOOLKIT\STANDARD\UIEXT\SPLASH51 directory demonstrates how to create a splash window.

Example

Splash Window

The following example from that sample shows a typical usage of SECSplashWnd.
Create the Splash Window first
SECSplashWnd * pSplashWnd = new SECSplashWnd(IDB_SPLASHWND,3500);
pSplashWnd->Create();
pSplashWnd->ShowWindow(SW_SHOW);
pSplashWnd->UpdateWindow();
ASSERT(pSplashWnd != NULL);

Class Members

Public Members

SECSplashWnd(UINT nNewBitmapID, UINT nNewDuration = 2500, BOOL bWaitForTimer = FALSE, BOOL bAlwaysOnTop = FALSE)

The SECSplashWnd constructor creates an instance of the SECSplashWnd object.

virtual BOOL  Create(CWnd* pParentWnd = NULL, DWORD dwStyle = WS_POPUP|WS_VISIBLE, DWORD dwExStyle = NULL)

This function creates the actual Splash Screen object.

virtual void  SetTaskbarTitle(CString strText)

This function can be called to add a taskbar entry for the Splash Screen.

virtual void  Dismiss()

This function may be called to dismiss the Splash Screen.

virtual BOOL  EnableTimer(UINT nNewDuration)

This function is called to enable/set the Splash Screen timer.

virtual BOOL  EnableTimer()

Called to enable the Splash Screen timer.

virtual void  DisableParent(BOOL bDisable = TRUE)

The Splash Screen parent may be disabled. Default: Parent enabled.

virtual void  SetAlwaysOnTop(BOOL bAlwaysOnTop = TRUE)

The splash screent is set with the WS_EX_TOPMOST style.

virtual void  AllowUserDismiss(BOOL bAllow = FALSE)

Sets whether the user may be allowed to dismiss the Splash Screen.