外観と動作のプロパティを構成できるグラフィック。
Description
これらのコントロールには、矢印、幾何学的図形、アクション アイコン、および塗りつぶし、サイズ、位置などのプロパティを構成できるシンボルが含まれます。 ユーザーがコントロールを選択した場合にアプリが応答するように、 OnSelect プロパティを構成することもできます。
主要なプロパティ (アイコンと図形)
塗りつぶし – コントロールの背景色。
OnSelect – ユーザーがコントロールを選択したときに実行するアクション。
キープロパティ (アイコンのみ)
アイコン - 表示するアイコンの種類 ( ArrowDown や ShoppingCart など)。
回転 - アイコンを回転させる角度の数。
色 - 名前または RGBA 値によるアイコンの色。
追加のプロパティ
AccessibleLabel – スクリーン リーダーのラベル。
DisplayMode – コントロールでユーザー入力 (編集) を許可するか、データのみを表示するか (表示)、無効 (無効) にするかを指定します。
FocusedBorderColor – コントロールがフォーカスされている場合のコントロールの境界線の色。
FocusedBorderThickness – コントロールがフォーカスされたときのコントロールの境界線の太さ。
Height – コントロールの上端と下端の間の距離。
HoverFill – ユーザーがマウス ポインターをその上に置いたままにしたときのコントロールの背景色。
PressedBorderColor – ユーザーがそのコントロールを選択したときのコントロールの境界線の色。
PressedFill – ユーザーがそのコントロールを選択したときのコントロールの背景色。
TabIndex – 他のコントロールに対するキーボード ナビゲーションの順序。
表示 – コントロールが表示されるか非表示になっているか。
幅 – コントロールの左端と右端の間の距離。
X – コントロールの左端とその親コンテナー (親コンテナーがない場合は画面) の左端間の距離。
Y – コントロールの上端とその親コンテナー (親コンテナーがない場合は画面) の上端間の距離。
関連する関数
Navigate( ScreenName, ScreenTransition )
Example
既定の Screen コントロール に Target という名前を付け、 ラベル コントロールを追加し、 その Text プロパティを Target と表示するように設定 します。
コントロールを追加して構成する方法がわからない場合
Screen コントロールを追加し、Source という名前を付けます。
[ソース] で、Shape コントロールを追加し、その OnSelect プロパティを次の数式に設定します。
Navigate(Target, ScreenTransition.Fade)
F5 キーを押し、[ 図形 ] コントロールを選択します。
ターゲット画面が表示されます。
(省略可能)Esc キーを押して既定のワークスペースに戻り、図形コントロールをターゲットに追加し、Shape コントロールの OnSelect プロパティを次の式に設定します。
Navigate(Source, ScreenTransition.Fade)
アクセシビリティ ガイドライン
色のコントラスト
以下は、ボタンとして使用されるグラフィック、または装飾用のグラフィックスにのみ適用されます。
アイコンの場合:
- 色 と 塗りつぶし
- その他の 標準カラー コントラスト要件 が適用されます (ボタンとして使用する場合)
罫線付きの図形の場合:
- BorderColor とコントロールの外側の色
- FocusedBorderColor とコントロールの外側の色 (ボタンとして使用される場合)
罫線のない図形の場合:
- コントロールの外側の塗りつぶしと色
- PressedFill とコントロールの外側の色 (ボタンとして使用される場合)
- HoverFill とコントロールの外側の色 (ボタンとして使用される場合)
スクリーン リーダーのサポート
重要なグラフィックスには AccessibleLabel を設定する必要があります。
グラフィックが装飾用の場合、または冗長な情報を提供する場合は、 AccessibleLabel を空のままにするか、空の文字列 "" に設定します。 スクリーン リーダーはこれらのグラフィックスを無視します。
たとえば、このフォームを変更できないことを示す [ラベル] の横に [ロック] アイコンを配置できます。 アイコンに AccessibleLabel は必要ありません。 ラベル にはその意味が既に説明されているためです。
Important
TabIndex が 0 以上の場合、アイコンまたは図形がボタンになります。 外観は変わりませんが、スクリーン リーダーはそれをボタンとして扱います。 AccessibleLabel が空の場合でも、コントロールは無視されません。 TabIndex が 0 未満の場合、スクリーン リーダーはアイコンまたは図形をイメージとして扱います。
キーボードのサポート
グラフィックをボタンとして使用する場合、TabIndex は 0 以上にする必要があります。 その後、キーボード ユーザーはそれに移動できます。
グラフィックをボタンとして使用する場合は、フォーカス インジケーターを明確に表示する必要があります。 この結果を得るには、 FocusedBorderColor と FocusedBorderThickness を使用します。