ตัวควบคุมสิ่งที่แนบมาใน Power Apps

ตัวควบคุมที่อนุญาตให้ผู้ใช้ดาวน์โหลดไฟล์ลงในอุปกรณ์ของพวกเขา ตลอดจนอัปโหลดและลบไฟล์จากรายการที่สร้างขึ้นโดยใช้รายการ Microsoft หรือตาราง Microsoft Dataverse

คำอธิบาย

ตัวควบคุม สิ่งที่แนบมา ช่วยให้คุณสามารถเปิด เพิ่ม และลบไฟล์จากรายการหรือตาราง Dataverse ได้

Limitations

ตัวควบคุมสิ่งที่แนบมามีข้อจํากัดดังต่อไปนี้:

1. ตัวควบคุมสิ่งที่แนบมาสนับสนุนเฉพาะรายการและตาราง Dataverse เป็นแหล่งข้อมูลเท่านั้น นิพจน์ที่แปลงแหล่งข้อมูลเหล่านี้เป็นตาราง ตัวอย่างเช่น ด้วยฟังก์ชัน ForAll จะไม่ได้รับการสนับสนุน

2. การอัปโหลดและลบฟังก์ชันการทํางานจะทํางานเฉพาะภายในฟอร์ม ตัวควบคุมสิ่งที่แนบมาปรากฏขึ้นถูกปิดใช้งานเมื่ออยู่ในโหมดแก้ไขและไม่ได้อยู่ภายในฟอร์ม เมื่อต้องการบันทึกการเพิ่มและการลบไฟล์ ผู้ใช้แอปต้องบันทึกฟอร์ม เนื่องจากข้อจํากัดนี้ ตัวควบคุมสิ่งที่แนบมาไม่พร้อมใช้งานจากแท็บ แทรก แต่ปรากฏในฟอร์มเมื่อเขตข้อมูลฟอร์มสิ่งที่แนบมาเปิดใช้งานในฟอร์ม SharePoint หรือ Dataverse

3. ตัวควบคุมสิ่งที่แนบมาบนเว็บเบราว์เซอร์ให้คุณเลือกหลายไฟล์ และอนุญาตให้ใช้ฟังก์ชันการลากแล้วปล่อย อย่างไรก็ตาม เมื่อใช้ตัวควบคุมสิ่งที่แนบมาบน Power Apps Mobile คุณสามารถเพิ่มไฟล์ได้ครั้งละหนึ่งไฟล์เท่านั้น

4. ไฟล์ที่จัดเก็บใน OneDrive หรือที่เก็บข้อมูลบนคลาวด์อื่นๆ อาจไม่สามารถแนบได้อย่างถูกต้อง ลองดาวน์โหลดไฟล์เหล่านี้ไปยังอุปกรณ์ก่อนที่จะแนบไฟล์เหล่านั้นโดยใช้ตัวเลือกไฟล์ของอุปกรณ์

5. แอป Power Apps สําหรับอุปกรณ์เคลื่อนที่ไม่สนับสนุนการบันทึกวิดีโอโดยตรงจากกล้อง หรือเลือกวิดีโอจากไลบรารีรูปภาพเมื่อใช้ตัวควบคุมสิ่งที่แนบมา เมื่อต้องเพิ่มวิดีโอ ผู้ใช้ต้องใช้ตัวเลือกเรียกดู

   • บน Android: ตัวเลือก เรียกดู จะแสดงไฟล์ทุกประเภทรวมถึงวิดีโอให้คุณเลือกและแนบไฟล์วิดีโอของคุณ
   • บน iOS: ตัวเลือก เรียกดู จะแสดงเฉพาะไฟล์ที่จัดเก็บไว้ในแอปไฟล์ ถ้าวิดีโอของคุณยังไม่ได้บันทึกคุณจําเป็นต้องย้ายวิดีโอไปยังแอปไฟล์ก่อนที่จะแนบ

   ถ้าวิดีโอไม่ปรากฏเป็นตัวเลือกที่จะแนบ ก่อนอื่นให้บันทึกวิดีโอลงในแอปไฟล์ของอุปกรณ์ของคุณ จากนั้นลองอีกครั้ง

คุณสมบัติที่สำคัญ

Items – คอลัมน์ สิ่งที่แนบมา ของรายการหรือตาราง Dataverse คอลเลกชัน และ ตาราง ไม่ได้รับการสนับสนุน

MaxAttachments – จํานวนสูงสุดของไฟล์ที่ตัวควบคุมจะยอมรับ

