アイコン、カーソル、ビットマップをロードします。
#Include <WinAPI.au3>
_WinAPI_LoadImage($hInstance, $sImage, $iType, $iXDesired, $iYDesired, $iLoad)
パラメータ
| $hInstance | ロードされる画像を格納しているモジュールのインスタンスを表します。 OEMイメージをロードする場合はこのパラメータをゼロに設定してください。 |
| $sImage | ロードする画像を表します。
$hInstanceパラメータが0でなく$iLoadパラメータに$LR_LOADFROMFILEが含まれていない場合、 $sImageは$hInstanceモジュール内の画像リソースの名前を格納している文字列です。 $hInstanceが0で$LR_LOADFROMFILEが指定されていない場合、 このパラメータの下位ワードはロードするOEMイメージの識別子でなければなりません。 |
| $iType | ロードされる画像の種類を指定します。このパラメータは次の値のいずれかです: $IMAGE_BITMAP - ビットマップをロードします $IMAGE_CURSOR - カーソルをロードします $IMAGE_ICON - アイコンをロードします |
| $iXDesired | アイコンまたはカーソルの幅をピクセル単位で指定します。 この値が0で、$iLoadがLR_DEFAULTSIZEの場合、この関数はSM_CXICONまたはSM_CXCURSORのシステムメトリックスと値を 使って幅の設定をおこないます。 このパラメータが0で、LR_DEFAULTSIZEが使用されていない場合、この関数は実際のリソースの幅を使用します。 |
| $iYDesired | アイコンまたはカーソルの高さをピクセル単位で指定します。 この値が0で、$iLoadがLR_DEFAULTSIZEの場合、この関数はSM_CYICONまたはSM_CYCURSORのシステムメトリックスと値を 使って高さの設定をおこないます。 このパラメータが0で、LR_DEFAULTSIZEが使用されていない場合、この関数は実際のリソースの高さを使用します。 |
| $iLoad | 次の値の組み合わせを指定します: $LR_DEFAULTCOLOR - デフォルトフラグ $LR_CREATEDIBSECTION - $iTypeに$IMAGE_BITMAPが指定されている場合、この関数が互換性のあるビットマップではなくDIBセクションビットマップを返すようにします。 このフラグはビットマップをディスプレイデバイスの色とマッピングせずにロードするために使用されます。 $LR_DEFAULTSIZE - $iXDesired、$iYDesiredの値が0に設定されている場合にカーソル、アイコンのシステムメトリック値によって指定された幅、高さを使用します。 このフラグを設定されず、$iXDesired、$iYDesiredの値が0に設定されている場合、この関数は実際のリソースのサイズを使用します。 リソースが複数の画像を格納している場合、この関数は最初の画像のサイズを使用します。 $LR_LOADFROMFILE - $sImageパラメータで指定されたファイルから画像をロードします。 このフラグが設定されていない場合、$sImageはリソースの名前になります。 $LR_LOADMAP3DCOLORS - 画像のカラーテーブルを検索し、次のグレーの色合いを対応する3D色で置き換えます: 暗いグレー: RGB(128,128,128) COLOR_3DSHADOW グレー : RGB(192,192,192) COLOR_3DFACE 明るいグレー: RGB(223,223,223) COLOR_3DLIGHT $LR_LOADTRANSPARENT - 画像の最初のピクセルのカラー値を取得し、カラーテーブルの対応するエントリーをデフォルトのウィンドウカラーで置き換えます。 そのエントリーを使用している画像内のピクセルは全てデフォルトのウィンドウカラーになります。 この値は対応するカラーテーブルをもっている画像のみに適用されます。 $iLoadが$LR_LOADTRANSPARENTと$LR_LOADMAP3DCOLORSの両方の値を含んでいる場合、$LRLOADTRANSPARENTが優先されます。 ただし、カラーテーブルのエントリーはCOLOR_WINDOWではなくCOLOR_3DFACEで置き換えられます。 $LR_MONOCHROME - 白黒の画像をロードします。 $LR_SHARED - 画像が複数回ロードされた場合、画像ハンドルを共有します。 LR_SHAREDが設定されていない場合、同じリソースに対する2回目のLoadImageの呼び出しでは画像が再ロードされ、異なるハンドルが返されます。 非標準サイズの画像、ロード後に変更される画像、ファイルからロードされる画像に対しては$LR_SHAREDを使用しないでください。 |
返し値
| 成功: | 新しくロードした画像のハンドル |
| 失敗: | 0 |
注意
定義済み定数用にConstants.au3が必要です。
関連
こちらも参照
MSDNライブラリでLoadImageを検索して下さい。