テキスト、数値、日付、または通貨などのデータを表示するボックスです。
Description
ラベルには、テキストのリテラル文字列として指定したデータが表示されます。入力したとおりに表示されるか、テキストの文字列に評価される数式として表示されます。 ラベルは、多くの場合、他のコントロール (画面を識別するバナーなど) の外部、別のコントロール (評価コントロールやオーディオ コントロールなど) を識別するラベルとして、またはギャラリーに表示され、アイテムに関する特定の種類の情報が表示されます。
重要なプロパティ
AutoHeight – true に設定すると、ラベルの高さが自動的に拡大され、すべてのテキストが表示されます。 割り当てられた高さにテキストを切り捨てるには false に設定します。
色 – コントロール内のテキストの色。
フォント – テキストが表示されるフォントファミリの名前。
テキスト – コントロールに表示されるテキスト、またはユーザーがコントロールに入力するテキスト。
DelayOutput – テキスト入力中にアクションを遅延するには true に設定します。
追加のプロパティ
[配置] – コントロールの水平方向の中心を基準にしたテキストの位置。
AutoHeight – Text プロパティに一度に表示できる文字よりも多くの文字が含まれている場合に、ラベルの Height プロパティが自動的に増加するかどうかを指定します。
BorderColor – コントロールの境界線の色。
BorderStyle – コントロールの境界線が Solid、Dashed、Doted、None のいずれであるか。
BorderThickness – コントロールの境界線の太さ。
DisplayMode – コントロールでユーザー入力 (編集) を許可するか、データのみを表示するか (表示)、無効 (無効) にするかを指定します。
DisabledBorderColor – コントロールの DisplayMode プロパティが Disabled に設定されている場合のコントロールの境界線の色。
DisabledColor – DisplayMode プロパティが Disabled に設定されている場合のコントロール内のテキストの色。
DisabledFill – DisplayMode プロパティが Disabled に設定されている場合のコントロールの背景色。
塗りつぶし – コントロールの背景色。
FocusedBorderColor – コントロールがフォーカスされている場合のコントロールの境界線の色。
FocusedBorderThickness – コントロールがフォーカスされたときのコントロールの境界線の太さ。
FontWeight – コントロール内のテキストの重み: 太字、 半ボルト、 標準、 または太さ。
Height – コントロールの上端と下端の間の距離。
HoverBorderColor – ユーザーがそのコントロールにマウス ポインターを置いたままにしたときのコントロールの境界線の色。
HoverColor – ユーザーがマウス ポインターを置いたままにしたときのコントロール内のテキストの色。
HoverFill – ユーザーがマウス ポインターをその上に置いたままにしたときのコントロールの背景色。
斜体 – コントロール内のテキストが斜体かどうかを指定します。
LineHeight – リスト内のテキストまたは項目の行間の距離です。
Live – スクリーン リーダーがラベルの Text プロパティの値に対する変更を読み上げる方法。
- [オフ] に設定すると、スクリーン リーダーは変更を読み上げません。
- [Polite] に設定すると、スクリーン リーダーが読み上げ中に発生した変更を発表する前に、スクリーン リーダーの読み上げが終了します。
- Assertive に設定すると、スクリーン リーダーは、スクリーン リーダーが読み上げ中に発生した変更を読み上げるために中断します。
OnSelect – ユーザーがコントロールをタップまたはクリックしたときに実行するアクション。
オーバーフロー – Wrap プロパティが true に設定され、コントロールの Text プロパティの値に一度に表示できる文字よりも多くの文字が含まれている場合に、スクロール バーがラベルに表示されるかどうか。
PaddingBottom – コントロール内のテキストとそのコントロールの下端との間の距離。
PaddingLeft – コントロール内のテキストとそのコントロールの左端との間の距離。
PaddingRight – コントロール内のテキストとそのコントロールの右端との間の距離。
PaddingTop – コントロール内のテキストとそのコントロールの上端との間の距離。
PressedBorderColor – ユーザーがそのコントロールをタップまたはクリックしたときのコントロールの境界線の色。
PressedColor – ユーザーがそのコントロールをタップまたはクリックしたときのコントロール内のテキストの色。
PressedFill – ユーザーがそのコントロールをタップまたはクリックしたときのコントロールの背景色。
ロール - 見出し 1 などのラベル テキストのセマンティック ロール。 ラベルのスタイルは変更されませんが、スクリーン リーダーによる解釈に対して意味的に正しい出力になります。
サイズ – コントロールに表示されるテキストのフォント サイズ。
取り消し線 – コントロールに表示されるテキストを線で表示するかどうかを指定します。
TabIndex – 他のコントロールに対するキーボード ナビゲーションの順序。
ヒント – ユーザーがコントロールの上にマウス ポインターを置いたときに表示される説明テキスト。
下線 – コントロールに表示されるテキストの下に行を表示するかどうかを指定します。
VerticalAlign – コントロールの垂直方向の中心に対するコントロール上のテキストの位置。
表示 – コントロールが表示されるか非表示になっているか。
幅 – コントロールの左端と右端の間の距離。
折り返し – テキストを複数行に折り返すかどうかを指定します。
X – コントロールの左端とその親コンテナー (親コンテナーがない場合は画面) の左端間の距離。
Y – コントロールの上端とその親コンテナー (親コンテナーがない場合は画面) の上端間の距離。
関連する関数
例示
リテラル文字列を表示する
ラベルを追加し、 その Text プロパティを "Hello, world" (二重引用符を含む) に設定します。
コントロールを追加して構成する方法がわからない場合
数式の結果を表示する
ラベルを追加し、 Text プロパティを次のような数式に設定します。
Today()注
数式を指定する場合、数式の引数がリテラル文字列でない限り、引用符は使用しません。 その場合は、数式ではなく引数を二重引用符で囲みます。
ギャラリーにデータを表示する
この手順では、ヨーロッパのさまざまな都市の人口に関するデータを含む CityPopulations というコレクションを作成します。 次に、3 つのラベルを含むギャラリーでそのデータを表示し、各ラベルに表示されるデータの種類を指定します。
ボタンを追加し、OnSelect プロパティを次の計算式に設定します。
ClearCollect(CityPopulations, {City:"London", Country:"United Kingdom", Population:8615000}, {City:"Berlin", Country:"Germany", Population:3562000}, {City:"Madrid", Country:"Spain", Population:3165000}, {City:"Rome", Country:"Italy", Population:2874000}、{City:"Paris"、Country:"France"、Population:2273000}、{City:"Hamburg"、Country:"Germany"、Population:1760000}、{City:"Barcelona"、Country:"Spain"、Population:1602000}、{City:"Munich"、Country:"Germany"、Population Population:1494000}, {City:"Milan", Country:"Italy", Population:1344000})F5 キーを押してボタンを選択し、Esc キーを押します。
テキスト ギャラリーを追加し、その Items プロパティを CityPopulations に設定します。
ギャラリーを選択すると、右側のウィンドウにそのギャラリーのオプションが表示されます。
[ギャラリー 1] ウィンドウで、一番上の一覧を [人口] に設定し、中央の一覧を [市区町村] に設定し、下の一覧を [国] に設定します。
アクセシビリティ ガイドライン
その名前にもかかわらず、 ラベル コントロールを別のコントロールのラベルとして使用する必要はありません。 任意のテキストを表示するために使用できます。
ラベルは、OnSelect 動作を指定することで、ボタンまたはリンクとして使用できます。 この方法を使用する場合、ボタンと同様のアクセシビリティに関する考慮事項があります。
色のコントラスト
次の間に適切な色のコントラストが必要です。
- 色 と 塗りつぶし
- その他の 標準カラー コントラスト要件 が適用されます (ボタンまたはリンクとして使用する場合)
スクリーン リーダーのサポート
テキスト が存在する必要があります。
スクリーン リーダーが Text プロパティの値に対する変更を読み上げる必要がある場合は、Live を [形式指定] または [Assertive] に設定する必要があります。
注
TabIndex が 0 以上の場合、スクリーン リーダーはラベルをボタンとして扱います。
ロービジョンのサポート
-
ラベル がリンクとして使用されている場合、ラベルはリンクのように見えます。
- 下線を true に設定する
- HoverColor は色と異なる必要があります
キーボードのサポート
- テキストをボタンまたはリンクとして使用する場合は、TabIndex を 0 以上にする必要があります。 これにより、キーボード ユーザーはそれに移動できます。
- テキストがボタンまたはリンクとして使用されている場合は、フォーカス インジケーターを明確に表示する必要があります。 これを実現するには、FocusedBorderColor と FocusedBorderThickness を使用します。