IDirect3DDevice8::ShowCursor

This method displays or hides the cursor.

BOOL ShowCursor(
  BOOL bShow
);

Parameters

  • bShow
    [in] If bShow is TRUE, the cursor is shown. If bShow is FALSE, the cursor is hidden.

Return Values

Value indicating whether the cursor was previously visible. TRUE if the cursor was previously visible, or FALSE if the cursor was not previously visible.

Remarks

Microsoft® Direct3D® cursor functions use either GDI cursor or software emulation, depending on the hardware. Users usually want to respond to a WM_SETCURSOR message. For example, the users might want to write the message handler like this:

case WM_SETCURSOR:
    // Turn off window cursor 
    SetCursor( NULL );
    m_pd3dDevice->ShowCursor( TRUE );
    return TRUE; // prevent Windows from setting cursor to window class
cursor
break;

Or users might want to call the IDirect3DDevice8::SetCursorProperties method if they want to change the cursor. See the code in the Microsoft DirectX® Graphics C/C++ Samples for more detail.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: D3d8.h.
Link Library: D3d8.lib.

See Also

IDirect3DDevice8::SetCursorPosition | IDirect3DDevice8::SetCursorProperties | IDirect3DDevice8

 Last updated on Thursday, April 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.