Home Man
Search
Today's Posts
Register

Linux & Unix Commands - Search Man Pages

CentOS 7.0 - man page for xmclipboardregisterformat (centos section 3)

XmClipboardRegisterFormat(library call) 		  XmClipboardRegisterFormat(library call)

NAME
       XmClipboardRegisterFormat -- A clipboard function that registers a new format

SYNOPSIS
       #include <Xm/CutPaste.h>
       int XmClipboardRegisterFormat (display, format_name, format_length)
	       Display * display;
	       char    * format_name;
	       int     format_length;
       (void)

DESCRIPTION
       XmClipboardRegisterFormat  registers  a	new  format.  Each format stored on the clipboard
       should have a length associated with it; this length must be known to the  clipboard  rou-
       tines.  Formats	are known as targets in the Inter-Client Communication Conventions Manual
       (ICCCM). All of the formats specified by version 1.1 of the ICCCM conventions are  prereg-
       istered.  Any  other format that the application wants to use must either be 8-bit data or
       be registered via this routine.	Failure to register the length of  the	data  results  in
       incompatible applications across platforms having different byte-swapping orders.

       display	 Specifies  a  pointer	to  the Display structure that was returned in a previous
		 call to XOpenDisplay or XtDisplay.

       format_name
		 Specifies the string name for the new format (target).

       format_length
		 Specifies the format length in bits (8, 16, or 32).

RETURN
       XmClipboardBadFormat
		 The format_name must not be NULL, and the format_length must be 8, 16, or 32.

       XmClipboardSuccess
		 The function was successful.

       XmClipboardLocked
		 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.

       XmClipboardFail
		 The  function	failed because the specified format was already registered with a
		 different length from that specified now. If a specified format was already reg-
		 istered  with	the  same  length  as  that  specified now, XmClipboardSuccess is
		 returned.

RELATED
       XmClipboardStartCopy(3).

							  XmClipboardRegisterFormat(library call)


All times are GMT -4. The time now is 01:47 PM.

Unix & Linux Forums Content Copyrightę1993-2018. All Rights Reserved.
UNIX.COM Login
Username:
Password:  
Show Password