ตัวควบคุม การ์ด ใน Power Apps

ให้ประสบการณ์การแสดงและการแก้ไขสำหรับฟิลด์ของตัวควบคุม แสดงฟอร์ม หรือ แก้ไขฟอร์ม

คำอธิบาย

ตัวควบคุม แสดงฟอร์ม และ แก้ไขฟอร์ม ทำหน้าที่เป็นคอนเทนเนอร์สำหรับการแสดงและการดูเรกคอร์ดทั้งหมด แต่ละคอนเทนเนอร์สามารถจัดเก็บชุดตัวควบคุม การ์ด ที่แสดงแต่ละฟิลด์ หรือให้วิธีการอัปเดตฟิลด์ แต่ละการ์ดมีคุณสมบัติ DataField ที่ระบุฟิลด์ของเรกคอร์ดที่ใช้งานได้

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

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

คุณสามารถกำหนดตัวควบคุมของการ์ดที่กำหนดไว้ล่วงหน้า โดนการปรับขนาด ย้าย ซ่อน เพิ่มตัวควบคุม และทำการเปลี่ยนแปลงอื่นๆ คุณยังสามารถเริ่มต้นด้วยการ์ดว่างทั้งหมด "การ์ดแบบกำหนดเอง" ที่คุณเพิ่มตัวควบคุมตั้งแต่ต้น

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

ภายในคอนเทนเนอร์ของฟอร์ม เรกคอร์ด ThisItem จะพร้อมใช้งานและมีฟิลด์ทั้งหมดของเรกคอร์ด ตัวอย่างเช่น คุณสมบัติ Default ของการ์ดมักจะตั้งค่าเป็น ThisItem.FieldName

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

ดู ทำความเข้าใจการ์ดข้อมูล สำหรับตัวอย่างวิธีการกำหนดค่า ปลดล็อก และสร้างการ์ด

คุณสมบัติสำคัญ

DataField – ชื่อของฟิลด์ภายในเรกคอร์ดที่การ์ดนี้แสดงและแก้ไข

• ระบุชื่อเป็นสตริงเดียวแบบคงที่ที่อยู่ระหว่างเครื่องหมายอัญประกาศคู่ (ตัวอย่างเช่น "ชื่อ") ไม่ใช่สูตร
• ยกเลิกการผูกการ์ด โดยการตั้งค่าคุณสมบัติ DataField เป็น ว่าง คุณสมบัติ Valid และ Update จะถูกละเว้นสำหรับการ์ดที่ไม่ถูกผูกไว้

Default – ค่าเริ่มต้นของตัวควบคุม ก่อนที่จะถูกเปลี่ยนแปลงโดยผู้ใช้

• สำหรับแต่ละตัวควบคุมในการ์ด ให้ตั้งค่าคุณสมบัตินี้เป็น Parent.Default เพื่ออ้างอิงถึงค่าเริ่มต้นของฟิลด์ตามแหล่งข้อมูล ตัวอย่างเช่น ตั้งค่าคุณสมบัติ Default ของแถบเลื่อนเป็น Parent.Default เพื่อให้แน่ใจว่า ผู้ใช้จะเริ่มด้วยค่าทั่วไปสำหรับแถบเลื่อน

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

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

DisplayName – ชื่อที่จำง่ายสำหรับฟิลด์ในแหล่งข้อมูล

• ฟังก์ชัน DataSourceInfo มีเมตาดาต้านี้จากแหล่งข้อมูล
• ตัวควบคุมภายในการ์ดควรใช้ Parent.DisplayName เพื่ออ้างอิงถึงชื่อของฟิลด์

Error – ข้อความแสดงข้อผิดพลาดที่ใช้งานง่ายเพื่อแสดงสำหรับฟิลด์นี้เมื่อการตรวจสอบล้มเหลว

