データセットに基づいて画像リソースを作成します。この関数には2つのバリアントがあります。
ファイルに基づいてリソースを作成する
bool ResourceCreate (const string resource_name 、 //リソース名const string path //ファイルへの相対パス ); |
bool ResourceCreate (const string resource_name 、 //リソース名const uint& data [] 、 //配列として設定されたデータuint img_width 、//画像リソースの幅uint img_height 、//画像リソースの高さuint data_xoffset 、/ /画像の左上隅の水平右方向オフセットuint data_yoffset 、// 画像の左上隅の垂直下方向オフセットuint data_width |
パラメーター
resource_name
[入力]リソース名。
path
[in]リソースデータを含むファイルへの相対パス。パスが「\」(「\\」と表記)から始まる場合、ファイルパスはterminal_data_folder \ MQL4 \に相対的であると見なされます。そうでない場合、ファイルは.EX4プログラムフォルダーに関連して指定されると見なされます。
data[][]
[in]完全な画像を作成するための1次元または2次元の配列。
img_width
[in]画像の形でリソースに配置されるピクセル単位の長方形の画像領域の幅。data_width 値より大きくすることはできません。
img_height
[in]画像の形でリソースに配置されるピクセル単位の長方形の画像領域の高さ。
data_xoffset
[in]画像の長方形領域の水平右方向オフセット。
data_yoffset
[in]画像の矩形領域の垂直下向きオフセット。
data_width
[in] 1次元配列にのみ必要です。データセットからの画像の全幅を示します。data_width = 0の場合、img_width と等しいと見なされます。2次元配列の場合、パラメーターは無視され、data [] 配列の2番目の次元に等しいと見なされます。
color_format
[in] ENUM_COLOR_FORMAT列挙の値からの色処理メソッド。
戻り値
成功した場合はtrue、それ以外の場合はfalseを返します。エラーに関する情報を取得するには、GetLastError()関数を呼び出します。次のエラーが発生する可能性があります。
- 4015 — ERR_RESOURCE_NAME_DUPLICATED(動的および静的リソースの同一名)
- 4016 — ERR_RESOURCE_NOT_FOUND(リソースが見つかりません)
- 4017 — ERR_RESOURCE_UNSUPPORTED_TYPE(このタイプのリソースはサポートされていません)
- 4018 — ERR_RESOURCE_NAME_IS_TOO_LONG(リソースの名前が長すぎます)
注意
関数の2番目のバージョンが、異なる幅、高さ、およびシフトパラメーターで同じリソースを作成するために呼び出された場合、新しいリソースは作成されず、既存のリソースが更新されます。
関数の最初のバージョンはファイルから画像と音声をアップロードするために使用され、2番目のバージョンは画像の動的作成にのみ使用されます。
画像は、24ビットまたは32ビットの色深度のBMP形式である必要があります。サウンドはWAV形式のみです。リソースのサイズは16 MBを超えてはなりません。
識別子 | 説明 |
COLOR_FORMAT_XRGB_NOALPHA | アルファチャネルのコンポーネントは無視されます |
COLOR_FORMAT_ARGB_RAW | 色成分は端末で処理されません(ユーザーが正しく設定する必要があります) |
COLOR_FORMAT_ARGB_NORMALIZE | 色成分は端末によって処理されます |