Inhalt in die Zwischenablage schreiben (pasteboard.write)

Deklaration

pasteboard.write(Daten [, Uniform_Type_Identifier ])
pasteboard.write(Zwischenablageelement [, Optionen ])
pasteboard.write(Liste_von_Zwischenablageelementen [, Optionen ])

Parameter

• Daten
  String; Inhalt, der in die Zwischenablage geschrieben werden soll.
  Tabellenwert; Zwischenablageelement, dessen Schlüssel ein Uniform Type Identifier und dessen Wert Stringdaten sind (ab Version 20260428 unterstützt).
  Tabellenwert; Liste von Zwischenablageelementen, wobei jedes Element ein Zwischenablageelement ist (ab Version 20260428 unterstützt).

• Uniform_Type_Identifier
  Textwert, optional; Uniform Type Identifiers, Standardwert "public.utf8-plain-text"

• Optionen Tabellenwert, optional (ab Version 20260428 unterstützt)
  local_only Boolescher Wert; nur lokal speichern, ab iOS 10 unterstützt
  expiration_date Zahlenwert; Unix-Zeitstempel in Sekunden, ab iOS 10 unterstützt

  Struktur eines Zwischenablageelements

  {
      ["public.utf8-plain-text"] = "普通文本",
      ["public.rtf"] = "RTF 数据",
      ["public.html"] = "HTML 数据",
      ["public.png"] = "PNG 二进制数据",
      ...
  }

Rückgabewert

• Erfolg
  Boolescher Wert; bei erfolgreichem Schreiben true, andernfalls false.

Beschreibung

Schreibt Inhalt in die Systemzwischenablage.
Stichwörter: in die Zwischenablage, das Clipboard oder die Kopierablage schreiben
Wenn ein Zwischenablageelement oder eine Liste von Zwischenablageelementen übergeben wird, werden für dasselbe Zwischenablageelement Darstellungen in mehreren Formaten geschrieben. iOS 9 ignoriert das Argument Optionen.

Beispiel

pasteboard.write("hello") -- Den Text "hello" in die Zwischenablage schreiben
--
pasteboard.write(screen.image():png_data(), 'public.png') -- Den aktuellen Screenshot in die Zwischenablage schreiben
--
pasteboard.write([[{\rtf1\ansi\deff0
{\fonttbl{\f0 Helvetica;}}
{\colortbl;\red255\green0\blue0;}
\f0\fs32 normal {\b bold} {\i italic} \cf1 red\cf0\par
\u20320?\u22909?
}]], "public.rtf") -- RTF-Richtext in die Zwischenablage schreiben

-- Ab Version 20260428 werden mehrere Formate für dasselbe Zwischenablageelement unterstützt
pasteboard.write({
    ["public.utf8-plain-text"] = "normal bold italic red\n你好",
    ["public.rtf"] = [[{\rtf1\ansi\deff0
{\fonttbl{\f0 Helvetica;}}
{\colortbl;\red255\green0\blue0;}
\f0\fs32 normal {\b bold} {\i italic} \cf1 red\cf0\par
\u20320?\u22909?
}]],
    ["public.html"] = [[<p>normal <b>bold</b> <i>italic</i> <span style="color:red">red</span><br>你好</p>]],
}, {
    local_only = true,
    expiration_date = os.time() + 3600,
})

Hinweis: Der obige Code verwendet die Funktion screen.image aus einem anderen Kapitel.