[]
【重要】2024年1月公開のアップデート「未適用」のお客様へ デモ ヘルプ APIリファレンス
トライアル版
(Showing Draft Content)

Wijmo_Olap.Detaildialog

DetailDialog クラス

グリッドセルの詳細の表示に使用されるダイアログを表します。

階層

コンストラクタ

プロパティ

メソッド

イベント

コンストラクタ

constructor

  • new DetailDialog(element: any, options?: any): DetailDialog

  • DetailDialog クラスの新しいインスタンスを初期化します。

    引数

    • element: any

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

    • オプション options: any

      コントロールの初期化データを含むJavaScriptオブジェクト。

    戻り値 DetailDialog

プロパティ

cellHeader

cellHeader: string

表示されている値のセルヘッダーを取得します。

この情報はダイアログが表示される前に更新され、詳細グリッドの上部に表示されます。

cellValue

cellValue: string

表示されている値の書式設定されたセル値を取得します。

この情報はダイアログが表示される前に更新され、詳細グリッドの上部に表示されます。

columnHeader

columnHeader: string

表示されている値の列ヘッダーを取得します。

この情報はダイアログが表示される前に更新され、詳細グリッドの上部に表示されます。

content

content: HTMLElement

このPopup に含まれるHTML要素を取得または設定します。

detailCount

detailCount: number

詳細ダイアログに表示される項目数を取得します。

この情報はダイアログが表示される前に更新され、ダイアログヘッダーに表示されます。

dialogResult

dialogResult: any

Popup を非表示にした後に、そのコンテンツを処理するために使用できる値を取得または設定します。

このプロパティは、Popup が表示されたときにnullに設定され、ボタンクリックイベントに 応答して、またはhide メソッドの呼び出しの中で設定できます。

dialogResultEnter

dialogResultEnter: any

Popup 表示中にユーザーが［Enter］キーを押したときにdialogResult として 使用される値を取得または設定します。

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

ユーザーが［Enter］を押し、dialogResultEnter プロパティがnullでない場合、 ポップアップは、すべての子要素が有効な状態かどうかをチェックします。 有効な状態の場合は、ポップアップが閉じ、dialogResult プロパティが dialogResultEnter プロパティの値に設定されます。

dialogResultSubmit

dialogResultSubmit: string

ダイアログがフォーム要素によってホストされ、 ユーザーがフォームを送信するときにdialogResultとして使用される文字列を取得または設定します。

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

このプロパティを空でない文字列に設定すると、コントロールは フォームのsubmitイベントを処理し、フィールドを検証し、 指定した値に設定されたdialogResultでフォームを閉じます。 例えば：

let dlg = new Popup('#theForm', {
    dialogResultSubmit: 'ok'
});
dlg.show(true, () => {
    if (dlg.dialogResult == dlg.dialogResultSubmit) {
        // フォームは有効です。ここで結果を処理します
    }
});

また、Popupがフォーム以外の要素でホストされている場合に使用できるdialogResultEnterプロパティを参照してください。

fadeIn

fadeIn: boolean

Popup を表示するときにフェードインアニメーションを使用する かどうかを決定する値を取得または設定します。

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

fadeOut

fadeOut: boolean

Popup を非表示にするときにフェードアウトアニメーションを使用する かどうかを決定する値を取得または設定します。

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

hideTrigger

hideTrigger: PopupTrigger

Popup を非表示にするアクションを取得または設定します。

このプロパティのデフォルト値はPopupTrigger.Blurです。 フォーカスを失った場合、またはEscキーを押した時にポップアップが非表示になります。

hideTrigger プロパティをPopupTrigger.Click に設定すると、ポップアップはオーナ要素を クリックする場合、またはEscキーを押した時非表示になります。 hideTriggerプロパティをPopupTrigger.Leaveに設定すると、マウスがポップアップまたはその所有者要素を離れた後、ポップアップは短い間隔で非表示になります。 hideTriggerプロパティをPopupTrigger.Noneに設定した場合、 ポップアップはhideメソッドが呼び出されたとき、

