[]
ゲージの全体的な形状と外観を表すために使用されるRange を取得または設定します。
ゲージ値をテキストとして表示するために使用される書式文字列を取得または設定します。
ゲージ値の表示に使用されるカスタマイズされた文字列を返す コールバックを取得または設定します。
このプロパティは、ゲージに表示される文字列をカスタマイズしたいが、 format プロパティでは十分でない場合に使用してください。
指定する場合、コールバック関数は、ゲージ、部分名、値、および 書式設定された値をパラメータとして取る必要があります。また、ゲージに表示される文字列を返す必要があります。
次に例を示します。
// 値を文字列に変換するコールバック
gauge.getText = (gauge, part, value, text) => {
switch (part) {
case 'value':
if (value <= 10) return 'Empty!';
if (value <= 25) return 'Low...';
if (value <= 95) return 'Good';
return 'Full';
case 'min':
return 'EMPTY';
case 'max':
return 'FULL';
}
return text;
}
ユーザーがマウスホイールで現在の値を編集できるかどうかを決定するゲージ値を取得または設定します。
このプロパティのデフォルト値は true。
ゲージに影の効果を表示するかどうかを示す値を取得または 設定します。
このプロパティのデフォルト値は true。
コントロールをホストしているDOM要素を取得します。
Gauge が値の変更を示すためにアニメーションを使用するか どうかを決定する値を取得または設定します。
このプロパティのデフォルト値は true。
コントロールが無効かどうかを判定する値を取得または設定します。
無効化されたコントロールは、マウスイベントやキーボードイベントを取得できません。
ユーザーがマウスとキーボードを使用して値を編集できるかどうかを示す値を 取得または設定します。
このプロパティのデフォルト値は true。
現在、コントロールがタッチイベントを処理しているかどうかを示す値を取得します。
コントロールが現在更新中かどうかを示す値を取得します。
ゲージに表示できる最大値を取得または設定します。
min およびmax プロパティの使用方法については、 「minおよびmaxプロパティの使用」トピックを参照してください。
ゲージに表示できる最小値を取得または設定します。
min およびmax プロパティの使用方法については、 「minおよびmaxプロパティの使用」トピックを参照してください。
範囲を描画するための始点を取得または設定します。
デフォルトでは、このプロパティはnullに設定されており、値の範囲はゲージの最小値から始まります。最小値がゼロ未満の場合はゼロから始まります。
ゲージの現在の値を表すために使用される Range を取得または設定します。
このゲージの範囲のコレクションを取得します。
要素内のコントロールを右から左のレイアウトでホストするかどうかを示す値を取得します。
ranges プロパティに含まれる範囲をゲージに表示するかどうか を示す値を取得または設定します。
ゲージのLinearGauge.isReadOnly プロパティを falseに設定すると、 ユーザーがゲージをクリックして値を編集できるようになります。
ゲージにテキストとして表示する ShowText の値を取得または設定します。
このプロパティのデフォルト値については、{@linkRadialGauge}コントロールの場合は ShowText.All 、と {@linkLinearGauge}コントロールの場合は ShowText.None です。
ゲージで、各目盛りのテキスト値を表示するかどうかを決定するプロパティを取得または設定します。
目盛りのテキストをスタイルする場合はCSSを使用ことができます。
.wj-gauge .wj-tick-text text {
opacity: 1;
font-family: Courier;
font-size: 8pt;
fill: purple;
}
showTicks および tickSpacing プロパティも参照してください。
このプロパティのデフォルト値は false です。
ゲージで、各 step (または tickSpacing)値に目盛りマークを表示するかどうかを決定するプロパティを 取得または設定します。
目盛りは、CSSでwj-gaugeおよびwj-ticksクラス名を使用して書式設定できます。以下に例を示します。
.wj-gauge .wj-ticks {
stroke-width: 2px;
stroke: white;
}
このプロパティのデフォルト値はfalseです。
ranges コレクションに含まれる範囲をゲージ内に積み重ねる かどうかを決定する値を取得または設定します。
stackRanges のデフォルト値はfalseであり、ranges コレクションの範囲はゲージのフェイスと同じ太さで表示されます。
stackRanges をtrueに設定すると、範囲が狭くなり、 並んで表示されます。
ユーザーが方向キーを押すかマウスホイールを回したときにvalue プロパティを増減する量を取得または設定します。
コントロールに関連付けられた tabindex 属性の値を取得または設定します。
tabindex属性値は、コントロールのホストHTML要素で指定することで、 Wijmoコントロールに対して静的に定義できます。 ただし、Wijmoコントロールは複雑な構造であり、コントロールが正しく機能できるように、属性値を内部要素に伝達する必要があるため、 この値をアプリケーションのライフサイクルの後半で変更することはできません。
そのため、コントロールのtabindexを動的に読み取ったり変更したりするには、このプロパティを使用して行う必要があります。
ゲージの太さを0~1のスケールで取得または設定します。
thicknessを1に設定すると、ゲージは最大限に太くなります。
値が小さいほどゲージは細くなります。
ゲージの現在の値を示す要素のサイズ(ピクセル単位)を取得または設定します。
目盛りマークの間隔を取得または設定します。
目盛りマークの間隔を取得または設定します。
ゲージ上に目盛りを表示するようにするには、showTicks プロパティをtrueに設定します。 デフォルトでは、目盛りマークの間隔はstep プロパティによって定義されます。
tickSpacing プロパティを使用してデフォルトをオーバーライドし、 step プロパティの値と異なるスペーシングを設定できます。 デフォルトの動作に戻すには、tickSpacing プロパティをnullに 設定します。
ゲージに表示される値を取得または設定します。
Gauge コントロールのインスタンス化に使用されるテンプレートを取得または設定します。
このControl が所有する要素にイベントリスナーを追加します。
コントロールは、アタッチされているリスナーとそのハンドラのリストを保持し、 コントロール が破棄されているときにそれらを簡単に削除すること ができます(dispose と removeEventListener ) メソッドを参照してください)。
イベントリスナーを削除しないと、メモリリークが発生する可能があります。
デフォルトでは passive パラメータはfalseに設定されています。これはイベントハンドラが event.preventDefault() を呼び出すことを意味します。 タッチイベントまたはマウスホイールイベントにpassiveハンドラを追加する場合は、このパラメータをtrueに設定するとアプリケーションのパフォーマンスが向上します。
passive イベントリスナーの詳細については、「Improving scrolling performance with passive listeners」を参考してください。
イベントのターゲット要素。
イベントを指定する文字列。
イベントが発生したときに実行する関数。
リスナーがターゲット要素によって処理される前にコントロールによって処理される必要があるかどうかを示します。
ハンドラーが preventDefault() を呼び出さないことを示します。
コントロールの新しいインスタンスにテンプレートを適用し、ルート要素を返します。
このメソッドはテンプレート化されたコントロールのコンストラクターによって呼び出されますので、このメソッドは使用できません。 テンプレートのパーツを対応するコントロールメンバにバインドする役割を持ちます。
以下のサンプルコードは、InputNumber コントロールのインスタンスにテンプレートを適用します。 このテンプレートには、'wj-part'属性が'input'、'btn-inc'、および'btn-dec'に設定された要素を含める必要があります。 コントロールのメンバである'_tbx'、'_btnUp'、'_btnDn'には、これらの要素への参照が割り当てられます。
this.applyTemplate('wj-control wj-inputnumber', templateString, {
_tbx: 'input',
_btnUp: 'btn-inc',
_btnDn: 'btn-dec'
}, 'input');
@param classNames コントロールのホスト要素に追加するクラスの名前。 @param template コントロールのテンプレートを定義するHTML文字列。 @param parts パーツ変数とその名前のディクショナリー。 @param namePart ホスト要素にちなんで名付けられたパーツの名前。 これにより、コントロールがフォームで使用されたときにデータをどのように送信するかが決まります。
次にendUpdate が呼び出されるまで通知を中断します。
このコントロールにフォーカスのある要素が含まれているかどうかをチェックします。
beginUpdate/endUpdate ブロック内で関数を実行します。
この関数の実行が完了するまでコントロールは更新されません。 このメソッドは、関数が例外を生成した場合でも endUpdate が呼び出されるようにします。
実行する関数。
ホスト要素との関連付けを解除することによってコントロールを破棄します。
dispose メソッドは、addEventListener メソッドによって 追加されたイベントリスナーを自動的に削除します。
コントロールを動的に作成および削除するアプリケーションでは、 dispose メソッドを呼び出すことが重要です。 コントロールを破棄しないと、 メモリリークが発生する可能があります。.
beginUpdate の呼び出しによって中断された通知を再開します。
コントロールを無効にする必要があります。このパラメータのデフォルト値は true です。
このコントロールにフォーカスを設定します。
オブジェクトが指定されたプロパティを持つかどうかを判定します。
プロパティの名前。
指定したポイントにあるゲージの値に対応する数値を取得します。
次に例を示します。```typescript // hit test a point when the user clicks on the gauge gauge.hostElement.addEventListener('click', e => { var ht = gauge.hitTest(e.pageX, e.pageY); if (ht != null) { console.log('you clicked the gauge at value ' + ht.toString()); } });
調べるポイント(ウィンドウ座標単位)、MouseEventオブジェクト、またはポイントのX座標。
ポイントのY座標(最初のパラメーターが数値の場合)。
ポイントでのゲージの値、またはポイントがゲージの面上にない場合はnull。
指定したオブジェクトからプロパティをコピーしてコントロールを初期化します。
このメソッドを使用すると、各プロパティの値をコードで設定する代わりにプレーンなデータオブジェクトを使用してコントロールを初期化できます。
例:
grid.initialize({
itemsSource: myList,
autoGenerateColumns: false,
columns: [
{ binding: 'id', header: 'Code', width: 130 },
{ binding: 'name', header: 'Name', width: 60 }
]
});
// 以下と同等です。
grid.itemsSource = myList;
grid.autoGenerateColumns = false;
// など
初期化データは適用時に型チェックされます。 初期化オブジェクトに不明なプロパティ名または無効なデータ型が含まれている場合、このメソッドは例外をスローします。
初期化データを含むオブジェクト。
非同期更新を発生させるため、コントロールを無効にします。
内容だけでなくコントロールのレイアウトも更新するかどうか。
オブジェクトが別のオブジェクトのプロトタイプチェーンに存在するかどうかを判定します。
プロトタイプチェーンが判定される別のオブジェクト。
invalidInput イベントを発生させます。
イベントハンドラーがイベントをキャンセルした場合、コントロールは無効な入力内容とフォーカスを保持します。
refreshing イベントを発生させます。
valueChanged イベントを発生させます。
指定されたプロパティが列挙可能かどうかを判断します。
プロパティの名前。
コントロールを更新します。
内容だけでなくコントロールのレイアウトも更新するかどうかを示します。
このControl が所有する要素にアタッチされている1つまたは複数のイベントリスナーを解除します。
イベントのターゲット要素。 nullの場合、すべてのターゲットにアタッチされているリスナーが解除されます
イベントを指定する文字列。 nullの場合、すべてのイベントにアタッチされているリスナーが解除されます。
削除するハンドラ。 nullの場合は、すべてのハンドラが削除されます。
リスナーがキャプチャリスナーかどうか。 nullの場合、キャプチャリスナーと非キャプチャリスナーの両方が解除されます。
削除されたリスナーの数。
現在のロケールを使用して文字列に変換された日付を返します。
オブジェクトの文字列表現を返します。
指定されたオブジェクトのプリミティブ値を返します。
HTML要素に含まれるすべてのWijmoコントロールを破棄します。
コンテナー要素。
指定したDOM要素でホストされているコントロールを取得します。
コントロールをホストするDOM要素、またはホスト要素のCSS セレクター(例: '#theCtrl')。
指定したHTML要素に含まれるすべてのWijmoコントロールを無効化します。
このメソッドは、コントロールの表示状態やサイズを変更する 動的なパネルをアプリケーションで使用している場合に使用します。 たとえば、スプリッタ、アコーディオン、およびタブコントロールは通常、 その中の要素の表示状態を変更します。この場合、その要素に含まれるコントロールに通知しないと、 それらのコントロールが適切に機能しなくなる可能性があります。 これが起こる場合は、動的コンテナーで適切なイベントを処理し、 Control.invalidateAll メソッドを呼び出してコンテナー内のWijmoコントロールの レイアウト情報が適切に更新されるようにする必要があります。
コンテナー要素。nullに設定すると、ページ上に存在するすべてのWijmoコントロールが無効化されます。
HTML要素で存在するすべてのWijmoコントロールを更新する。
コントロールが時間おいて更新される代わりに直ちに更新されること以外はinvalidateAll メソッドと同様です。
コンテナー要素。nullに設定すると、ページ上に存在するすべてのWijmoコントロールが無効化されます。
コントロールがフォーカスを取得したときに発生します。
無効な文字が入力されたときに発生します。
ユーザーが入力した値が適切な種類に変換できない値、または有効な範囲外の値を貼り付ける場合、 無効な入力エラーが発生する場合があります。
イベントハンドラーがイベントをキャンセルする場合、 ユーザーがエラーを修正できるように、 コントロールは無効なコンテンツとフォーカスを保持します。
イベントがキャンセルされない場合、コントロールは無効な入力エラーを無視し、 元のコンテンツを保持します。
コントロールがフォーカスを失ったときに発生します。
コントロールが内容を更新した後で発生します。
コントロールが内容を更新する直前に発生します。
value プロパティの値が変更されたときに発生します。
Wijmo Gaugeコントロールの基本クラス(抽象)。