Hyperlink コントロール

Hyperlink コントロールには、コンピューターの既定のブラウザーで開かれるアドレスへの HTML リンクが表示されます。 HTML 以外のプロトコルでは、リンクはサポートされていません。

Windows インストーラー 4.5 以前: サポートされていません。 このコントロールは、Windows インストーラー 5.0 以降で使用できます。

HyperLink コントロールの Text 値では、アンカー <a> タグと HREF 属性値を使って、リンクの URL と表示されるテキストを指定します。

<a href="https://www.blueyonderairlines.com">Blue Yonder Airlines</a>

コントロールの属性

Hyperlink コントロールでは次の属性を使用できます。 イベントを使用して属性の値を変更するには、EventMapping テーブルの ControlEvent にコントロールをサブスクライブし、Attribute 列に属性の識別子を記載します。 Event 列に ControlEvent の識別子を入力します。

属性識別子	16 進数ビット	説明
Position		ダイアログ ボックス内のコントロールの位置。 Control テーブルまたは BBControl テーブルの Width、Height、X、Y の各列に、コントロールの幅、高さ、左隅の座標を入力します。 長さと距離にはインストーラー単位を使用します。
テキスト		コントロールによって表示されるテキスト。 テキスト文字列のフォントとフォント スタイルを設定するには、表示される文字の文字列の先頭に {\style} または {&style} を付けます。 ここで、style は、TextStyle テーブルの TextStyle 列に記載されている識別子です。 これらのどちらも存在しないが、DefaultUIFont プロパティが有効なテキスト スタイルとして定義されている場合は、そのフォントが使用されます。 また、テキスト値は [Property] を参照先のプロパティに解決します。
[表示]	0x00000000 0x00000001	表示されないコントロール。 表示されるコントロール。 作成時にコントロールを表示または非表示にするには、Control テーブルまたは BBControl テーブルの Attributes 列のビット ワードに、このビットを含めます。 ControlCondition テーブルを使って、コントロールの非表示または表示を設定することもできます。
有効	0x00000000 0x00000002	無効状態のコントロール。 有効状態のコントロール。 作成時にコントロールを有効にするには、Control または BBControl テーブルの Attributes 列のビット ワードに、このビットを含めます。 ControlCondition テーブルを使用して、コントロールを有効または無効にすることもできます。
Sunken	0x00000000 0x00000004	既定の表示スタイルを表示します。 浮き彫りの 3-D の外観を使用してコントロールを表示します。 Control テーブルの Attributes 列のビット ワードにこれらのビットを含めます。
透明	0x00000000 0x00010000	不透明なコントロール。 コントロールを通して背景が表示されます。 コントロールは、WS_EX_TRANSPARENT スタイルになります。 Control または BBControl テーブルの Attributes 列に、このビットを含めます。

 

解説

このコントロールは、CreateWindowEx 関数を使って、WC_LINK クラスから作成できます。 WS_CHILD、WS_TABSTOP、WS_GROUP の各スタイルがあります。

色付きのビットマップの上に透明なテキスト コントロールを配置しないでください。 ユーザーが表示配色を変更した場合、テキストが表示されなくなるおそれがあります。 たとえば、ユーザーがアクセシビリティ上の理由のためにハイ コントラスト パラメーターを設定すると、テキストが見えなくなることがあります。

コントロール内のテキストがコントロールの幅より長い場合は、折り返されたテキストを収めるのに十分な高さがあるかどうかに応じて、テキストは折り返されるか切り捨てられます。