iron_taskdialog.hsp
Version 3.8
Date 2026/04/18
Author IronHSP
目次 (2 グループ / 32 ページ)
タスクダイアログ
taskdlg
タスクダイアログを表示 (フル機能版)
Windows Vista 以降の TaskDialogIndirect API を使用して、モダンなタスクダイアログを表示します。
MessageBox の上位互換として、より豊富なカスタマイズが可能です。
taskdlg_set_width
タスクダイアログの幅を設定
次回の taskdlg 呼び出しで使用されるダイアログの幅をピクセル単位で設定します。
0 を指定すると、コンテンツに応じた自動幅になります (デフォルト)。
内部的に TASKDIALOGCONFIG 構造体の cxWidth フィールドに設定されます。
taskdlg_simple
簡易タスクダイアログを表示
選択肢なしの簡易タスクダイアログを表示します。
OS 標準の共通ボタン (OK / Yes / No / Cancel / Retry / Close) のみを使用するシンプルな版です。
タスクダイアログ定数
IDCANCEL
キャンセルボタン ID (値: 2)
キャンセルボタンが押された場合や、× ボタン / Esc キーで閉じた場合に stat にこの値 (2) が返ります。
taskdlg のコマンドリンク形式でキャンセルされた場合も同じ値が返ります。
Windows API の標準定数です。
IDCLOSE
閉じるボタン ID (値: 8)
閉じるボタンが押された場合に stat にこの値 (8) が返ります。
Windows API の標準定数です。
IDNO
いいえ (No) ボタン ID (値: 7)
「いいえ」ボタンが押された場合に stat にこの値 (7) が返ります。
Windows API の標準定数です。
IDOK
OK ボタン ID (値: 1)
taskdlg_simple で TDBTN_OK を指定した場合、OK ボタンが押されると stat にこの値 (1) が返ります。
Windows API の標準定数です。
IDRETRY
再試行ボタン ID (値: 4)
再試行ボタンが押された場合に stat にこの値 (4) が返ります。
Windows API の標準定数です。
IDYES
はい (Yes) ボタン ID (値: 6)
「はい」ボタンが押された場合に stat にこの値 (6) が返ります。
Windows API の標準定数です。
TDBTN_CANCEL
キャンセルボタン定数 (値: 0x08)
共通ボタンとしてキャンセルボタンを表示します。
値は 0x08 (8) です。
キャンセルボタンが押された場合、stat に IDCANCEL (2) が返ります。
TDBTN_CLOSE
閉じるボタン定数 (値: 0x20)
共通ボタンとして「閉じる」ボタンを表示します。
値は 0x20 (32) です。
閉じるボタンが押された場合、stat に IDCLOSE (8) が返ります。
TDBTN_NO
いいえ (No) ボタン定数 (値: 0x04)
共通ボタンとして「いいえ」ボタンを表示します。
値は 0x04 (4) です。
「いいえ」ボタンが押された場合、stat に IDNO (7) が返ります。
TDBTN_OK
OK ボタン定数 (値: 0x01)
共通ボタンとして OK ボタンを表示します。
値は 0x01 (1) です。
taskdlg_set_buttons や taskdlg_simple の buttons パラメータに指定します。
複数のボタンを表示する場合は OR 演算子 (|) で組み合わせます。
TDBTN_RETRY
再試行ボタン定数 (値: 0x10)
共通ボタンとして「再試行」ボタンを表示します。
値は 0x10 (16) です。
再試行ボタンが押された場合、stat に IDRETRY (4) が返ります。
TDBTN_YES
はい (Yes) ボタン定数 (値: 0x02)
共通ボタンとして「はい」ボタンを表示します。
値は 0x02 (2) です。
「はい」ボタンが押された場合、stat に IDYES (6) が返ります。
TDF_ALLOW_DIALOG_CANCELLATION
ダイアログキャンセル許可フラグ (値: 0x0008)
タイトルバーの × ボタンや Esc キーでダイアログを閉じられるようにします。
閉じた場合、stat に IDCANCEL (2) が返ります。
値は 0x0008 です。
taskdlg および taskdlg_simple のデフォルトフラグに含まれています。
TDF_ENABLE_HYPERLINKS
ハイパーリンク有効フラグ (値: 0x0001)
content や footer テキスト中の <a href="URL">テキスト</a> 形式のハイパーリンクを有効にします。
値は 0x0001 です。
taskdlg_set_flags で設定します。
taskdlg のデフォルトフラグに含まれています。
TDF_USE_COMMAND_LINKS
コマンドリンク表示フラグ (値: 0x0010)
taskdlg の選択肢をコマンドリンク形式 (大きなボタン + 矢印アイコン) で表示します。
通常のラジオボタンではなく、Vista スタイルの大きな選択ボタンになります。
値は 0x0010 です。
taskdlg のデフォルトフラグに含まれています。
TDICO_ERROR
エラーアイコン定数 (値: 2)
赤い丸のエラーアイコンを表示します。
値は 2 です。内部的に TD_ERROR_ICON (0xFFFE) に変換されます。
TDICO_INFO
情報アイコン定数 (値: 3)
青い丸の情報アイコンを表示します。
値は 3 です。内部的に TD_INFORMATION_ICON (0xFFFD) に変換されます。
TDICO_NONE
アイコンなし定数 (値: 0)
メインアイコンまたはフッターアイコンにアイコンを表示しないことを示す定数です。
値は 0 です。taskdlg や taskdlg_simple の mainico / footico パラメータに指定します。
TDICO_SHIELD
シールドアイコン定数 (値: 4)
UAC シールド (盾) アイコンを表示します。
管理者権限が必要な操作を示すときに使用します。
値は 4 です。内部的に TD_SHIELD_ICON (0xFFFC) に変換されます。
TDICO_WARNING
警告アイコン定数 (値: 1)
黄色い三角形の警告アイコンを表示します。
値は 1 です。内部的に TD_WARNING_ICON (0xFFFF) に変換されます。