Project translation

autohotkey-docs-translation · Mar 29, 2024 · 1daba03 · 1daba03
1 parent 280c6d3
commit 1daba03
Show file tree

Hide file tree

Showing 39 changed files with 157 additions and 113 deletions.
diff --git a/target/docs/ChangeLog.htm b/target/docs/ChangeLog.htm
@@ -14,6 +14,25 @@ <h1>変更点・新機能</h1>
 <p><a href="v2-changes.htm">v1.1からv2.0への変更点</a>は、v1.1とv2.0の相違点をカバーしています。</p>
 <p>変更点の技術的な詳細については、<a href="https://github.com/AutoHotkey/AutoHotkey/tree/alpha">GitHub</a>を参照してください。</p>
 
+<h2 id="v2.0.12">2.0.12 - March 23, 2024</h2>
+<p>Fixed Gui GetPos/GetClientPos when Gui has an owner window or +DPIScale.</p>
+<p>Fixed Until preventing subfolder recursion in file loops.</p>
+<p>Fixed DllCall to throw when arg type is UStr.</p>
+<p>Fixed a memory leak occurring for each regex callout.</p>
+<p>Fixed Send erroneously releasing a modifier due to a race condition. For example, <code>~LAlt::Send "{Blind}x"</code> intermittently released LAlt if some other keyboard hook was installed more recently than the script's own hook.</p>
+<p>Fixed icon loader to prefer higher bit-depth when multiple bitmaps of the same size are present.</p>
+<p>Fixed SendInput failing to release LCtrl if it had already released RAlt and the layout does not have AltGr.</p>
+<p>Fixed key-up hotkeys not firing if the key repeats after modifiers change. For example, <code>F1::Send "{Ctrl down}"</code> should allow <code>F1 up::</code> to execute when the key is released even though Ctrl is down, but was not allowing it after key-repeat occurs.</p>
+<p>Fixed an error message to refer to #HotIf rather than #IfWin. [PR #327]</p>
+<p>Fixed OwnProps erroneously skipping properties with optional parameters.</p>
+<p>Fixed inconsistent behaviour of cloned dynamic properties.</p>
+<ul>
+  <li>OwnProps not skipping cloned properties which require parameters.</li>
+  <li>Parameters not being passed recursively to parameterless properties (i.e. to allow <code>a.b[c]</code> to evaluate as <code>(a.b)[c]</code>).</li>
+</ul>
+<p>Fixed SysGetIPAddresses causing a Critical Error when the network subsystem is non-functional; e.g. in Windows safe mode.</p>
+<p>Changed ControlGetFocus to return 0 when focus can't be determined, such as when a console window is active.</p>
+
 <h2 id="v2.0.11">2.0.2 - 2023年12月23日</h2>
 <p>Windows 10で最初に表示されるメニューがキーボード入力を受け付けない場合の回避策を追加しました。</p>
 <p>Fixed the <a href="lib/Gui.htm#Add">Add method (Gui)</a> to support the ShortDate option for DateTime controls.</p>

diff --git a/target/docs/Objects.htm b/target/docs/Objects.htm
@@ -304,15 +304,20 @@ <h4 id="Custom_Classes_staticvar">静的クラス変数</h4>
 <p><code>static x.y := z</code>のような宣言も、<code>x</code>が以前にこのクラスで定義されていればサポートされる。例えば、<code>static x := {}, x.y := 42</code>は<code>x</code>を宣言し、<code><i>ClassName</i>.x.y</code>も初期化します。<a href="lib/Class.htm#Prototype">Prototype</a>は各クラスで暗黙的に定義されているため、<code>static Prototype.sharedValue := 1</code>を使用すると、クラスのすべてのインスタンスに動的に継承される値を設定できます（インスタンス自体のプロパティによってシャドウされるまで）。</p>
 
 <h4 id="Custom_Classes_class">入れ子のクラス</h4>
