Microsoft DirectX 8.0 (Visual Basic)

Direct3DDevice8.SetCursorPosition

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

object.SetCursorPosition( _ 
    XScreenSpace As Long, _ 
    YScreenSpace As Long
    Flags As CONST_D3DSCPFLAGS)

指定項目

object
Direct3DDevice8 オブジェクトを表すオブジェクト式。
XScreenSpace
スクリーン空間座標で表したカーソルの新しい X 位置。「注意」を参照すること。
YScreenSpace
スクリーン空間座標で表したカーソルの新しい Y 位置。「注意」を参照すること。
Flags
カーソルの更新オプションを指定する。現在、定義されているフラグは 1 つだけである。

D3DCURSOR_IMMEDIATE_UPDATE

リフレッシュ レートでカーソルを更新する。

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

エラー コード

失敗した場合はエラーが発生し、Err.NumberD3DERR_INVALIDCALL が設定される。

エラー トラッピングの詳細については、Microsoft® Visual Basic® の「エラー処理」を参照すること。

注意

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

カーソルが Direct3DDevice8.ShowCursor によって隠されている場合、カーソルは描画されない。

参照

Direct3DDevice8.SetCursorPropertiesDirect3DDevice8.ShowCursor