Gui,Add,Picture

提供: AutoHotkey Wiki
移動: 案内検索

実行制御 | GUI表示 | 演算・変数 | メモリ・DLL操作 | 文字列操作 | キーボード | マウス | シェル | ウィンドウ | ウィンドウグループ
ステータスバー | コントロール | サウンド | ファイル | INIファイル | レジストリ | 環境変数 | AutoHotkey | その他 | 設定関係 | オブジェクト

Gui,Add,Picture[編集]

GUIウィンドウに画像を表示するコントロールを追加する。

Gui, Add, Picture [, Options, Text]

Parameters[編集]

引数名 説明
Options オプションを半角スペース区切りで列挙。
Gui,Addの項参照。
WとHを指定しないと、画像の実際のサイズで表示される。縦横の比率を維持して拡大/縮小するには、WかHの片方を普通に設定し、もう片方を h-1w-1のように指定する。
Gでサブルーチンラベル名を指定することで、画像をクリックしたときに実行されるサブルーチンを設定できる。
固有のオプションはない。
Text 画像ファイル名を指定する。相対パスで指定した場合、相対パスで指定した場合は、%A_WorkingDir%を基準としたパスとなる。

固有のOption[編集]

IconN N にアイコン番号を指定。実行ファイルやDLLファイルに複数のアイコンが含まれる場合、2番目以降のアイコンを表示する。
この機能を使用した場合、AltSubmitオプションは使用できない。
AltSubmit GDIPlus.dllを使用して描画を行う。
画像の透過色が有効になり、BackgroundTransオプションを共に指定すれば下のコントロールを透過表示できるようになる。
複数サイズの画像を持つアイコンファイルの場合、通常は32*32のイメージが優先されるが、AltSubmitを使用すると16*16のイメージが優先される。
BackgroundTrans 透過色部分を透過し、下に配置されたコントロールが見えるようにする。
後から解除するには、GuiControl+Backgroundを設定する。
指定しなかった場合、透過色部分はコントロールの背景色になる。

Remarks[編集]

アイコン(*.ico)、カーソル(*.cur)、アニメーションカーソル(*.ani)、実行ファイルやDLLファイル内のアイコンを表示できる。
実行ファイルやDLLファイル内のアイコンで、複数のサイズのイメージを含む場合、常に最大のイメージがロードされる。
実行ファイルやDLLファイル内のアイコンは、BackgroundTransによる背後コントロール透過は有効にならない。

BMP/JPEG/GIF/PNG/TIF/ICO、そのほか、OSのGDI+エンジンがサポートしている形式の画像が表示できる。

ほかのコントロールの後ろに背景として表示したい場合は、Pictureコントロールを最初に配置すればよい。
ただし、PictureコントロールにGオプションでサブルーチンが割り当てられている場合、上に配置されたコントロールをクリックしたときにもそのサブルーチンが実行されてしまう。
これを回避するには、Pictureコントロールをほかのコントロールより後に配置し、Optionに 0x4000000(WS_CLIPSIBLINGS)を設定する。

Related[編集]

GUI, Gui,Add