ウィジェットの基礎

ウィジェットは GUIKit で構築するGUIの基本コンポーネントである．このチュートリアルでは，ウィジェットの基本的ないくつかの点と，それらがどのように働くかについて説明する．ウィジェットに関するより詳しい情報は「定義構築ブロック」を参照のこと．

これは，3つのボタンが付いたパネルからなる基本的なウィジェットを作る．これは，まだ何も表示しない．

以下で，上記のウィジェットを実行する．これで，パネルがスクリーンに表示されるはずである．

GUIRunの結果はGUIObject式である．これはGUIを実行するハンドルとして使うことができる．

GUIScreenShotはGUIObject式を取り，GUIがスクリーン上でどのように見えるかを示す画像を返す．表示された画像の方が使用中のシステムにとって相応しいかもしれない．

ウィジェットの命名

GUIKit の重要な特徴のひとつはウィジェットに名前を付けられることである．

以下でウィジェットを作成・実行し，これに名前を与える．

GUIInformationはGUIObject式を取り，その内部情報を返す．この例ではGUIObjectからすべての名前付きウィジェットを取り出す．名前はMyWidgetというものひとつしかない．

ウィジェットの名前は多くの場所でGUIのスクリプトに使われる．

ウィジェットの特性

特性を通したウィジェットの操作は GUIKit のキーコンセプトである．インターフェース中のウィジェットにどんな特性があるかを見付け，その現行値のクエリを行い，それに変更を加えるのを助けるための特性に基づいた関数がたくさんある．

次で，2つの名前付きウィジェットを持つGUIを実行する．

これは，2つの名前付きウィジェットがあることを示している．

これは，ダイアログで"button1"によって参照されているウィジェットに使えるすべての特性名のリストを要求している．

ToStringとToExpressionをSetPropertyValueとともに使ってStringへの変換を含むようにすることができる．あるいは ToStringやToExpressionに見られる一般的なオプショナルの引数を使ってWolfram言語式の値に変換することができる．次はテキスト特性を変換する．新たな値が即座に表示される．

特性値はウィジェットへの参照から直接抽出することができる．

次は，返された特性値が文字列であることを示している．

J/Link で定義されているように等価のWolfram言語式を自動的に持つ特性値を返すようにすることもできるし，PropertyValueを使って設定することもできる．

ウィジェットのその他の詳細

名前と特性に加え，ウィジェットにはGUIの作成にとって重要なその他の数多くの特性がある．これらについてはGUIObject参照を使って調べることができる．

次は，組込みのGUIを実行する．

次は，インターフェースの動的なスナップショットを示す．

一意的な文字列名で登録されたインターフェース内のすべてのウィジェットのリストを取り出し，これらのウィジェットインスタンスをこれらの参照名で参照することができる．

次は，"inputField"という名前で登録されているウィジェットが使えるすべての特性名を求める．PropertyValue[{"inputField","propertyName"}]およびSetPropertyValue[{"inputField","propertyName"},newValue]を使ってこれらの値のクエリを行ったり設定したりすることができる．

InvokeMethod[{"inputField","methodName"},arguments]でこのウィジェットに実行できるメソッド名にどんなものがあるかを見付けることもできるし，文字列パターンを使ってこれらの名前にフィルタを掛けることもできる．

これらに加え，イベントが起るたびにWolfram言語コードを実行するのにどんなイベント名が使えるかを BindEvent[{"inputField","eventName"},Script[code]]を使って調べることができる．