またはユーザーがEscapeキーを押したときにのみ非表示になります。

hostElement

hostElement: HTMLElement

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

isDisabled

isDisabled: boolean

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

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

isDraggable

isDraggable: boolean

ポップアップをそのヘッダーでマウスによって ドラッグできるかどうかを示す値を取得または設定します。

ヘッダは、 '.wj-dialog-header' または '.modal-header'のCSSセレクタによって識別されます。 ダイアログに 'wj-dialog-header' または '.modal-header'クラスを持つ要素が含まれていない場合、 ユーザーがポップアップをドラッグすることができません。

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

isResizable

isResizable: boolean

ポップアップを端からマウスでドラッグしてサイズを変更できるかどうかを決定する値を取得または設定します。

ホスト要素のmax-width、min-width、max-height、およびmin-heightのCSSプロパティを設定して、 ポップアップのサイズを制限できます。

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

isTouching

isTouching: boolean

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

isUpdating

isUpdating: boolean

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

isVisible

isVisible: boolean

Popup が現在表示されているかどうかを決定する値を取得します。

modal: boolean

Popup をモーダルダイアログとして表示するかどうかを決定する値を 取得または設定します。

モーダルダイアログは、Popup がページ内の他のコンテンツより目立つように、 暗い背景が付けられます。

ダイアログを完全にモーダルにするには、Popup.hideTrigger プロパティを PopupTrigger.None に設定して、ユーザーが背景をクリックしても ダイアログを閉じることができないようにします。この場合は、Popup.hide メソッドが呼び出されるか、 ユーザーが［Esc］キーを押した場合にのみ、ダイアログが閉じられます。

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

owner

owner: HTMLElement | null

Popup を所有する要素を取得または設定します。

オーナーがnullの場合、ポップアップはダイアログとして動作します。 ダイアログは、画面の中央に配置され、 show メソッドを使用して表示する必要があります。

position

position: PopupPosition

オーナ要素に対してポップアップを表示する必要があるPopupPositionを取得または設定します。

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

removeOnHide

removeOnHide: boolean

Popupを単に非表示にするのではなく、非表示にするときに{@linkPopup}ホスト要素を非表示にするか、DOMから削除するかどうかを決定する値を取得または設定します。

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

removeOnHideは、Popupが非表示になっている場合は、DOMからPopup要素を削除しますが、作成時に削除しないことに注意してください。

Popupにアクセスキー（accesskey属性）を持つ要素が含まれている場合、Popupが表示されていないときにアクティブ化する必要がありません。 Popupは、作成後にDOMから削除します。 例えば：

import { Popup} from '@grapecity/wijmo.input';
import { removeChild } from '@grapecity/wijmo';
// ポップアップを作成します
let popup = new Popup('#popup', {
    owner: '#show'
});

// accesskey要素にイベントハンドラを追加します（accesskey要素はDOMにあります）
document.getElementById('alert').addEventListener('click', e => alert('hi'));

// ポップアップ（およびアクセスキー要素）をDOMから削除します
// そのため、ポップアップが表示されるまでアクセスキーは機能しません
removeChild(popup.hostElement);

rightToLeft

rightToLeft: boolean

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

rowHeader

rowHeader: string

表示されている値の行ヘッダーを取得します。

この情報はダイアログが表示される前に更新され、詳細グリッドの上部に表示されます。

showTrigger

showTrigger: PopupTrigger

Popup を表示するアクションを取得または設定します。

このプロパティのデフォルト値はPopupTrigger.ClickOwnerです。 オーナー要素をクリックすると、ポップアップが表示されます。

showTrigger プロパティをPopupTrigger.None に設定すると、 ポップアップはshow メソッドを呼び出すのみで表示されます。

tabOrder

tabOrder: number

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

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

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

静的 controlTemplate

controlTemplate: string

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

メソッド

