Dialog

Dialog (クラス)

            public Dialog
            {inherits StandardActiveTraversalContainer, ControlContainer, CommandBinding}

インポート元： CURL.GUI.STANDARD. package 内で定義されています CURL.GUI.CONTROL-BASE.

直接継承しているサブクラス: RecordForm, HttpForm, RecordSetDisplayNavigationPanel

Control を含み、フォームレベルのアクションを処理するコンテナ。

説明

Dialog は Control に使用される通常のコンテナです。タブ、ニーモニック、開く、閉じるをモーダルウィンドウまたは非モーダルウィンドウとして処理します。

グラフィカルで見ると、これは Frame であるため、HBox や Table などのレイアウトオブジェクトは Dialog の直接のグラフィカルな子になる必要があります。

注意事項

このオブジェクトは、"Dialog"のスタイルルールを記述することによってスタイル化されます。

コンストラクタ

default:

バインドする新しい Dialog オブジェクトを作成します。

コンストラクタ public

{Dialog.default

use-look-and-feel?:bool = true,
bound-command:#Command = null,
...

}

プロパティ

_controls:

格納された Control の追跡に使用される実際の配列。

フィールド protected Dialog._controls:{Array-of Control} ={{Array-of Control}}

controls:

この Dialog に含まれる Control の反復子。

アクセサ public Dialog.controls:{Iterator-of Control}

look-and-feel:

オプションの検索と ControlUI の指定に使用される LookAndFeel。

非ローカルオプション public Dialog.look-and-feel:LookAndFeel

open?:

この Dialog は開いていますか?

フィールド public-get private-set Dialog.open?:bool =false

options-present-here:

このオブジェクトに存在する全てのオプションのイテレータを返します。オプションは、ローカルで設定されていても、スタイルシートで設定されていても、LookAndFeel で設定されていても、適切であれば全て含まれます。

アクセサ public Dialog.options-present-here:{Iterator-of OptionItem}

return-state:

Dialog が閉じられた後の、その状態。

フィールド public Dialog.return-state:#String =null

style-element:

スタイリングの目的のための、この Visual の "要素" や "型" です。

アクセサ public Dialog.style-element:String

use-look-and-feel?:

look-and-feel オブジェクトまたは標準のオプション親のどちらがダイアログの外観の基準になるかを決定します。

アクセサ public Dialog.use-look-and-feel?:bool

セッター public Dialog.use-look-and-feel?:bool

プロパティ継承 StandardActiveTraversalContainer: _current-active, current-active, repeat-traversal?, traversors

プロパティ継承 CommandBinding: bound-command, bound-command-impl

プロパティ継承 StandardActiveTraversor: focus-object

プロパティ継承 Frame: clonable-class?, halign, halign-spec, hstretch?, hstretch?-spec, valign, valign-spec, vstretch?, vstretch?-spec

プロパティ継承 ActiveTraversor: _active-traversal-container, active-traversal-container, mnemonic, tab-index, takes-focus?, valid?, validation-result

プロパティ継承 BaseFrame: child, completely-clonable-children?, graphical-children, ordered-children, reverse-ordered-children, width-first?

プロパティ継承 DataBindingTarget: data-binding-context, data-bindings

プロパティ継承 EventTarget: event-handlers

プロパティ継承 Visual: _style-element, cursor, data-source, dragee, font-size, graphical-parent, has-key-focus?, input-method-enabled?, input-method-keyboard-mode, name, options, style-class, style-manager, style-options, test-child?, test-description, test-name, test-parent?, test-type-name, test-visible?, tooltip, user-data

プロパティ継承 OptionListInterface: option-register-proc, registered-option-keys

プロパティ継承 GetBoundsBox: layout-locally-valid?, layout-valid?

プロパティ継承 Box: clip-child-shadows?

クラス変数と定数

cancel:

ダイアログが [キャンセル] ボタンで閉じられたときの Dialog.return-state の標準値 (cancel-button を参照してください)。

