[]
この特定のコンポーネントのグローバルなWjOptions.asyncBindingsの設定をオーバーライドできます。 詳細については、WjOptions. WjOptions.asyncBindings プロパティの説明を参照してください。
ゲージがホスト要素に収まるように自動的に拡大縮小されるかどうかを示す値を取得または設定します
このプロパティのデフォルト値は true。
ゲージの全体的な形状と外観を表すために使用されるRange を取得または設定します。
ゲージのフェイス要素の境界を取得します。
このプロパティは、ゲージ上にカスタムのSVG要素を配置するために使用されます。
ゲージ値をテキストとして表示するために使用される書式文字列を取得または設定します。
ゲージ値の表示に使用されるカスタマイズされた文字列を返す コールバックを取得または設定します。
このプロパティは、ゲージに表示される文字列をカスタマイズしたいが、 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;
}
プログラムによるアクセスに使用されるWijmo gotFocusイベントのAngular(EventEmitter)バージョン。 コードでこのイベントのAngularバージョンをサブスクライブする場合は、このイベント名を使用してください。 テンプレート連結では、通常のgotFocus Wijmoイベント名を使用してください。
ユーザーがマウスホイールで現在の値を編集できるかどうかを決定するゲージ値を取得または設定します。
このプロパティのデフォルト値は true。
ゲージに影の効果を表示するかどうかを示す値を取得または 設定します。
このプロパティのデフォルト値は true。
コントロールをホストしているDOM要素を取得します。
このイベントは、コンポーネントがAngularによって初期化された後、つまり すべての連結プロパティが割り当てられ、子コンポーネント(ある場合)が初期化された後にトリガされます。
プログラムによるアクセスに使用されるWijmo invalidInputイベントのAngular(EventEmitter)バージョン。 コードでこのイベントのAngularバージョンをサブスクライブする場合は、このイベント名を使用してください。 テンプレート連結では、通常のinvalidInput Wijmoイベント名を使用してください。
Gauge が値の変更を示すためにアニメーションを使用するか どうかを決定する値を取得または設定します。
このプロパティのデフォルト値は true。
コントロールが無効かどうかを判定する値を取得または設定します。
無効化されたコントロールは、マウスイベントやキーボードイベントを取得できません。
コンポーネントがAngularによって初期化されているかどうかを示します。 この値は、initializedイベントをトリガする直前にfalseからtrueになります。
ユーザーがマウスとキーボードを使用して値を編集できるかどうかを示す値を 取得または設定します。
このプロパティのデフォルト値は true。
現在、コントロールがタッチイベントを処理しているかどうかを示す値を取得します。
コントロールが現在更新中かどうかを示す値を取得します。
プログラムによるアクセスに使用されるWijmo lostFocusイベントのAngular(EventEmitter)バージョン。 コードでこのイベントのAngularバージョンをサブスクライブする場合は、このイベント名を使用してください。 テンプレート連結では、通常のlostFocus Wijmoイベント名を使用してください。
ゲージに表示できる最大値を取得または設定します。
min およびmax プロパティの使用方法については、 「minおよびmaxプロパティの使用」トピックを参照してください。
ゲージに表示できる最小値を取得または設定します。
min およびmax プロパティの使用方法については、 「minおよびmaxプロパティの使用」トピックを参照してください。
ゲージの針として使用するSVGElementを取得または設定します。
指定されている場合、針要素はX方向に0から100単位まで移動し、 Y軸に対して対称移動します。 このプロパティが設定されている場合、針要素がゲージDOMの一部になり、元のコンテナから削除されます。 1つの要素を複数のゲージで使用する場合には、cloneメソッドを利用して針要素のコピーを作成します。
ポインター範囲に対するゲージの needleElement の長さを決定する値を取得または設定します。
このプロパティのデフォルト値は NeedleLength.Middle。
ゲージの針要素の形状を決定する値を取得または設定します。
このプロパティを使用して、定義済みの針形状を選択できます。 定義済みの形状は createNeedleElement メソッドを使用して作成されます。
また、 createNeedleElement メソッドを使用して作成したカスタム要素、または任意のメソッドを使用して作成したカスタムSVGグループ要素にneedleElementプロパティを設定することで、カスタム針要素を作成することができます。
CSSを使用して針のスタイルを設定することができます。 以下に例を示します。
.wj-gauge .wj-needle {
fill: orangered;
stroke: orangered;
}
.wj-gauge .wj-needle .wj-inner-needle-cap {
fill: white;
}
このプロパティのデフォルト値は NeedleShape.None です。
範囲を描画するための始点を取得または設定します。
デフォルトでは、このプロパティはnullに設定されており、値の範囲はゲージの最小値から始まります。最小値がゼロ未満の場合はゼロから始まります。
ゲージの現在の値を表すために使用される Range を取得または設定します。
このゲージの範囲のコレクションを取得します。
プログラムによるアクセスに使用されるWijmo refreshedイベントのAngular(EventEmitter)バージョン。 コードでこのイベントのAngularバージョンをサブスクライブする場合は、このイベント名を使用してください。 テンプレート連結では、通常のrefreshed Wijmoイベント名を使用してください。
プログラムによるアクセスに使用されるWijmo refreshingイベントのAngular(EventEmitter)バージョン。 コードでこのイベントのAngularバージョンをサブスクライブする場合は、このイベント名を使用してください。 テンプレート連結では、通常のrefreshing Wijmoイベント名を使用してください。
要素内のコントロールを右から左のレイアウトでホストするかどうかを示す値を取得します。
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に設定すると、範囲が狭くなり、 並んで表示されます。
ゲージの開始角度を取得または設定します。
ゲージの掃引角度(度単位)を取得または設定します。 角度は9時の位置から時計回りに度単位で測定されます。
このプロパティのデフォルト値は 0 です。
ユーザーが方向キーを押すかマウスホイールを回したときにvalue プロパティを増減する量を取得または設定します。
ゲージの掃引角度を取得または設定します。
ゲージの掃引角度(度単位)を取得または設定します。 角度は9時の位置から時計回りに度単位で測定されます。
このプロパティのデフォルト値は 180 です。
コントロールに関連付けられた tabindex 属性の値を取得または設定します。
tabindex属性値は、コントロールのホストHTML要素で指定することで、 Wijmoコントロールに対して静的に定義できます。 ただし、Wijmoコントロールは複雑な構造であり、コントロールが正しく機能できるように、属性値を内部要素に伝達する必要があるため、 この値をアプリケーションのライフサイクルの後半で変更することはできません。
そのため、コントロールのtabindexを動的に読み取ったり変更したりするには、このプロパティを使用して行う必要があります。
ゲージの太さを0~1のスケールで取得または設定します。
thicknessを1に設定すると、ゲージは最大限に太くなります。
値が小さいほどゲージは細くなります。
ゲージの現在の値を示す要素のサイズ(ピクセル単位)を取得または設定します。
目盛りマークの間隔を取得または設定します。
目盛りマークの間隔を取得または設定します。
ゲージ上に目盛りを表示するようにするには、showTicks プロパティをtrueに設定します。 デフォルトでは、目盛りマークの間隔はstep プロパティによって定義されます。
tickSpacing プロパティを使用してデフォルトをオーバーライドし、 step プロパティの値と異なるスペーシングを設定できます。 デフォルトの動作に戻すには、tickSpacing プロパティをnullに 設定します。
ゲージに表示される値を取得または設定します。
このイベントは、valueプロパティへの両方向のバインドを実装するために使用されます。 このイベントは、プロパティ値が変更されたときに発生し、引数は新しいプロパティ値を保持します。 valueChangeイベント名を使用して、テンプレートでハンドラをこのイベントに連結できます。
プログラムによるアクセスに使用されるWijmo valueChangedイベントのAngular(EventEmitter)バージョン。 コードでこのイベントのAngularバージョンをサブスクライブする場合は、このイベント名を使用してください。 テンプレート連結では、通常のvalueChanged Wijmoイベント名を使用してください。
[(ngModel)]ディレクティブ(指定されている場合)によって表されるプロパティの名前を定義します。 デフォルト値は'value'です。
Gauge コントロールのインスタンス化に使用されるテンプレートを取得または設定します。
コントロールの新しいインスタンスにテンプレートを適用し、ルート要素を返します。
このメソッドはテンプレート化されたコントロールのコンストラクターによって呼び出されますので、このメソッドは使用できません。 テンプレートのパーツを対応するコントロールメンバにバインドする役割を持ちます。
以下のサンプルコードは、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 が呼び出されるまで通知を中断します。
このコントロールにフォーカスのある要素が含まれているかどうかをチェックします。
Wijmoコンポーネントから継承されるカスタムコンポーネントを作成する場合は、このメソッドを
オーバーライドして、通常はクラスコンストラクタで行う必要な初期化を行うことができます。
このメソッドは、Wijmoコンポーネントコンストラクタの最後の行で呼び出され、
カスタムコンポーネントのコンストラクタを宣言しなくて済むようにします。これにより、
コンストラクタのパラメータを保持したり、Wijmoコンポーネントのコンストラクタパラメータとの同期を維持する必要がなくなります。
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の場合、キャプチャリスナーと非キャプチャリスナーの両方が解除されます。
削除されたリスナーの数。
現在のロケールを使用して文字列に変換された日付を返します。
オブジェクトの文字列表現を返します。
指定されたオブジェクトのプリミティブ値を返します。
ゲージの針として使用するSVGElementを作成します。
針の形状を定義する 「x」と 「y」の値を持つオブジェクトの配列。 「x」値は0(ゲージの中心)から100(ゲージの半径)までの範囲に指定する必要があります。 「y」値は針の幅を定義し、範囲が0から20までです。 各 「y」値は2回使用されます。これを左から右に使用すると、 針の軸より上の針の範囲を定義します。 符号を逆にして右から左に使用すると、軸の下の針の範囲を定義します。
原点を中心とした円であるcap要素の半径を定義するオプションの値。
cap要素の上に描かれた円の半径を定義するオプションの値。
createNeedleElementメソッドは、 needleElementプロパティで使用できるカスタムの針形状を作成する簡単な方法を提供します。
たとえば、次のコードでは、 NeedleShape 列挙で定義される一般的な針形状を作成するために、 RadialGauge によって createNeedleElement メソッドが内部的に使用される方法を示しています。
let needle = null;
switch (value) {
case NeedleShape.Triangle:
needle = RadialGauge.createNeedleElement([
{ x: -10, y: 10 }, { x: 100, y: 0 }
]);
break;
case NeedleShape.Diamond:
needle = RadialGauge.createNeedleElement([
{ x: -20, y: 0 }, { x: 0, y: 10 }, { x: 100, y: 0 }
]);
break;
case NeedleShape.Drop:
needle = RadialGauge.createNeedleElement([
{ x: 0, y: 20 }, { x: 100, y: 0 }
], 20, 10);
break;
case NeedleShape.Outer:
needle = RadialGauge.createNeedleElement([
{ x: 60, y: 20 }, { x: 100, y: 0 }
]);
break;
}
HTML要素に含まれるすべてのWijmoコントロールを破棄します。
コンテナー要素。
指定したDOM要素でホストされているコントロールを取得します。
コントロールをホストするDOM要素、またはホスト要素のCSS セレクター(例: '#theCtrl')。
指定したHTML要素に含まれるすべてのWijmoコントロールを無効化します。
このメソッドは、コントロールの表示状態やサイズを変更する 動的なパネルをアプリケーションで使用している場合に使用します。 たとえば、スプリッタ、アコーディオン、およびタブコントロールは通常、 その中の要素の表示状態を変更します。この場合、その要素に含まれるコントロールに通知しないと、 それらのコントロールが適切に機能しなくなる可能性があります。 これが起こる場合は、動的コンテナーで適切なイベントを処理し、 Control.invalidateAll メソッドを呼び出してコンテナー内のWijmoコントロールの レイアウト情報が適切に更新されるようにする必要があります。
コンテナー要素。nullに設定すると、ページ上に存在するすべてのWijmoコントロールが無効化されます。
HTML要素で存在するすべてのWijmoコントロールを更新する。
コントロールが時間おいて更新される代わりに直ちに更新されること以外はinvalidateAll メソッドと同様です。
コンテナー要素。nullに設定すると、ページ上に存在するすべてのWijmoコントロールが無効化されます。
コントロールがフォーカスを取得したときに発生します。
無効な文字が入力されたときに発生します。
ユーザーが入力した値が適切な種類に変換できない値、または有効な範囲外の値を貼り付ける場合、 無効な入力エラーが発生する場合があります。
イベントハンドラーがイベントをキャンセルする場合、 ユーザーがエラーを修正できるように、 コントロールは無効なコンテンツとフォーカスを保持します。
イベントがキャンセルされない場合、コントロールは無効な入力エラーを無視し、 元のコンテンツを保持します。
コントロールがフォーカスを失ったときに発生します。
コントロールが内容を更新した後で発生します。
コントロールが内容を更新する直前に発生します。
value プロパティの値が変更されたときに発生します。
wijmo.gauge.RadialGauge コントロールに対応するAngular 2コンポーネント。
wj-radial-gauge コンポーネントを使用して、Angular 2アプリケーションに RadialGauge コントロールを 追加できます。Angular 2マークアップの構文については、
「Angular 2マークアップ構文」を参照してください。
WjRadialGauge コンポーネントは、 RadialGauge コントロールから派生され、 そのすべてのプロパティ、イベント、およびメソッドを継承しています。
wj-radial-gauge コンポーネントには、wijmo.angular2.gauge.WjRange の子コンポーネントを含めます。