Microsoft DirectX 8.0 (Visual Basic)

Direct3DDevice8.SetCursorProperties

カーソルのプロパティを設定する。

object.SetCursorProperties( _ 
    XHotSpot As Long, _ 
    YHotSpot As Long, _ 
    CursorSurface As Direct3DSurface8)

指定項目

object
Direct3DDevice8 オブジェクトを表すオブジェクト式。
XHotSpot
カーソルの左上隅を基準としてカーソルの内部に向かう X 座標オフセット (ピクセル単位)。カーソルの中心と見なされる。カーソルが新しい位置に指定された場合、イメージは、この新しい位置からのオフセットに描かれる。この新しい位置は、その位置からホット スポットの座標を引くことによって決定された位置である。
YHotSpot
カーソルの左上隅を基準としてカーソルの内部に向かう Y 座標オフセット (ピクセル単位)。カーソルの中心と見なされる。カーソルが新しい位置に指定された場合、イメージは、この新しい位置からのオフセットに描かれる。この新しい位置は、その位置からホット スポットの座標を引くことによって決定された位置である。
CursorSurface
Direct3DSurface8 オブジェクト。このパラメータは、8888 ARGB サーフェス (フォーマットは D3DFORMAT_A8R8G8B8) をポイントしていなければならない。このサーフェスのコンテンツは、カーソルの表示に使われる内部バッファにコピーされて、同時にフォーマット変換が行われる場合がある。このサーフェスのディメンジョンはディスプレイ モードのディメンジョンより小さくなければならず、各方向とも 2 の累乗でなければならない。ただし、両方向が同じ大きさでなくてもかまわない。アルファ チャネルは、0.0 または 1.0 でなければならない。

エラー コード

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

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

注意

このメソッドは、Microsoft® Win32® API の ShowCursor および SetCursor 関数とは独立している。アプリケーションでは、Win32 カーソルまたは Microsoft Direct3D® カーソルのいずれかを使用し、両方を使用してはならない。

アプリケーションでは、D3DCAPS8 型の適切なメンバを調べることで、カーソルで利用可能なハードウェア サポートを確認できる。一般に、ハードウェアがサポートするのは 32 × 32 のカーソルだけである。さらに、ウィンドウ モードでは、システムがサポートできるのも 32 × 32 のカーソルだけである。その場合でも SetCursorProperties は成功するが、カーソルはこのサイズに縮小されて、ホットスポットは適切にスケーリングされる可能性がある。

参照

Direct3DDevice8.SetCursorPositionDirect3DDevice8.ShowCursorD3DCAPS8