&timer で指定する [指定する時間] の書式通りかどうかをチェックする。

引数の値が &timer の [指定する時間] の書式通りの 6桁の数字なら True を返す。

それ以外なら False を返す。

&wait で指定する [指定する時間] の書式通りかどうかをチェックする。

引数の値が &wait の [指定する時間] の書式通りの文字なら True を返す。
1h 1m 1sなど

それ以外なら False を返す。

返り値は 16進数に変換した数字になる。

0x1 といった、 0x が先頭についた数字になる。

trim0xFlag の引数に True を指定した場合、返り値が 0x を取り除いた数字になる。

返り値は 10進数に変換した数字になる。

引数に指定する数字は 0x が先頭に付いていても、付いていなくてもどちらでもよい。

単純に今の日付と時間を返す関数。

2020年01月01日 23時59分59秒
といった文字列を返り値にする。

ただ単に

を使っている。

ErrorLevel_TextRunRun の変数の値が 1 以上なら、 False を返す。

それ以外なら True を返す。

ErrorLevel_TextRunRun の変数の値が 1 以上なら、 errorMessage の文字をエラー表示する。

ErrorLevel_TextRunRun の変数を初期値に戻す。

をした場合と同じ。

エラー表示 に、引数の文字を出力する。

追加で出力する。
後、最後に改行を加える。

を使用した関数。

Ｇｕｉのコントロールの文字を取得する簡易的な関数である。

Text のコントロールや
Edit のコントロールの文字を取得することを目的した関数である。

返り値はコントロールから取得した文字である。

Ｇｕｉのコントロールの文字を取得する関数は、他に

もある。

controlVar には、変数名の文字列を入れる。

といった感じである。

B_conText1_Edit1 といった変数は、コントロールの変数名を格納した変数なので、

とった指定の仕方になる。

&collabText や &stockExeAllBlue などで使用できる、
D_stockBlue_1$$ などの文字を変換して取得できる。

引数の値の中に、 D_stockBlue_1$$ などの文字列があると、 D_stockBlue_1$$ なら、
ストックの 1 の入力欄の文字に変換されて返り値として返す。

変換するものが無い場合は元の文字列を返す。

漢数字や全角文字から &timer の規定のコマンドで使われるような時間を表す 6 桁の数字を返す。

時 分 秒 の単語から、時間を解析する。

二十三時五十九分五十九秒 なら
235959 に変換する。

2 、 4 、 6 桁の数字の場合のみ、時間を表す数字かどうかを調べて、 6 桁の数字を返す。

12 は
120000

1234 は
123400
になる。

dateTime形式のの数字の場合も、 6 桁の数字のみを返す。

20210101235959 は
235959
になる。

少しでも書式に合わない引数の場合、エラーが出力され
返り値は error の文字列になる。

errorNotViewFlag の引数があるが、これに True を代入していた場合、エラーがあってもエラーを出力しないようにする。

漢数字や全角文字から、 &wait の規定のコマンドで使われる様な、
時間を表す  1h  1m  1s  といった文字に変換して返す。

時間 分 秒 の単語から、時間を解析する。

二十三時間五十九分五十九秒 なら
23h 59m 59s に変換する。

元々、1h  1m  1s といった文字なら、そのまま返す。

数字のみの場合はエラー。

少しでも書式に合わない引数の場合、エラーが出力され
返り値は error の文字列になる。

errorNotViewFlag の引数があるが、これに True を代入していた場合、エラーがあってもエラーを出力しないようにする。

アイテムの引数を返す。

引数にアイテム名を指定する。

アイテムの種類の番号を返す。

引数にアイテム名を指定する。

アイテムの種類が

を返す。

アイテムのスクリプト リンク先 を返す。

引数にアイテム名を指定する。

アイテムの作業フォルダを返す。

引数にアイテム名を指定する。

上位フォルダを返す。

file の引数に、ファイルパスを指定する。

そのファイルパスが存在するフォルダ 親フォルダ を返す。

ショートカットの、本体のファイルパスを取得する。

