a1200   NEWS   APPS   DOCS   ABOUT
a1200
----
a1200
----
Autodocs
 Devices:
 clipboard.device
  CBD_CHANGEHOOK
  CBD_CURRENTREADID
  CBD_CURRENTWRITEID
  CBD_POST
  CMD_READ
  CMD_UPDATE
  CMD_WRITE
Include
GuruMeditation
Docs » Autodocs » clipboard.device » CBD_POST

NAME

	CBD_POST -- Post availability of a clip to the clipboard.

FUNCTION

	Indicate to the clipboard device that data is available for
use by accessors of the clipboard. This is intended to be
used when a cut is large, in a private data format, and/or
changing frequently, and it thus makes sense to avoid
converting it to an IFF form and writing it to the clipboard
unless another application wants it. The post provides a
message port to which the clipboard device will send a satisfy
message if the data is required.
If the satisfy message is received, the write associated with
the post must be performed. The act of writing the clip
indicates that the message has been received: it may then be
re-used by the clipboard device, and so must actually be
removed from the satisfy message port so that the port is not
corrupted.
If the application wishes to determine if a post it has
performed is still the current clip, it should check the
post's io_ClipID with that returned by the CBD_CURRENTREADID
command. If the current read io_ClipID is greater, the clip
is not still current.
If an application has a pending post and wishes to determine
if it should satisfy it (e.g. before it exits), it should
check the post's io_ClipID with that returned by the
CBD_CURRENTWRITEID command. If the current write io_ClipID is
greater, there is no need to satisfy the post.
IO REQUEST
io_Message mn_ReplyPort set up
io_Device preset by OpenDevice
io_Unit preset by OpenDevice
io_Command CBD_POST
io_Data pointer to satisfy message port
io_ClipID zero

RESULT

	io_Error	non-zero if an error occurred
io_ClipID the clip ID assigned to this post, to be used
in the write command if this is satisfied

Comments

Name:
E-mail: Use this if you want a message if you get a response, will not be shown.
Comment:
Select correct short for:

Abyss

AYS
FC
SCX
DC

Comments:

$VER: d0.se 1.14 Copyright © 2011-2020 Tobias Geijersson support at d0 dot se