DIDEVICEIMAGEINFO
デバイス イメージを表示する、またはイメージにコールアウトをオーバーレイするのに必要な情報を格納する。この型は DIDEVICEIMAGEINFOHEADER 型内の配列として、DirectInputDevice8.GetImageInfo メソッドに渡される。
Type DIDEVICEIMAGEINFO
CalloutLine(0 To 4) As POINT
CalloutRect As RECT
flags As Long
ImagePath As String
ObjId As Long
ViewID As Long
OverlayRect As RECT
TextAlign As Long
ValidPts As Long
End Type
メンバ
- CalloutLine
- コールアウトの線を描画するポイントの座標を指定する型の配列。コールアウト線は、デバイス コントロールと、ゲーム アクションのキャプションを結ぶ線である。各線は、1 〜 4 のセグメントを持つことができる。このメンバは、flags に DIDIFT_OVERLAY フラグが含まれる場合にのみ有効である。
- CalloutRect
- ゲーム アクションの文字列が表示される長方形の座標を指定する型。アプリケーションはクリッピングを処理する。このメンバは、flags に DIDIFT_OVERLAY フラグが含まれる場合にのみ有効である。
- flags
- イメージの使用目的を記述したフラグ。このメンバは、CONST_DIDIFTFLAGS 列挙のいずれか 1 つの値を使用できる。
- DIDIFT_CONFIGURATION
- ファイルは、デバイスに対するアクションの現在構成を表示するために使用される。オーバーレイ イメージの座標は、構成イメージの左上隅を起点とする相対座標である。
- DIDIFT_OVERLAY
- もし提供されていれば、ファイルは、構成イメージ上の特定のコントロールのオーバーレイである。ViewID、OverlayRect、ObjID、CalloutLine、CalloutRect、および TextAlign の各メンバは有効であり、これらに格納されたデータを使って、デバイスの単一コントロールのオーバーレイとコールアウト情報が表示される。ファイルが指定されない場合 (パス文字列が NULL)、rdOverlay 以外の関連するその他すべてのメンバが使用される。
- ImagePath
- デバイスのイメージを含むファイルの完全修飾パス。
- ObjId
- このデバイスのオーバーレイ イメージが対応するコントロール識別子。オブジェクト タイプ フラグとインスタンス値の組み合わせである。この識別子の詳細については、「DirectInputDeviceObjectInstance.GetType」を参照すること。このメンバは、flags に DIDIFT_OVERLAY フラグが含まれる場合にのみ有効である。
- OverlayOffset
- このオーバーレイを表示するデバイス構成イメージのオフセット。このメンバは、flags に DIDIFT_OVERLAY フラグが含まれる場合にのみ有効である。
- OverlayRect
- デバイス構成イメージの左上ピクセルを原点とする相対座標を使って、オーバーレイ イメージをペイントする対象の長方形。このメンバは、flags に DIDIFT_OVERLAY フラグが含まれる場合にのみ有効である。
- TextAlign
- CalloutRect メンバが表す四角形内のテキストの配置を指定する値。CONST_DIDALFLAGS 列挙からの、1 つの水平方向の配置フラグと、1 つの垂直方向の配置フラグの組み合わせでなければならない。
定義済みの水平方向配置フラグは次のとおり。
- DIDAL_LEFTALIGNED
- テキストを左枠線に揃える。
- DIDAL_CENTERED
- テキストを水平方向の中央に寄せる。
- DIDAL_RIGHTALIGNED
- テキストを右枠線に揃える。
定義済みの垂直方向配置フラグは次のとおり。
- DIDAL_MIDDLE
- テキストを垂直方向の中央に寄せる。
- DIDAL_TOPALIGNED
- テキストを上枠線に揃える。
- DIDAL_BOTTOMALIGNED
- テキストを下枠線に揃える。
このメンバは、flags に DIDIFT_OVERLAY フラグが含まれる場合にのみ有効である。
- ValidPts
- CalloutLine 配列中の要素の数。
- ViewID
- デバイス ビュー イメージ (DIDIFT_CONFIGURATION) の場合、これはデバイス ビューの ID である。デバイス コントロール オーバーレイ (DIDIFT_OVERLAY) の場合、この値はデバイス ビューを ID によって参照する。デバイス ビューによって、イメージとコールアウト情報が表示される。