PixelGetColor

指定した座標のピクセルの色を取得します。 <分節 21706 ¶>

Color := PixelGetColor(X, Y , Mode)

パラメータ

X, Y

Type: Integer

画素の X 座標と Y 座標を指定します。座標は、CoordMode関数を使用して変更した場合を除いて、アクティブウィンドウのクライアント領域を基準にしています。

Mode

型：文字列

空白または省略したときは、通常の方法でピクセルを取得します。そうでないときは、次のワードを指定します。複数の単語がある場合は、それぞれをスペースで区切ってください（例："Alt Slow"）。

Alt：色を取得するための代替方法を使用します。通常の方法では、特定のタイプのウィンドウに対して無効または不正確な色が生成される場合に使用します。この方法は、通常の方法より10 %程度遅くなります。

Slow：より精巧な方法で色を取得します。これは、特定のフルスクリーンアプリケーションで、他の方法が失敗した場合に機能する可能性があります。この方法は、通常の方法と比較して約3倍の速度がかかります。注：Slowは Altより優先されるので、この場合はAltを指定する必要はありません。

戻り値

型：文字列

画素のRGB（赤緑青）色を16進数で表す文字列を返す関数です。例えば、紫は青と赤の強度が0x80（128）、緑の強度が0x00（0）であるため、0x800080と定義されています。

エラー処理

失敗したときはOSErrorをスローします。

備考

つまり、他のウィンドウの後ろに隠れたウィンドウのピクセルカラーを取得することはできません。一方、マウスカーソルの下にある画素は、通常、検出することができます。ただし、ゲームカーソルは例外で、ほとんどの場合、カーソルの下にあるピクセルを遮ります。

Window Spy（トレイアイコンメニューで利用可能）またはこのページの下にある例で、現在画面に表示されている色を確認することができます。

既知の制限事項：

PixelSearch、ImageSearch、CoordMode、MouseGetPos

例

ホットキーを押すと、マウスカーソルの現在位置にある画素の色が表示されます。

^!z::  ; Control+Alt+Z hotkey.
{
    MouseGetPos &MouseX, &MouseY
    MsgBox "The color at the current cursor position is " PixelGetColor(MouseX, MouseY)
}