引数にファイルパスを指定する。

この関数では、 本体のファイルパスに続く引数 パラメーター は取得できない。

F_getShortcutPathAndArgs(   ) の方を使えば、 本体のファイルパス と 引数も取得する。

似たようなものに、
Alt+Shift+P &shortCutPath
があるが、これは変数に代入したりはできない。

ショートカットのリンク先 本体のファイルパス と 引数 を取得する。

引数にファイルパスを指定する。

F_getShortcutPath( shortcutFile ) との違いは、
こちらは、本体のファイルパス のみ取得する。

この F_getShortcutPathAndArgs( shortcutFile ) の方は、
本体のファイルパス と 引数も取得する。

の形が返り値である。

実行元のテキストの入力欄の文字を所得する。

使用できるのは、 テキストのＧｕｉのみが対象である。

一行テキスト 、 分割テキスト のみが対象になる。
二行以上のテキスト では対象にならない。

分割テキスト で動作させていた場合、フォーカスされている入力欄の文字を取得する。

trimFlag の引数は
Trim( ) の関数を最後に使用するかどうか。

True か引数を省略したなら、前後のスペースとタブの文字が取り除かれる。

一応、 &parsentss や &sharpss のようなものを自作する時のために用意している。

この F_getTextEditExecutor( ) と、
&outArgsToTextEditExecutor と
&sendEndToTextEditExecutor を使えばそれが可能かもしれない。

テキストの入力欄の文字を所得する。

使用できるのは、 テキストのＧｕｉのみが対象である。

一行テキスト 、 分割テキスト 、 二行以上のテキスト のみで使用できる。

GuiNum の引数に
テキストのＧｕｉの番号を指定する。
B_GuiNumText1 などを指定することが前提。

number の引数に
上から何番目の入力欄かを指定。
分割テキストでなければ意味を成さない。

trimFlag の引数は
Trim( ) の関数を最後に使用するかどうか。

True か引数を省略したなら、前後のスペースとタブの文字が取り除かれる。

&timer や &wait で実行されるタイマーの情報を返り値として返す。

タイマー一覧 のウインドウにある 10種類のタイマーに関する情報と同じ。

タイマーが実行中かどうかや、残り時間や、実行しようとしているスクリプトを返り値として返す。

listNumber の引数に、タイマーの番号を指定する。

返り値として返すのはその番号のタイマーの情報になる。

inforNumber の引数には、情報の種類を番号で指定する。

何らかのエラーがあった場合は error の文字を返り値として返す。
エラーも出力される。

inforNumber に 3 以外を指定していた場合は、
listNumber に指定した番号のタイマーが実行中でない場合もエラーとして扱う。

を実行する関数。

Gui を作成、操作をする。

option が Sub-command に
value1 が Param2 に
value2 が Param3 に
value3 が Param4 に該当する。

value の指定がいらない場合、カラの文字ではなく
_ アンダーバー の文字を入れる。

カラでは、カラの文字を明示的に指定する事になってしまう。

を実行する。

画像ファイルがあるかを確認して、画像を追加する。

画像が見つかれば、画像を追加して True を返す。

見つからなければ、何もせず False を返す。

画像ファイルがあるかを確認して、画像を追加する。

F_GuiAddPictureFileExist(  )
と違い、引数の noExtFile に拡張子を含めないファイルパスを指定する。

その、拡張子なしで指定したファイルパスに

• .gif
• .jpg
• .jpeg
• .png

のいずれかを足したファイルが見つかればその画像を追加する。

引数の noExtFile で指定したファイルが存在するなら、そちらを使用する。

つまり、拡張子なし、拡張子ありのどちらを指定してもよい。
よって、 F_GuiAddPictureFileExist(  )
と同じと思ってよい。

画像が見つかれば、画像を追加して True を返す。

見つからなければ、何もせず False を返す。

を実行する関数。

Gui のコントロールに、valueの値を指定して操作をする簡易的な関数。

controlVar が ControlID に
option が Sub-command に
value が Param3 に該当する。

