PixelGetColor

Retrieves the color of the pixel at the specified X and Y coordinates.

Color := PixelGetColor(X, Y , Mode)

パラメータ

X, Y

型：整数

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

Mode

型：文字列

If blank or omitted, the pixel is retrieved using the normal method. Otherwise, specify one or more of the following words. 複数の単語がある場合は、それぞれをスペースで区切ってください（例："Alt Slow"）。

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

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

戻り値

型：文字列

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

エラー処理

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

備考

つまり、他のウィンドウの後ろに隠れたウィンドウのピクセルカラーを取得することはできません。一方、マウスカーソルの下にある画素は、通常、検出することができます。The exception to this is game cursors, which in most cases will obstruct any pixels beneath them.

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

既知の制限事項：

• 部分的に透明なウィンドウや、色の1つが不可視とされたウィンドウ（WinSetTransColor）は、通常、それ自身の色ではなく、それ自身の背後にあるウィンドウの色を生成します。
• PixelGetColorは、アプリケーションによっては正確な結果が得られない場合があります。この場合、最後のパラメータにAltまたはSlowという単語を指定してみてください。

関連

PixelSearch、ImageSearch、CoordMode、MouseGetPos

例

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