> ## 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.

# IField

> ABBYY FlexiCaptureスクリプト用のIFieldオブジェクトリファレンス: field値、領域、シンボル、検証フラグ、テーブルの行とセルの読み書き。

<div id="what-it-does">
  ## 概要
</div>

ドキュメントのfieldです。fieldの型は、**Type** プロパティで確認できます。テーブルfieldでは、**Rows** および **Cell** オブジェクトのメソッドを使用できます。

<div id="methods">
  ## メソッド
</div>

<table width="100%">
  <thead>
    <tr>
      <th style={{ textAlign: "left" }}>
        <p>
          <strong>定義</strong>
        </p>
      </th>

      <th style={{ textAlign: "left" }}>
        <p>
          <strong>説明</strong>
        </p>
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        <p>
          AddRegion( page : <a href="/ja/flexi-capture/appendix/scripts/ipage">IPage</a>, rect : string ) : <a href="/ja/flexi-capture/appendix/scripts/ifieldregion">IFieldRegion</a>
        </p>
      </td>

      <td>
        <p>
          指定した座標の領域を field に追加します。<strong>rect</strong> は、\[left,top,right,bottom] 形式の矩形を表す文字列です。このメソッドを使用するには、IField オブジェクトに対する書き込み
          権限が必要です。
        </p>

        <details>
          <summary>コード例</summary>
          <p>field 1 の領域を field 2 にコピーするコード例:</p>

          <pre>
            <code>field2.AddRegion( field1.Regions\[0].Page, field1.Regions\[0].SurroundingRect.ToString() )</code>
          </pre>
        </details>

        <p>
          <strong>注: </strong> このメソッドはテーブルでは使用できません。領域を削除するには、<a href="/ja/flexi-capture/appendix/scripts/ifieldregion">IFieldRegion</a>.Delete() メソッドを使用します。
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>Cell( columnName : string, rowNum : int ) : IField</p>
      </td>

      <td>
        <p>列名と行番号を指定してテーブルのセルを取得します。テーブルでのみ使用できます。スクリプトルールでは使用できません。</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>CheckRules( )</p>
      </td>

      <td>
        <p>指定した field とその子要素のルールをチェックします。ルール内では使用できません。</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>Field( Path : string) : IField</p>
      </td>

      <td>
        <p>
          指定した要素を基準に子要素を検索します。<a href="/ja/flexi-capture/appendix/scripts/scripting-model#pathforming">相対パス</a>が使用されます。ルールでは、ルール設定で定義されている
          field 名の同義語のみ使用できます。
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>GetFieldExtractor( )</p>
      </td>

      <td>
        <p>
          <a href="/ja/flexi-capture/i-field-extractor">IFieldExtractor</a> オブジェクトを返します。
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>GetLangs() : IVARAIANTArray</p>
      </td>

      <td>
        <p>field で検出された言語の ID を返します。</p>

        <details>
          <summary>例</summary>

          <p>
            field にどの言語が含まれているかを確認する <a href="/ja/flexi-capture/templates/properties-custom-action">ユーザースクリプト</a> の例:
          </p>

          <pre>
            <code>var t = Context.Field("Field Name").GetLangs(); var p = ""; foreach (var s in t) \{ p += s.ToString()+","; } FCTools.ShowMessage( "Language " +  p);</code>
          </pre>
        </details>
      </td>
    </tr>

    <tr>
      <td>
        <p>HasField( parameter : string) : bool</p>
      </td>

      <td>
        <p>
          指定したパスの field が存在するかどうかを確認します。<a href="/ja/flexi-capture/appendix/scripts/scripting-model#pathforming">相対パス</a>が使用されます。ルールでは、ルール設定で定義されている
          field 名の同義語のみ使用できます。
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>Suggest( VARIANT newSuggest )</p>
      </td>

      <td>
        <p>field に候補を追加します。</p>

        <p>
          <strong>注: </strong> 値または文字列の形式で指定できます。追加された値は小数点以下 4 桁で書き込まれます。
        </p>

        <p>たとえば、メソッド field.Suggest( "12.90" ) は "12.90" の形式で候補を追加し、field.Suggest( 12.90 ) は 12.9000 として候補を追加します。</p>
      </td>
    </tr>
  </tbody>
</table>

<div id="properties">
  ## プロパティ
</div>

