Écrire du contenu dans le presse-papiers (pasteboard.write)

Déclaration

pasteboard.write(données [, identificateur de type universel])
pasteboard.write(élément du presse-papiers [, options])
pasteboard.write(liste d’éléments du presse-papiers [, options])

Paramètres

• Données
  Type chaîne, contenu à écrire dans le presse-papiers Type table, élément du presse-papiers, clé = identificateur de type universel, valeur = données textuelles (pris en charge depuis 20260428) Type table, liste d’éléments du presse-papiers, chaque élément étant un élément du presse-papiers (pris en charge depuis 20260428)

• Identificateur de type universel
  Type texte, Uniform Type Identifiers, "public.utf8-plain-text" par défaut

• Options Type table, paramètre facultatif (pris en charge depuis 20260428) local_only booléen, conserver uniquement sur cet appareil, pris en charge par iOS 10 et versions ultérieures expiration_date numérique, horodatage Unix en secondes, pris en charge par iOS 10 et versions ultérieures

  Structure d’un élément du presse-papiers

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

Valeur de retour

• Succès
  Type booléen, renvoie true en cas d’écriture réussie et false sinon

Description

Écrit du contenu dans le presse-papiers du système. Mots-clés : écrire dans le presse-papiers. Lorsqu’un élément ou une liste d’éléments est fourni, plusieurs représentations de format sont écrites dans le même élément du presse-papiers. iOS 9 ignore le paramètre options.

Exemple

pasteboard.write("hello") -- Écrire le texte "hello" dans le presse-papiers
--
pasteboard.write(screen.image():png_data(), 'public.png') -- Écrire la capture d’écran actuelle dans le presse-papiers
--
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") -- Écrire du texte enrichi RTF dans le presse-papiers

-- Les versions postérieures à 20260428 prennent en charge plusieurs formats dans un même élément
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,
})

Remarque : le code ci-dessus utilise la fonction hors de ce chapitre screen.image.