• คุณสมบัตินี้ถูกตั้งค่าเมื่อมีการเรียก SubmitForm
• ข้อความอธิบายปัญหาการตรวจสอบตามเมตาดาต้าของแหล่งข้อมูล และการตรวจสอบคุณสมบัติ Required ของการ์ด

Required – กำหนดว่าการ์ดที่แก้ไขฟิลด์ของแหล่งข้อมูลต้องมีค่าหรือไม่

• ฟังก์ชัน DataSourceInfo มีเมตาดาต้าที่จำเป็นจากแหล่งข้อมุล
• ตัวควบคุมภายในการ์ดควรใช้ Parent.Required เพื่อกำหนดว่าฟิลด์ของการ์ดมีความจำเป็นหรือไม่

Update – ค่าในการเขียนกลับไปยังแหล่งข้อมูลสำหรับฟิลด์

• ใช้สูตรของคุณสมบัตินี้ในการดึงค่าจากตัวควบคุมการแก้ไขของการ์ด เพื่อเขียนกลับไปยังแหล่งข้อมูล ตัวอย่างเช่น ตั้งค่าคุณสมบัติ Update ของการ์ดเป็น Slider.Value เพื่ออัปเดตแหล่งข้อมูลด้วยค่าจากแถบเลื่อนในการ์ดดังกล่าว

Width – ระยะห่างระหว่างขอบด้านซ้ายและด้านขวาของตัวควบคุม

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

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

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

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

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

Fill – สีพื้นหลังของตัวควบคุม

Height – ระยะห่างระหว่างขอบด้านบนและด้านล่างของตัวควบคุม

Valid – ตัวควบคุม การ์ด หรือตัวควบคุม แก้ไขฟอร์ม มีรายการที่ถูกต้อง พร้อมที่จะถูกส่งไปยังแหล่งข้อมูลหรือไม่

Visible – กำหนดว่าตัวควบคุมปรากฏขึ้น หรือถูกซ่อน

X – ระยะห่างระหว่างขอบด้านซ้ายของตัวควบคุมและขอบด้านซ้ายของคอนเทนเนอร์หลัก (หน้าจอ ถ้าไม่มีคอนเทนเนอร์หลัก) สำหรับตัวควบคุม การ์ด ในคอนเทนเนอร์ที่มีหลายคอลัมน์ คุณสมบัตินี้กำหนดคอลัมน์ที่การ์ดปรากฏขึ้น

Y – ระยะห่างระหว่างขอบด้านบนของตัวควบคุมและขอบด้านบนของคอนเทนเนอร์หลัก (หน้าจอ ถ้าไม่มีคอนเทนเนอร์หลัก) สำหรับตัวควบคุม การ์ด ในคอนเทนเนอร์ที่มีหลายแถว คุณสมบัตินี้กำหนดแถวที่การ์ดปรากฏขึ้น

ตัวอย่าง

ดู ทำความเข้าใจการ์ดข้อมูล และ ทำความเข้าใจเค้าโครงฟอร์มข้อมูล เป็นตัวอย่าง

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

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

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

• Fill และตัวควบคุมย่อย ตัวอย่างเช่น ถ้าการ์ดมี ป้ายกำกับ และป้ายชื่อมีการเติมโปร่งใส จากนั้น Fill ของการ์ดจะกลายเป็นสีพื้นหลังสำหรับป้ายชื่ออย่างมีประสิทธิภาพ ดังนั้น ควรมีความคมชัดระหว่าง Fill ของการ์ด และ Color ของป้ายชื่อ

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

• ต้องมี DisplayName

หมายเหตุ

บอกให้เราทราบเกี่ยวกับภาษาที่คุณต้องการในคู่มือ ทำแบบสำรวจสั้นๆ (โปรดทราบว่าแบบสำรวจนี้เป็นภาษาอังกฤษ)

แบบสำรวจนี้ใช้เวลาทำประมาณเจ็ดนาที ไม่มีการเก็บข้อมูลส่วนบุคคล (คำชี้แจงสิทธิ์ส่วนบุคคล)