Sdílet prostřednictvím


Funkce Copy

Platí pro: aplikace plátna modelem řízené aplikace

Zkopíruje text do schránky v zařízení, kde je aplikace spuštěna.

Description

Funkce Copy převezme libovolnou textovou hodnotu a zkopíruje ji do schránky. Bez ohledu na obsah textu bude schránka obsahovat prostý text bez zvláštního typu mime. Funkce je považována za funkci s vedlejšími účinky a v důsledku toho ji lze použít pouze ve vlastnostech chování.

Poznámka:

Funkce Copy() je omezena na přístup udělený do schránky hostitelem aplikace. Výsledkem je, že scénáře vestavěných aplikací, jako Power Apps v SharePoint, vestavěné aplikace v Power BI, Teams atd. nepodporují Copy(). Ani jiné vestavěné scénáře nemusí tuto funkci podporovat. Tvůrci by měli použít IfError(), aby zajistili, že akce kopírování do schránky byla účinná, a pokud ne, aby uživatele správně upozornili, že se kopírování nezdařilo.

Syntaxe

Kopírovat( text )

  • text – Povinné. Text, který má být zkopírován do schránky.

Příklady

Textový vstup s tlačítkem Kopírovat

Funkci Copy lze použít k vytvoření stylu ovládacích prvků zadávání, který se vyskytuje v mnoha aplikacích, kde tlačítko přímo na textu zadání umožňuje rychlou kopii textu zadání do schránky.

  1. Vložte na obrazovku ovládací prvek pro Text input. Výchozí bude název TextInput1.
  2. Vložte ovládací prvek Button na obrazovku vedle ovládacího prvku zadání.
  3. Nastavte vlastnost OnSelect tlačítka na Copy( TextInput1.Text ).

Když je tlačítko vybráno, text z ovládacího prvku pro zadávání textu se zkopíruje do schránky.

Zpracování textu pro vložení do schránky

Funkce Copy přijímá text, který může být sám o sobě výrazem, který nějakým způsobem manipuluje s textem z vaší aplikace. Aplikace může mít například záznam zaměstnance, který obsahuje jméno, příjmení a titul zaměstnance. Vzorec může vložit tyto informace do schránky jako jeden kus textu. Následující příklad používá interpolaci řetězců ke spojení dat do jednoho řetězce:

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