5.20193.637
WjSunburst Wijmo API クラス

WjSunburst クラス

wijmo.chart.hierarchical.Sunburst コントロールに対応するAngular 2コンポーネント。

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

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

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

wj-sunburst コンポーネントには、wijmo.angular2.chart.WjFlexChartLegend の子コンポーネントを含めます。

階層

プロパティ

binding

binding: string

チャート値を含むプロパティの名前を取得または設定します。

bindingName

bindingName: any

データ項目の名前を含むプロパティの名前を取得または設定します。この名前は配列または文字列である必要があります。

childItemsPath

childItemsPath: any

階層化データの子項目の生成に使用される1つ以上のプロパティの名前を 取得または設定します。

このプロパティには、項目の子項目を含むプロパティの名前を指定する文字列を設定します (たとえば、 'items')。

項目が異なる名前を持つ異なるレベルの子項目の場合は、 このプロパティに、各レベルの子項目を含むプロパティの名前から成る 配列を設定します (たとえば、. [ 'accounts', 'checks', 'earnings' ])。

collectionView

collectionView: ICollectionView

チャートデータを含むICollectionView オブジェクトを取得します。

dataLabel

dataLabel: PieDataLabel

ポイントのデータラベルを取得または設定します。

footer

footer: string

チャートのフッタに表示されるテキストを取得または設定します。

footerStyle

footerStyle: any

チャートのフッタスタイルを取得または設定します。

gotFocusNg

gotFocusNg: EventEmitter<any>

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

header

header: string

チャートのヘッダに表示されるテキストを取得または設定します。

headerStyle

headerStyle: any

チャートのヘッダスタイルを取得または設定します。

hostElement

hostElement: HTMLElement

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

initialized

initialized: EventEmitter<any>

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

innerRadius

innerRadius: number

パイの内側半径のサイズを取得または設定します。

内側半径はパイ半径に対する割合として測定されます。

このプロパティのデフォルト値はゼロです(つまり、円グラフになります)。このプロパティをゼロより大きい値に設定すると、円グラフの中央に穴が開きます(これをドーナツグラフと呼びます)。

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

isAnimated

isAnimated: boolean

項目が選択されたときにアニメーションを使用するかどうかを示す値を取得または設定します。

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

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

isDisabled

isDisabled: boolean

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

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

isInitialized

isInitialized: boolean

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

isTouching

isTouching: boolean

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

isUpdating

isUpdating: boolean

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

itemFormatter

itemFormatter: Function

チャート要素の外観をカスタマイズするための項目書式設定関数を取得または設定します。

指定されている場合、関数は、チャート上に要素を描画するIRenderEngine 、 描画する要素を記述するHitTestInfo パラメータ、 および項目のデフォルトの描画を提供する関数の3つのパラメータを受け取る必要があります。

次に例を示しています。v

itemFormatter: function (engine, hitTestInfo, defaultRenderer) {
  var ht = hitTestInfo,
      binding = 'downloads';

  // 正しい系列/要素であることを確認します
  if (ht.series.binding == binding && ht.pointIndex > 0 &&
      ht.chartElement == ChartElement.SeriesSymbol) {

    // 現在値と前の値を取得します
    var chart = ht.series.chart,
        items = chart.collectionView.items,
        valNow = items[ht.pointIndex][binding],
        valPrev = items[ht.pointIndex - 1][binding];

    // 値が増加している場合は行を追加します
    if (valNow > valPrev) {
      var pt1 = chart.dataToPoint(ht.pointIndex, valNow),
          pt2 = chart.dataToPoint(ht.pointIndex - 1, valPrev);
      engine.drawLine(pt1.x, pt1.y, pt2.x, pt2.y, null, {
        stroke: 'gold',
        strokeWidth: 6
      });
    }
  }

  // 要素を通常通りに描画します
  defaultRenderer();
}

{@sample: Chart/LineArea/CustomLineSegments/purejs Example}

itemsSource

itemsSource: any

