Wijmo
Interops
- Vue2
- React
- Angular2
  - Barcode
  - Chart
  - Core
  - Directivebase
  - Gauge
  - Grid
  - Input
  - Nav
  - Olap
  - Viewer

Wijmo_Angular2_Gauge.Wjlineargauge

WjLinearGauge クラス

wijmo.gauge.LinearGauge コントロールに対応するAngular 2コンポーネント。

wj-linear-gauge コンポーネントを使用して、Angular 2アプリケーションに LinearGauge コントロールを追加できます。Angular 2マークアップの構文については、

「Angular 2マークアップ構文」を参照してください。

WjLinearGauge コンポーネントは、 LinearGauge コントロールから派生され、そのすべてのプロパティ、イベント、およびメソッドを継承しています。

wj-linear-gauge コンポーネントには、wijmo.angular2.gauge.WjRange の子コンポーネントを含めます。

階層

LinearGauge
- WjLinearGauge

プロパティ

メソッド

イベント

プロパティ

asyncBindings

asyncBindings: boolean

この特定のコンポーネントのグローバルなWjOptions.asyncBindingsの設定をオーバーライドできます。詳細については、WjOptions. WjOptions.asyncBindings　プロパティの説明を参照してください。

direction

direction: GaugeDirection

ゲージが塗りつぶされていく方向を取得または設定します。

このプロパティのデフォルト値はGaugeDirection.Rightです。

face

face: Range

ゲージの全体的な形状と外観を表すために使用されるRange を取得または設定します。

faceBounds

faceBounds: Rect

ゲージのフェイス要素の境界を取得します。

このプロパティは、ゲージ上にカスタムのSVG要素を配置するために使用されます。

Example

format

format: string

ゲージ値をテキストとして表示するために使用される書式文字列を取得または設定します。

getText

getText: IGetGaugeText

ゲージ値の表示に使用されるカスタマイズされた文字列を返すコールバックを取得または設定します。

このプロパティは、ゲージに表示される文字列をカスタマイズしたいが、 format プロパティでは十分でない場合に使用してください。

指定する場合、コールバック関数は、ゲージ、部分名、値、および書式設定された値をパラメータとして取る必要があります。また、ゲージに表示される文字列を返す必要があります。

次に例を示します。

// 値を文字列に変換するコールバック
gauge.getText = (gauge, part, value, text) => {
    switch (part) {
case 'value':
if (value &lt;= 10) return 'Empty!';
if (value &lt;= 25) return 'Low...';
if (value &lt;= 95) return 'Good';
return 'Full';
        case 'min':
return 'EMPTY';
        case 'max':
   return 'FULL';
    }
    return text;
}

gotFocusNg

gotFocusNg: EventEmitter<any>

プログラムによるアクセスに使用されるWijmo gotFocusイベントのAngular（EventEmitter）バージョン。コードでこのイベントのAngularバージョンをサブスクライブする場合は、このイベント名を使用してください。テンプレート連結では、通常のgotFocus Wijmoイベント名を使用してください。

handleWheel

handleWheel: boolean

ユーザーがマウスホイールで現在の値を編集できるかどうかを決定するゲージ値を取得または設定します。

このプロパティのデフォルト値は true。

hasShadow

hasShadow: boolean

ゲージに影の効果を表示するかどうかを示す値を取得または設定します。

このプロパティのデフォルト値は true。

hostElement

hostElement: HTMLElement

コントロールをホストしているDOM要素を取得します。

initialized

initialized: EventEmitter<any>

このイベントは、コンポーネントがAngularによって初期化された後、つまりすべての連結プロパティが割り当てられ、子コンポーネント（ある場合）が初期化された後にトリガされます。

invalidInputNg

invalidInputNg: EventEmitter<any>

プログラムによるアクセスに使用されるWijmo invalidInputイベントのAngular（EventEmitter）バージョン。コードでこのイベントのAngularバージョンをサブスクライブする場合は、このイベント名を使用してください。テンプレート連結では、通常のinvalidInput Wijmoイベント名を使用してください。

