CStatic::SetCursor

Associates a new cursor image with the static control.

HCURSOR SetCursor( 
   HCURSOR hCursor  
);

Parameters

  • hCursor
    Handle of the cursor to be drawn in the static control.

Return Value

The handle of the cursor previously associated with the static control, or NULL if no cursor was associated with the static control.

Remarks

The cursor will be automatically drawn in the static control. By default, it will be drawn in the upper-left corner and the static control will be resized to the size of the cursor.

You can use various window and static control styles, including the following:

  • SS_ICON   Use this style always for cursors and icons.

  • SS_CENTERIMAGE   Use to center in the static control. If the image is larger than the static control, it will be clipped. If it is smaller than the static control, the empty space around the image will be filled with the background color of the static control.

Example

CStatic myStatic;

// Create a child icon static control.
myStatic.Create(_T("my static"), 
   WS_CHILD|WS_VISIBLE|SS_ICON|SS_CENTERIMAGE, CRect(10,10,150,50), 
   pParentWnd);

// If no image is defined for the static control, define the image  
// to the system arrow and question mark cursor. 
if (myStatic.GetCursor() == NULL)
   myStatic.SetCursor(::LoadCursor(NULL, IDC_HELP));

Requirements

Header: afxwin.h

See Also

Reference

CStatic Class

Hierarchy Chart

CStatic::GetCursor

STM_SETIMAGE

Cursors