> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Engine オブジェクトの CreateEmptyUserPattern メソッド

> ABBYY FineReader Engine API の Engine オブジェクトの CreateEmptyUserPattern メソッド — このメソッドは、指定した場所に空のユーザーパターンファイル (*.ptn) を作成します。

このメソッドは、指定した場所に空のユーザーパターンファイル (\*.ptn) を作成します。

<div id="syntax">
  ## 構文
</div>

<div id="c">
  ### C++
</div>

```cpp theme={null}
HRESULT CreateEmptyUserPattern( BSTR FileName );
```

### C\#

```csharp theme={null}
void CreateEmptyUserPattern( string FileName );
```

<div id="visual-basic-net">
  ### Visual Basic .NET
</div>

```vb theme={null}
Sub CreateEmptyUserPattern(FileName As String)
```

<div id="parameters">
  ## パラメーター
</div>

FileName

\[in] この変数には、新しく作成されたユーザーパターン ファイルのフルパスが格納されます。

* Windows: C:\pattern.ptn
* Linux: /home/user/Documents/Patterns/pattern.ptn
* macOS: /Users/user/Documents/pattern.ptn

<div id="return-values">
  ## 戻り値
</div>

このメソッドに固有の戻り値はありません。[ABBYY FineReader Engine 関数の標準の戻り値](/ja/fine-reader/engine/api-reference/return-codes)が返されます。

<div id="remarks">
  ## 備考
</div>

* ユーザーパターンは、「文字の画像 — 文字そのもの」の組を複数定義したファイルです。ユーザーパターンは、認識時に非標準のフォントの文字を識別するために使用できます。認識時にユーザーパターンを使用するには、[IRecognizerParams::UserPatternsFile](/ja/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/recognizerparams#userpatternsfile) プロパティでそのパスを指定します。
  * Linux では、ユーザーパターンは [Engine](/ja/fine-reader/engine/api-reference/engine-object-iengine-interface) オブジェクトの [TrainUserPattern](/ja/fine-reader/engine/api-reference/engine-object-iengine-interface/supplementary-methods/trainuserpattern-method) メソッドを使用して学習できます。
  * Windows では、ユーザーパターンは [IEngine::EditUserPattern](/ja/fine-reader/engine/api-reference/engine-object-iengine-interface/supplementary-methods/edituserpattern-method) メソッドで編集するか、認識時に学習できます。[トレーニングを用いた認識](/ja/fine-reader/engine/guided-tour/advanced-techniques/using-gui-elements/recognizing-with-training) を参照してください。
* 本メソッドは、ライセンスが [User Patterns Training](/ja/fine-reader/engine/licensing/modules#user_patterns_training) モジュールをサポートしている場合にのみ有効です。
* パターンの学習は、[CJK languages](/ja/fine-reader/engine/guided-tour/advanced-techniques/recognizing-cjk-languages#cjk) ではサポートされていません。

<div id="see-also">
  ## 関連項目
</div>

[トレーニングを用いた認識](/ja/fine-reader/engine/guided-tour/advanced-techniques/using-gui-elements/recognizing-with-training)

[Engine](/ja/fine-reader/engine/api-reference/engine-object-iengine-interface)

[EditUserPattern](/ja/fine-reader/engine/api-reference/engine-object-iengine-interface/supplementary-methods/edituserpattern-method)