</head> <body> <h1>ClipWait</h1> <p><a href="A_Clipboard.htm">クリップボード</a>にデータが入るまで待ちます。</p> <pre class="Syntax"><span class="func">ClipWait</span> <span class="optional">Timeout, WaitFor</span></pre> <h2 id="Parameters">パラメータ</h2> <dl> <dt>Timeout</dt> <dd> <p>型:<a href="../Concepts.htm#numbers">整数</a>または<a href="../Concepts.htm#numbers">浮動小数点数</a></p> <p>省略した場合は、無期限に待機します。そうでなければ、指定された秒数以上待機することはありません。1秒未満の時間を待機するには、浮動小数点数を指定します。たとえば最大250ミリ秒待機するときは、0.25と指定します。</p> </dd> <dt>WaitFor</dt> <dd> <p>型:<a href="../Concepts.htm#numbers">整数</a></p> <p>If omitted, it defaults to 0 (wait only for text or files). Otherwise, specify one of the following numbers to indicate what to wait for:</p> <p><strong>0:</strong> The function is more selective, waiting specifically for text or files to appear ("text" includes anything that would produce text when you paste into Notepad).</p> <p><strong>1:</strong> The function waits for data of any kind to appear on the clipboard.</p> <p>その他の値は、将来の使用のために予約されています。</p> </dd> </dl> <h2 id="Return_Value">戻り値</h2> <p>型:<a href="../Concepts.htm#boolean">整数(ブーリアン)</a></p> <p>この関数は、タイムアウトした場合は0 (false)を、そうでない場合(すなわちクリップボードにデータがある場合)は1 (true)を返します。</p> <h2 id="Remarks">備考</h2> <p>このクリップボードが空白かどうかをチェックする独自のループよりも、この関数を使用する方がよいでしょう。これは、この関数によってクリップボードが開かれることがないため、パフォーマンスが向上し、クリップボードを使用している可能性のある他のアプリケーションと干渉する可能性が回避されるためです。</p> <p>この機能は、テキストに変換可能なもの(HTMLなど)をテキストとみなします。また、エクスプローラーウィンドウで<kbd>Ctrl</kbd>+<kbd>C</kbd>でコピーしたようなファイルもテキストとみなします。このようなファイルは、スクリプト内でクリップボード変数が参照されるたびに、自動的にそのファイル名(フルパス付き)に変換されます。詳しくは<a href="A_Clipboard.htm">A_Clipboard</a>をご覧ください。</p> <p>最後のパラメータに1を指定すると、クリップボードに何らかのデータが表示されたときに、この関数が満たされます。<a href="ClipboardAll.htm">ClipboardAll</a>と併用することで、画像などテキスト以外のものを保存することができます。</p> <p>関数が待機状態にある間、<a href="../Hotkeys.htm">ホットキー</a>、<a href="Menu.htm">カスタムメニュー項目</a>、または<a href="SetTimer.htm">タイマー</a>によって新しい<a href="../misc/Threads.htm">スレッド</a>を起動することができます。</p> <h2 id="Related">関連</h2> <p><a href="A_Clipboard.htm">A_Clipboard</a>、<a href="WinWait.htm">WinWait</a>、<a href="KeyWait.htm">KeyWait</a></p> <h2 id="Examples">例</h2> <div class="ex" id="ExBasic"> <p><a class="ex_number" href="#ExBasic"></a> クリップボードを空にし、現在の選択範囲をクリップボードにコピーし、クリップボードにデータが入るまで最大2秒間待機します。ClipWaitがタイムアウトした場合はエラーメッセージを表示し、それ以外の場合はクリップボードの内容を表示します。</p> <pre>A_Clipboard := "" <em>; クリップボードを空にする</em> Send "^c" if !ClipWait(2) { MsgBox "The attempt to copy text onto the clipboard failed." return } MsgBox "clipboard = " A_Clipboard return</pre> </div> </body> </html>