写真を撮るか、ローカル デバイスから画像を読み込みます。
Description
このコントロールを使用すると、ユーザーは自分のデバイスから写真を撮影したり、画像ファイルをアップロードしたり、このコンテンツでデータ ソースを更新したりできます。 モバイル デバイスでは、ユーザーにデバイスの選択ダイアログが表示され、写真を撮るか、既に使用可能なものを選択するかが選択されます。
このコントロールは、 画像 と 画像の追加ボタンの 2 つのコントロールを含むグループ化されたコントロールです。 Image コントロールには、アップロードされた画像が表示されます。画像がアップロードされていない場合はプレースホルダーが表示されます。 [ 画像の追加] ボタンをクリック すると、画像をアップロードするように求められます。
Image プロパティについては、Image コントロールのリファレンスを参照してください。
制限事項
画像コントロールには、次の制限があります。
- iOS で [画像の追加] コントロールを使用する場合、カメラまたはギャラリーを使用してインポートされた画像には、向き、位置情報、カメラの設定などのメタデータは含まれません。
画像ボタンのプロパティを追加する
AccessibleLabel – スクリーン リーダーのラベル。 画像を追加する目的を説明する必要があります。
[配置] – コントロールの水平方向の中心を基準にしたテキストの位置。
BorderColor – コントロールの境界線の色。
BorderStyle – コントロールの境界線が Solid、Dashed、Doted、None のいずれであるか。
BorderThickness – コントロールの境界線の太さ。
ChangePictureText – 画像がアップロードされたときにボタンに表示されるテキスト。
色 – コントロール内のテキストの色。
DisabledBorderColor – コントロールの DisplayMode プロパティが Disabled に設定されている場合のコントロールの境界線の色。
DisabledColor – DisplayMode プロパティが Disabled に設定されている場合のコントロール内のテキストの色。
DisabledFill – DisplayMode プロパティが Disabled に設定されている場合のコントロールの背景色。
DisplayMode – コントロールでユーザー入力 (編集) を許可するか、データのみを表示するか (表示)、無効 (無効) にするかを指定します。
エラー - 画像のアップロードに問題がある場合、このプロパティには適切なエラー文字列が含まれます。
塗りつぶし – コントロールの背景色。
FocusedBorderColor – コントロールがフォーカスされている場合のコントロールの境界線の色。
FocusedBorderThickness – コントロールがフォーカスされたときのコントロールの境界線の太さ。
フォント – テキストが表示されるフォントファミリの名前。
FontWeight – コントロール内のテキストの重み: 太字、 半ボルト、 標準、 または太さ。
Height – コントロールの上端と下端の間の距離。
HoverBorderColor – ユーザーがそのコントロールにマウス ポインターを置いたままにしたときのコントロールの境界線の色。
HoverColor – ユーザーがマウス ポインターを置いたままにしたときのコントロール内のテキストの色。
HoverFill – ユーザーがマウス ポインターをその上に置いたままにしたときのコントロールの背景色。
斜体 – コントロール内のテキストが斜体かどうかを指定します。
メディア – オーディオまたはビデオ コントロールが再生するクリップの識別子。
OnChange – ユーザーがコントロールの値を変更したときに実行するアクション (スライダーを調整するなど)。
OnSelect – ユーザーがコントロールをタップまたはクリックしたときに実行するアクション。
埋め込み – インポートまたはエクスポート ボタンのテキストと、そのボタンの端との間の距離。
PressedBorderColor – ユーザーがそのコントロールをタップまたはクリックしたときのコントロールの境界線の色。
PressedColor – ユーザーがそのコントロールをタップまたはクリックしたときのコントロール内のテキストの色。
PressedFill – ユーザーがそのコントロールをタップまたはクリックしたときのコントロールの背景色。
リセット – コントロールが既定値に戻るかどうか。
サイズ – コントロールに表示されるテキストのフォント サイズ。
取り消し線 – コントロールに表示されるテキストを線で表示するかどうかを指定します。
TabIndex – 他のコントロールに対するキーボード ナビゲーションの順序。
テキスト – 画像がアップロードされていないときにボタンに表示されるテキスト。
ヒント – ユーザーがコントロールの上にマウス ポインターを置いたときに表示される説明テキスト。
下線 – コントロールに表示されるテキストの下に行を表示するかどうかを指定します。
UseMobileCamera – モバイル カメラを使用可能な場合に直接使用するかどうか。 これを TRUE に設定すると、ユーザーはカメラを使用して写真を撮影し、デバイス ギャラリーから既存の画像をアップロードできなくなります。
VerticalAlign – コントロールの垂直方向の中心に対するコントロール上のテキストの位置。
表示 – コントロールが表示されるか非表示になっているか。
幅 – コントロールの左端と右端の間の距離。
X – コントロールの左端とその親コンテナー (親コンテナーがない場合は画面) の左端間の距離。
Y – コントロールの上端とその親コンテナー (親コンテナーがない場合は画面) の上端間の距離。
関連する関数
Patch( DataSource, BaseRecord, ChangeRecord )
例示
イメージ ギャラリー コントロールにイメージを追加する
[ 画像の追加] コントロールを追加し、3 回クリックします。
[ 開く ] ダイアログ ボックスで、画像ファイルをクリックまたはタップし、[ 開く] をクリックまたはタップします。
Button コントロールを追加し、[画像の追加] コントロールの下に移動し、Button コントロールの OnSelect プロパティを次の数式に設定します。
Collect(MyPix, AddMediaButton1.Media)垂直ギャラリー コントロールを追加し、その Items プロパティを MyPix に設定します。
ギャラリーで Image コントロールを選択し、 Image プロパティをThisItem.Value に設定します。
F5 キーを押し、 ボタン コントロールをクリックまたはタップします。
[ 画像の追加] コントロールの画像が 垂直ギャラリー コントロールに表示されます。 イメージの縦横比が縦型ギャラリー コントロールの Image コントロールと同じではない場合は、Image コントロールの ImagePosition プロパティを Fit に設定します。
[ 画像の追加 ] コントロールをクリックまたはタップし、別の画像ファイルをクリックまたはタップし、[ 開く] をクリックまたはタップして、追加した ボタン コントロールをクリックまたはタップします。
2 番目のイメージが イメージ ギャラリー コントロールに表示されます。
(省略可能)前の手順を 1 回以上繰り返し、Esc キーを押して既定のワークスペースに戻ります。
SaveData 関数を使用してイメージをローカルに保存するか、Patch 関数を使用してデータ ソースを更新します。
アクセシビリティ ガイドライン
ボタンと画像に関する同じガイドラインが適用されます。 さらに、次の点を考慮してください。
色のコントラスト
- 画像の追加ボタン は、テキストと背景の間に適切なコントラストを持っている必要があります。 アップロードされた画像の色が異なる場合があるため、[画像の追加] ボタンで不透明な塗りつぶしを使用して、一貫したコントラストを確保します。
スクリーン リーダーのサポート
- 画像の追加ボタン には 、画像 の追加または変更をユーザーに求めるテキストと ChangePictureText が必要です。
キーボードのサポート
- キーボード ユーザーが移動できるように、[図の追加] ボタンの TabIndex が 0 以上である必要があります。
- [画像の追加] ボタン には、明確に表示されるフォーカス インジケーターが必要です。 これを実現するには、FocusedBorderColor と FocusedBorderThickness を使用します。