isAnimated

isAnimated: boolean

Gauge が値の変更を示すためにアニメーションを使用するかどうかを決定する値を取得または設定します。

このプロパティのデフォルト値は true。

isDisabled

isDisabled: boolean

コントロールが無効かどうかを判定する値を取得または設定します。

無効化されたコントロールは、マウスイベントやキーボードイベントを取得できません。

isInitialized

isInitialized: boolean

コンポーネントがAngularによって初期化されているかどうかを示します。この値は、initializedイベントをトリガする直前にfalseからtrueになります。

isReadOnly

isReadOnly: boolean

ユーザーがマウスとキーボードを使用して値を編集できるかどうかを示す値を取得または設定します。

このプロパティのデフォルト値は true。

isTouching

isTouching: boolean

現在、コントロールがタッチイベントを処理しているかどうかを示す値を取得します。

isUpdating

isUpdating: boolean

コントロールが現在更新中かどうかを示す値を取得します。

lostFocusNg

lostFocusNg: EventEmitter<any>

プログラムによるアクセスに使用されるWijmo lostFocusイベントのAngular（EventEmitter）バージョン。コードでこのイベントのAngularバージョンをサブスクライブする場合は、このイベント名を使用してください。テンプレート連結では、通常のlostFocus Wijmoイベント名を使用してください。

max

max: number

ゲージに表示できる最大値を取得または設定します。

min およびmax プロパティの使用方法については、「minおよびmaxプロパティの使用」トピックを参照してください。

min

min: number

ゲージに表示できる最小値を取得または設定します。

min およびmax プロパティの使用方法については、「minおよびmaxプロパティの使用」トピックを参照してください。

origin

origin: number

範囲を描画するための始点を取得または設定します。

デフォルトでは、このプロパティはnullに設定されており、値の範囲はゲージの最小値から始まります。最小値がゼロ未満の場合はゼロから始まります。

pointer

pointer: Range

ゲージの現在の値を表すために使用される Range を取得または設定します。

ranges

ranges: ObservableArray

このゲージの範囲のコレクションを取得します。

refreshedNg

refreshedNg: EventEmitter<any>

プログラムによるアクセスに使用されるWijmo refreshedイベントのAngular（EventEmitter）バージョン。コードでこのイベントのAngularバージョンをサブスクライブする場合は、このイベント名を使用してください。テンプレート連結では、通常のrefreshed Wijmoイベント名を使用してください。

refreshingNg

refreshingNg: EventEmitter<any>

プログラムによるアクセスに使用されるWijmo refreshingイベントのAngular（EventEmitter）バージョン。コードでこのイベントのAngularバージョンをサブスクライブする場合は、このイベント名を使用してください。テンプレート連結では、通常のrefreshing Wijmoイベント名を使用してください。

rightToLeft

rightToLeft: boolean

要素内のコントロールを右から左のレイアウトでホストするかどうかを示す値を取得します。

showRanges

showRanges: boolean

ranges プロパティに含まれる範囲をゲージに表示するかどうかを示す値を取得または設定します。

ゲージのLinearGauge.isReadOnly プロパティを falseに設定すると、ユーザーがゲージをクリックして値を編集できるようになります。

デモ

showText

showText: ShowText

ゲージにテキストとして表示する ShowText の値を取得または設定します。

このプロパティのデフォルト値については、{@linkRadialGauge}コントロールの場合は ShowText.All 、と {@linkLinearGauge}コントロールの場合は ShowText.None です。

showTickText

showTickText: boolean

ゲージで、各目盛りのテキスト値を表示するかどうかを決定するプロパティを取得または設定します。

目盛りのテキストをスタイルする場合はCSSを使用ことができます。

.wj-gauge .wj-tick-text text {
    opacity: 1;
font-family: Courier;
    font-size: 8pt;
    fill: purple;
}

showTicks および tickSpacing プロパティも参照してください。

このプロパティのデフォルト値は false です。

showTicks

showTicks: boolean