<table width="100%">
  <thead>
    <tr>
      <th style={{ textAlign: "left" }}>
        <p>
          <strong>名称</strong>
        </p>
      </th>

      <th style={{ textAlign: "left" }}>
        <p>
          <strong>型</strong>
        </p>
      </th>

      <th style={{ textAlign: "left" }}>
        <p>
          <strong>アクセス</strong>
        </p>
      </th>

      <th style={{ textAlign: "left" }}>
        <p>
          <strong>説明</strong>
        </p>
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        <p>Caption</p>
      </td>

      <td>
        <p>string</p>
      </td>

      <td>
        <p>読み取り専用</p>
      </td>

      <td>
        <p>
          フォームに表示されるfieldの名前です。このプロパティの値は、<a href="/ja/flexi-capture/appendix/scripts/ifield#propertyname">Name</a> プロパティと同じ場合があります。
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>子アイテム</p>
      </td>

      <td>
        <p>
          <a href="/ja/flexi-capture/appendix/scripts/ifields">IFields</a>
        </p>
      </td>

      <td>
        <p>読み取り専用</p>
      </td>

      <td>
        <p>fieldの子アイテム (テーブルの場合はセル) 。スクリプトルールでは使用できません。</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>FullName</p>
      </td>

      <td>
        <p>string</p>
      </td>

      <td>
        <p>読み取り専用</p>
      </td>

      <td>
        <p>
          ドキュメントにおける完全な field 名です。ドキュメント内の field の一意の識別子です。{" "}
          <a href="/ja/flexi-capture/appendix/scripts/scripting-model#pathforming">Field</a> メソッドを使用してドキュメントの field を検索する際に使用できます。スクリプトルールでは、返される値は{" "}
          <a href="/ja/flexi-capture/appendix/scripts/ifield#propertyname">Name</a> と一致し、一意ではありません。
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>HasRuleError</p>
      </td>

      <td>
        <p>bool</p>
      </td>

      <td>
        <p>読み取り/書き込み</p>
      </td>

      <td>
        <p>field にルールの警告またはエラーが関連付けられているかどうかを指定します。</p>

        <p>
          <strong>注:</strong> スクリプトルールでは、このプロパティはエラーメッセージに field を表示するかどうかを指定します。
        </p>

        <p>
          ルールには、<a href="/ja/flexi-capture/templates/rule-script">ルールのプロパティ</a>ルールのプロパティ ダイアログで指定された fields のコレクションが含まれます。ルール チェックが失敗すると、エラー
          メッセージ (<a href="/ja/flexi-capture/appendix/scripts/irulecontext">IRuleContext</a>
          <strong>.ErrorMessage</strong> で指定) と、コレクション内の fields へのリンクが文書エディターに表示されます。このプロパティを <strong>false</strong> に設定すると、その field は
          エラーに関連付けられたリンクの一覧から除外されます。
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>IsExportable</p>
      </td>

      <td>
        <p>bool</p>
      </td>

      <td>
        <p>読み取り専用</p>
      </td>

      <td>
        <p>field がエクスポート対象かどうかを指定します (Document Definition の設定に基づきます) 。</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>IsIndexed</p>
      </td>

      <td>
        <p>bool</p>
      </td>

      <td>
        <p>読み取り専用</p>
      </td>

      <td>
        <p>field をインデックス可能にするかどうかを指定します。可能な場合、field の値は Document Definition の document およびページの External fields から利用できます。</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>IsMatched</p>
      </td>

      <td>
        <p>bool</p>
      </td>

      <td>
        <p>読み取り専用</p>
      </td>

      <td>
        <p>field がマッチしているかどうかを示します。</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>IsSuspicious</p>
      </td>

      <td>
        <p>bool</p>
      </td>

      <td>
        <p>読み取り専用</p>
      </td>

      <td>
        <p>fieldの値が確実に認識されているかどうかを示します。</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>IsValid</p>
      </td>

      <td>
        <p>bool</p>
      </td>

      <td>
        <p>読み取り専用</p>
      </td>

      <td>
        <p>field に書式エラーがないかどうかを示します。</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>IsVerified</p>
      </td>

      <td>
        <p>bool</p>
      </td>

      <td>
        <p>読み取り/書き込み</p>
      </td>

      <td>
        <p>
          field が確認済みかどうかを指定します。 <br />
          <strong>注:</strong> このプロパティは <a href="/ja/flexi-capture/templates/field-group">field グループ</a>field グループ では機能しません。

          <br />

          このプロパティは、field に対する "書き込み" 権限がなくても、ルール内で <strong>true</strong> に設定できます。フラグを解除するには、"書き込み" 権限が必要です。
        </p>

        <p>
          フラグが <strong>true</strong> の場合、field はすでに確認済みであるかのように文書エディターで灰色で表示されます。フラグが <strong>false</strong> の場合、field は白色で表示され、確認が必要です。field が確認されると、フラグは <strong>true</strong> に設定されます。
        </p>

        <p>
          <strong>注:</strong> このフラグを <strong>false</strong> に設定しても、field が Data Verification ステージに送られることはありません。そのためには、IField または <a href="/ja/flexi-capture/appendix/scripts/icharacterparams">ICharacterParams</a> インターフェイスの <strong>NeedVerification</strong>{" "}
          プロパティを使用します。
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>IsVisible</p>
      </td>

      <td>
        <p>bool</p>
      </td>

      <td>
        <p>読み取り/書き込み</p>
      </td>

      <td>
        <p>field をドキュメントのレイアウトに反映するかどうかを指定します (Document Definition の設定に従う) 。</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>Items</p>
      </td>

      <td>
        <p>
          <a href="/ja/flexi-capture/appendix/scripts/ifields">IFields</a>
        </p>
      </td>

      <td>
        <p>読み取り専用</p>
      </td>

      <td>
        <p>field のインスタンス (テーブル field の行) 。</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <a id="propertyname" />名前
        </p>
      </td>

      <td>
        <p>string</p>
      </td>

      <td>
        <p>読み取り専用</p>
      </td>

      <td>
        <p>Document Definition内のfield名です。</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>NeedVerification</p>
      </td>

      <td>
        <p>bool</p>
      </td>

      <td>
        <p>読み取り/書き込み</p>
      </td>

      <td>
        <p>フィールド自体 (文字ではなく) に検証が必要かどうかを指定します。</p>

        <p>
          フラグが <strong>true</strong> の場合、文書エディターではそのフィールドが赤い背景で表示されます。これは、そのフィールドに検証が必要であることを意味します。<a href="/ja/flexi-capture/templates/properties-verification">field properties</a>field properties で
          Send to field verification オプションが選択されている場合、そのフィールドは Data Verification ステージに送られます。フィールドの検証が完了すると、このフラグは <strong>false</strong> に設定されます。
        </p>

        <p>
          フィールド全体ではなく特定の文字に検証が必要かどうかを指定するには、{" "}
          <a href="/ja/flexi-capture/appendix/scripts/icharacterparams">ICharacterParams</a> インターフェイスの <strong>NeedVerification</strong> プロパティを使用します。
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>ReadOnly</p>
      </td>

      <td>
        <p>bool</p>
      </td>

      <td>
        <p>読み取り専用</p>
      </td>

      <td>
        <p>
          field が「読み取り専用」権限 (Document Definition の設定に従う) を持つかどうかを指定します。ルールで使用する場合は、そのルールがその field に対して「書き込み」権限を持つことを示します。
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>ReadOnlyInForm</p>
      </td>

      <td>
        <p>bool</p>
      </td>

      <td>
        <p>読み取り/書き込み</p>
      </td>

      <td>
        <p>フォーム上のフィールドが"読み取り専用"権限を持つかどうかを指定します (Document Definition Settings の設定によります) 。</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          Regions<a href="#condition">\*\*</a>
        </p>
      </td>

      <td>
        <p>
          <a href="/ja/flexi-capture/appendix/scripts/ifieldregions">IFieldRegions</a>
        </p>
      </td>

      <td>
        <p>読み取り専用</p>
      </td>

      <td>
        <p>field region の配列です。オーバーフローした field は複数の領域を持つ場合があります。</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>行</p>
      </td>

      <td>
        <p>
          <a href="/ja/flexi-capture/appendix/scripts/ifields">IFields</a>
        </p>
      </td>

      <td>
        <p>読み取り専用</p>
      </td>

      <td>
        <p>テーブルの行の集合です。テーブル以外のfieldでは使用できません。</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>シンボル</p>
      </td>

      <td>
        <p>
          <a href="/ja/flexi-capture/appendix/scripts/icharactersparams">ICharactersParams</a>
        </p>
      </td>

      <td>
        <p>読み取り専用</p>
      </td>

      <td>
        <p>シンボルのプロパティに関する詳細情報。</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>Text</p>
      </td>

      <td>
        <p>string</p>
      </td>

      <td>
        <p>読み取り/書き込み</p>
      </td>

      <td>
        <p>field値をテキストで表したものです。</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>型</p>
      </td>

      <td>
        <p>
          <a href="/ja/flexi-capture/appendix/scripts/texportfieldtype">TExportFieldType</a>
        </p>
      </td>

      <td>
        <p>読み取り専用</p>
      </td>

      <td>
        <p>field の種類。</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>Value</p>
      </td>

      <td>
        <p>VARIANT</p>
      </td>

      <td>
        <p>読み取り/書き込み</p>
      </td>

      <td>
        <p>
          VARIANT 形式の field の値です。field の設定で整数を含むよう指定されており、その絶対値が 2147483647 以下の場合、このプロパティは Int32 型のオブジェクトを返します。field の絶対値が 2147483647 を超える場合、このプロパティは double 型のオブジェクトを返します。
        </p>
      </td>
    </tr>
  </tbody>
</table>

<a id="condition" />\*\* - License のプロパティで Advanced XML Export オプションの選択が解除されている場合、このプロパティは使用できません。
