CWnd::OnVScrollClipboard

Syntax

afx_msg void OnVScrollClipboard( CWnd* pClipAppWnd, UINT nSBCode, UINT nPos );

Parameters

pClipAppWnd

Specifies a pointer to a Clipboard-viewer window. The pointer may be temporary.

nSBCode

Specifies one of the following scroll-bar codes:

Value Description

SB_BOTTOM Scroll to lower right.
SB_ENDSCROLL End scroll.
SB_LINEDOWN Scroll one line down.
SB_LINEUP Scroll one line up.
SB_PAGEDOWN Scroll one page down.
SB_PAGEUP Scroll one page up.
SB_THUMBPOSITION Scroll to the absolute position. The current position is provided in nPos.
SB_TOP Scroll to upper left.

nPos

Contains the scroll box position if the scroll-bar code is SB_THUMBPOSITION; otherwise, nPos is not used.

Remarks

If the CWnd owns the Clipboard, the OnVScrollClipboard member function is called by the Clipboard viewer when the Clipboard data has the CF_OWNERDISPLAY format and there is an event in the Clipboard viewer's vertical scroll bar. OnVScrollClipboard should scroll the Clipboard image, invalidate the appropriate section, and update the scroll-bar values.

The Clipboard owner should use the Invalidate or InvalidateRect member function or repaint as desired. The scroll-bar position should also be reset.

This message-handler member function calls the Default member function. Override this member function in your derived class to handle the WM_VSCROLLCLIPBOARD message.

See Also

CWnd::Invalidate, CWnd::OnHScrollClipboard, CWnd::InvalidateRect, WM_VSCROLLCLIPBOARD, CWnd::Default