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(文字列):コントロールのClassNN(クラス名とインスタンス番号)は、Window Spyで確認することができます。例えば、「Edit1」はクラス名「Edit」を持つ最初のコントロールです。
Text(文字列):コントロールのテキストです。マッチング動作は、SetTitleMatchModeによって決定されます。
HWND(整数):コントロールのHWND。通常、ControlGetHwnd、MouseGetPos、またはDllCallによって取得されます。また、DetectHiddenWindowsがOffの場合でも、非表示のコントロールに対して機能します。それ以降のウィンドウパラメータは無視されます。
Object:GuiControlなど、Hwnd
プロパティを持つ任意の型のオブジェクト。オブジェクトにHwnd
プロパティがない場合はPropertyErrorが、純粋な整数を返さない場合はTypeErrorが投げられる。それ以降のウィンドウパラメータは無視されます。
省略:いくつかの機能は、コントロールとトップレベルウィンドウのどちらに対しても操作することができます。Controlパラメータを省略すると、この関数はターゲットウィンドウ(Controlパラメータで指定した WinTitle)のコントロールの1つではなく、そのコントロールの1つです。例えば、ControlSendはキーボードメッセージを直接ウィンドウに送信することができます。
通常、以下のようなエラーが発生することがあります:
信頼性を高めるため、コントロールを変更するControl関数を使用するたびに、自動的に遅延が行われます(ControlSetStyleと ControlSetExStyleを除く)。この遅延は、SetControlDelayまたはA_ControlDelayに値を割り当てることで変更可能です。詳しくは、SetControlDelayの備考を参照してください。
現在マウスが乗っているコントロールのClassNNまたはHWNDを検出するには、MouseGetPosを使用します。
ウィンドウ内の全てのコントロールの配列を取得するには、WinGetControlsまたはWinGetControlsHwndを使用します。
SetControlDelay、Win関数、GuiControlオブジェクト(スクリプトで作成したコントロール用)