ゲージで、各 step (または tickSpacing)値に目盛りマークを表示するかどうかを決定するプロパティを取得または設定します。

目盛りは、CSSでwj-gaugeおよびwj-ticksクラス名を使用して書式設定できます。以下に例を示します。

.wj-gauge .wj-ticks {
    stroke-width: 2px;
    stroke: white;
}

このプロパティのデフォルト値はfalseです。

stackRanges

stackRanges: boolean

ranges コレクションに含まれる範囲をゲージ内に積み重ねるかどうかを決定する値を取得または設定します。

stackRanges のデフォルト値はfalseであり、ranges コレクションの範囲はゲージのフェイスと同じ太さで表示されます。

stackRanges をtrueに設定すると、範囲が狭くなり、並んで表示されます。

step

step: number

ユーザーが方向キーを押すかマウスホイールを回したときにvalue プロパティを増減する量を取得または設定します。

tabOrder

tabOrder: number

コントロールに関連付けられた tabindex 属性の値を取得または設定します。

tabindex属性値は、コントロールのホストHTML要素で指定することで、 Wijmoコントロールに対して静的に定義できます。ただし、Wijmoコントロールは複雑な構造であり、コントロールが正しく機能できるように、属性値を内部要素に伝達する必要があるため、この値をアプリケーションのライフサイクルの後半で変更することはできません。

そのため、コントロールのtabindexを動的に読み取ったり変更したりするには、このプロパティを使用して行う必要があります。

thickness

thickness: number

ゲージの太さを0~1のスケールで取得または設定します。

thicknessを1に設定すると、ゲージは最大限に太くなります。

値が小さいほどゲージは細くなります。

thumbSize

thumbSize: number

ゲージの現在の値を示す要素のサイズ（ピクセル単位）を取得または設定します。

tickSpacing

tickSpacing: number

目盛りマークの間隔を取得または設定します。

ゲージ上に目盛りを表示するようにするには、showTicks　プロパティをtrueに設定します。デフォルトでは、目盛りマークの間隔はstep プロパティによって定義されます。

tickSpacing プロパティを使用してデフォルトをオーバーライドし、 step プロパティの値と異なるスペーシングを設定できます。デフォルトの動作に戻すには、tickSpacing プロパティをnullに設定します。

value

value: number

ゲージに表示される値を取得または設定します。

valueChangePC

valueChangePC: EventEmitter<any>

このイベントは、valueプロパティへの両方向のバインドを実装するために使用されます。このイベントは、プロパティ値が変更されたときに発生し、引数は新しいプロパティ値を保持します。 valueChangeイベント名を使用して、テンプレートでハンドラをこのイベントに連結できます。

valueChangedNg

valueChangedNg: EventEmitter<any>

プログラムによるアクセスに使用されるWijmo valueChangedイベントのAngular（EventEmitter）バージョン。コードでこのイベントのAngularバージョンをサブスクライブする場合は、このイベント名を使用してください。テンプレート連結では、通常のvalueChanged Wijmoイベント名を使用してください。

wjModelProperty

wjModelProperty: string

[(ngModel)]ディレクティブ（指定されている場合）によって表されるプロパティの名前を定義します。デフォルト値は'value'です。

静的 controlTemplate

controlTemplate: string

Gauge コントロールのインスタンス化に使用されるテンプレートを取得または設定します。

メソッド

applyTemplate

applyTemplate(classNames: string, template: string, parts: Object, namePart?: string): HTMLElement

継承元 Control.applyTemplate
コントロールの新しいインスタンスにテンプレートを適用し、ルート要素を返します。

このメソッドはテンプレート化されたコントロールのコンストラクターによって呼び出されますので、このメソッドは使用できません。テンプレートのパーツを対応するコントロールメンバにバインドする役割を持ちます。

以下のサンプルコードは、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 ホスト要素にちなんで名付けられたパーツの名前。これにより、コントロールがフォームで使用されたときにデータをどのように送信するかが決まります。
引数
- classNames: string
- template: string
- parts: Object
- オプション namePart: string
戻り値 HTMLElement

