SECMultiDocTemplate::OnEnableSysCommandEx

voidSECMultiDocTemplate::OnEnableSysCommandEx(CFrameWnd*pFrameWnd, DWORDdwScxFlags)

Tailor WM_SYSCOMMANDEX commands of interest.

Defined in: Sdocmult.cpp

Return Value

void

Parameters

pFrameWnd

Frame enabled for WM_SYSCOMMANDEX

dwScxFlags

SyscommandEx flags. Currently the following are supported:

SCXOPT_NO_CAPTION_BUTTON

Do not show dockable view caption button

Comments

WM_SYSCOMMANDEX handling allows the frame type to be dynamic (e.g., as in docking views) and optionally has a new button in the caption to automatically send WM_SYSCOMMANDEX messages for the user. The virtual OnEnableSysCommandEx() is called when a new frame is created. The default implementation OnEnableSysCommandEx() calls the EnableSysCommandEx() member of the frame and passes the DWORD flags parameter as is. To enable WM_SYSCOMMANDEX handling but disable the caption button, use m_dwScxFlags |= SCXOPT_NO_CAPTION_BUTTON or m_dwDockableScxFlags |= SCXOPT_NO_CAPTION_BUTTON. The SCXOPT_ constants are in the namespace nsSysCommandEx.

SCXOPT_ENABLED

Necessary for any WM_SYSCOMMANDEX processing

SCXOPT_NO_CAPTION_BUTTON

Turn off the caption button

SCXOPT_NO_HANDLE_RDBLCLK

disable right double click firing of WM_SYSCOMMANDEX.

SCXOPT_NO_CONTEXTMENU

disables the context menu, which is normally displayed on a right mouse button up, in the caption.