addEventListener

  • addEventListener(target: EventTarget, type: string, fn: any, capture?: boolean, passive?: boolean): void

  • このControl が所有する要素にイベントリスナーを追加します。

    コントロールは、アタッチされているリスナーとそのハンドラのリストを保持し、 コントロール が破棄されているときにそれらを簡単に削除すること ができます（dispose と removeEventListener ) メソッドを参照してください）。

    イベントリスナーを削除しないと、メモリリークが発生する可能があります。

    デフォルトでは passive パラメータはfalseに設定されています。これはイベントハンドラが event.preventDefault() を呼び出すことを意味します。 タッチイベントまたはマウスホイールイベントにpassiveハンドラを追加する場合は、このパラメータをtrueに設定するとアプリケーションのパフォーマンスが向上します。

    passive　イベントリスナーの詳細については、「Improving scrolling performance with passive listeners」を参考してください。

    引数

    • target: EventTarget

      イベントのターゲット要素。

    • type: string

      イベントを指定する文字列。

    • fn: any

      イベントが発生したときに実行する関数。

    • オプション capture: boolean

      リスナーがターゲット要素によって処理される前にコントロールによって処理される必要があるかどうかを示します。

    • オプション passive: boolean

      ハンドラーが preventDefault() を呼び出さないことを示します。

    戻り値 void

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', 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

containsFocus

  • containsFocus(): boolean

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

    戻り値 boolean

deferUpdate

  • deferUpdate(fn: Function): void

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

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

    引数

    • fn: Function

      実行する関数。

    戻り値 void

endUpdate

  • endUpdate(): void

focus

  • focus(): void

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

    戻り値 void

getTemplate

  • getTemplate(): string

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

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

    戻り値 string

hasOwnProperty

  • hasOwnProperty(v: PropertyKey): boolean

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

    引数

    • v: PropertyKey

      プロパティの名前。

    戻り値 boolean

hide

  • hide(dialogResult?: any): void

  • Popup を非表示にします。

    引数

    • オプション dialogResult: any

      Popup　を閉じる前に　dialogResult　プロパティに割り当てられる オプションの値。

    戻り値 void

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

onDragged

onDragging

onGotFocus

onHidden

onHiding

onInvalidInput

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

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

    引数

    戻り値 boolean

onPositionChanged

onPositionChanging

onRefreshed

onRefreshing

onResized

onResizing

onShowing

onShown

onSizeChanged

onSizeChanging

propertyIsEnumerable

  • propertyIsEnumerable(v: PropertyKey): boolean

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

    引数

    • v: PropertyKey

      プロパティの名前。

    戻り値 boolean

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

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

show

  • show(modal?: boolean, handleResult?: Function): void

  • Popup を表示します。

    引数

    • オプション modal: boolean

      ポップアップをモーダルダイアログとして表示するかどうか。 指定した場合、その値がmodal プロパティに設定されます。

    • オプション handleResult: Function

      ポップアップが非表示になると、コールバックが呼び出されます。 コールバックが指定されている場合は、パラメータとしてポップアップを受け取ります。

      handleResult コールバックを使用すると、 hidden イベントにハンドラを アタッチしなくても、呼び出し元がモーダルダイアログの結果を処理できます。 たとえば、 以下のコードは、CollectionView 内の現在の項目を編集するための ダイアログを表示します。 編集結果は、 Popup.dialogResult 値に応じてコミット またはキャンセルされます。 次に例を示します。

      function editCurrentItem(popupEditor: Popup, view: CollectionView) {
    view.editItem(view.currentItem);
    popupEditor.show(true, (e: Popup) => {
        if (e.dialogResult == 'wj-hide-ok') {
            view.commitEdit();
        } else {
            view.cancelEdit();
        }
    });
}

    戻り値 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

イベント

dragged

dragged: Event<Popup, EventArgs>

Popup がドラッグされた後に発生します。

isDraggableプロパティも参考してください。

dragging

dragging: Event<Popup, CancelEventArgs>

Popupがドラッグされようとしているときに発生します。

isDraggableプロパティも参考してください。

gotFocus

gotFocus: Event<Control, EventArgs>

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

hidden

hidden: Event<Popup, EventArgs>

Popup が非表示になる後に発生します。

hiding

hiding: Event<Popup, CancelEventArgs>

