คุณสมบัติส่วนประกอบพื้นที่ทำงาน

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

ข้อกำหนดเบื้องต้น

คุณลักษณะนี้เปิดโดยค่าเริ่มต้นสำหรับแอปใหม่ สําหรับแอปที่มีอยู่ คุณต้องเปิดใช้งานในการตั้งค่าแอป

1. เปิด แอปพื้นที่ทำงานสำหรับการแก้ไข ใน Power Apps Studio บนแถบคำสั่ง ให้เลือก การตั้งค่า>การอัปเดต

2. บนแท็บ ใหม่ ให้ค้นหาและเปิดการตั้งค่า คุณสมบัติส่วนประกอบขั้นสูง

ชนิดของคุณสมบัติ

ผู้สร้างมีคุณสมบัติสี่ประเภท

1. คุณสมบัติของข้อมูล: คุณสมบัติของข้อมูลเกี่ยวข้องกับข้อมูล เช่น ค่าสีหรือข้อความ คุณสมบัติ Data สามารถตั้งค่าเป็น Input หรือ Output ซึ่งแสดงว่าส่วนประกอบให้ข้อมูลกับแอป (Output) หรือแอปให้ข้อมูลกับส่วนประกอบ (Input) คุณสมบัติ Data เป็นคุณสมบัติเดียวที่เข้าร่วมในโฟลว์ข้อมูลของแอป
2. คุณสมบัติของฟังก์ชัน: คุณสมบัติของฟังก์ชันเกี่ยวข้องกับตรรกะ เช่น การคำนวณตามพารามิเตอร์เฉพาะหรือการแก้ไขข้อความ คุณสมบัติ Function สามารถตั้งค่าเป็น Input หรือ Output ซึ่งแสดงว่าส่วนประกอบกำหนดฟังก์ชันให้แอปสามารถเรียก (Output) หรือแอปกำหนดฟังก์ชันให้ส่วนประกอบสามารถเรียก (Input) คุณสมบัติของ ฟังก์ชัน ไม่เข้าร่วมในโฟลว์ข้อมูลของแอป และไม่สามารถใช้ส่วนประกอบหรือตัวแปรของแอปได้
3. คุณสมบัติของการดำเนินการ: คุณสมบัติของการดำเนินการเป็นคุณสมบัติประเภทหนึ่งที่จัดการกับตรรกะและทำงานเหมือนกับ ฟังก์ชันเอาต์พุต ดังนั้น ส่วนประกอบจึงมีการกำหนดตรรกะ และตรรกะนั้นสามารถใช้นิพจน์แบบลูกโซ่และจัดการกับคอลเลกชันหรือตัวแปร ("ลักษณะการทำงาน") ตัวอย่างเช่น คุณสมบัติ Clear()Action อาจมีฟังก์ชันการทำงานที่แอปสามารถเรียกเพื่อล้างค่าบางค่าในส่วนประกอบ หรือคุณสมบัติ Save()Action ที่อัปเดตแหล่งข้อมูล
4. คุณสมบัติของเหตุการณ์: คุณสมบัติของเหตุการณ์เป็นประเภทของคุณสมบัติที่เกี่ยวข้องกับตรรกะและฟังก์ชันที่เป็น ฟังก์ชันอินพุต ดังนั้น แอปจะกำหนดตรรกะว่าส่วนประกอบใดสามารถเรียกได้ และตรรกะนั้นสามารถใช้นิพจน์แบบลูกโซ่และจัดการกับคอลเลกชันหรือตัวแปร ("ลักษณะการทำงาน") โดยทั่วไป ชื่อของคุณสมบัติเหล่านี้จะแสดงถึงเหตุการณ์เช่น OnSelect หรือ OnChanged

คุณสมบัติข้อมูล

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

1. ในบานหน้าต่างคุณสมบัติของส่วนประกอบ ให้เลือก คุณสมบัติที่กำหนดเองใหม่
2. ในบานหน้าต่าง คุณสมบัติที่กำหนดเองใหม่ ให้ป้อนชื่อที่แสดง Slider Color
3. เลือก ชนิดคุณสมบัติ เป็น Data และเลือกค่า คำนิยามคุณสมบัติ เป็น Input
4. สุดท้าย จากดรอปดาวน์ ชนิดข้อมูล ให้เลือก สี
5. คลิก สร้าง

จากนั้นเลือกตัวควบคุม Slider1แถบเลื่อน ค้นหาคุณสมบัติ ValueFill และในแถบสูตร ให้ป้อน Component1.SliderColor Component1 เป็นชื่อของส่วนประกอบ และ SliderColor เป็นชื่อของคุณสมบัติที่คุณเพิ่ม

ตอนนี้ส่วนประกอบมีคุณสมบัติ SliderColor ที่สามารถตั้งค่าในแอปที่ใช้เพื่อส่งสีไปยังส่วนประกอบและตั้งค่าคุณสมบัติ ValueFill ของแถบเลื่อน

