スライダー
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
Sliderコントロールには、水平方向のスライダーが表示されます。ユーザーは、コントロールに表示されるハンドル (またはハンドル) をドラッグして、1つの値または値の範囲を選択できます。
SliderコントロールがValueの種類 (ユーザーが1つの値を選択できる) か、Rangeの種類 (ユーザーが値の範囲の開始値と終了値を選択できる) かを指定できます。Sliderコントロールは、一連の数値、または表示名と値を含む一連の項目のいずれかで機能します。
また、次の項目を指定することもできます。
-
選択可能な最小値と最大値。
-
最小値と最大値の間で選択可能な値 (「ステップ」) の数。
-
最初に選択した値または値の範囲。
-
数値の色とサイズ。
-
画像のサイズ。
コントロールに値のラベルを表示するかどうかを指定したり、これらのラベルを表示する頻度を指定したりできます。
Sliderコントロールへの項目のバインド
Sliderコントロールへの項目のバインド
数値を設定する代わりに、アイテムをSliderコントロールにバインドできます。 PageSettingsの下のフォルダに複数のアイテムを作成する場合は、DataSourceプロパティでそのフォルダをポイントします。これらの項目のどのフィールドをSliderコントロールがDisplayFieldNameプロパティの値に使用するかを指定します。コントロールがSelectedValueフィールドまたはSelectedValueStartフィールドとSelectedValueEndフィールドで使用できるのは、これらの値です。
これらの項目のどのフィールドをSliderコントロールが、ユーザーがハンドルをドラッグしたときに表示されるツールヒントに使用するかを指定します。
バインド
バインド
rebindメソッドを使用して、コントロールによって処理されるデータをプログラムで変更します。
次のように、スライダーコンポーネントのpublicメソッドrebind(items) を呼び出すことで、プログラムでアイテムをスライダーにバインドすることもできます。
項目は、{itemId, itemName, value}型のオブジェクトのJSON配列として渡します。 ValueFieldNameプロパティとDisplayFieldNameプロパティを設定できるのは、新しいデータがコントロールに渡されるときだけです。
rebind(null) は特殊なケースです。これにより、Sliderコントロールがバインド解除されます。
新しいデータを渡す (またはコントロールをバインド解除に設定する) ときは、Minimum、Maximum、およびStepプロパティの設定を考慮する必要があります。設定されていない場合、以前の値は有効なままです。
Itemsパラメーターを指定せずにrebind() を呼び出すと、コントロールが処理する現在のデータに対してプロパティの変更が有効になります。ValueFieldNameプロパティとDisplayFieldNameプロパティは例外であることに注意してください。
プロパティ
プロパティ
|
Name |
Description |
Default |
|---|---|---|
|
Appearance | ||
|
DisplayFieldName (ディスプレイフィールド名) |
選択した項目のヒントとしてコントロールが表示するために使用するデータ フィールドの名前を指定します。 |
_Display名 |
|
イズタイトルバー |
trueの場合、Sliderコントロールはスライダー バーの上にラベルを表示します。 | |
|
TitleValuesステップ |
Sliderがtrueの場合に コントロールに表示されるラベルの頻度を指定しますIsTitleBar。「10」を指定すると、Sliderコントロールには10個ごとにラベルが表示されます。 | |
|
種類 |
Sliderコントロールのタイプを指定します。単一 または 範囲 を選択できます。 |
単 |
|
値フィールド名 |
コントロールがSelectedValue、SelectedValueStart 、SelectedValueEndの値に使用する選択した項目のデータ フィールドの名前を指定します。 | |
|
Data | ||
|
アイテムデータソース |
Sliderコントロールが値を表示する項目を取得するデータ ソースを指定します。 | |
|
最大 |
Sliderコントロールでユーザーが選択できる最大値を指定します。MaximumとMinimumを合わせて、Sliderコントロールのスケールを指定します。 | |
|
最低限 |
Sliderコントロールでユーザーが選択できる最小値を指定します。MaximumとMinimumは、Sliderコントロールのスケールを指定します。 | |
|
選択値 |
タイプSingleのSliderコントロールの選択した値を指定します。 |
最大 |
|
SelectedValueEnd (選択値終了) |
値の範囲の上限として選択した値を指定します。これは、タイプRangeのSliderコントロール用です。 |
最大 |
|
SelectedValueStart (選択値開始) |
値の範囲の下限として選択した値を指定します。これは、タイプRangeのSliderコントロール用です。 |
最低限 |
|
歩 |
タイプRangeのSliderコントロールで最大値と最小値の間で選択できる不連続値の数を指定します。 | |
|
TitleValueAffix (タイトル値アフィックス) |
Sliderコントロールが表示するすべてのラベルの前に追加するテキスト文字列を指定します。 | |
|
タイトル値サフィックス |
Sliderコントロールが表示するすべてのラベルの後に追加するテキスト文字列を指定します。 | |