テキスト、数値、日付、通貨などのデータを表示するボックスです。
説明
ラベルには、入力した内容がそのまま表示されるリテラル文字列として、またはテキスト文字列に評価される数式として指定したデータが表示されます。 ラベルは通常、他のコントロール (画面を識別するためのバナーなど) の外側に、別のコントロール (評価コントロール、オーディオ コントロールなど) を識別するラベルとして、またはギャラリー内の項目に関する特定の種類の情報を示すために表示されます。
主要なプロパティ
AutoHeight – ラベルにすべてのテキストが表示されるように高さを自動的に調整する場合は true に設定します。 割り当てた高さでテキストを切り捨てる場合は false に設定します。
Color – コントロールのテキストの色です。
Font – テキストを表記するフォントのファミリー名です。
Text – コントロールに表示されるテキスト、またはコントロールにユーザーが入力するテキストです。
DelayOutput – テキスト入力時に操作を遅延させる場合は true に設定します。
その他のプロパティ
Align – コントロールの水平方向の中心に対するテキストの位置です。
AutoHeight – Text プロパティの内容がコントロールで一度に表示できる文字数を超えている場合に、自動的に Height プロパティを大きくするかどうかを指定します。
BorderColor – コントロールの境界線の色です。
BorderStyle – コントロールの境界線を Solid (実線)、Dashed (破線)、Dotted (点線)、None (なし) のいずれに指定します。
BorderThickness – コントロールの境界線の太さです。
DisplayMode – コントロールで、ユーザー入力を許可するか (Edit)、データの表示のみを許可するか (View)、許可しないか (Disabled) を設定します。
DisabledBorderColor – コントロールの DisplayMode プロパティが Disabled に設定されている場合のコントロールの境界線の色です。
DisabledColor – コントロールの DisplayMode プロパティが Disabled に設定されている場合のコントロール内のテキストの色です。
DisabledFill – コントロールの DisplayMode プロパティが Disabled に設定されている場合のコントロールの背景色です。
Fill – コントロールの背景色です。
FontWeight – コントロール内のテキストの太さです。Bold (太字)、Semibold (中太)、Normal (標準)、Lighter (細字) から指定します。
Height – コントロールの上端と下端の距離です。
HoverBorderColor – コントロール上にユーザーがマウス ポインターを重ねているときのコントロールの境界線の色です。
HoverColor – コントロールにユーザーがマウス ポインターを重ねているときのコントロール内のテキストの色です。
HoverFill – コントロールにユーザーがマウス ポインターを重ねているときのコントロールの背景色です。
Italic – コントロール内のテキストを斜体にするかどうかを指定します。
LineHeight – テキストの行間やリスト内の項目間などの距離です。
OnSelect – ユーザーがコントロールをタップまたはクリックした場合のアプリの反応を指定します。
Overflow – ラベルの Wrap プロパティが true に設定され、Text プロパティの値がコントロールで一度に表示できる文字数を超えている場合に、ラベルにスクロール バーを表示するかどうかを指定します。
PaddingBottom – コントロール内のテキストとそのコントロールの下端間の距離です。
PaddingLeft – コントロール内のテキストとそのコントロールの左端間の距離です。
PaddingRight – コントロール内のテキストとそのコントロールの右端間の距離です。
PaddingTop – コントロール内のテキストとそのコントロールの上端間の距離です。
PressedBorderColor – コントロールをユーザーがタップまたはクリックしたときのコントロールの境界線の色です。
PressedColor – コントロールをユーザーがタップまたはクリックしたときのコントロール内のテキストの色です。
PressedFill – コントロールをユーザーがタップまたはクリックしたときのコントロールの背景色です。
Size – コントロールに表示されるテキストのフォント サイズです。
Strikethrough – コントロールに表示されるテキストに取り消し線を付けるかどうかを指定します。
Tooltip – ユーザーがポインターをコントロールに合わせたときに表示される説明テキストです。
Underline – コントロールに表示されるテキストの下に線を引くかどうかを指定します。
VerticalAlign – コントロールの垂直方向の中心に対するコントロール上でのテキストの位置です。
Visible – コントロールを表示するか非表示にするかを指定します。
Width – コントロールの左端と右端の間の距離です。
Wrap – 長すぎてラベルに収まらないテキストを次の行に折り返すかどうかを指定します。
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:1494000}, {City:"Milan", Country:"Italy", Population:1344000})F5 キーを押して、ボタンを選択し、Esc キーを押します。
テキスト ギャラリーを追加し、その Items プロパティを CityPopulations に設定します。
ギャラリーを選択すると、右側のペインにそのギャラリーのオプションが表示されます。
Gallery1 ペインで、上部の一覧を Population に、中央の一覧を City に、下部の一覧を Country にそれぞれ設定します。