value の指定がいらない場合、カラの文字ではなく
_ アンダーバー の文字を入れる。

カラでは、カラの文字を明示的に指定する事になってしまう。

B_conText1_Edit1 といった変数は、コントロールの変数名を格納した変数なのでこれらを使う場合は、

とった指定の仕方になる。

を実行する関数。

Gui のコントロールの内容を取得をする簡易的な関数。

controlVar が ControlID に
option が Sub-command に
value が Param4 に該当する。

OutputVar を指定する箇所がありません。
返り値がコントロールの内容を取得した文字になる。

B_conText1_Edit1 といった変数は、コントロールの変数名を格納した変数なのでこれらを使う場合は、

とった指定の仕方で使う。

または、

とった指定の仕方でも使える。

option と value の指定がいらない場合、カラの文字ではなく
_ アンダーバー の文字を入れる。

カラでは、カラの文字を明示的に指定する事になってしまう。

実行元の テキスト を閉じる。

閉じた後、
WinWaitActive, A, , 1
を使って、何らかのウインドウがアクティブになるのを少し待つ。

尚、実行元の テキスト を閉じる際、
設定 の テキストを閉じるのではなく、最小化させるようにする のチェックボックスの影響を受ける。

実行元の テキスト を閉じる。

引数の値が、
A の文字列であった時のみ、実行元の テキスト を閉じる。

F_hideGuiTextAndWaitActiveAny( )
とほぼ同じだが、
WinWaitActive, A, , 1
を使用しない。

こちらも、実行元の テキスト を閉じる際、
設定 の テキストを閉じるのではなく、最小化させるようにする のチェックボックスの影響を受ける。

テキスト を閉じる。

引数にＧｕｉの番号を指定する。

使用できるのは、 テキスト のＧｕｉのみが対象である。

• 一行テキスト
• 分割テキスト
• 二行以上のテキスト

のみで使用できる。

例

説明表示のウインドウも一緒に閉じるようにしてある。

設定 の テキストを閉じるのではなく、最小化させるようにする のチェックボックスの影響を受ける。

テキスト を閉じる。

F_hideGuiTextPattern( GuiNum )
を細かく指定するタイプ。

使用できるのは、 テキスト のＧｕｉのみが対象である。

• 一行テキスト
• 分割テキスト
• 二行以上のテキスト

のみで使用できる。

outGuiHideFlag の引数には、
説明表示系のウインドウも一緒に閉じるかどうか の指定。

True なら、説明表示系のウインドウも一緒に閉じる。

それ以外なら Falseなら 、それをしない。

minimizeOption の引数には、
設定 の テキストを閉じるのではなく、最小化させるようにする の設定の影響を受けるかどうか。

True なら、設定の影響を受ける。

それ以外なら Falseなら 、設定の影響は無関係。

あくまで、設定の影響をうけるかどうかであって、最小化の動作を指定するわけではない点に注意が必要。

明示的に最小化させる場合は、
Gui, %GuiNum%:Minimize
や
F_minimizeGui( GuiNum ) を使う。

半角入力か、全角入力かを確認する。

最前面のウインドウ内が対象。

全角入力の状態なら、1
半角入力の状態なら、0
を返す。

半角入力か、全角入力かを操作する。

引数が、
1 なら 全角入力 に
0 なら 半角入力 にする。

最前面のウインドウ内が対象。

入力補完が表示している時、入力補完で選択されている文字を 一行テキスト の入力欄に出力する。

引数には 一行テキスト のＧｕｉの番号を指定する。

この関数を実行した時は、その指定した 一行テキスト も表示している必要がある。

一行テキスト 以外のＧｕｉの番号を指定する事は想定していない。

分割テキスト のＧｕｉの番号を指定しても、 一番上の入力欄に出力するだけになる。

基本は、 常時使用のキー から使用するものである。

返り値は、出力できたら True を返す。
そうでなければ False を返す。

指定している 一行テキスト が表示されてない場合などは失敗して False になる。

テキスト上の

• 上
• 下
• PageUp
• PageDown

