ユーザーがデバイスにファイルをダウンロードし、Microsoft Lists または Microsoft Dataverse テーブルを使用して作成されたリストからファイルをアップロードおよび削除するために使用できるコントロール。
Description
Attachments コントロールを使用すると、リストまたは Dataverse テーブルからファイルを開いたり、追加したり、削除したりできます。
Note
この記事では、従来の添付ファイル コントロールについて説明します。 フォームの外部での使用もサポートするモダン コントロールについては、「 添付ファイルのモダン コントロール (プレビュー)」を参照してください。
制限事項
添付ファイル コントロールには、次の制限があります。
添付ファイル コントロールでは、リストと Dataverse テーブルのみがデータ ソースとしてサポートされます。 ForAll 関数など、これらのデータ ソースをテーブルに変換する式はサポートされていません。
アップロードと削除の機能は、フォーム内でのみ機能します。 フォーム内ではなく 編集 モードの場合、添付ファイル コントロールは無効になります。 ファイルの追加と削除を保存するには、アプリ ユーザーがフォームを保存する必要があります。 この制限により、添付ファイル コントロールは [ 挿入 ] タブからは使用できませんが、添付ファイル フォーム フィールドが SharePoint フォームまたは Dataverse フォームで有効になっている場合はフォームに表示されます。
Web ブラウザーの添付ファイル コントロールを使用すると、複数のファイルを選択し、ドラッグ アンド ドロップ機能を使用できます。 ただし、 Power Apps Mobile で添付ファイル コントロールを使用する場合は、一度に 1 つのファイルのみを追加できます。
OneDrive またはその他のクラウド ストレージに格納されているファイルを添付できない場合があります。 デバイスのファイル ピッカーを使用して添付する前に、これらのファイルをデバイスにダウンロードしてみてください。
Power Apps モバイル アプリでは、 Attachments コントロールを使用する場合、カメラから直接ビデオをキャプチャしたり、フォト ライブラリからビデオを選択したりすることはできません。 ビデオを追加するには、[ 参照 ] オプションを使用する必要があります。
- Android の場合: [参照 ] オプションには、ビデオを含むすべてのファイルの種類が表示されるため、ビデオ ファイルを選択して添付できます。
- iOS の場合: [参照 ] オプションには、 ファイル アプリに格納されているファイルのみが表示されます。 ビデオがまだそこに保存されていない場合は、添付する前に ファイル アプリに移動する必要があります。
ビデオを添付するオプションとして表示されない場合は、まずビデオをデバイスの ファイル アプリに保存してから、もう一度やり直してください。
Android または iOS モバイル デバイスでMicrosoft Teamsでキャンバス アプリを実行する場合、添付ファイルのアップロードと表示はサポートされていません。
重要なプロパティ
Items – リストまたは Dataverse テーブルの Attachment 列。 コレクション と テーブル はサポートされていません。
MaxAttachments – コントロールが受け入れるファイルの最大数。
MaxAttachmentSize – 新しい添付ファイルごとに許可される最大ファイル サイズ (MB)。 ここで 1 MB は 1,000,000 バイト (106 B) または 1,000 KB です。
OnAddFile – ユーザーが新しい添付ファイルを追加したときに実行するアクション。
OnRemoveFile – ユーザーが既存の添付ファイルを削除したときに実行するアクション。
OnUndoRemoveFile – ユーザーが削除された添付ファイルを復元するときに実行するアクション。
追加のプロパティ
AccessibleLabel – スクリーン リーダーのラベル。 添付ファイルの目的を記述する必要があります。
AddAttachmentText – 新しい添付ファイルの追加に使用するリンクのラベル テキスト。
BorderColor – コントロールの境界線の色。
BorderStyle – コントロールの境界線が Solid、Dashed、Doted、None のいずれであるか。
BorderThickness – コントロールの境界線の太さ。
色 – コントロールのテキストの色。
DisabledBorderColor – コントロールの DisplayMode プロパティが Disabled に設定されている場合のコントロールの境界線の色。
DisabledColor – DisplayMode プロパティが Disabled に設定されている場合のコントロール内のテキストの色。
DisabledFill – DisplayMode プロパティが Disabled に設定されている場合のコントロールの背景色。
DisplayMode – コントロールでファイルの追加と削除 (編集) を許可するか、データのみを表示するか (表示)、無効 (無効) にするかを指定します。
[DropTargetBackgroundColor] – コントロールのドロップ ターゲットの背景の色。
[DropTargetBorderColor] – コントロールのドロップ ターゲットの境界線の色。
[DropTargetBorderStyle] – コントロールのドロップ ターゲットの境界線が Solid、Dashed、Doted、None のいずれであるか。
[DropTargetBorderThickness] – コントロールのドロップ ターゲット境界線の太さ。
[DropTargetTextColor] – コントロールのドロップ ターゲット テキストの色。
塗りつぶし – コントロールの背景色。
FocusedBorderColor – コントロールがフォーカスされている場合のコントロールの境界線の色。
FocusedBorderThickness – コントロールがフォーカスされたときのコントロールの境界線の太さ。
Height – コントロールの上端と下端の間の距離。
フォント – テキストが表示されるフォントファミリの名前。
FontWeight – コントロール内のテキストの重み: 太字、 半ボルト、 標準、 または太さ。
HoverBorderColor – ユーザーがそのコントロールにマウス ポインターを置いたままにしたときのコントロールの境界線の色。
HoverColor – ユーザーがマウス ポインターを置いたままにしたときのコントロール内のテキストの色。
HoverFill – ユーザーがマウス ポインターをその上に置いたままにしたときのコントロールの背景色。
斜体 – コントロール内のテキストが斜体かどうかを指定します。
MaxAttachmentsText – コントロールに許可されるファイルの最大数が含まれている場合に、"ファイルの添付" リンクを置き換えるテキスト。
NoAttachmentsText – ファイルが添付されていない場合にユーザーに表示される情報テキスト。
埋め込み – インポートまたはエクスポート ボタンのテキストと、そのボタンの端との間の距離。
PressedBorderColor – ユーザーがそのコントロールを選択したときのコントロールの境界線の色。
PressedColor – ユーザーがそのコントロールを選択したときのコントロール内のテキストの色。
PressedFill – ユーザーがそのコントロールを選択したときのコントロールの背景色。
リセット – 添付ファイル コントロールに対するすべての変更を元に戻し、以前に保存した状態に戻ります。
サイズ – コントロールに表示されるテキストのフォント サイズ。
取り消し線 – コントロールに表示されるテキストを線で表示するかどうかを指定します。
TabIndex – 他のコントロールに対するキーボード ナビゲーションの順序。
ヒント – ユーザーがコントロールの上にマウス ポインターを置いたときに表示される説明テキスト。
下線 – コントロールに表示されるテキストの下に行を表示するかどうかを指定します。
表示 – コントロールが表示されているか非表示であるか。
幅 – コントロールの左端と右端の間の距離。
X – コントロールの左端とその親コンテナーの左端との間の距離 (親コンテナーがない場合は画面)。
Y – コントロールの上端と親コンテナーの上端 (親コンテナーがない場合は画面) の間の距離。
例
フォームをアプリに追加し、リストをデータ ソースとして設定します。
左側のツリー ビューで [ フォームの表示 ] コントロールを選択します。 代わりに フォームの編集 を使用することもできます。
右側のオプション パネルの [プロパティ] タブで [ データ ソース ] を選択し、接続先のリストを選択します。
[ フィールド ] セクションで [ フィールド の編集] を選択し、[ フィールドの追加] を選択します。
[ 添付ファイル ] フィールドを選択し、[追加] を選択 します。
リストに関連付けられている [添付ファイル] フィールドがフォームに表示されます。
アクセシビリティ ガイドライン
色のコントラスト
次の間に適切な色のコントラストがあることを確認します。
- ItemColor と ItemFill
- ItemHoverColor と ItemHoverFill
- ItemPressedColor と ItemPressedFill
- AddedItemColor と AddedItemFill
- RemovedItemColor と RemovedItemFill
- ItemErrorColor と ItemErrorFill
- AddAttachmentColor と Fill
- MaxAttachmentsColor と Fill
- NoAttachmentsColor と Fill
この要件は、 標準のカラー コントラスト要件に加えて行われます。
スクリーン リーダー対応
次のプロパティを含めます。
- AccessibleLabel
- AddAttachmentsText
- MaxAttachmentsText
- NoAttachmentsText
キーボードのサポート
- キーボード ユーザーが移動できるように、 TabIndex の値を 0 以上に設定して使用します。
- フォーカス インジケーターは明確に表示する必要があります。 この明確さを実現するには、 FocusedBorderColor と FocusedBorderThickness を使用します。