Hotstring - 構文と使用法

スクリプトの実行中に、ホットストリングを作成、変更、有効化、または無効化します。

パラメータ

Sub-functions

EndChars

ホットストリングレコグナイザーで終端文字として使用される文字のセットを取得または変更します。

現在、ホットストリングごとに異なる終了文字のセットを指定することはできません。

MouseReset

マウスクリックでホットストリング認識機能がリセットされるかどうかを制御するグローバル設定を取得または変更します（ここで説明）。

NewValueは、マウスクリックの検出とホットストリング認識器のリセットを有効にする場合は 1 (true)、無効にする場合は 0 (false)を指定します。戻り値は、この関数が呼び出される前に有効であった設定値です。

本機能による変更で正当化される場合は、マウスフックの取り付け、取り外しが可能です。

#Hotstring NoMouse も、この設定に影響し、NewValueにfalseを指定することと同じです。

Reset

ホットストリングレコグナイザーを即座にリセットします。

つまり、スクリプトは全く新しいホットストリングを待ち始め、以前に入力したものは考慮されなくなります。

エラー

パラメータが不正な場合、またはメモリ確保に失敗した場合は、例外を投げます。

Replacementが省略され、Stringが有効であるが既存のホットストリングと一致しない場合、TargetErrorがスローされます。これは、ホットストリングの存在をテストするために利用することができます。事例：

備考

スクリプトが中断されると、新しく追加/有効になったホットストリングも中断が解除されるまで中断されます（中断セクションで説明したように除外される場合を除きます）。

キーボードやマウスのフックは、本機能による変更で正当化される場合、取り付けまたは取り外しが可能です。

この機能は、自分以外のスクリプトのホットストリングを直接有効にしたり無効にしたりすることはできません。

Once a script has at least one hotstring, it becomes persistent, meaning that ExitApp rather than Exit should be used to terminate it.

バリアント（複製）ホットストリング

各定義が異なるHotIf基準、大文字小文字の区別（C vs. C0/C1）、または、単語の区別（?）を持つ場合、特定のホットストリングを複数回作成することができます。これらはホットストリング・バリアントと呼ばれています。事例：

ホットストリングの複数のバリアントが発火の対象となる場合、最も早く作成されたものだけが発火します。

関連

例

Hotstring Helperです。ホットストリングのヘビーユーザーであれば、以下のスクリプトが便利かもしれません。Andreas Boruttaが作成したv1スクリプトをベースにしています。Win+H（または任意の他のホットキー）を押すことで、現在選択されているテキストをホットストリングに変換することができます。例えば、ワープロで「by the way」を選択している場合、Win+Hを押すと、その省略形（例：btw）の入力を促し、新しいホットストリングをスクリプトに追加して有効にします。

#h::  ; Win+H hotkey
{
    ; 現在選択されているテキストを取得します。その代わりにクリップボードが使われます。
    ; EditGetSelectedTextは、より多くのエディターで動作するためです。
    ;（すなわちワープロ）。現在のクリップボードの内容を保存して
    ; 後日、復元されます。これはプレーンテキストしか扱えませんが、より良いようです。
    ; 何もしないよりは：
    ClipboardOld := A_Clipboard
    A_Clipboard := "" ; Must start off blank for detection to work.
    Send "^c"
    if !ClipWait(1)  ; ClipWait timed out.
    {
        A_Clipboard := ClipboardOld ; Restore previous contents of clipboard before returning.
        return
    }
    ; CRLFやLFを`nに置き換えて、"send-raw "ホットストリングで使用することができます：
    ; 他の文字も同様です。
    ; rawモードでは問題ありません：
    ClipContent := StrReplace(A_Clipboard, "``", "````")  ;  以下の他の置換と干渉しないように、この置換を最初に行います。
    ClipContent := StrReplace(ClipContent, "`r`n", "``n")
    ClipContent := StrReplace(ClipContent, "`n", "``n")
    ClipContent := StrReplace(ClipContent, "`t", "``t")
    ClipContent := StrReplace(ClipContent, "`;", "```;")
    A_Clipboard := ClipboardOld  ; クリップボードの以前の内容を復元します。
    ShowInputBox(":T:`::" ClipContent)
}

ShowInputBox(DefaultValue)
{
    ; 入力ボックスのキャレットを、より使いやすい位置に移動させます：
    SetTimer MoveCaret, 10
    ; 入力ボックスを表示し、デフォルトのホットストリングを提供します：
    IB := InputBox("
    (
    表示された挿入口に略号を入力してください。また、必要に応じて、置換テキストを編集することもできます。

    Example entry: :T:btw`::by the way
    )", "New Hotstring",, DefaultValue)
    if IB.Result = "Cancel"  ; ユーザがキャンセルを押した。
        return

    if RegExMatch(IB.Value, "(?P<Label>:.*?:(?P<Abbreviation>.*?))::(?P<Replacement>.*)", &Entered)
    {
        if !Entered.Abbreviation
            MsgText := "You didn't provide an abbreviation"
        else if !Entered.Replacement
            MsgText := "You didn't provide a replacement"
        else
        {
            Hotstring Entered.Label, Entered.Replacement  ; 今すぐHotstringを有効にします。
            FileAppend "`n" IB.Value, A_ScriptFullPath  ; 後で使うためにホットストリングを保存します。
        }
    }
    else
        MsgText := "The hotstring appears to be improperly formatted"

    if IsSet(MsgText)
    {
        Result := MsgBox(MsgText ". Would you like to try again?",, 4)
        if Result = "Yes"
            ShowInputBox(DefaultValue)
    }
    
    MoveCaret()
    {
        WinWait "New Hotstring"
        ; そうでない場合は、入力ボックスの挿入点をユーザーが略語を入力する場所に移動させます。
        Send "{Home}{Right 3}"
        SetTimer , 0
    }
}