のキーと同じ動作をさせる。

テキスト上では、

• 上
• 下
• PageUp
• PageDown

のキーは、
入力補完の選択している位置を変えるキーとして独自の動作をする。

この関数を使うことで、同じ動作を別のキーに指定するといったことができる。

分割テキスト上でも使用できる。

引数で動作させるキーを指定する。
数字で指定する。

1 上
2 下
3 PgUp
4 PgDown
5 Home

なお、 テキスト上のキーとして登録する際は、
%-- を右端に記述する必要がある。

これがないと、実行元の引数が邪魔になってしまう。

アイテムを実行する。

引数が、 アイテム名 の文字列の場合は True

そうでなかった場合は False を返す。

似たようなものに
F_textExe( command )
があるが、
この F_itemExe( itemName, args )
の方は、 アイテム名であったときのみ実行する。

こちらの方が無駄な処理をしない分、少し処理が効率的である。

fromFileName から登録する アイテム を一つだけ再読み込みする。

fromFileName の item フォルダの中にその アイテム名 の情報があれば、それを登録する。

itemName の引数に、 アイテム名を指定する。

itemCategoryDir の引数には、
アイテムのカテゴリーフォルダにアイテムの情報がある場合、そのフォルダ名を指定する。

フォルダ名の最後に _ があるフォルダの事。
このフォルダはアイテムではなくアイテムのカテゴリー用のフォルダになる。

categoryDir の引数には、
カテゴリーフォルダ名を指定する。

既にアイテムが登録されている場合は、そのアイテムの情報は無くなり上書きされる。
つまり編集する。

この場合、 itemCategoryDir と categoryDir はカラの文字を指定するか指定を省略すると、 アイテム の情報から カテゴリーフォルダと アイテムのカテゴリーフォルダを調べて対処するようになっている。 編集の場合はむしろ指定しない方がよい。

まだアイテムが登録されていなければ新規登録扱いになる。

新規登録の場合は、 categoryDir の指定が必要。
アイテムのカテゴリーフォルダの中にある アイテム を指定する場合は、 itemCategoryDir の方も指定する必要がある。

なお、 categoryDir の指定は、 first を指定する場合は、カラの文字でもよかったりする。

エラーがあった場合だが、
既にアイテムが登録されている場合は、エラーがあったとしても、元のアイテムの情報は無くなる。

返り値は

アイテムを削除した後にエラーがある場合は 3
を返す。

似たようなものとして、規定のコマンドに
&itemReloadOneFromFileName がある。

出来ることは同じである。
ただし、こちらは引数の順番が違う点に注意が必要である。

漢数字を数字に変換する。

後、全角文字の数字を半角の数字に変える。

例

九万九千九百九十九 は
99999 になる。

引数には、漢数字などを入れなければならない。

少しでも書式に合わない引数の場合、エラーが出力され
返り値は error になる。

数字を指定する分にはエラーにはならない。

errorNotViewFlag の引数があるが、これに True を代入していた場合、エラーがあってもエラーを出力しないようにする。

F_lastWordSetFirstNumAllFromAllLineStr() 内で使われる関数。

F_lastWordSetFirstNumAllFromAllLineStr() 内で使われる関数。

テキストの文字を自動的に実行の設定 のタブを切り替える。

引数にタブの番号を入れる。

`r の文字を CRの改行 に、

`n の文字を LFの改行 に置換する。

それらの文字が無いなら、元の文字列を返す。

CRの改行を `r の文字に、

LFの改行を `n の文字に置換する。

それらの文字が無いなら、元の文字列を返す。

つまり、
F_linefeedReplace( str ) と逆である。

複数行の文字を一行にしたい時などに使う。

TRR のＧｕｉを最小化させる。

を実行させる。

現時点ではそれだけである。

F_hideGuiTextPattern( GuiNum ) のように、
説明表示のウインドウ を一緒に閉じたりなどはできない。

TRR上のＧｕｉなら自作したＧｕｉでも使用できる。

二行以上のテキスト と同じ処理をする。

