Microsoft DirectX 8.0 (C++)

IDirect3DDevice8::SetCursorPosition

カーソルの位置と更新オプションを設定する。

void SetCursorPosition(
  UINT XScreenSpace,
  UINT YScreenSpace,
  DWORD Flags
);

パラメータ

XScreenSpace
[in] スクリーン空間座標で表したカーソルの新しい x 位置。「注意」を参照すること。
YScreenSpace
[in] スクリーン空間座標で表したカーソルの新しい y 位置。「注意」を参照すること。
Flags
[in] カーソルの更新オプションを指定する。現在、定義されているフラグは 1 つだけである。
D3DCURSOR_IMMEDIATE_UPDATE
リフレッシュ レートでカーソルを更新する。

このフラグを指定した場合、システムは最低ディスプレイのリフレッシュ レートの半分の速度でカーソルを更新することを保証するが、ディスプレイのリフレッシュ レートより頻繁に更新することはない。このフラグを指定しない場合、このメソッドはカーソルの更新を次の IDirect3DDevice8::Present の呼び出しまで遅延させる。このデフォルトの動作は、通常、フラグを設定した場合よりもパフォーマンスが向上する。ただし、Present の呼び出しの頻度が高く、ユーザーがカーソルの動きに大きな遅延を感じるようであれば、アプリケーションでこのフラグを設定する必要がある。

戻り値

なし。

注意

フルスクリーン モードで実行している場合、スクリーン空間座標はバック バッファ座標に変換されて、現在のディスプレイ モードに合わせて適切にスケーリングされる。ウィンドウ モードで実行している場合は、スクリーン空間座標はデスクトップ座標に変換される。カーソル イメージは、指定した位置から IDirect3DDevice8::SetCursorProperties メソッドで指定されているホットスポット オフセットの値を引いた位置に描画される。

カーソルが IDirect3DDevice8::ShowCursor で隠されている場合、カーソルは描画されない。

動作環境

  ヘッダー : d3d8.h で宣言。
  インポート ライブラリ : D3d8.lib を使用。

参照

IDirect3DDevice8::SetCursorPropertiesIDirect3DDevice8::ShowCursor