beginUpdate

beginUpdate(): void

継承元 Control.beginUpdate

次にendUpdate が呼び出されるまで通知を中断します。

戻り値 void

containsFocus

containsFocus(): boolean

継承元 Control.containsFocus

このコントロールにフォーカスのある要素が含まれているかどうかをチェックします。

戻り値 boolean

created

created(): void

Wijmoコンポーネントから継承されるカスタムコンポーネントを作成する場合は、このメソッドを
オーバーライドして、通常はクラスコンストラクタで行う必要な初期化を行うことができます。このメソッドは、Wijmoコンポーネントコンストラクタの最後の行で呼び出され、カスタムコンポーネントのコンストラクタを宣言しなくて済むようにします。これにより、コンストラクタのパラメータを保持したり、Wijmoコンポーネントのコンストラクタパラメータとの同期を維持する必要がなくなります。

戻り値 void

deferUpdate

deferUpdate(fn: Function): void

継承元 Control.deferUpdate

beginUpdate/endUpdate ブロック内で関数を実行します。

この関数の実行が完了するまでコントロールは更新されません。このメソッドは、関数が例外を生成した場合でも endUpdate が呼び出されるようにします。

引数
- fn: Function
  
  実行する関数。
戻り値 void

dispose

dispose(): void

継承元 Gauge.dispose

オーバーライド Control.dispose

ホスト要素との関連付けを解除することによってコントロールを破棄します。

dispose メソッドは、addEventListener メソッドによって追加されたイベントリスナーを自動的に削除します。

コントロールを動的に作成および削除するアプリケーションでは、 dispose メソッドを呼び出すことが重要です。コントロールを破棄しないと、メモリリークが発生する可能があります。

戻り値 void

endUpdate

endUpdate(shouldInvalidate?: boolean): void

継承元 Control.endUpdate

beginUpdate の呼び出しによって中断された通知を再開します。

引数
- オプション shouldInvalidate: boolean
  
  コントロールを無効にする必要があります。このパラメータのデフォルト値は true です。
戻り値 void

focus

focus(): void

継承元 Control.focus

このコントロールにフォーカスを設定します。

戻り値 void

getTemplate

getTemplate(): string

継承元 Control.getTemplate

コントロールのインスタンスの作成に使用されたHTMLテンプレートを取得します。

このメソッドは、クラス階層をさかのぼってコントロールのテンプレートを指定する最も近い祖先を探します。たとえば、ComboBox コントロールのプロトタイプを指定した場合、そのプロトタイプによってDropDown 基本クラスで定義されたテンプレートがオーバーライドされます。

戻り値 string

hasOwnProperty

hasOwnProperty(v: PropertyKey): boolean

継承元 Object.hasOwnProperty

オブジェクトが指定されたプロパティを持つかどうかを判定します。

引数
- v: PropertyKey
  
  プロパティの名前。
戻り値 boolean

hitTest

hitTest(pt: any, y?: number): number

継承元 Gauge.hitTest
指定したポイントにあるゲージの値に対応する数値を取得します。