public constant Dialog.cancel:String ="cancel"

done:

ダイアログが [完了] ボタンで閉じられたときの Dialog.return-state の標準値 (done-button を参照してください)。

public constant Dialog.done:String ="done"

no:	ダイアログが [いいえ] ボタンで閉じられたときの Dialog.return-state の標準値 (no-button を参照してください)。

public constant Dialog.no:String ="no"

ok:	ダイアログが [OK] ボタンで閉じられたときの Dialog.return-state の標準値 (ok-button を参照してください)。

public constant Dialog.ok:String ="ok"

yes:

ダイアログが [はい] ボタンで閉じられたときの Dialog.return-state の標準値 (yes-button を参照してください)。

public constant Dialog.yes:String ="yes"

メソッド

close:

Dialog.show で表された Dialog を閉じます。

public

{Dialog.close state:String}:void

get-by-name:

含まれている Control を名前で検索します。

public final

{Dialog.get-by-name name:String}:#Control

handle-look-and-feel-change:

look-and-feel が変更されたときに必要な調整を行います。

protected

{Dialog.handle-look-and-feel-change

old:LookAndFeel,
new:LookAndFeel

}:void

handle-observer-message:

監視対象のオブジェクトがメッセージを送信するときにこのメソッドを呼び出します。Observer はこのメソッドを実装して、変更が発生したときに処理を実行する必要があります。

protected

{Dialog.handle-observer-message

sender:Observable,
message:any

}:void

option-lookup-here:

オプション検索ステップを実行します。

public

