ฟังก์ชัน Copy
ใช้กับ:
แอป Canvas แอปที่ขับเคลื่อนด้วยโมเดล
คัดลอกข้อความไปยังคลิปบอร์ดบนอุปกรณ์ที่แอปทำงานอยู่
รายละเอียด
ฟังก์ชัน คัดลอก รับค่าข้อความใดๆ และคัดลอกไปยังคลิปบอร์ด โดยไม่คำนึงถึงเนื้อหาของข้อความ คลิปบอร์ดจะมีข้อความธรรมดาโดยไม่มีชนิด mime พิเศษใดๆ ฟังก์ชันนี้ถือเป็นฟังก์ชันผลข้างเคียง และเป็นผลให้สามารถใช้ในคุณสมบัติลักษณะการทำงานเท่านั้น
หมายเหตุ
ฟังก์ชัน Copy() ถูกจำกัดการเข้าถึงคลิปบอร์ดโดยโฮสต์ของแอป เป็นผลให้สถานการณ์แอปที่ฝังตัว เช่น Power Apps ใน SharePoint, แอปที่ฝังอยู่ใน Power BI, Teams ฯลฯ ไม่รองรับ Copy() สถานการณ์แบบฝังอื่นๆ อาจไม่รองรับฟังก์ชันนี้เช่นกัน ผู้สร้างควรใช้ IfError() เพื่อให้แน่ใจว่าการดำเนินการคัดลอกไปยังคลิปบอร์ดใช้งานได้ และหากไม่เป็นไปตามที่คาดหวังก็ถือเป็นการแจ้งเตือนผู้ใช้ว่าการคัดลอกล้มเหลว
ไวยากรณ์
คัดลอก( ข้อความ )
- ข้อความ - จำเป็น ข้อความที่จะคัดลอกไปยังคลิปบอร์ด
ตัวอย่าง
ป้อนข้อความด้วยปุ่มคัดลอก
ฟังก์ชัน คัดลอก สามารถใช้เพื่อสร้างรูปแบบการควบคุมการป้อนข้อมูลที่เห็นได้ในหลายๆ แอป ซึ่งตอนนี้การกดปุ่มบนข้อความที่ป้อนจะทำให้สามารถคัดลอกข้อความของการป้อนข้อมูลได้อย่างรวดเร็ว ไปที่คลิปบอร์ด
- แทรกตัวควบคุม การป้อนข้อความ บนหน้าจอ โดยค่าเริ่มต้น ชื่อจะเป็น TextInput1
- แทรกตัวควบคุม ปุ่ม บนหน้าจอ ถัดจากตัวควบคุมอินพุต
- ตั้งค่าคุณสมบัติ OnSelect ของปุ่มเป็น Copy( TextInput1.Text )
เมื่อเลือกปุ่มนี้ ข้อความจากตัวควบคุมการป้อนข้อความจะถูกคัดลอกไปยังคลิปบอร์ด
กำลังประมวลผลข้อความเพื่อใส่ในคลิปบอร์ด
ฟังก์ชัน คัดลอก ยอมรับข้อความ ซึ่งสามารถเป็นนิพจน์ที่ปรับเปลี่ยนข้อความจากแอปของคุณไม่ทางใดก็ทางหนึ่ง ตัวอย่างเช่น แอปอาจมีเรกคอร์ดพนักงานที่มี ชื่อ นามสกุล และตำแหน่งของพนักงาน สูตรสามารถใส่ข้อมูลนี้ในคลิปบอร์ดเป็นข้อความชิ้นเดียว ตัวอย่างต่อไปนี้ใช้การแก้ไขสตริงเพื่อรวมข้อมูลเป็นสตริงเดียว:
Copy( $"{employeeRecord.Name} {employeeRecord.LastName} ({employeeRecord.Title})" )