Microsoft DirectX 8.0 (Visual Basic)

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
もし提供されていれば、ファイルは、構成イメージ上の特定のコントロールのオーバーレイである。ViewIDOverlayRectObjIDCalloutLineCalloutRect、および 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 によって参照する。デバイス ビューによって、イメージとコールアウト情報が表示される。