UI ツールキット: ツールチップ

ユーザーがページ上のビューの上にカーソルを移動したときにメッセージを表示します。

通常、ツールチップ・ビューは、入力ビューに関する有益なヒントを表示する場合に使用します。ツールチップ・ビューは、他のビュー (「プレーン・テキスト」など) のコンテナーです。

「構成」で、ビューの外観および動作プロパティーを設定または変更します。「イベント」で、数式構成プロパティーを設定します。

画面サイズ: プロパティー名の横に画面サイズ・アイコンがある構成プロパティーは、画面サイズごとに異なる値を持つことができます。値を設定しない場合、画面サイズはそのデフォルト値として次に大きい画面サイズの値を継承します。

テーマ定義: テーマ定義は、ビューの色およびスタイルを指定し、その外観を決定します。ビューのルック・アンド・フィールをテーマ・エディターでプレビューできます。テーマを参照してください。

以下の表に、ツールチップの外観構成プロパティーを示します。

表 1. ツールチップの外観構成プロパティー
外観構成プロパティー	説明	データ・タイプ
ラベルの表示	ラベルを表示します。ツールチップ・ビューにラベルがある場合、そのラベルが表示されます。ツールチップ・ビューにラベルがなく、かつそのツールチップ・ビューに別のビューが含まれている場合、内部にあるビューのラベルが表示されます。「ラベルの表示」が選択されていない場合は、どちらのラベルも表示されません。注: ビューの「ラベルの可視性」プロパティーは無視されます。	`Boolean`
ラベルの配置	ラベルの位置。	`String`
ラベルの幅	ラベルの幅です。幅の単位は px (ピクセル)、% (パーセント)、または em で指定できます。例えば、50px、20%、または 0.4em のようにします。単位タイプが指定されていない場合は、px と見なされます。	`String`
幅	ビューの幅です。幅の単位は px (ピクセル)、% (パーセント)、または em で指定できます。例えば、50px、20%、または 0.4em のようにします。単位タイプが指定されていない場合は、px と見なされます。	`Integer`
色のスタイル	ビューの色のスタイル。色は、指定したテーマの変数に対応します。	`ColorStyle`
水平位置	ツールチップの水平位置決め。
垂直位置	ツールチップの垂直位置決め。

以下の表に、ツールチップの動作構成プロパティーを示します。

表 2. ツールチップの動作構成プロパティー
動作構成プロパティー	説明	データ・タイプ
ツールチップの表示	ページのロード時にツールチップを表示します。	`Boolean`
マウスオーバー時に表示	関連するビューの上にユーザーがカーソルを移動させたときにツールチップを表示します。	`Boolean`
HTML のテキスト	HTML を使用してツールチップ・テキストをレンダリングします。その場合、ツールチップ・テキストを、「一般」タブの「ヘルプ」テキスト・ボックスに入力する必要があります。	`Boolean`

この例では、ツールチップ内にプレーン・テキスト・ビューが配置され、ツールチップ・ビューに対して以下の外観構成プロパティーが設定されています。

イベント:
- 「ツールチップの数式」は "My tooltip"に設定されています。
外観構成:
- 「ラベルの表示」が選択されていません。
- 「ラベルの配置」は「左」に設定されています。
- 「幅」は 50%に設定されます。
- 「色のスタイル」は「デフォルト」に設定されています。
- 「水平位置」は「左」に設定されています。
- 「垂直位置」は「上部」に設定されています。
Behavior 構成:
- 「ツールチップの表示」が選択されています。
- 「マウスオーバー時に表示」は選択されていません。
- 「HTML のテキスト」が選択されています。

上記のように各プロパティー値が設定されている場合、デフォルトのツールチップ・ビューの半分のサイズのツールチップ・エレメントが作成され、「マイ・ツールチップ」というテキストが黒い背景で表示されます。このツールチップ・エレメントは、画面左側のテキスト域の上部に表示され、ページをロードすると即時に表示されます。

注: ツールチップ・ビューはコンテナー・ビューです。ツールチップ・ビューは、実行時に、ネストされたビューの周囲で折り返されます。

「イベント」プロパティーで数式構成プロパティーおよびビューのイベント・ハンドラーの設定や変更を行います。イベントをプログラムでトリガーするかユーザーがビューと対話したときにトリガーするように設定できます。イベントの定義方法およびコーディング方法については、ユーザー定義イベントを参照してください。

以下の表に、ツールチップの数式構成プロパティーを示します。

表 3. ツールチップの数式構成プロパティー
数式構成プロパティー	説明	データ・タイプ
ツールチップの数式	ツールチップ・テキストを計算するための数式または式。数式について詳しくは、数式を参照してください。	`String`

ツールチップには、以下のタイプのイベント・ハンドラーがあります。

On load: ページのロード時にアクティブ化されます。
On click: ツールチップがクリックされたときにアクティブ化されます。

Coach またはページの作成方法については、 Coach の作成を参照してください。
標準プロパティー (「一般」、「構成」、「位置決め」、「可視性」、および「HTML 属性」) について詳しくは、「プロパティーの表示」を参照してください。

ツールチップ

構成プロパティー

例

イベント

方法

その他のリソース