似たようなものに、規定のコマンドの
&multiplelineExe がある。

&multiplelineExe は `n の文字を改行に変換するが、
F_multiplelineExe( command ) は それはやらない。

アイテム を登録する。

似たようなものに、規定のコマンドの
&newItemFromCommand がある。

&newItemFromCommand を使った時と違い、返り値がある。

エラーがある場合は、 0 を返し、
成功した場合は 1 を返す。

&newItem で表示するＧｕｉを使って アイテム を登録したときと違い、
ファイルに設定を保存したりしないので、再起動すると、全て無かったことになる。

蓄え式説明表示 に、引数の文字を出力する。

追加で出力。

キーを送信する前の待機時間が beforeWinDelay の指定で、キーを送信した後の待機時間が afterSleepDelay の指定と思えばよい。

を実行する関数。

Ｇｕｉのコントロールに、 value の値をセットする簡易的な関数。

Text のコントロールや、 Edit のコントロールに
文字をセットすることを目的としたもの。

Ｇｕｉのコントロールを操作する関数は、他に
F_GuiControl(  )
もある。

controlVar の引数には、
変数名の文字列を入れる。

といった感じ。

B_conText1_Edit1 といった変数は、コントロールの変数名を格納した変数なのでこれらを使う場合は、

とった指定の仕方になる。

value の引数には、
コントロールにセットしたい文字列を入れる。

テキストの入力欄に文字を出力する。

使用できるのは、 テキストのＧｕｉのみが対象である。

• 一行テキスト
• 分割テキスト
• 二行以上のテキスト

のみで使用できる。

引数の意味は下記を参考に。

テキストの文字で自動的に実行の設定 のウインドウを表示する。

option の引数には、
表示する時の状態を指定する。

この部分 の指定と同じ指定方法になる。

指定しない場合、カラの文字ではなく、
"_" アンダーバー を入れる。
または、引数自体を省略する。

toggleFlag の引数は、
True の場合、すでに表示してる時に使用した場合は閉じる。

TRR のウインドウを表示する。

すでに表示している時に使うと閉じる動作になる。

引数にＧｕｉの番号を指定する。

option の引数には、
表示する時の状態を指定する。

この部分 の指定と同じ指定方法になる。

指定しない場合、カラの文字ではなく、
"_" アンダーバー を入れる。
または、引数自体を省略する。

テキストのＧｕｉを表示する。

すでに表示している時に使うと閉じる動作になる。

使用できるのは、 テキストのＧｕｉのみが対象である。

• 一行テキスト
• 分割テキスト
• 二行以上のテキスト

のみで使用できる。

option の引数には、
表示する時の状態を指定する。

この部分 の指定と同じ指定方法になる。

指定しない場合、カラの文字ではなく、
"_" アンダーバー を入れる。
または、引数自体を省略する。

説明表示用のウインドウも一緒に閉じるようにしてある。

設定 の テキストを閉じるのではなく、最小化させるようにする の設定の影響を受ける。

テキストのＧｕｉを表示する。

すでに表示している時に使うと閉じる動作になる。

F_showToggleGuiTextPattern(  )
を細かく指定するタイプ。

使用できるのは、 テキストのＧｕｉのみが対象である。

• 一行テキスト
• 分割テキスト
• 二行以上のテキスト

のみで使用できる。

outGuiHideFlag の引数は、
説明表示用のウインドウも一緒に閉じるかどうか。

True なら説明表示のウインドウも一緒に閉じる。
それ以外なら Falseなら、 それをしない。

minimizeOption の引数は、
設定 の テキストを閉じるのではなく、最小化させるようにする の設定の影響を受けるかどうか。

True なら設定の影響を受ける。
それ以外なら Falseなら、 設定の影響は無関係。

あくまで、設定の影響をうけるかどうかであって、
最小化の動作を指定するわけではない点に注意が必要。

明示的に最小化させる場合は、
Gui, %GuiNum%:Minimize
や
F_minimizeGui( GuiNum )
を使う。

option の引数には、
表示する時の状態を指定する。

この部分 の指定と同じ指定方法になる。

指定しない場合、カラの文字ではなく、
"_" アンダーバー を入れる。
または、引数自体を省略する。

ウインドウを表示する。

すでに表示している時に使うと閉じる動作をする。

引数に、Ｇｕｉの番号と、ウインドウタイトルを指定する。

F_showToggleGui( GuiNum, option ) と違い、
TRR の既存のウインドウにだけでなく、
TRR上で自作した Ｇｕｉの番号でも動作する。
変わりに、ウインドウタイトルの指定も必要。

ただし、 TRR上で自作した Ｇｕｉにのみ使用でき、
他のソフトのウインドウなどには使用できない。

option の引数には、
表示する時の状態を指定する。

この部分 の指定と同じ指定方法になる。

指定しない場合、カラの文字ではなく、
"_" アンダーバー を入れる。
または、引数自体を省略する。

入力補完一覧 のＧｕｉの 簡易入力 のタブにある、
簡易入力と同じものを追加する。

似たようなものに、規定のコマンドの
&snippetAdd がある。

できることは変わらない。

引数は、下記を参考に。

文字を置換する。

か

を使う。

IfInString で指定の文字があるか確認してから使う。

元の文字列から、置換する文字が見つからなければ、
元の文字列を返す。

引数は、下記を参考に。

一行テキストと同じ処理を実行する。

引数に処理を指定する。
一行テキストに記入する場合と同じ。

分割テキストと同じ処理を実行する。

引数に処理を指定。
分割テキストに記入する場合と同じ。

dbqFlag の引数は、
ファイルパスのみなら""をつける のチェックボックスと同じもの。

True なら、チェックをしている時と同じ動作をする。

この関数を使って実行した場合でも、
結果表示は 分割テキスト の 出力先 の方には出力はしない。

引数は下記を参考に。

#[アイテム名]# や %[変数名]% の文字があった場合、
アイテムのリンク先や変数の値に変える。

このホームページでは、この処理をテキストアウトするとか、展開するとか言っている。

明示的に展開したい場合のために用意している。

ない場合は、元の文字列を返す。

の様に、変数を代入する処理などで
" " でくくられた文字列は、
# # や % % で囲まれた文字は展開されないので、
その変数の文字を展開したい場合のためにも用意している。

一時的な説明表示 に、
引数の文字を出力する。

前にあった文字を消し、上書きで出力する。

ツールチップに、引数の文字を出力する。

O_toolTipX
O_toolTipY
の位置に表示され、

O_toolTipSecond
の秒数で閉じる。

ツールチップに、引数の文字を出力する。

表示する位置と秒数を指定する。

O_toolTipX
O_toolTipY
O_toolTipSecond
の設定の影響を受けない。

ツールチップに、引数の文字を出力する。

2 の番号を使ったツールチップ。

F_toolTipOutputAssign(  ) の関数を使って表示させたツールチップの影響を受けない、
第二のツールチップ。

内部処理的に、閉じるために使用するサブルーチンなどが独立しているため
上の関数で作ったツールチップとの同時使用が可能。

表示する位置と秒数を指定する。

O_toolTipX
O_toolTipY
O_toolTipSecond
の設定の影響を受けない。

を実行する。

`r や `n などの文字は CRの改行 や LFの改行 に変換される。

ほぼ全ての ` を用いたエスケープ文字は変換される。

他にも、 %[変数名]% を、変数の値に変える効果も持っている。

TRR では、これらの `n などの文字は改行扱いされないため、スクリプトでこれらの文字を使用する場合は、

などを使用していかなければならない。

ちなみに、 0x がついていない 16進数の数字を指定しても、元の文字列が返ってくるだけである。

と

をただ実行するだけ。

引数で指定したウインドウタイトルのウインドウをアクティブにするのと、
アクティブになるのを少しだけ待つ。

をただ実行するだけ。

引数で指定したウインドウタイトルのウインドウが
アクティブになるのを少しだけ待つ。