This function peeks into the clipboard and returns the format of the
data that is currently stored in the clipboard. Currently, Hollywood
recognizes only text and image data in the clipboard. Thus, this
function will return one of the following type specifiers:
#CLIPBOARD_TEXT:
-
Text is currently on the clipboard.
#CLIPBOARD_IMAGE:
-
Graphics data is currently on the clipboard.
#CLIPBOARD_EMPTY:
-
The clipboard is currently empty.
#CLIPBOARD_UNKNOWN:
-
Hollywood did not recognize the data currently
stored on the clipboard.
To retrieve the data from the clipboard, you have to use GetClipboard()
but keep in mind that the data on the clipboard can change at any time.
So there is no guarantee that the data that was on the clipboard when you
called PeekClipboard()
will still be there when you call GetClipboard().