Skip to Main Content
Volume 7A: XView Programming Manual
book

Volume 7A: XView Programming Manual

by Dan Heller
October 1994
Intermediate to advanced content levelIntermediate to advanced
770 pages
22h 58m
English
O'Reilly Media, Inc.
Content preview from Volume 7A: XView Programming Manual
Notify_error
notify_post_destroy(client, status, when)
Notify_client client;
Destroy_status status;
Notify_event_type when;
NOTIFY_INVAL
is returned if status or when is not defined. After notifying a client to
destroy itself, all references to client are purged from the Notifier.
20.7.5 Delivery Time of Destroy Events
Unlike a client event notification, the Notifier does not try to detect when it is safe to post a
destroy notification. Thus, a destroy notification can come at any time. It is up to the good
judgement of a caller of notify_post_destroy() or notify_die() (described in
Section 20.10, “Notifier Control”) to make the call when a client is not likely to be in the
middle of accessing its data structures.
If status is DESTROY_CHECKING and the argument when is NOTIFY_IMMEDIATE, then
notify_post_destroy() may return NOTIFY_DESTROY_VETOED, if the client does not
want to go away. See Section 20.9.5, “Modifying an Objects’ Destruction,” for details on
these values.
Often you want to tell a client to go away at a safe time. This implies that delivery of the
destroy event will be delayed, in which case the return value of notify_post_des-
troy() cannot be NOTIFY_DESTROY_VETOED because the client has not been asked yet. To
get around this problem, the Notifier will flush the destroy event of a checking/destroy pair of
events if the checking phase is vetoed. Thus, a common idiom is:
(void) notify_post_dest
Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
and much more.
Start your free trial

You might also like

Volume 6A: Motif Programming Manual

Volume 6A: Motif Programming Manual

David Brennan, Dan Heller, Paula Ferguson
Java™ Media APIs: Cross-Platform Imaging, Media, and Visualization

Java™ Media APIs: Cross-Platform Imaging, Media, and Visualization

Alejandro Terrazas, John Ostuni, Michael Barlow

Publisher Resources

ISBN: 9780937175873