CWnd::OnHScrollClipboard

Syntax

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

Parameters

pClipAppWnd

Specifies a pointer to a Clipboard-viewer window. The pointer may be temporary, and should not be stored for later use.

nSBCode

Specifies one of the following scroll-bar codes in the low-order word:

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, not used.

Remarks

The Clipboard owner's OnHScrollClipboard 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 horizontal scroll bar. The owner 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 functions, 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_HSCROLLCLIPBOARD message.

See Also

CWnd::Invalidate, CWnd::OnVScrollClipboard, CWnd::InvalidateRect, CWnd::Default, WM_HSCROLLCLIPBOARD