次に例を示します。```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()); } });
引数
- pt: any
  
  調べるポイント（ウィンドウ座標単位）、MouseEventオブジェクト、またはポイントのX座標。
- オプション y: number
  
  ポイントのY座標（最初のパラメーターが数値の場合）。
戻り値 number

ポイントでのゲージの値、またはポイントがゲージの面上にない場合はnull。

initialize

initialize(options: any): void

継承元 Control.initialize
指定したオブジェクトからプロパティをコピーしてコントロールを初期化します。

このメソッドを使用すると、各プロパティの値をコードで設定する代わりにプレーンなデータオブジェクトを使用してコントロールを初期化できます。

例:
```
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;
// など 
```
初期化データは適用時に型チェックされます。初期化オブジェクトに不明なプロパティ名または無効なデータ型が含まれている場合、このメソッドは例外をスローします。
引数
- options: any
  
  初期化データを含むオブジェクト。
戻り値 void

invalidate

invalidate(fullUpdate?: boolean): void

継承元 Control.invalidate

非同期更新を発生させるため、コントロールを無効にします。

引数
- オプション fullUpdate: boolean
  
  内容だけでなくコントロールのレイアウトも更新するかどうか。
戻り値 void

isPrototypeOf

isPrototypeOf(v: Object): boolean

継承元 Object.isPrototypeOf

オブジェクトが別のオブジェクトのプロトタイプチェーンに存在するかどうかを判定します。

引数
- v: Object
  
  プロトタイプチェーンが判定される別のオブジェクト。
戻り値 boolean

onGotFocus

onGotFocus(e?: EventArgs): void

継承元 Control.onGotFocus

gotFocus イベントを発生させます。

引数
- オプション e: EventArgs
戻り値 void

onInvalidInput

onInvalidInput(e: CancelEventArgs): boolean

継承元 Control.onInvalidInput

invalidInput イベントを発生させます。

イベントハンドラーがイベントをキャンセルした場合、コントロールは無効な入力内容とフォーカスを保持します。

引数
- e: CancelEventArgs
戻り値 boolean

onLostFocus

onLostFocus(e?: EventArgs): void

継承元 Control.onLostFocus

lostFocus イベントを発生させます。

引数
- オプション e: EventArgs
戻り値 void

onRefreshed

onRefreshed(e?: EventArgs): void

継承元 Control.onRefreshed

refreshed イベントを発生させます。

引数
- オプション e: EventArgs
戻り値 void

onRefreshing

onRefreshing(e?: EventArgs): void

継承元 Control.onRefreshing

refreshing イベントを発生させます。

引数
- オプション e: EventArgs
戻り値 void

onValueChanged

onValueChanged(e?: EventArgs): void

継承元 Gauge.onValueChanged

valueChanged イベントを発生させます。

引数
- オプション e: EventArgs
戻り値 void

propertyIsEnumerable

propertyIsEnumerable(v: PropertyKey): boolean

継承元 Object.propertyIsEnumerable

指定されたプロパティが列挙可能かどうかを判断します。

引数
- v: PropertyKey
  
  プロパティの名前。
戻り値 boolean

refresh

refresh(fullUpdate?: boolean): void

継承元 Gauge.refresh

オーバーライド Control.refresh

コントロールを更新します。

引数
- オプション fullUpdate: boolean
  
  内容だけでなくコントロールのレイアウトも更新するかどうかを示します。
戻り値 void

removeEventListener

removeEventListener(target?: EventTarget, type?: string, fn?: any, capture?: boolean): number

継承元 Control.removeEventListener

このControl が所有する要素にアタッチされている1つまたは複数のイベントリスナーを解除します。

引数
- オプション target: EventTarget
  
  イベントのターゲット要素。 nullの場合、すべてのターゲットにアタッチされているリスナーが解除されます
- オプション type: string
  
  イベントを指定する文字列。 nullの場合、すべてのイベントにアタッチされているリスナーが解除されます。
- オプション fn: any
  
  削除するハンドラ。 nullの場合は、すべてのハンドラが削除されます。
- オプション capture: boolean
  
  リスナーがキャプチャリスナーかどうか。 nullの場合、キャプチャリスナーと非キャプチャリスナーの両方が解除されます。
戻り値 number

削除されたリスナーの数。

toLocaleString

toLocaleString(): string

継承元 Object.toLocaleString

現在のロケールを使用して文字列に変換された日付を返します。

戻り値 string

toString

toString(): string

継承元 Object.toString

オブジェクトの文字列表現を返します。

戻り値 string

valueOf

valueOf(): Object

継承元 Object.valueOf

指定されたオブジェクトのプリミティブ値を返します。

戻り値 Object

静的 disposeAll

disposeAll(e?: HTMLElement): void

継承元 Control.disposeAll

HTML要素に含まれるすべてのWijmoコントロールを破棄します。

引数
- オプション e: HTMLElement
  
  コンテナー要素。
戻り値 void

静的 getControl

getControl(element: any): Control

継承元 Control.getControl

指定したDOM要素でホストされているコントロールを取得します。

引数
- element: any
  
  コントロールをホストするDOM要素、またはホスト要素のCSS セレクター（例: '#theCtrl'）。
戻り値 Control

静的 invalidateAll

invalidateAll(e?: HTMLElement): void

継承元 Control.invalidateAll

指定したHTML要素に含まれるすべてのWijmoコントロールを無効化します。

このメソッドは、コントロールの表示状態やサイズを変更する動的なパネルをアプリケーションで使用している場合に使用します。たとえば、スプリッタ、アコーディオン、およびタブコントロールは通常、その中の要素の表示状態を変更します。この場合、その要素に含まれるコントロールに通知しないと、それらのコントロールが適切に機能しなくなる可能性があります。これが起こる場合は、動的コンテナーで適切なイベントを処理し、 Control.invalidateAll メソッドを呼び出してコンテナー内のWijmoコントロールのレイアウト情報が適切に更新されるようにする必要があります。

引数
- オプション e: HTMLElement
  
  コンテナー要素。nullに設定すると、ページ上に存在するすべてのWijmoコントロールが無効化されます。
戻り値 void

静的 refreshAll

refreshAll(e?: HTMLElement): void

継承元 Control.refreshAll

HTML要素で存在するすべてのWijmoコントロールを更新する。

コントロールが時間おいて更新される代わりに直ちに更新されること以外はinvalidateAll メソッドと同様です。

引数
- オプション e: HTMLElement
  
  コンテナー要素。nullに設定すると、ページ上に存在するすべてのWijmoコントロールが無効化されます。
戻り値 void

イベント

gotFocus

gotFocus: Event<Control, EventArgs>

コントロールがフォーカスを取得したときに発生します。

invalidInput

invalidInput: Event<Control, CancelEventArgs>

無効な文字が入力されたときに発生します。

ユーザーが入力した値が適切な種類に変換できない値、または有効な範囲外の値を貼り付ける場合、無効な入力エラーが発生する場合があります。

イベントハンドラーがイベントをキャンセルする場合、ユーザーがエラーを修正できるように、コントロールは無効なコンテンツとフォーカスを保持します。

イベントがキャンセルされない場合、コントロールは無効な入力エラーを無視し、元のコンテンツを保持します。

lostFocus

lostFocus: Event<Control, EventArgs>

コントロールがフォーカスを失ったときに発生します。

refreshed

refreshed: Event<Control, EventArgs>

コントロールが内容を更新した後で発生します。

refreshing

refreshing: Event<Control, EventArgs>

コントロールが内容を更新する直前に発生します。

valueChanged

valueChanged: Event<Gauge, EventArgs>

value プロパティの値が変更されたときに発生します。

Wijmo_Angular2_Gauge.Wjlineargauge

WjLinearGauge クラス

階層

プロパティ

メソッド

イベント

プロパティ

asyncBindings

direction

face

faceBounds

Example

format

getText

gotFocusNg

handleWheel

hasShadow

hostElement

initialized

invalidInputNg

isAnimated

isDisabled

isInitialized

isReadOnly

isTouching

isUpdating

lostFocusNg

max

min

origin

pointer

ranges

refreshedNg

refreshingNg

rightToLeft

showRanges

showText

showTickText

showTicks

stackRanges

step

tabOrder

thickness

thumbSize

tickSpacing

value

valueChangePC

valueChangedNg

wjModelProperty

静的 controlTemplate

メソッド

applyTemplate

引数

classNames: string

template: string

parts: Object

オプション namePart: string

戻り値 HTMLElement

beginUpdate

戻り値 void

containsFocus

戻り値 boolean

created

戻り値 void

deferUpdate

引数

fn: Function

戻り値 void

dispose

戻り値 void

endUpdate

引数

オプション shouldInvalidate: boolean

戻り値 void

focus

戻り値 void

getTemplate

戻り値 string

hasOwnProperty

引数