Power Apps の 添付ファイル コントロール

  • [アーティクル]

ユーザーがデバイスにファイルをダウンロードしたり、Microsoft Lists を使用して作成されたリストまたは Microsoft Dataverse テーブルからファイルをアップロードおよび削除したりできるようにするコントロール。

説明設定

添付ファイル コントロールにより、リストや Dataverse テーブルの間でファイルを開く、追加、削除ができるようになります。

制限

Attachment コントロールには、次の制限があります。

  1. Attachment コントロールは、データ ソースとしてリストと Dataverse テーブルのみサポートします。 これらのデータ ソースをテーブルに変換する式。たとえば、 ForAll 機能はサポートされていません。

  2. アップロードと削除の機能は、フォームの内部でのみ機能します。 Attachment コントロールは、編集モードでフォーム内にない場合、無効と表示されます。 ファイルの追加と削除を保存するには、アプリ ユーザーがフォームを保存する必要があります。 この制限のため、Attachment コントロールは挿入タブからは利用できませんが、SharePoint または Dataverse フォームで添付ファイル フォーム フィールドが有効である場合はフォームに表示されます。

  3. Web ブラウザの 添付ファイル コントロールを使用すると、複数のファイルを選択し、ドラッグ アンド ドロップ機能を利用することができます。 ただし、Power Apps モバイル で 添付ファイル コントロールを使用する場合は、一度に追加できるファイルは 1 つだけです。

重要なプロパティ

Items – リストの Attachment 列または Dataverse テーブル。 コレクション および テーブル は、サポートされていません。

MaxAttachments – コントロールが受け入れるファイルの最大数。

MaxAttachmentSize – 新しい添付ファイルごとに許容される最大ファイル サイズ (MB)。 ここでの 1 MB は 1,000,000 バイト (106 B) または 1,000 KB です。

OnAddFile – ユーザーが新しい添付ファイルを追加したときに実行するアクション。

OnRemoveFile – ユーザーが既存の添付ファイルを削除したときに実行するアクション。

OnUndoRemoveFile – ユーザーが削除した添付ファイルを復元したときに実行するアクション。

追加のプロパティ

AccessibleLabel – スクリーン リーダー用のラベル。 添付ファイルの目的を説明する必要があります。

AddAttachmentText – 新しい添付ファイルを追加するために使用するリンクのラベル テキスト。

BorderColor – コントロールの境界線の色。

BorderStyle – コントロールの境界線が実線、破線、点線、またはなしかどうか。

BorderThickness – コントロールの境界線の太さ。

Color - コントロール内のテキストの色。

DisabledBorderColor – コントロールの DisplayMode プロパティが無効に設定されている場合のコントロールの境界線の色。

DisabledColor – コントロールの DisplayMode プロパティが無効に設定されている場合のコントロール内のテキストの色。

DisabledFill – コントロールの DisplayMode プロパティが無効に設定されている場合のコントロールの背景色。

DisplayMode – コントロールがファイルの追加と削除を許可するかどうか (編集)、データの表示のみを許可するか (表示)、または無効 (無効) にします。

[DropTargetBackgroundColor] – コントロールのドロップ ターゲットの背景の色。

[DropTargetBorderColor] – コントロールのドロップ ターゲットの境界の色。

[DropTargetBorderStyle] - コントロールのドロップ ターゲットを、実線、破線、点線、なしのいずれかにするかを示します。

[DropTargetBorderThickness] – コントロールのドロップ ターゲットの太さ。

[DropTargetTextColor] – コントロールのドロップ ターゲットのテキストの色。

Fill – コントロールの背景色。

FocusedBorderColor – コントロールがフォーカスされているときのコントロールの境界線の色。

FocusedBorderThickness – コントロールがフォーカスされているときのコントロールの境界線の太さ。

Height – コントロールの上端と下端間の距離。

Font – テキストを表示するフォントのファミリーの名前。

FontWeight – コントロール内のテキストの太さ: 太字、中太、標準、または細字。

HoverBorderColor – ユーザーがコントロール上にマウス ポインターを重ねているときのコントロールの境界線の色。

HoverColor – ユーザーがコントロールにマウス ポインターを重ねているときのコントロール内のテキストの色。

HoverFill – ユーザーがコントロールにマウス ポインターを重ねているときのコントロールの背景色。

Italic – コントロール内のテキストを斜体にするかどうか。

MaxAttachmentsText – 許容されるファイルの最大数がコントロールに含まれているときに、"添付ファイル" リンクと置き換えられるテキスト。

NoAttachmentsText – 添付ファイルがないときにユーザーに表示される情報テキスト。

Padding – インポートまたはエクスポート ボタンのテキストと、そのボタンの端との間の距離。

PressedBorderColor – ユーザーがコントロールを選択するときのコントロールの境界線の色。

PressedColor – ユーザーがコントロールを選択するときのコントロール内のテキストの色。

PressedFill – ユーザーがコントロールを選択するときのコントロールの背景色。

Reset – 添付ファイル コントロールに加えられたすべての変更を、以前に保存された状態に戻します。

Size – コントロールに表示されるテキストのフォント サイズ。

Strikethrough – コントロールに表示されるテキストに取り消し線を付けるかどうか。

TabIndex – 他のコントロールに関連するキーボード ナビゲーションの順序。

Tooltip – ユーザーがコントロールにカーソルを置くときに表示される説明テキスト。

Underline – コントロールに表示されるテキストの下に線を引くかどうか。

Visible – コントロールが表示されるかどうか。

Width – コントロールの左端と右端間の距離。

X – コントロールの左端とその親コンテナー (親コンテナーがない場合は画面) の左端間の距離。

Y – コントロールの上端とその親コンテナー (親コンテナーがない場合は画面) の上端間の距離。

例

  1. アプリにフォームを追加し、そのデータ ソースとしてリストを設定します。

  2. 左側にあるツリー ビュー内の表示フォーム コントロールを選択します。 代わりにEdit Formを使用することもできます。

  3. 右側のオプション パネルのプロパティ タブで Data Source を選択してから、接続したリストを選択します。

  4. フィールド セクションで編集フィールドを選択し、フィールドの追加を選択します。

  5. 添付ファイル フィールドを選択し、追加を選択します。

    リストに関連付けられている添付ファイル フィールドが、フォームに表示されます。

コントロールを追加して構成する方法に関する説明

アクセシビリティ ガイドライン

色のコントラスト

次の間には適切な色のコントラストが必要です:

  • ItemColor と ItemFill
  • ItemHoverColor と ItemHoverFill
  • ItemPressedColor と ItemPressedFill
  • AddedItemColor と AddedItemFill
  • RemovedItemColor と RemovedItemFill
  • ItemErrorColor と ItemErrorFill
  • AddAttachmentColor とFill
  • MaxAttachmentsColor とFill
  • NoAttachmentsColor とFill

この要件は、標準的なカラーコントラストの要件に追加されるものです。

スクリーン リーダー サポート

次のプロパティが存在する必要があります:

キーボードのサポート

  • TabIndex を 0 以上にして、キーボード ユーザーがそこに移動できるようにする必要があります。
  • フォーカス インジケーターは明確に表示する必要があります。 この透明度を実現するには FocusedBorderColor と FocusedBorderThickness を使用します。

注意

ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)

この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。