チャートの作成に使用されるデータを含む配列またはICollectionView オブジェクトを取得または設定します。

itemsSourceChangedNg

itemsSourceChangedNg: EventEmitter<any>

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

itemsSourceChangingNg

itemsSourceChangingNg: EventEmitter<any>

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

legend

legend: Legend

チャートの凡例を取得または設定します。

lostFocusNg

lostFocusNg: EventEmitter<any>

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

offset

offset: number

スライスのパイ中心からのオフセットを取得または設定します。

オフセットはパイ半径に対する割合として測定されます。

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

palette

palette: string[]

系列の表示に使用されるデフォルトの色の配列を取得または設定します。

配列にはCSSの色を表す文字列が含まれています。 次に例を示します。

// 名前で指定された色を使用します
chart.palette = ['red', 'green', 'blue'];
// または、RGBA値で指定された色を使用します
chart.palette = [
  'rgba(255,0,0,1)',
  'rgba(255,0,0,0.8)',
  'rgba(255,0,0,0.6)',
  'rgba(255,0,0,0.4)'];

Palettes クラスにある事前定義されたパレットのセットを使用できます。次に例を示します。

chart.palette = Palettes.coral;

plotMargin

plotMargin: any

プロットマージン(ピクセル単位)を取得または設定します。

プロットマージンは、コントロールの端からプロット領域の端までの領域を表します。

デフォルトでは、この値は軸ラベルに必要なスペースに基づいて自動的に計算されますが、 コントロール内のプロット領域の位置を精密に制御したい場合(たとえば、 複数のチャートコントロールをページ上に整列させるときなど)はこれをオーバーライドできます。

このプロパティは数値またはCSSスタイルのマージン指定に設定できます。例:

// すべての側のプロットマージンを20ピクセルに設定します
chart.plotMargin = 20;
// 上側、右側、下側、左側のプロットマージンを設定します
chart.plotMargin = '10 15 20 25';
// 上側/下側(10px)および左側/右側(20px)のプロットマージンを設定します
chart.plotMargin = '10 20';

refreshedNg

refreshedNg: EventEmitter<any>

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

refreshingNg

refreshingNg: EventEmitter<any>

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

renderedNg

renderedNg: EventEmitter<any>

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

renderingNg

renderingNg: EventEmitter<any>

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

reversed

reversed: boolean

角度を反転(反時計回り)するかどうかを決定する値を取得または設定します。

デフォルト値はfalseです。この場合、角度は時計回りに測定されます。

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

rightToLeft

rightToLeft: boolean

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

selectedIndex

selectedIndex: number

選択されたスライスのインデックスを取得または設定します。

selectedItemOffset

selectedItemOffset: number

選択されたスライスのパイ中心からのオフセットを取得または設定します。

オフセットはパイ半径に対する割合として測定されます。

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

selectedItemPosition

selectedItemPosition: Position

選択されたスライスの位置を取得または設定します。

このプロパティを'None'以外の値に設定すると、スライスを選択したときに円グラフが回転します。

円グラフをクリックしたときにスライスが選択されるようにするには、 selectionMode プロパティを「Point」に設定する必要があります。

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

selectionChangedNg

selectionChangedNg: EventEmitter<any>

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

selectionMode

selectionMode: SelectionMode

ユーザーがチャートをクリックしたときに何が選択されるかを示す列挙値を取得または設定します。

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

startAngle

startAngle: number

パイスライスの開始角度(度単位)を取得または設定します。

ゲージの掃引角度を取得または設定します。 角度は9時の位置から時計回りに度単位で測定されます。

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

titles

titles: string[]

円のタイトルを取得または設定します。

binding で複数のプロパティが指定されている場合、タイトルは各円グラフの上部に表示されます。 プロパティが設定されていない(未定義)場合、プロパティ名は円グラフのタイトルとして使用されます。

tooltip

tooltip: ChartTooltip

チャートのTooltip を取得します。

wjModelProperty

wjModelProperty: string

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

メソッド