MaxAttachmentSize – สูงสุดอนุญาตให้ใช้ขนาดไฟล์เป็นเมกะไบต์ของสิ่งที่แนบมาแต่ละใหม่ นี่คือ 1 MB คือ 1,000,000 ไบต์ (10⁶ B) หรือ 1,000 KB

OnAddFile – การดําเนินการเพื่อดําเนินการเมื่อผู้ใช้เพิ่มสิ่งที่แนบมากับไฟล์ใหม่

OnRemoveFile – การดําเนินการเพื่อดําเนินการเมื่อผู้ใช้ลบสิ่งที่แนบมาที่มีอยู่

OnUndoRemoveFile – การดําเนินการเพื่อดําเนินการเมื่อผู้ใช้คืนค่าสิ่งที่แนบมาที่ถูกลบ

คุณสมบัติเพิ่มเติม

AccessibleLabel – ป้ายชื่อสําหรับโปรแกรมอ่านหน้าจอ ควรอธิบายวัตถุประสงค์ของสิ่งที่แนบมา

AddAttachmentText – ข้อความป้ายชื่อสําหรับลิงก์ที่ใช้เพื่อเพิ่มสิ่งที่แนบมาใหม่

BorderColor – สีเส้นขอบของตัวควบคุม

BorderStyle – กําหนดว่าเส้นขอบของตัวควบคุมจะเป็น เส้นทึบเส้นประเส้นไข่ปลา หรือ ไม่มี

BorderThickness – ความหนาของเส้นขอบของตัวควบคุม

Color – สีของข้อความของตัวควบคุม

DisabledBorderColor สีของเส้นขอบของตัวควบคุม ถ้าคุณสมบัติ DisplayMode ของตัวควบคุมถูกตั้งค่าเป็น ปิดใช้งาน

DisabledColor – สีของข้อความในตัวควบคุม ถ้าคุณสมบัติ DisplayMode ถูกตั้งค่าเป็น Disabled

DisabledFill – สีพื้นหลังของตัวควบคุมถ้าคุณสมบัติ DisplayMode ถูกตั้งค่าเป็น Disabled

DisplayMode – กําหนดว่าตัวควบคุมจะอนุญาตการเพิ่มและลบไฟล์ (Edit) แสดงข้อมูลเท่านั้น (View) หรือถูกปิดใช้งาน (Disabled)

[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. เลือกตัวควบคุม แสดงฟอร์ม ในมุมมองแบบทรีทางด้านซ้ายมือ คุณยังสามารถใช้ แก้ไขฟอร์ม แทนได้

3. เลือก แหล่งข้อมูล ในแท็บคุณสมบัติในบานหน้าต่างตัวเลือกทางด้านขวา จากนั้นเลือกรายการที่คุณเชื่อมต่อ

4. เลือกแก้ไขเขตข้อมูลในส่วนเขตข้อมูล และเลือกเพิ่มเขตข้อมูล

5. เลือกเขตข้อมูล สิ่งที่แนบมา และเลือก เพิ่ม

   เขตข้อมูลสิ่งที่แนบมาที่เชื่อมโยงกับรายการจะปรากฏในแบบฟอร์ม

เรียนรู้วิธีการเพิ่มและกําหนดค่าตัวควบคุม

แนวทางการช่วยสําหรับการเข้าถึง

ความคมชัดของสี

ต้องมีความคมชัดของสีที่เพียงพอระหว่าง:

• ItemColor และ ItemFill
• ItemHoverColor และ ItemHoverFill
• ItemPressedColor และ ItemPressedFill
• AddedItemColor และ AddedItemFill
• RemovedItemColor และ RemovedItemFill
• ItemErrorColor และ ItemErrorFill
• AddAttachmentColor และ เติม
• MaxAttachmentsColor และ เติม
• NoAttachmentsColor และ เติม

ข้อกําหนดนี้นอกเหนือจากข้อกําหนดความคมชัดของสีมาตรฐาน

การสนับสนุนตัวอ่านหน้าจอ

คุณสมบัติต่อไปนี้ต้องแสดงขึ้น:

• AccessibleLabel
• AddAttachmentsText
• MaxAttachmentsText
• NoAttachmentsText

การสนับสนุนแป้นพิมพ์

• TabIndex ต้องเป็นศูนย์หรือมากกว่า เพื่อให้ผู้ใช้คีย์บอร์ดสามารถนําทางได้
• ต้องมองเห็นตัวบ่งชี้โฟกัสได้อย่างชัดเจน ใช้ FocusedBorderColor และ FocusedBorderThickness เพื่อให้ได้ความชัดเจนนี้