-<p>入れ子になったクラス定義では、クラス・オブジェクトを別のグローバル変数ではなく、外側のクラスの静的/クラス変数に関連付けることができます。上記の例では、<code>NestedClassクラス</code>が <a href="lib/Class.htm">Class</a>オブジェクトを構築し、<code>ClassName.NestedClass</code>に格納しています。サブクラスは、<em>NestedClass</em>を継承するか、独自のネスト・クラスでオーバーライドすることができます（この場合、<code>(<i>WhichClass</i>.NestedClass)()</code>を使用して、適切なクラスをインスタンス化できます）。</p>
+<p>入れ子になったクラス定義では、クラス・オブジェクトを別のグローバル変数ではなく、外側のクラスの静的/クラス変数に関連付けることができます。上記の例では、<code>NestedClassクラス</code>が <a href="lib/Class.htm">Class</a>オブジェクトを構築し、<code>ClassName.NestedClass</code>に格納しています。Subclasses could inherit <em>NestedClass</em> or override it with their own nested class (in which case <code><i>WhichClass</i>.NestedClass()</code> could be used to instantiate whichever class is appropriate).</p>
 <pre>
 class NestedClass
 {
     ...
 }
 </pre>
 <p>クラスを入れ子にすることは、外側のクラスとの特定の関係を意味するものではない。ネストされたクラスは自動的にインスタンス化されないし、ネストされたクラスのインスタンスは、スクリプトが明示的にその接続を行わない限り、アウター・クラスのインスタンスとの接続を持たない。</p>
-<p>しかし、<a href="lib/Object.htm">オブジェクト</a>に対するメソッドの動作方法のため、<code><i>WhichClass</i>.NestedClass()</code>は、<em>WhichClass</em>を最初のパラメータとして暗黙的に渡しており、<code><i>WhichClass</i>.NestedClass.Call(<i>WhichClass</i>)</code>と同等です。<code>static Call()</code>がオーバーライドされない限り、このパラメータは自動的に<a href="#Custom_NewDelete">__New</a>に渡される。</p>
+<p>Each nested class definition produces a dynamic property with <em>get</em> and <em>call</em> accessor functions instead of a simple value property. This is to support the following behaviour (where class X contains the nested class Y):</p>
+<ul>
+<li><code>X.Y()</code> does not pass X to <code>X.Y.Call</code> and ultimately <code>__New</code>, which would otherwise happen because this is the normal behaviour for function objects called as methods (which is how the nested class is being used here).</li>
+<li><code>X.Y := 1</code> is an error by default (the property is read-only).</li>
+<li>初めて参照または呼び出すと、クラスが初期化されます。</li>
+</ul>
 
 <h4 id="Custom_Classes_method">メソッド</h4>
 <p>メソッド定義は関数定義と同じように見える。各メソッド定義は、<code>this</code>という名前の隠された第1パラメータを持つ<a href="lib/Func.htm">Func</a>を作成し、メソッドの呼び出しやその関数オブジェクトの取得に使用されるプロパティを定義する。</p>

diff --git a/target/docs/Scripts.htm b/target/docs/Scripts.htm
@@ -126,6 +126,7 @@ <h2 id="continuation">長い線を短い線に分割する</h2>
 <p>継続セクションの上の行が<a href="Concepts.htm#names">名前</a>文字で終わっており、そのセクションが引用符で囲まれた文字列で始まっていない場合、名前と継続セクションの内容を区切るために、1つのスペースが自動的に挿入される。</p>
 <p id="continuation_quotes">上記の例のように、引用符で囲まれた文字列の中で継続セクションが始まる場合、引用符は自動的にエスケープされる（つまり、リテラル文字として解釈される）。それ以外の場合、引用符は通常と同じように機能する。つまり、継続セクションは引用符で囲まれた文字列を含むことができる。</p>
 <p id="continuation_defaults">デフォルトでは、継続セクション内の最初の行のインデントに基づいて、先頭のスペースやタブが省略される。最初の行にスペースとタブが混在している場合、最初の種類の文字だけがインデントとして扱われます。もし、ある行が最初の行より小さくインデントされたり、間違った文字でインデントされた場合、その行のすべての先頭の空白はそのまま残されます。 </p>