applyTemplate

  • applyTemplate(classNames: string, template: string, parts: Object, namePart?: string): HTMLElement
  • コントロールの新しいインスタンスにテンプレートを適用し、ルート要素を返します。

    このメソッドはテンプレート化されたコントロールのコンストラクターによって呼び出され、 テンプレートのパーツを対応するコントロールメンバにバインドする役割を持ちます。 以下のサンプルコードは、InputNumber コントロールのインスタンスにテンプレートを適用します。 このテンプレートには、'wj-part'属性が'input'、'btn-inc'、および'btn-dec'に設定された要素を含める必要があります。 コントロールのメンバである'_tbx'、'_btnUp'、'_btnDn'には、これらの要素への参照が割り当てられます。

    this.applyTemplate('wj-control wj-inputnumber', template, {
      _tbx: 'input',
      _btnUp: 'btn-inc',
      _btnDn: 'btn-dec'
    }, 'input');

    引数

    • classNames: string

      コントロールのホスト要素に追加するクラスの名前。

    • template: string

      コントロールのテンプレートを定義するHTML文字列。

    • parts: Object

      パーツ変数とその名前のディクショナリー。

    • オプション namePart: string

      ホスト要素にちなんで名付けられたパーツの名前。 これにより、コントロールがフォームで使用されたときにデータをどのように送信するかが決まります。

    戻り値 HTMLElement

beginUpdate

  • beginUpdate(): void

containsFocus

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

    戻り値 boolean

created

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

    戻り値 void

deferUpdate

  • deferUpdate(fn: Function): void
  • beginUpdate/endUpdate ブロック内で関数を実行します。

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

    引数

    • fn: Function

      実行する関数。

    戻り値 void

dispose

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

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

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

    戻り値 void

endUpdate

  • endUpdate(): void

focus

  • focus(): void
  • このコントロールにフォーカスを設定します。

    戻り値 void

getTemplate

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

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

    戻り値 string

hasOwnProperty

  • hasOwnProperty(v: PropertyKey): boolean
  • オブジェクトが指定されたプロパティを持つかどうかを判定します。

    引数

    • v: PropertyKey

      プロパティの名前。

    戻り値 boolean

initialize

  • initialize(options: any): void
  • 指定したオブジェクトからプロパティをコピーしてコントロールを初期化します。

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

    例:

    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
  • 非同期更新を発生させるため、コントロールを無効にします。

    引数

    • オプション fullUpdate: boolean

      内容だけでなくコントロールのレイアウトも更新するかどうか。

    戻り値 void

isPrototypeOf

  • isPrototypeOf(v: Object): boolean
  • オブジェクトが別のオブジェクトのプロトタイプチェーンに存在するかどうかを判定します。

    引数

    • v: Object

      プロトタイプチェーンが判定される別のオブジェクト。

    戻り値 boolean

onGotFocus

onItemsSourceChanged

onItemsSourceChanging

onRefreshed

onRefreshing

onRendered

onRendering

onSelectionChanged

pageToControl

  • pageToControl(pt: any, y?: number): Point
  • ページ座標をコントロール座標に変換します。

    引数

    • pt: any

      ページ座標のポイントまたはページ座標のx値。

    • オプション y: number

      ページ座標のy値。 ptが数値型の場合、値は数値である必要があります。 ただし、ptがPoint型の場合は、yパラメータはオプションになります。

    戻り値 Point

propertyIsEnumerable

  • propertyIsEnumerable(v: PropertyKey): boolean
  • 指定されたプロパティが列挙可能かどうかを判断します。

    引数

    • v: PropertyKey

      プロパティの名前。

    戻り値 boolean

refresh

  • refresh(fullUpdate?: boolean): void
  • チャートを更新します。

    引数

    • オプション fullUpdate: boolean

      内容だけでなくコントロールのレイアウトも更新するかどうかを示す値。

    戻り値 void

