リンク

リンクを使用して、外部 Web ページへのリンクを作成したり、クリックされたときにサービス内に境界イベントを発行するリンクを作成したりします。

データ・バインディング

「一般」プロパティー・タブでコントロールのデータ・バインディングの設定や変更を行います。リンク・コントロールは、ブール変数にバインドすることができます。バインドした場合、そのリンクをクリックすると、変数の値が true に設定されます。

リンク・コントロールを使用して、外部 Web ページにリンクしたり、同じ Coach やコントロール内の異なるコントロールやセクション (テーブル内のリンクなど) に対する相互参照を作成することができます。

構成プロパティー

「構成」プロパティー・タブで、リンク・コントロールの構成プロパティー (外観プロパティーや動作プロパティーなど) の設定や変更を行います。数式構成プロパティーは「イベント」タブで設定します。

画面サイズ: プロパティー名の横に「画面サイズ」アイコンがある構成プロパティーには、画面サイズごとに異なる値を指定できます。値を設定しない場合、画面サイズはそのデフォルト値として次に大きい画面サイズの値を継承します。Process Designer デスクトップ・エディター (非推奨) を使用している場合は、大きい画面サイズにその値を設定していることになります。その他の画面サイズはこの値を継承します。

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

以下の表に、リンク・コントロールの外観構成プロパティーをリストします。

表 1. リンクの外観構成プロパティー
外観構成プロパティー	説明	データ型
幅	リンク・テキストの幅の単位は `px` (ピクセル)、`%` (パーセント)、または `em` で指定します。例えば、`50px`、`20%`、または `0.4em` のようにします。単位タイプが指定されていない場合は、`px` とみなされます。	`ストリング`
テキストの配置	コントロールの幅に応じて、リンク・テキストの配置を指定します。選択可能なオプションは、「`左`」、「`中央`」、「`右`」です。	`ストリング`
色のスタイル	リンクの色のスタイルを指定します。色は、指定したテーマの変数に対応します。この設定はテキストのみに適用され、ラベルには適用されません。	`ストリング`
サイズ・スタイル	テキスト・サイズを指定します。この設定は、ラベルとテキストの両方に適用されます。	`ストリング`
テキストのウェイト	テキスト・ウェイトを指定します。この設定はテキストのみに適用され、ラベルには適用されません。デフォルト細字標準中太字太字	`ストリング`
ラベルの配置	テキストを基準としたラベルの配置を指定します。選択可能なオプションは、`「上部 (Top)」` および `「左 (Left)」` です。ラベルを左側に配置すると、指定したリンクの幅が変更されることに注意してください。	`ストリング`

以下の表に、リンク・コントロールの動作構成プロパティーをリストします。

表 2. リンクの動作構成プロパティー
動作構成プロパティー	説明	データ型
タブ・インデックス	タブ・シーケンスのインデックス。タブのインデックスは 1 から始まり、スパースに設定することができます。例えば、1、5、10 などと指定できます。タブ・インデックス・プロパティーは、タブ・キーを押して Coach エリア間を移動する場合に、タブ・シーケンスをコントロールします。	`整数`
リンク・テキスト	リンクのテキストを指定します。	`ストリング`
複数クリックを防止	ユーザーがリンクを複数回クリックするのを防止します。このプロパティーが適用されるのは、「境界イベント」タイプのリンクだけです。	`ブール`
リンク・タイプ	リンクのタイプを指定します。選択可能なオプションは、次のとおりです。境界イベント: サービス内に境界イベントを発行します。 URL: 外部の Web ページにリンクします。	`ストリング`
リンク URL	リンクの URL アドレス。このプロパティーが適用されるのは、URL タイプのリンクだけです。	`ストリング`
同じウィンドウで開く	指定された URL アドレスを使用して、同じブラウザー・ウィンドウで Web ページを開きます。このプロパティーが適用されるのは、URL タイプのリンクだけです。	`ブール`

例

IBM サポートへのリンクを Coach に追加するには、以下の手順を実行します。

Coach の適切な場所にリンク・コントロールを追加し、そのリンクに対して以下の構成プロパティーを設定します。
1. 「動作」の「リンク・テキスト」フィールドに「IBM サポートに移動」と入力し、「リンク・タイプ」を URL に設定して、「リンク URL」フィールドに「https://www.ibm.com/support」と入力します。「同じウィンドウで開く」はクリアしたままにします。
2. 「外観」で、「テキストの配置」を「左」、「色のスタイル」を「ミュート」、「サイズ・スタイル」を「大」、「テキストのウェイト」を「細字」、「ラベルの配置」を「上部」に設定します。
変更を保存します。

Coach を実行すると、「IBM サポートに移動」というテキストが表示された明るいグレーのリンクが作成されます。このリンクをクリックすると、IBM サポート・ポータルに移動します。

イベント

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

以下の表に、リンク・コントロールの数式構成プロパティーを示します。

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

リンク・コントロールには、以下のタイプのイベント・ハンドラーがあります。

ロード時: ページのロード時にアクティブ化されます。例:
```
me.setText("Link to Google")
```
クリック時: リンクがクリックされたときに、別のページへ移動する前にアクティブ化されます。評価された式から false が返された場合は、リンクをクリックしても境界イベントは起動しません。例:
```
return me.getText() != ""
```
境界イベント時: リンク・コントロールを通じて境界イベントが起動された後に、ページに留まるイベントにフローが到達したときにアクティブ化されます。詳しくは、『Coach ビューのコンテキスト・オブジェクト』トピックの context.trigger() プロパティーを参照してください。例:
```
me.setColorStyle("G")
```

特定のイベントによっては、JavaScript ロジックを使用してコントロールの効果を変更できます。コントロールを含むイベントの使用についての追加情報は、トピック『ユーザー定義イベント』に記載されています。

メソッド

リンクに使用できるメソッドの詳細情報については、リンクの JavaScript API を参照してください。

追加のリソース

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