+<p>By default, trailing spaces or tabs are omitted.</p>
 <p>継続セクションのデフォルトの動作は、セクションの開始括弧の右側に以下のオプションを1つ以上含めることで上書きすることができる。複数のオプションがある場合は、それぞれをスペースで区切る。事例：<code class="no-highlight">( LTrim Join|</code>.</p>
 <p id="Join"><strong>Join</strong><em>String</em>: Specifies how lines should be connected together. If this option is not used, each line except the last will be followed by a linefeed character (`n). If <em>String</em> is omitted, lines are connected directly to each other without any characters in between. Otherwise, specify for <em>String</em> a string of up to 15 characters. For example, <code>Join`s</code> would insert a space after each line except the last. Another example is <code>Join`r`n</code>, which inserts CR+LF between lines. Similarly, <code>Join|</code> inserts a pipe between lines. To have the final line in the section also ended by <em>String</em>, include a blank line immediately above the section's closing parenthesis.</p>
 <p id="LTrim"><strong>LTrim：</strong>各行の先頭のスペースとタブをすべて削除する。<a href="#continuation_defaults">デフォルトの "スマート"な振る舞い</a>のため、これは通常不要である。</p>

diff --git a/target/docs/Variables.htm b/target/docs/Variables.htm
@@ -312,7 +312,7 @@ <h3 id="operators">式演算子（優先順位の降順）</h3>
     <td><p><strong>コンマ（複数ステートメント）</strong>。カンマは、1行に複数の部分式を記述するために使用することができる。これは、複数の割り当てや関数コールをグループ化するためによく使われる。事例：<code>x:=1<strong>,</strong> y+=2<strong>,</strong> ++index, MyFunc()</code>. このようなステートメントは、左から右の順に実行される。</p>
       <p class="note"><strong>注：</strong>カンマ（またはその他の演算子）で始まる行は、自動的にその上の行に<a href="Scripts.htm#continuation">追加</a>される。こちらもご覧ください：<a href="#CommaPerf">コンマのパフォーマンス</a>。</p>
       <p>カンマは、関数呼び出しや制御フロー文のパラメータを区切るためにも使われる。複数ステートメント式をパラメータ・リストに含めるには、括弧で囲む。例えば、<code>MyFn((x, y))</code>はxとyの両方を評価するが、MyFnの最初の唯一のパラメーターとしてyを渡す。</p>
-      <p id="CommaPerf">The comma operator usually performs better than writing separate expressions, especially when assigning one variable to another (e.g. <code>x:=y, a:=b</code>). たとえば、5つまたは10個の単純な式を1つの式にまとめると、35%速くなることがあります。</p>
+      <p id="CommaPerf">In contrast to AutoHotkey v1, the comma operator usually performs worse than writing separate expressions. Performance continues to decrease as more and more expressions are combined into a single expression; for example, it can be 35&nbsp;% slower to combine five or ten simple expressions into a single expression. The exception to this may be when combining function calls.</p>
     </td>
   </tr>
 </table>

diff --git a/target/docs/index.htm b/target/docs/index.htm
@@ -12,7 +12,7 @@
 <body>
 
 <a id="ahklogo" href="https://www.autohotkey.com" target="_blank"><img src="static/ahk_logo.svg" onerror="this.src='static/ahk_logo.png'; this.onerror=null;" alt="AutoHotkey"></a>
-<h1>Version <a href="ChangeLog.htm"><!--ver-->2.0.11<!--/ver--></a></h1>
+<h1>Version <a href="ChangeLog.htm"><!--ver-->2.0.12<!--/ver--></a></h1>
 <p><a href="https://www.autohotkey.com">https://www.autohotkey.com</a></p>
 <p>© 2014 Steve Gray, Chris Mallett, portions ©<a href="https://www.autoitscript.com/">AutoIt Team</a>and various others</p>
 <p style="font-size:85%">ソフトウェアライセンス<a href="license.htm">GNU一般公衆ライセンス</a></p>

diff --git a/target/docs/lib/ComCall.htm b/target/docs/lib/ComCall.htm
@@ -24,7 +24,7 @@ <h2 id="Parameters">パラメータ</h2>
       <p>型：<a href="../Concepts.htm#numbers">整数</a></p>
       <p>仮想関数テーブル内のメソッドのゼロベースインデックス。</p>
       <p><em>インデックス</em>は、元のインターフェース定義内でのメソッドの位置に対応します。マイクロソフトのドキュメントでは、通常、メソッドをアルファベット順に記載していますが、これは関係ありません。正しいインデックスを決定するために、元のインターフェイスの定義を見つけてください。これは、ヘッダーファイルやタイプライブラリの中にあるかもしれません。</p>
-      <p>親インターフェースから継承されるメソッドを考慮することが重要です。すべてのCOMインタフェースは最終的に<a href="https://learn.microsoft.com/windows/win32/api/unknwn/nn-unknwn-iunknown">IUnknown</a>から派生するため、最初の3つのメソッドは常にQueryInterface（0）、AddRef（1）、Release（2）です。例えば、<em>IShellItem2</em>は <em>IShellItem</em>の拡張で、インデックス3から始まり、5つのメソッドを含むので、<em>IShellItem2</em>の最初のメソッド（GetPropertyStore）はインデックス8にある。</p>
+      <p>親インターフェースから継承されるメソッドを考慮することが重要です。すべてのCOMインタフェースは最終的に<a href="https://learn.microsoft.com/windows/win32/api/unknwn/nn-unknwn-iunknown">IUnknown</a>から派生するため、最初の3つのメソッドは常にQueryInterface（0）、AddRef（1）、Release（2）です。例えば、<em>IShellItem2</em>は <em>IShellItem</em>の拡張で、インデックス3から始まり、5つのメソッドを含むので、<em>IShellItem2</em>の最初のメソッド（GetPropertyStore）はインデックス8にあります。</p>
       <p class="note"><strong>ヒント：</strong>Microsoftによって定義されたCOMインターフェースについては、インターネットまたはWindows SDKで<em>「</em><b>IInterfaceNameVtbl</b>」-例えば「IUnknownVtbl」を検索してみてください。Microsoft独自のインターフェース定義には、インターフェースの仮想関数テーブルのこのプレーンC定義が付属しており、すべてのメソッドを正しい順序で明示的にリストアップしています。</p>
       <p>無効なインデックスを渡すと、プログラムの終了を含む未定義の動作が発生する可能性があります（ただし、これに限定されるものではありません）。</p>
   </dd>
@@ -132,7 +132,7 @@ <h2 id="Examples">例</h2>
         <em>; TaskbarList のすべてのインスタンスのベースオブジェクトを取得します。</em>
         proto := this.Prototype
 
-<em>; バウンド関数を使用して、パラメータを事前に定義することができます。
+<em>; Bound関数でパラメータを事前に定義することができます。
         ; ラッパー関数を必要とせず、より使いやすいメソッドを提供します。
 ; HrInit自身はパラメータを持たないので、インデックスだけをバインドします。
         ; であり、呼び出し側は暗黙のうちに 'this' を提供することになる。</em>
@@ -155,7 +155,7 @@ <h2 id="Examples">例</h2>
     __new() {
         this.comobj := ComObject(TaskbarList.CLSID, TaskbarList.IID)
         this.ptr := this.comobj.ptr
-        <em>; ITaskbarList を介したリクエスト初期化。</em>
+        <em>; ITaskbarList を介してリクエストを初期化します。</em>
         this.HrInit()
     }
 }

diff --git a/target/docs/lib/ControlGetItems.htm b/target/docs/lib/ControlGetItems.htm
@@ -34,7 +34,7 @@ <h2 id="Parameters">パラメータ</h2>
 </dl>
 
 <h2 id="Return_Value">戻り値</h2>
-<p>型：<a href="Array.htm">Array</a></p>
+<p>型：<a href="Array.htm">配列</a></p>
 <p>この関数は、各項目または行のテキストを含む配列を返す。</p>
 
 <h2 id="Error_Handling">エラー処理</h2>

diff --git a/target/docs/lib/DirCopy.htm b/target/docs/lib/DirCopy.htm
@@ -2,7 +2,7 @@
 <html lang="ja">
 <head>
 <title>DirCopy - 構文と使用法｜AutoHotkey v2</title>
-<meta name="description" content="DirCopy関数は、フォルダをそのすべてのサブフォルダとファイルとともにコピーします（xcopyに似ています）。" />
+<meta name="description" content="The DirCopy function copies a folder along with all its sub-folders and files (similar to xcopy) or the entire contents of an archive file such as ZIP." />
 <meta name="ahk:equiv-v1" content="lib/FileCopyDir.htm" />
 <meta http-equiv="content-type" content="text/html; charset=UTF-8">
 <meta http-equiv="X-UA-Compatible" content="IE=edge">
@@ -13,7 +13,7 @@
 
 <h1>DirCopy</h1>
 
-<p>フォルダをそのすべてのサブフォルダとファイルとともにコピーします（xcopyに似ています）。</p>
+<p>Copies a folder along with all its sub-folders and files (similar to xcopy) or the entire contents of an archive file such as ZIP.</p>
 
 <pre class="Syntax"><span class="func">DirCopy</span> Source, Dest <span class="optional">, Overwrite</span></pre>
 <h2 id="Parameters">パラメータ</h2>
@@ -23,7 +23,7 @@ <h2 id="Parameters">パラメータ</h2>
   <dd>
       <p>型：<a href="../Concepts.htm#strings">文字列</a></p>
       <p>ソースディレクトリの名前（末尾にバックスラッシュを付けない）。絶対パスが指定されていない場合は、<a href="../Variables.htm#WorkingDir">A_WorkingDir</a>にあると仮定されます。事例：C:\My Folder</p>
-      <p>OSがサポートしている場合、<em>Source</em>にはZIPファイルのパスも指定でき、この場合、その内容は宛先ディレクトリにコピーされます。Windows 7、Windows 11での動作が確認されています。</p>
+      <p>If supported by the OS, <em>Source</em> can also be the path of an archive file, in which case its contents will be copied to the destination directory. ZIP files are always supported. TAR files require at least Windows 10 (1803) build 17063. RAR, 7z, gz and others require at least Windows 11 23H2 (which uses <a href="https://github.com/libarchive/libarchive">libarchive</a>, where all supported formats are listed).</p>
   </dd>
 
   <dt>Dest</dt>

diff --git a/target/docs/lib/FileDelete.htm b/target/docs/lib/FileDelete.htm
@@ -2,7 +2,7 @@
 <html lang="ja">
 <head>
 <title>FileDelete - 構文と使用法｜AutoHotkey v2</title>
-<meta name="description" content="FileDelete 関数は、1つまたは複数のファイルを削除します。" />
+<meta name="description" content="The FileDelete function deletes one or more files permanently." />
 <meta http-equiv="content-type" content="text/html; charset=UTF-8">
 <meta http-equiv="X-UA-Compatible" content="IE=edge">
 <link href="../static/theme.css" rel="stylesheet" type="text/css" />
@@ -12,7 +12,7 @@
 
 <h1>FileDelete</h1>
 
-<p>1つまたは複数のファイルを削除します。</p>
+<p>Deletes one or more files permanently.</p>
 
 <pre class="Syntax"><span class="func">FileDelete</span> FilePattern</pre>
 <h2 id="Parameters">パラメータ</h2>
@@ -32,6 +32,7 @@ <h2 id="Error_Handling">エラー処理</h2>
 <p>ファイルが見つかった場合、<a href="../Variables.htm#LastError">A_LastError</a>には0（ゼロ）または最後の失敗の直後のオペレーティングシステムのGetLastError()関数の結果が設定されます。それ以外の場合、A_LastError は、ファイルが見つからなかった理由を示す可能性のあるエラーコードを含みます。</p>
 
 <h2 id="Remarks">備考</h2>
+<p>To send a file to the recycle bin, use the <a href="FileRecycle.htm">FileRecycle</a> function.</p>
 <p>読み取り専用ファイルを削除するには、まず読み取り専用属性を削除します。事例：<code><a href="FileSetAttrib.htm">FileSetAttrib</a> "-R", "C:\My File.txt"</code>.</p>
 <h2 id="Related">関連</h2>
 <p><a href="FileRecycle.htm">FileRecycle</a>, <a href="DirDelete.htm">DirDelete</a>, <a href="FileCopy.htm">FileCopy</a>, <a href="FileMove.htm">FileMove</a></p>