Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   3690 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

XmClipboardInquirePendingItems(3X) OSF/MotifXmClipboardInquirePendingItems(3X)

NAME
       XmClipboardInquirePendingItems  -  A  clipboard function that returns a
       list of data_id/private_id pairs

SYNOPSIS
       #include <Xm/Xm.h> #include <Xm/CutPaste.h>

       int  XmClipboardInquirePendingItems  (display,	window,	  format_name,
		 item_list,  count)	 Display	  * display;	  Win‐
       dow	     window;	  char		   * format_name;      XmClip‐
       boardPendingList* item_list;	 unsigned long	  * count;

DESCRIPTION
       XmClipboardInquirePendingItems  returns	a  list	 of data_id/private_id
       pairs for the specified format name.  A data item is considered pending
       if  the	application  originally passed it by name, the application has
       not yet copied the data, and the item has not  been  deleted  from  the
       clipboard.   The application is responsible for freeing the memory pro‐
       vided by this function to store the list.  To  free  the	 memory,  call
       XtFree.

       This  function  is used by an application when exiting, to determine if
       the data that is passed by name should be sent to the clipboard.	 Spec‐
       ifies  a pointer to the Display structure that was returned in a previ‐
       ous call to XOpenDisplay or XtDisplay.  Specifies a widget's window  ID
       that  relates  the  application	window to the clipboard.  The widget's
       window ID can be obtained by  using  XtWindow.	The  same  application
       instance	 should pass the same window ID to each of the clipboard func‐
       tions that it calls.  Specifies a string that contains the name of  the
       format  for  which  the	list  of  data	ID/private  ID	pairs is to be
       obtained.  Specifies the address of the array  of  data	ID/private  ID
       pairs  for  the specified format name.  This argument is a type XmClip‐
       boardPendingList.  The application is responsible for freeing the  mem‐
       ory provided by this function for storing the list.  Specifies the num‐
       ber of items returned in the list.  If there is no data for the	speci‐
       fied  format  name, or if there is no item on the clipboard, this argu‐
       ment equals zero.

RETURN VALUE
       The function is successful.  The function failed because the  clipboard
       was  locked  by	another	 application.  The application can continue to
       call the function again with the same parameters until  the  lock  goes
       away.   This  gives  the application the opportunity to ask if the user
       wants to keep trying or to give up on the operation.

RELATED INFORMATION
       XmClipboardStartCopy(3X).

					    XmClipboardInquirePendingItems(3X)

Vote for polarhome