Class XbpClipBoard() Foundation
Class function of the XbpClipBoard class.
The XbpClipBoard class provides objects that access the clipboard. The clipboard allows data to be easily exchanged between different processes.
Managing the clipboard is similar to managing a file. Both must be opened before reading or writing information and must later be closed. The unique aspect of the clipboard is that only one single process (more precisely: one single thread) at a time can access the clipboard. This is similar to a file being exclusively opened. As long as the Xbase++ application has the clipboard open, no other application or thread can access it. It is therefore extremely important to close the clipboard after it has been opened by an XbpClipBoard object.
The clipboard can simultaneously hold information that appears in different formats. For example, ASCII text can be stored in the clipboard along with a graphic in the metafile format. Access to different formats in the clipboard is controlled using the :getBuffer() method of the XbpClipBoard object. The formats that are currently available in the clipboard are determined using the :queryFormats() method. The following constants are defined in the XBP.CH file to identify the different clipboard formats:
|XBPCLPBRD_TEXT||Data in ASCII text format|
|XBPCLPBRD_BITMAP||Graphic data in a bitmap format|
|XBPCLPBRD_METAFILE||Graphic data in a meta file format|
|nFormat||User-defined format, see :registerFormat()|
If you see anything in the documentation that is not correct, does not match your experience with the particular feature or requires further clarification, please use this form to report a documentation issue.