{Dialog.option-lookup-here

key:OptionKey,
local?:bool

}:(item:#OptionItem, local-key?:bool)

option-propagate-notify:

バインディングオプションに、このオブジェクトがオプションの親から継承した変更が存在する場合に呼び出されます。

public

{Dialog.option-propagate-notify

item:OptionItem,
removed?:bool

}:void

register-control:

Control をこの ControlContainer に登録します。

public

{Dialog.register-control c:Control}:void

reset:

この Dialog 内のすべてのコントロールと Dialog 自体に Reset イベントを送ります。

public

{Dialog.reset}:void

show:

独自のウィンドウにダイアログを表示します。

public

{Dialog.show

title:String = {host-localize "Pop-up Window"},
modal?:bool = true,
center?:bool = true,
owner:#View = {View.get-default-owner},
style:DialogStyle = DialogStyle.standard,
large-icon:#Pixmap = null,
small-icon:#Pixmap = null

}:void

show-at-xy:

ウィンドウ内の設定された位置にダイアログを表示します。

public

{Dialog.show-at-xy

title:String = {host-localize "Pop-up Window"},
modal?:bool = true,
owner:#View = {View.get-default-owner},
style:DialogStyle = DialogStyle.standard,
large-icon:#Pixmap = null,
small-icon:#Pixmap = null,
x:Distance,
y:Distance

}:void

unregister-control:

Control をこの ControlContainer から登録解除します。

public

{Dialog.unregister-control c:Control}:void

メソッド継承 StandardActiveTraversalContainer: add-internal, become-active, become-active-from-traversal, dispatch-mnemonic, get-sorted-traversors, internal-remove-child, on-key-press, react-to-child-change, register-active-traversor, traverse, traverse-from-visual, unregister-active-traversor

メソッド継承 ControlContainer: commit

メソッド継承 ActiveTraversalContainer: insist-active

メソッド継承 StandardActiveTraversor: fire-event-at-container, handle-mnemonic, on-focus-in

メソッド継承 Frame: add, clone-appearance-helper, remove-child

メソッド継承 GraphicOptions: any-to-Distance, get-display-context

メソッド継承 GuiEventTarget: handle-delegate-event, handle-event, on-action, on-cancel-mode, on-command-changed, on-commit, on-composition-change-event, on-composition-result-event, on-context-menu-event, on-current-record-change-request, on-current-record-changed, on-destroy-notify, on-destroy-requested, on-drag-over, on-drag-pointer, on-drag-started, on-drop, on-end-composition-event, on-focus-event, on-focus-out, on-gesture, on-gesture-begin, on-gesture-end, on-gesture-magnify, on-gesture-pan, on-gesture-rotate, on-gesture-swipe, on-gesture-tap, on-gesture-touch, on-grab-release, on-gui-event, on-input-method-event, on-key-event, on-pointer-button, on-pointer-crossing, on-pointer-event, on-pointer-motion, on-pointer-press, on-pointer-release, on-pointer-scroll, on-raw-key-event, on-raw-key-press, on-raw-key-release, on-reset, on-selectable-added, on-selectable-removed, on-selection-changed, on-selection-context-activated, on-selection-context-deactivated, on-selection-event, on-start-composition-event, on-start-event, on-stop-event, on-view-activate, on-view-deactivate, on-window-close, remove-event-handlers-for-event-class

メソッド継承 Observer: observe, stop-observing

メソッド継承 ActiveTraversor: mark-invalid, mark-valid, request-key-focus

メソッド継承 DataBindingTarget: add-data-binding, get-data-binding, refresh-data-binding, remove-data-binding, unset-property, update-data-binding, validate-data-binding

メソッド継承 EventTarget: accepts-event-class?, add-event-handler, event-handler-present?, remove-event-handler, verify-event

メソッド継承 BasicBox: contains-point?, find-graphic-at, handle-crossing, on-pointer-envelope-event, pointer-enter-occurred, pointer-leave-occurred

メソッド継承 BasicEventTarget: enqueue-event

メソッド継承 GetBoundsBox: get-bounds, get-elastic-bounds-into, get-nonparent-bounds-into, request-layout, validate-layout

メソッド継承 InitRestArgParser: process-rest-args

メソッド継承 Box: clear, compare-children, find-test-children, get-delimited-child-text-selection, get-gui-path-to-child, get-range-as-selected-text, get-visible-rect-in-root-into, graphical-child-visible-at, make-gui-mark, search-next-here, search-prev-here

メソッド継承 Object: object-describe, object-describe-for-debugging, object-serialize

コンストラクタ詳細

default (コンストラクタ)

public

{Dialog.default

use-look-and-feel?:bool = true,
bound-command:#Command = null,
...

}

バインドする新しい Dialog オブジェクトを作成します。

use-look-and-feel?:

look-and-feel オブジェクトまたは標準のオプション親のどちらがダイアログの外観の基準になるかを決定します。

詳細は Dialog.use-look-and-feel? を参照してください。

bound-command: バインドするbound-command,Command。CommandBinding を参照してください。

...: 残余引数は StandardActiveTraversalContainer に渡され、そこから Frame に渡されます。

プロパティ詳細

_controls (フィールド)

protected Dialog._controls:{Array-of Control} ={{Array-of Control}}

格納された Control の追跡に使用される実際の配列。

controls (アクセサ)

アクセサ public Dialog.controls:{Iterator-of Control}

この Dialog に含まれる Control の反復子。

説明

ループや次のようなコードに使用できる反復子を返します。

{for c:Control in d.controls do
    set c.enabled? = false
}

look-and-feel (非ローカルオプション)

public Dialog.look-and-feel:LookAndFeel

オプションの検索と ControlUI の指定に使用される LookAndFeel。

説明

参照：Dialog.use-look-and-feel?

open? (フィールド)

public-get private-set Dialog.open?:bool =false

この Dialog は開いていますか?

説明

これはダイアログが表示される場合は true に、ダイアログが何らかの方法で閉じられている場合は false に設定されます。

options-present-here (アクセサ)

アクセサ public Dialog.options-present-here:{Iterator-of OptionItem}

オーバーライド

option-lookup-here メソッドをオーバーライドする場合は、このメソッドもオーバーライドしなければなりません。通常、option-lookup-here はバインディングオプションに追加されたオプションを(テーブルセルの行列のバインドのように)検索し、このメソッドのオーバーライドは、バインディングオプションを Iterator で返します。

導入: バージョン 6.0

return-state (フィールド)

public Dialog.return-state:#String =null

Dialog が閉じられた後の、その状態。

説明

これは初めは null です。ダイアログが表示されているときも null に設定されています。(Dialog.close を使用して) ダイアログが閉じられた場合には、Dialog.ok、Dialog.cancel、または、他の適切なストリングに設定する必要があります。

ダイアログが暗黙的に閉じられる場合 (たとえば、クローズボックスを使用するか、モーダルダイアログの場合にエスケープキーが押されたなど)、Dialog.return-state は null になります。

つまり、閉じられるダイアログに応答する場合は、WindowClose の EventHandler 内か、modal?= true の状態でこのメソッドを呼び出したコード内のどちらかで、Dialog.return-state の値が null であるかどうかを調べ、ダイアログが暗黙的に閉じられたかどうかを判定する必要があります。

style-element (アクセサ)

アクセサ public Dialog.style-element:String

スタイリングの目的のための、この Visual の "要素" や "型" です。

説明

この実装によって Visual._style-elementの値が返されますが、通常は定数を返すためにオーバーライドされます。

オーバーライド

Visual のサブクラスのスタイルが他のオブジェクトと異なる場合、このゲッターは適切な文字列を返すようにオーバーライドされる必要があります。慣例では,この文字列はクラス名または、オブジェクトを生成するマークアップの名前です。

オーバーライドでは、空の文字列でないかぎり、self._style-elementを返さなければなりません。

導入: バージョン 6.0

use-look-and-feel? (アクセサ)

アクセサ public Dialog.use-look-and-feel?:bool

セッター public Dialog.use-look-and-feel?:bool

look-and-feel オブジェクトまたは標準のオプション親のどちらがダイアログの外観の基準になるかを決定します。

説明

このプロパティが true の場合、ローカルおよび非ローカルの両オプションは、ローカル検索の後に、ダイアログの look-and-feel オブジェクト内で検索されます。

非ローカルオプションの場合において、この検索がダイアログのオプション親で通常行われる検索よりも前に行われる点に注意してください。これは、look-and-feel で設定された非ローカルオプションが、このプロパティが true ならば通常はダイアログのグラフィカルな親から継承するオプション設定を隠蔽してしまうことを意味します。

look-and-feel が StandardLookAndFeel である一般的な場合に影響を受けるオプションのリストについては、StandardLookAndFeel の説明を参照してください。

このプロパティを使って、Dialog の内容とコントロールの書式設定を、有効な look-and-feel の書式か、ダイアログのグラフィカルな親のどちらに一致させるか簡単に切り替えることができます。

この既定値は true です。またこの設定内容は、コントロールの ControlUI のソースとしての look-and-feel の使用には影響を与えません。

詳細は、look-and-feel と LookAndFeel を参照してください。

例

{Frame background={FillPattern.get-wheat},
    {Dialog
        || Don't use user preferences as default values.
        use-look-and-feel?=false,
        {spaced-vbox
            halign="center",
            {center Click the button below for a friendly message.},
            {CommandButton label = "Click Here",
                {on Action do
                    {popup-message "You've clicked a button!",
                        title = "Friendly Message"}
                }
            }
        }
    }
}

{Frame
    background={FillPattern.get-wheat},
    {Dialog
        || The default value is true anyway
        use-look-and-feel?=true,
        {spaced-vbox
            halign="center",
            {center Click the button below for a friendly message.},
            {CommandButton label = "Click Here",
                {on Action do
                    {popup-message "You've clicked a button!",
                        title = "Friendly Message"}
                }
            }
        }
    }
}

クラス変数と定数の詳細

cancel (クラス定数)

public constant Dialog.cancel:String ="cancel"

ダイアログが [キャンセル] ボタンで閉じられたときの Dialog.return-state の標準値 (cancel-button を参照してください)。

注意事項