Functional specification
61
CDE/Motif PST
CDEnext
TIMESTAMP
Used to query the timestamp that the PDM used to acquire ownership of
the
PDM_MANAGER
selection.
The client can initiate a conversion on any of the supported targets. The supported targets are described below.
3.3
PDM_START Selection Target
The running of a PDM requires two phases to complete.
Phase 1 involves a
SelectionRequest
and
SelectionNotify
on the
PDM_START
target to start a PDM.
During the
SelectionRequest
, Video X-Server and Print X-Server connection information is passed to the
PDM in a client-owned property. During the
SelectionNotify
, PDM startup status is returned in the same
property. For phase 1, the selection window, selection atom, all target atoms, type atoms, property atoms and
property windows are created relative to the Selection X-Server.
Phase 2 involves a
ClientMessage
to the client carrying shutdown information about the PDM, typically
"OK"
or
"CANCEL"
. For phase 2, all atom values and communication windows are created relative to the Print X-Server.
Phase 1 starts when the client creates the following:
requestor
A client owned window that will act as the selection requestor, and will
hold
property
. This window can be the same as
client_window
.
Note: when using with the
PDM_MBOX
target, it is important to use the
same
requestor
window id.
property
A client owned property for the two-way transfer of information as
described in Phase 1 of the protocol.
client_window
A client owned window that will live long enough to handle the
ClientMessage
describing
"OK"
or
"CANCEL"
as described in Phase
2 of the protocol.
Clients wishing to start a PDM can then make the following
ConvertSelection
request:
display
selection_display (
may be the same as
print_display)
selection
PDM_MANAGER
target
PDM_START
property
property
requestor
requestor
time
timestamp of the gesture that initiated the
ConvertSelection
request
The
PDM_START
target is parameterized, and the property named in the request (
property
) contains the
following list of information:
video_display
representing the display in the form "host:display[.screen]"
video_window
representing the window id in the form "0x123"