{{indexmenu_n>60}}
====== ダイアログ操作 ======

ダイアログ操作は以下の手順で行います。

  - ダイアログを開くボタンやメニュー項目をclick関数やmenu関数で操作する（click関数はthroughパラメータをtrueにすること）
  - dialogOpen関数でダイアログが開いたことを確認
  - dialogClick関数やdialogSearch関数などでダイアログ内の操作を行う
  - dialogClose関数でダイアログが閉じたことを確認

===== dialogOpen関数 =====
ダイアログが開いたかどうかを判定し次の処理に進みます。\\
ダイアログ操作関数で使用する内部情報を取得しているためこの手順は必須です。\\
3秒以内に開かない場合は確認ダイアログを表示します。

  dialogOpen([title])

<wrap em>title</wrap> [文字列] 省略可
<block indent>
確認対象となるダイアログのタイトルを指定します。\\
設定した場合、タイトルの完全一致するダイアログのみ判定の対象とします。\\
省略すると最初に開いたダイアログを操作対象と見なします。\\
文中に ''${変数名}'' と記述すると指定した変数に置換されます。
</block>
----
===== dialogClose関数 =====
ボタン操作で閉じないダイアログを閉じ、ダイアログが閉じたかどうかを判定し次の処理に進みます。\\
3秒以内に閉じない場合は確認ダイアログを表示します。\\
内部処理を実行しているためダイアログが閉じるタイミングで必ずこの関数を実行してください。

  dialogClose()

----
===== ダイアログ操作関数 =====
ダイアログ操作では操作対象の要素のクラス名（Windowsフォームのクラス名）を指定する必要があります。\\
頻出のダイアログに含まれる要素については[[function:dialog#クラス名一覧|本ページの下部]]にまとめてあります。\\
それ以外のダイアログについては各自で調べていただく必要があります。

<wrap em>class</wrap> [クラス名] 省略不可
<block indent>
ダイアログ操作関数共通のパラメータです。
</block>
----
==== dialogClick関数 ====

ボタンおよびチェックボックスをクリックします。\\
操作対象がON/OFFタイプのボタンおよびチェックボックスの場合はトグル動作になります。\\
パラメータを省略すると1回クリックします。

  dialogClick(class[, repeat])

<wrap em>repeat</wrap> [整数or変数名] 省略可
<block indent>
設定するとその回数ボタンをクリックします。
</block>
----
==== dialogCheck関数 ====

ON/OFFタイプのボタンおよびチェックボックスを現在の状態に関わらずONにします。

  dialogCheck(class)

----
==== dialogUncheck関数 ====

ON/OFFタイプのボタンおよびチェックボックスを現在の状態に関わらずOFFにします。

  dialogUncheck(class)

----
==== dialogSearch関数 ====

ドロップダウンリストから検索文字列と完全一致する項目を選択します。

  dialogSearch(class, string)

<wrap em>string</wrap> [文字列] 省略不可
<block indent>
検索する文字列を入力します。完全一致で検索されます。\\
同一名称の項目が複数ある場合は一番上の項目が選択されます。\\
文中に ''${変数名}'' と記述すると指定した変数に置換されます。
</block>
----
==== dialogSelect関数 ====
ドロップダウンリストの項目を上からの順番を指定して選択します。

  dialogSelect(class, count)

<wrap em>count</wrap> [整数or変数名] 省略不可
<block indent>
上から何番目の項目を選択するか指定します。一番上の項目が ''1'' です。
</block>
----
==== dialogCount関数 ====
ドロップダウンリストの項目数を[[:variable|変数]]に取得します。

  dialogCount(class, variable)

<wrap em>variable</wrap> [変数名] 省略不可
<block indent>
取得した項目数を格納する変数を指定します。
</block>
----
==== dialogCurrent関数 ====
ドロップダウンリストの現在選択中の項目の順番とテキスト（文字列）を[[:variable|変数]]に取得します。

  dialogCurrent(class[, variable1, variable2])

<wrap em>variable1</wrap> [変数] 省略可
<block indent>
選択されている項目の上からの順番（整数）を格納する変数を指定します。一番上の項目が ''1'' です。
</block>

<wrap em>variable2</wrap> [変数名] 省略可
<block indent>
選択されている項目のテキスト（文字列）を格納する変数を指定します。
</block>
-----
==== dialogSet関数 ====
  dialogSet(class, number)

入力欄に整数ないし小数をセットします。

<wrap em>number</wrap> [数値or変数名] 省略不可
<block indent>
挿入する値または変数名を指定します。
</block>
-----
==== dialogSetStr関数 ====
  dialogSet(class, string)

入力欄に文字列をセットします。

<wrap em>string</wrap> [文字列] 省略不可
<block indent>
挿入する文字列を指定します。\\
文中に ''${変数名}'' と記述すると指定した変数に置換されます。
</block>
----
===== クラス名一覧 =====
==== 物理ON/OFFフレーム変換 ====
{{:function:dialog_phsycs-on-off.png?nolink|物理ON/OFFフレーム変換}}
==== 外部親設定 ====
{{:function:dialog_op.png?nolink|外部親設定}}

※外部親設定ダイアログはdialogClose関数で閉じます
==== 時間拡大(縮小)率 ====
{{:function:dialog_time-expand.png?nolink|時間拡大(縮小)率}}
==== ファイルを開く ====
{{:function:dialog_file.png?nolink|ファイルを開く}}
==== モデル情報 ====
{{:function:dialog_model-info.png?nolink|モデル情報}}
----
===== 使用例 =====
==== 物理ON/OFFフレーム変換 ====
<code ini>
;物理ON/OFFフレーム変換ダイアログを開く
menu(6, 17)

;ダイアログ開始確認
dialogOpen(物理ON/OFFフレーム変換)

;ドロップダウンの2個目の項目(OFF)を選択
dialogSelect(ComboBox1,2)

;OKボタン押下
dialogClick(Button1)

;ダイアログ終了確認
dialogClose()
</code>
==== 外部親設定 ====
<code ini>
;外部親ボタンを押す
click(model_op,,, true)

;ダイアログ開始確認
dialogOpen(外部親設定)

;ドロップダウンから指定文字列に一致する項目を選択
dialogSearch(ComboBox1, 右袖)
dialogSearch(ComboBox2, 初音ミク)
dialogSearch(ComboBox3, 右袖)

;フレーム登録
dialogClick(Button6)

;ダイアログを閉じて終了確認
dialogClose()
</code>
==== モデル読み込み ====
<code ini>
;モデル読み込みボタンを押す
click(model_load,,, true)

;ダイアログ開始確認
dialogOpen(ファイルを開く)

;入力欄にフルパスを入力
dialogSetStr(Edit1, D:\MikuMikuDance_v926x64\UserFile\Model\初音ミク.pmd)

;開くボタン押下
dialogClick(Button1)

;ダイアログ終了確認
dialogClose()

;モデル情報ダイアログを処理
dialogOpen(モデル情報)
dialogClick(Button1)
dialogClose()
</code>