Commande coller

Article
06/13/2023

La commande coller copie le contenu du Presse-papiers dans l’espace de travail. Les appareils vidéo numériques reconnaissent cette commande.

Pour envoyer cette commande, appelez la fonction mciSendString avec le paramètre lpszCommand défini comme suit.

_stprintf_s(
  lpszCommand, 
  TEXT("paste %s %s %s"), 
  lpszDeviceID, 
  lpszItem, 
  lpszFlags
);

Paramètres

lpszDeviceID

Identificateur d’un appareil MCI. Cet identificateur ou alias est attribué lorsque l’appareil est ouvert.

lpszItem

Un ou plusieurs des indicateurs suivants.

Valeur	Signification
au rectangle	Spécifie l’emplacement dans le cadre où les données sont collées. Le coin supérieur gauche du rectangle correspond au coin supérieur gauche des données ajoutées. Si le rectangle a une taille différente de zéro en X ou Y, le contenu du Presse-papiers est mis à l’échelle dans ces dimensions lorsqu’il est collé dans le cadre. En cas d’omission, le rectangle est défini par défaut sur l’ensemble du cadre. Si cet indicateur est spécifié en mode « insert » (la valeur par défaut), toute région située à l’extérieur du rectangle est peinte d’une couleur unie.
flux de flux audio	Spécifie le flux audio dans l’espace de travail affecté par la commande. S’il n’existe qu’un seul flux audio dans le Presse-papiers, les données audio sont collées dans le flux désigné. S’il existe plusieurs flux audio dans le Presse-papiers, le flux indique le numéro de départ des séquences de flux. Si vous utilisez cet indicateur et souhaitez également coller une vidéo, vous devez également utiliser l’indicateur « flux vidéo ». (Si aucun indicateur n’est spécifié, tous les flux audio et vidéo sont collés et conservent leurs numéros de flux d’origine.)
insert	Spécifie que les données sont insérées dans l’espace de travail. Toutes les données après le point d’insertion sont déplacées vers l’avant dans l’espace de travail pour faire de la place. Il s’agit de la valeur par défaut.
overwrite	Spécifie que les données sont copiées dans l’espace de travail en écrivant sur toutes les données existantes après le point d’insertion. Les indicateurs « insert » et « overwrite » déterminent si les images sont détruites ou déplacées pendant l’opération de collage, et non la façon dont les données sont collées dans chaque image.
à positionner	Spécifie la position dans l’espace de travail à laquelle les données sont collées. S’il est omis, la valeur par défaut est la position actuelle.
flux vidéo	Spécifie le flux vidéo dans l’espace de travail affecté par la commande. S’il n’existe qu’un seul flux vidéo dans le Presse-papiers, les données vidéo sont collées dans le flux désigné. S’il existe plusieurs flux vidéo dans le Presse-papiers, le flux indique le numéro de départ des séquences de flux. Si vous utilisez cet indicateur et souhaitez également coller l’audio, vous devez également utiliser l’indicateur « flux audio ». (Si aucun indicateur n’est spécifié, tous les flux audio et vidéo sont collés et conservent leurs numéros de flux d’origine.)

lpszFlags

Il peut s’agir de « wait », « notify », « test » ou d’une combinaison de ceux-ci. Pour plus d’informations sur ces indicateurs, consultez Les indicateurs d’attente, de notification et de test.

Valeur renvoyée

Retourne zéro en cas de réussite ou d’erreur dans le cas contraire.

Notes

Aucun signal n’est présent dans les données copiées à partir du Presse-papiers. La modification devient permanente uniquement lorsque les données sont explicitement enregistrées ; toutefois, la lecture se comporte comme si les données ont été ajoutées.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]

Voir aussi

MCI
Chaînes de commande MCI