คุณอาจต้องการระบุค่าของแถบเลื่อนให้กับแอปที่ใช้งาน ในการดำเนินการนี้ ให้เพิ่มคุณสมบัติ Output

1. ในบานหน้าต่างคุณสมบัติของส่วนประกอบ ให้เลือก คุณสมบัติที่กำหนดเองใหม่
2. ในบานหน้าต่าง คุณสมบัติที่กำหนดเองใหม่ ให้ป้อนชื่อที่แสดง Slider Value
3. เลือก ชนิดคุณสมบัติ ของ ข้อมูล และเลือก คำนิยามคุณสมบัติ เป็นค่า Output
4. สุดท้าย จากดรอปดาวน์ ชนิดข้อมูล ให้เลือก ตัวเลข
5. คลิก สร้าง

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

1. ในบานหน้าต่างคุณสมบัติของส่วนประกอบ ให้คลิกคุณสมบัติ Slider Value
2. ในแถบสูตร ให้แทนที่ค่าเริ่มต้นของ 100 ด้วยสูตรต่อไปนี้: Slider1.Value

ตอนนี้ คุณสมบัติ SliderValue ของส่วนประกอบแสดงถึงค่าของแถบเลื่อนภายในส่วนประกอบซึ่งแอปที่ใช้สามารถอ่านได้

คุณสมบัติของฟังก์ชัน

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

ฟังก์ชัน Output เป็นวิธีง่ายๆ ในการสร้างฟังก์ชันแบบกำหนดเองสำหรับ Power Apps ส่วนประกอบจะกำหนดฟังก์ชัน Output ด้วยนิพจน์ที่รับอาร์กิวเมนต์และส่งคืนค่า ฟังก์ชันนี้สามารถใช้ในแอปโดยใช้ชื่อของส่วนประกอบ (เช่น Component1) โดยการเรียก Component1.MyFunction(arg1, arg2)

ฟังก์ชัน Input ช่วยให้แอปที่ใช้สามารถให้ตรรกะแก่ส่วนประกอบ คล้ายกับตัวชี้ฟังก์ชันหรือฟังก์ชันเรียกกลับ ตัวอย่างเช่น หากส่วนประกอบทํางานกับชื่อของบุคคล ส่วนประกอบนั้นสามารถมีฟังก์ชันอินพุตที่มีอาร์กิวเมนต์ firstname และ lastname และคาดว่าจะส่งคืนสตริง แอปสามารถกําหนดนิพจน์ฟังก์ชันที่จะส่งคืน $"{firstname} {lastname}" หรือ $"{lastname}, {firstname}" คอมโพเนนต์จะเรียกใช้ฟังก์ชันที่ผู้สร้างแอปจัดเตรียมไว้และใช้สตริงที่ส่งคืน

คุณสมบัติการดำเนินการ

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

ในตัวอย่างแถบเลื่อนก่อนหน้าสำหรับ คุณสมบัติข้อมูล คุณสามารถเพิ่มคุณสมบัติการดำเนินการที่ชื่อ ResetValue เพื่อตั้งค่าแถบเลื่อนกลับเป็นค่าเริ่มต้นได้ ใช้สูตร Reset( Slider1 ) สำหรับรายการนี้ ตอนนี้ อินสแตนซ์ของส่วนประกอบในแอปสามารถเรียก Component1.ResetValue() เพื่อตั้งค่าแถบเลื่อนกลับเป็นค่าเริ่มต้นได้

คุณสมบัติของเหตุการณ์

ตัวควบคุมมาตรฐานจำนวนมากมีคุณสมบัติชนิดเหตุการณ์ทั่วไป ซึ่งเป็นคุณสมบัติของฟังก์ชันลักษณะการทำงานอินพุต OnSelect ในตัวควบคุมปุ่มเป็นตัวอย่างทั่วไป คอมโพเนนต์สามารถกําหนดคุณสมบัติของเหตุการณ์และเรียกเหตุการณ์เหล่านี้เหมือนฟังก์ชันได้ ตัวอย่างเช่น ส่วนประกอบที่มีตัวควบคุมปุ่มสามารถมีคุณสมบัติเหตุการณ์ที่ชื่อ OnButtonClicked ใน OnSelect ของตัวควบคุมปุ่ม ส่วนประกอบสามารถเรียกคุณสมบัติ Component1.OnButtonClicked() ได้ แอปที่ใช้ประโยชน์สามารถกําหนดตรรกะของตัวเองเพื่อให้คุณสมบัตินี้ทํางานเมื่อกดปุ่มภายในส่วนประกอบ

ค่าเริ่มต้นสำหรับคุณสมบัติหรืออาร์กิวเมนต์

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

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