removeEventListener

  • removeEventListener(target?: EventTarget, type?: string, fn?: any, capture?: boolean): number
  • このControl が所有する要素にアタッチされている1つまたは複数のイベントリスナーを解除します。

    引数

    • オプション target: EventTarget

      イベントのターゲット要素。 nullの場合、すべてのターゲットにアタッチされているリスナーが解除されます。

    • オプション type: string

      イベントを指定する文字列。 nullの場合、すべてのイベントにアタッチされているリスナーが解除されます。

    • オプション fn: any

      削除するハンドラ。 nullの場合は、すべてのハンドラが削除されます。

    • オプション capture: boolean

      リスナーがキャプチャリスナーかどうか。 nullの場合、キャプチャリスナーと非キャプチャリスナーの両方が解除されます。

    戻り値 number

    The number of listeners removed.

saveImageToDataUrl

  • saveImageToDataUrl(format: ImageFormat, done: Function): void
  • チャートを画像ファイルに保存します。

    このメソッドはIEブラウザでは機能しないことにご注意ください。 IEのサポートが必要な場合は、 flex-chart.render モジュールをページに追加してください。

    引数

    • format: ImageFormat

      エクスポートされる画像のImageFormat

    • done: Function

      データURLの生成後に呼び出される関数。この関数は、引数としてデータURLに渡されます。

    戻り値 void

saveImageToFile

  • saveImageToFile(filename: string): void
  • チャートを画像ファイルに保存します。

    このメソッドはIEブラウザでは機能しないことにご注意ください。 IEのサポートが必要な場合は、 flex-chart.render モジュールをページに追加してください。

    引数

    • filename: string

      拡張子を含む、エクスポートされる画像ファイルの名前。サポートされているタイプは、PNG、JPEG およびSVGです。

    戻り値 void

toLocaleString

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

    戻り値 string

toString

  • toString(): string
  • オブジェクトの文字列表現を返します。

    戻り値 string

valueOf

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

    戻り値 Object

静的 disposeAll

  • disposeAll(e?: HTMLElement): void
  • HTML要素に含まれるすべてのWijmoコントロールを破棄します。

    引数

    • オプション e: HTMLElement

      コンテナー要素。

    戻り値 void

静的 getControl

  • getControl(element: any): Control
  • 指定したDOM要素でホストされているコントロールを取得します。

    引数

    • element: any

      コントロールをホストするDOM要素、またはホスト要素のCSS セレクター(例: '#theCtrl')。

    戻り値 Control

静的 invalidateAll

  • invalidateAll(e?: HTMLElement): void
  • 指定したHTML要素に含まれるすべてのWijmoコントロールを無効化します。

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

    引数

    • オプション e: HTMLElement

      コンテナー要素。nullに設定すると、ページ上に存在するすべてのWijmoコントロールが無効化されます。

    戻り値 void

静的 refreshAll

  • refreshAll(e?: HTMLElement): void
  • HTML要素で存在するすべてのWijmoコントロールを更新する。

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

    引数

    • オプション e: HTMLElement

      コンテナー要素。nullに設定すると、ページ上に存在するすべてのWijmoコントロールが無効化されます。

    戻り値 void

イベント

gotFocus

gotFocus: Event<Control, EventArgs>

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

itemsSourceChanged

itemsSourceChanged: Event<FlexChartBase, EventArgs>

チャートが新しい項目ソースにバインドされた後に発生します。

itemsSourceChanging

itemsSourceChanging: Event<FlexChartBase, CancelEventArgs>

チャートが新しい項目ソースにバインドされる前に発生します。

lostFocus

lostFocus: Event<Control, EventArgs>

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

refreshed

refreshed: Event<Control, EventArgs>

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

refreshing

refreshing: Event<Control, EventArgs>

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

rendered

チャートのレンダリングが完了した後に発生します。

rendering

チャートデータのレンダリングが開始される前に発生します。

selectionChanged

selectionChanged: Event<FlexChartBase, EventArgs>

プログラムコードまたはユーザーがチャートをクリックしたことによって選択が変更された後に発生します。 これは、たとえば詳細情報を示すテキストボックスを更新して現在の 選択を表示するような場合に役立ちます。