ฟังก์ชัน Copy

ใช้กับ: แอปพื้นที่ทำงาน แอปแบบจำลอง

คัดลอกข้อความไปยังคลิปบอร์ดบนอุปกรณ์ที่แอปทำงานอยู่

รายละเอียด

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

หมายเหตุ

ฟังก์ชัน Copy() ถูกจำกัดการเข้าถึงคลิปบอร์ดโดยโฮสต์ของแอป เป็นผลให้สถานการณ์แอปที่ฝังตัว เช่น Power Apps ใน SharePoint, แอปที่ฝังอยู่ใน Power BI, Teams ฯลฯ ไม่รองรับ Copy() สถานการณ์แบบฝังอื่นๆ อาจไม่รองรับฟังก์ชันนี้เช่นกัน ผู้สร้างควรใช้ IfError() เพื่อให้แน่ใจว่าการดำเนินการคัดลอกไปยังคลิปบอร์ดใช้งานได้ และหากไม่เป็นไปตามที่คาดหวังก็ถือเป็นการแจ้งเตือนผู้ใช้ว่าการคัดลอกล้มเหลว

ไวยากรณ์

คัดลอก( ข้อความ )

• ข้อความ - จำเป็น ข้อความที่จะคัดลอกไปยังคลิปบอร์ด

ตัวอย่าง

ป้อนข้อความด้วยปุ่มคัดลอก

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

1. แทรกตัวควบคุม การป้อนข้อความ บนหน้าจอ โดยค่าเริ่มต้น ชื่อจะเป็น TextInput1
2. แทรกตัวควบคุม ปุ่ม บนหน้าจอ ถัดจากตัวควบคุมอินพุต
3. ตั้งค่าคุณสมบัติ OnSelect ของปุ่มเป็น Copy( TextInput1.Text )

เมื่อเลือกปุ่มนี้ ข้อความจากตัวควบคุมการป้อนข้อความจะถูกคัดลอกไปยังคลิปบอร์ด

กำลังประมวลผลข้อความเพื่อใส่ในคลิปบอร์ด

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

Copy( $"{employeeRecord.Name} {employeeRecord.LastName} ({employeeRecord.Title})" )