Udostępnij za pośrednictwem

Funkcja Copy

  • Artykuł

Dotyczy: Aplikacje kanwy Aplikacje oparte na modelu

Kopiuje tekst do Schowka na urządzeniu, na którym działa aplikacja.

opis

Funkcja Copy przenosi dowolną wartość tekstu i kopiuje ją do Schowka. Niezależnie od zawartości tekstu schowek będzie zawierać zwykły tekst bez żadnego specjalnego typu mime. Funkcja jest uważana za funkcję z efektami ubocznymi i dlatego może być używana tylko we właściwościach zachowania.

Uwaga

Funkcja Copy() jest ograniczona dostępem do schowka przez hosta aplikacji. W rezultacie scenariusze osadzonych aplikacji, takich jak Power Apps w SharePoint, osadzonych aplikacji w Power BI Teams itp. nie obsługują Copy(). Inne scenariusze osadzone mogą także nie obsługiwać tej funkcji. Twórcy powinni używać funkcji IfError(), aby upewnić się, że akcja kopiowania do Schowka była skuteczna, a jeśli nie, aby prawidłowo alarmować użytkownika o tym, że kopia nie powiodła się.

Składnia

Kopiuj( tekst )

  • text - Wymagane. Tekst do skopiowania dla schowka.

Przykłady

Wprowadzanie tekstu za pomocą przycisku kopiowania

Funkcja Copy może służyć do tworzenia stylu kontrolek wejściowych widocznych w wielu aplikacjach. Dzięki przyciskowi w odpowiednim miejscu do tekstu wejściowego można szybko skopiować tekst wejściowy do schowka.

  1. Wstaw kontrolkę Text input na ekranie. Domyślną nazwą będzie TextInput1.
  2. Wstaw kontrolkę Przycisk na ekranie obok kontrolki wejściowej.
  3. Ustaw dla właściwości OnSelect przycisku formułę Copy( TextInput1.Text ).

Po wybraniu przycisku tekst z kontrolki wprowadzania tekstu zostanie skopiowany do Schowka.

Przetwarzanie tekstu w schowku

Funkcja Copy akceptuje tekst, który może być wyrażeniem, które w jakiś sposób modyfikuje tekst z aplikacji. Na przykład aplikacja może zawierać rekord pracownika z jego imieniem, nazwiskiem i tytułem. Formuła może umieścić te informacje w schowku jako jeden fragment tekstu. W następującym przykładzie użyto interpolacji danych w jeden ciąg:

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