Popup が非表示になる前に発生します。

invalidInput

invalidInput: Event<Control, CancelEventArgs>

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

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

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

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

lostFocus

lostFocus: Event<Control, EventArgs>

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

positionChanged

positionChanged: Event<Popup, EventArgs>

ユーザーがPopupを移動するときに発生します。つまり、draggingイベントとdraggedイベントの間。

ユーザーが Popup をドラッグすると、次のイベントが発生します。

  • dragging （1 回だけ発生する、キャンセルできます）
  • positionChanging （ユーザーがマウスを動かすと数回発生する、キャンセルできます）
  • positionChanged （ユーザーがマウスを動かすと数回発生します)
  • dragged （サイズ変更の処理が完了した後に1 回だけ発生します)

isDraggable プロパティも参考してください。

positionChanging

positionChanging: Event<Popup, PopupBoundsChangingEventArgs>

ユーザーがPopupを移動するときに発生します。つまり、draggingイベントとdraggedイベントの間。

ユーザーが Popup をドラッグすると、次のイベントが発生します。

  • dragging （1 回だけ発生する、キャンセルできます）
  • positionChanging （ユーザーがマウスを動かすと数回発生する、キャンセルできます）
  • positionChanged （ユーザーがマウスを動かすと数回発生します)
  • dragged （サイズ変更の処理が完了した後に1 回だけ発生します)

isDraggable プロパティも参考してください。

ユーザーがコントロールをドラッグするときに、positionChangingイベントを使用して、Popupの境界をキャンセルするか変更することができます。

たとえば、次のサンプルコードは、ポップアップを全画面表示に保ち、ユーザーがPopupの一部を画面からドラッグできないようにします。

new Popup('#thePopup', {
    isDraggable: true,
    isResizable: true,
    hideTrigger: 'None',

    // ブラウザウィンドウ内でポップアップを完全に保持します
    positionChanging: (s: Popup, e: PopupBoundsChangingEventArgs) => {
        let bnd = e.bounds;
        bnd.left = Math.max(Math.min(bnd.left, innerWidth + scrollX - bnd.width), scrollX);
        bnd.top = Math.max(Math.min(bnd.top, innerHeight + scrollY - bnd.height), scrollY);
    }
});

refreshed

refreshed: Event<Control, EventArgs>

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

refreshing

refreshing: Event<Control, EventArgs>

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

resized

resized: Event<Popup, EventArgs>

Popup がサイズ変更された後に発生します。

isResizableプロパティも参考してください。

resizing

resizing: Event<Popup, CancelEventArgs>

Popupのサイズが変更されようとしているときに発生します。

isResizableプロパティも参考してください。

showing

showing: Event<Popup, CancelEventArgs>

Popup が表示される前に発生させます。

shown

shown: Event<Popup, EventArgs>

Popup が表示された後に発生させます。

sizeChanged

sizeChanged: Event<Popup, EventArgs>

ユーザーがPopupのサイズを変更するときに発生します。つまり、resizingイベントとresizedイベントの間。

ユーザーが Popup のサイズを変更すると、次のイベントが発生します。

  • resizing （1 回だけ発生する、キャンセルできます）
  • sizeChanging （ユーザーがマウスを動かすと数回発生する、キャンセルできます）
  • sizeChanged （ユーザーがマウスを動かすと数回発生します)
  • resized （サイズ変更の処理が完了した後に1 回だけ発生します)

isResizable プロパティも参考してください。

sizeChanging

sizeChanging: Event<Popup, PopupBoundsChangingEventArgs>

ユーザーがPopupのサイズを変更するときに発生します。つまり、resizingイベントとresizedイベントの間。

ユーザーが Popup をドラッグすると、次のイベントが発生します。

  • resizing （1 回だけ発生する、キャンセルできます）
  • sizeChanging （ユーザーがマウスを動かすと数回発生する、キャンセルできます）
  • sizeChanged （ユーザーがマウスを動かすと数回発生します)
  • resized （サイズ変更の処理が完了した後に1 回だけ発生します)

isResizable プロパティも参考してください。