整数

整数を入力または表示できます。

データ・バインディング

「一般」プロパティー・タブで整数ビューのデータ・バインディングの設定や変更を行います。ビューは整数変数にバインドされます。

構成プロパティー

「構成」で、ビューの外観および動作プロパティーを設定または変更します。「イベント」で、数式構成プロパティーを設定します。

画面サイズ: プロパティー名の横に画面サイズ・アイコンがある構成プロパティーは、画面サイズごとに異なる値を持つことができます。値を設定しない場合、画面サイズはそのデフォルト値として次に大きい画面サイズの値を継承します。

テーマ定義: テーマ定義は、ビューの色およびスタイルを指定し、その外観を決定します。ビューのルック・アンド・フィールをテーマ・エディターでプレビューできます。テーマを参照してください。

以下の表に、整数ビューの外観構成プロパティーをリストします。

表 1. 整数の外観構成プロパティー
外観構成プロパティー	説明	データ・タイプ
幅	ビューの幅です。幅の単位は px (ピクセル)、% (パーセント)、または em で指定できます。例えば、50px、20%、または 0.4em のようにします。単位タイプが指定されていない場合は、px と見なされます。	`String`
サイズ・スタイル	ビュー内のテキストのサイズ。	`String`
ラベルの配置	このビューのラベルの配置。ラベルを左側に配置すると、指定したビューの幅が変更されます。	`String`
ラベルの幅	ラベルの幅です。幅の単位は px (ピクセル)、% (パーセント)、または em で指定できます。例えば、50px、20%、または 0.4em のようにします。単位タイプが指定されていない場合は、px と見なされます。	`String`

以下の表に、整数ビューの動作構成プロパティーをリストします。

表 2. 整数の動作構成プロパティー
動作構成プロパティー	説明	データ・タイプ
タブ・インデックス	タブ・シーケンスのインデックス。タブのインデックスは 1 から始まり、スパースに設定することができます。例えば、1、5、10 などと指定できます。タブ・インデックス・プロパティーは、タブ・キーを押して UI エリア間を移動する場合に、タブ・シーケンスをコントロールします。	`Integer`
プレースホルダーのテキスト	値が入力されなかった場合に表示するプレースホルダー・テキスト。	`String`
数値のフォーマット	3 桁ごとの分離文字を現在のユーザーのロケールに基づくか、カスタム構成オプションとして指定するかを決定します。使用可能なオプションは、「自動」および「カスタム」です。	`String`
3 桁ごとの分離文字の非表示	3 桁ごとの分離文字を非表示にします。デフォルトでは、このオプションは選択されていません。	`Boolean`
桁区切り記号	3 桁ごとに桁を区切ります。 3 桁ごとの分離文字として、コンマが最も一般的に使用されます。ユーザーのロケールに基づいて、他の記号 (ピリオドなど) またはカスタム文字を 3 桁ごとの分離文字として使用できます。	`String`
プレフィックス	数値の入力値の前につく記号。	`String`
接尾部	数値の入力値の後に続く記号。	`String`

例

UI ページに表示する整数のフォーマット設定を指定するには、ページのレイアウトに整数ビューを追加し、次にその構成プロパティーを以下のように設定します。

「外観」の下で、「サイズ・スタイル」を Defaultに設定し、「ラベルの配置」を Topに設定します。
「動作」の下で、「1000 区切り文字」を , (コンマ) に設定し、「接頭部」を $に設定します。
変更内容を保存します。

その結果、入力値の 1500 は $1,500 のように表示されます。

イベント

「イベント」プロパティーで数式構成プロパティーおよびビューのイベント・ハンドラーの設定や変更を行います。イベントをプログラムでトリガーするかユーザーがビューと対話したときにトリガーするように設定できます。イベントの定義方法およびコーディング方法については、ユーザー定義イベントを参照してください。

以下の表に、整数ビューの数式構成プロパティーを示します。

表 3. 整数の数式構成プロパティー
数式構成プロパティー	説明	データ・タイプ
値の数式	ビューでの値の表示方法を指定する数式。静的 `String` 値、数式、または集約関数を使用できます。数式について詳しくは、数式を参照してください。	`String`

整数ビューには、以下のタイプのイベント・ハンドラーがあります。

On load: ページのロード時にアクティブ化されます。例：
```
me.setValue(0.00);
```
On change: 値の変更時にアクティブ化されます。例：
```
${Decimal1}.setValue(oldValue); ${Decimal2}.setValue(newValue);
```
On focus: フォーカスが整数フィールドに移動したときにアクティブ化されます。例：
```
${Tooltip1}.setTooltipVisible(true)
```
On blur: 整数フィールドがフォーカスを失ったときにアクティブ化されます。例：
```
${Tooltip1}.setTooltipVisible(false);
```
On format: ユーザーが入力値にカスタム書式設定を適用したときにアクティブ化されます。フォーマット設定は、ステートメントの return 値に基づきます。例：
```
var neg = me.getValue() < 0; if (neg){return "(" + formattedValue + ")"}
```

特定のイベントによっては、JavaScript ロジックを使用してビューの効果を変更できます。ビューを使用したイベントの使用について詳しくは、トピック「ユーザー定義イベント」を参照してください。

方法

整数に使用できるメソッドの詳細情報については、整数 JavaScript API を参照してください。

その他のリソース

Coach またはページの作成方法については、 Coach の作成を参照してください。
標準プロパティー (「一般」、「構成」、「位置決め」、「可視性」、および「HTML 属性」) について詳しくは、「プロパティーの表示」を参照してください。