Control Functions

Functions for retrieving information about a control or for performing various operations on a control. 関数の名称をクリックすると詳細が表示されます。

機能 説明
ControlAddItem リストボックスまたはコンボボックスの下部に、指定された文字列を新規項目として追加します。
ControlChooseIndex ListBox、ComboBox、またはTabコントロールの選択範囲をN番目の項目に設定します。
ControlChooseString リストボックスまたはコンボボックスの選択範囲を、先頭部分が指定された文字列と一致する最初の項目に設定します。
ControlClick マウスボタンまたはマウスホイールイベントをコントロールに送信します。
ControlDeleteItem リストボックスまたはコンボボックスから指定されたエントリ番号を削除します。
ControlFindItem 指定された文字列と完全に一致するListBoxまたはComboBoxのエントリ番号を返します。
ControlFocus ウィンドウ上の指定されたコントロールに入力フォーカスを設定します。
ControlGetChecked チェックボックスまたはラジオボタンがチェックされている場合、0以外の値を返します。
ControlGetChoice ListBox、ComboBox で現在選択されている項目の名前を返します。
ControlGetClassNN 指定されたコントロールの ClassNN(クラス名とシーケンス番号)を返します。
ControlGetEnabled 指定されたコントロールが有効である場合、0 以外の値を返します。
ControlGetFocus ターゲットウィンドウのどのコントロールにキーボードフォーカスがあるのかを取得します(もしあれば)。
ControlGetHwnd 指定されたコントロールのユニークな ID 番号を返します。
ControlGetIndex ListBox、ComboBox、Tab コントロールで現在選択されている項目またはタブのインデックスを返します。
ControlGetItems ListBox, ComboBox, DropDownList の項目/行の配列を返します。
ControlGetPos コントロールの位置と大きさを取得します。
ControlGetStyle
ControlGetExStyle
指定されたコントロールのスタイルまたは拡張スタイルを表す整数を返します。
ControlGetText コントロールからテキストを取得します。
ControlGetVisible 指定されたコントロールが可視状態である場合、0 以外の値を返します。
ControlHide 指定されたコントロールを非表示にします。
ControlHideDropDown コンボボックスコントロールのドロップダウンリストを非表示にします。
ControlMove コントロールを移動またはサイズ変更します。
ControlSend
ControlSendText
キーストロークやテキストをシミュレーションして、ウィンドウやコントロールに送信します。
ControlSetChecked チェックボックスやラジオボタンをオン(チェック)またはオフ(チェック解除)します。
ControlSetEnabled 指定されたコントロールを有効または無効にします。
ControlSetStyle
ControlSetExStyle
指定されたコントロールのスタイルまたは拡張スタイルをそれぞれ変更します。
ControlSetText コントロールのテキストを変更します。
ControlShow 指定されたコントロールが以前に非表示になっていた場合、それを表示します。
ControlShowDropDown ComboBox コントロールのドロップダウンリストを表示します。
EditGetCurrentCol キャレット(テキスト挿入点)が存在するエディットコントロールのカラム番号を返します。
EditGetCurrentLine キャレット(テキスト挿入点)が存在するエディットコントロールの行番号を返します。
EditGetLine Edit コントロールの指定された行のテキストを返します。
EditGetLineCount Editコントロールの行数を返します。
EditGetSelectedText Edit コントロールで選択されているテキストを返します。
EditPaste エディットコントロールのキャレット(テキストの挿入位置)に指定された文字列を貼り付けます。
ListViewGetContent ListViewから項目/行のリストを返します。

制御パラメータ

個々のコントロールを操作する機能には、コントロールというパラメータがあり、コントロールを識別するためのいくつかの異なる方法をサポートしています。Controlパラメータには、以下のいずれかを指定します。

ClassNN (String):コントロールのClassNN(クラス名とインスタンス番号)は、Window Spyで確認することができます。例えば、「Edit1」はクラス名「Edit」を持つ最初のコントロールです。

Text (String):コントロールのテキストです。マッチング動作は、SetTitleMatchModeによって決定されます。

HWND (Integer):コントロールのHWND。通常、ControlGetHwndMouseGetPos、またはDllCallによって取得されます。また、DetectHiddenWindowsがOffの場合でも、非表示のコントロールに対して機能します。それ以降のウィンドウパラメータは無視されます。

Object: An object of any type with a Hwnd property, such as a GuiControl. オブジェクトにHwndプロパティがない場合はPropertyErrorが、純粋な整数を返さない場合はTypeErrorが投げられる。それ以降のウィンドウパラメータは無視されます。

Omitted: A few functions are able to operate on either a control or a top-level window. Controlパラメータを省略すると、この関数はターゲットウィンドウ(Controlパラメータで指定した WinTitle)のコントロールの1つではなく、そのコントロールの1つです。例えば、ControlSendはキーボードメッセージを直接ウィンドウに送信することができます。

エラー処理

通常、以下のようなエラーが発生することがあります。

備考

信頼性を高めるため、コントロールを変更するControl関数を使用するたびに、自動的に遅延が行われます(ControlSetStyleControlSetExStyleを除く)。この遅延は、SetControlDelayまたはA_ControlDelayに値を割り当てることで変更可能です。詳しくは、SetControlDelayの備考を参照してください。

現在マウスが乗っているコントロールのClassNNまたはHWNDを検出するには、MouseGetPosを使用します。

ウィンドウ内の全てのコントロールの配列を取得するには、WinGetControlsまたはWinGetControlsHwndを使用します。

SetControlDelayWin関数GuiControlオブジェクト(スクリプトで作成したコントロール用)