diff -r 51a74ef9ed63 -r ae94777fff8f Symbian3/SDK/Source/GUID-BBBA5C6C-4E8B-513A-8FA1-C7A04C54C140.dita --- a/Symbian3/SDK/Source/GUID-BBBA5C6C-4E8B-513A-8FA1-C7A04C54C140.dita Wed Mar 31 11:11:55 2010 +0100 +++ b/Symbian3/SDK/Source/GUID-BBBA5C6C-4E8B-513A-8FA1-C7A04C54C140.dita Fri Jun 11 12:39:03 2010 +0100 @@ -1,47 +1,47 @@ - - - - - -Clipboard -

The Symbian platform supports the concept of cut, copy and -paste by providing a clipboard. An application can copy data to the clipboard -and the same data can then be pasted in by the same application or by any -other application.

-

The clipboard is a resource which is shared by all applications. An application -must, therefore, hold the clipboard for the minimum time possible.

-
Cut, copy and paste

The clipboard is encapsulated -by the CClipboard class. Applications use this class when -they place data on, or retrieve data from the clipboard.

It is implemented -as a direct file store. When the data is placed on the clipboard, it is stored -in the clipboard's store as a stream or a network of streams. Every data type -placed on the clipboard is identified by a UID. This allows a pasting application -to identify the required data.

It uses a stream dictionary to maintain -UID and stream ID pairs, and always makes the stream dictionary the root stream -of the store.

The essential features of the CClipboard class -are shown in the following diagram:

- Clipboard class structure - -

Any type of data can be placed on the clipboard. When retrieving -data, applications check the UID in the stream dictionary to determine whether -there is any data relevant to them. The following diagram illustrates a typical -situation:

- Clipboard store - -
-
-Using Clipboard - -Direct file -stores -Dictionary -stores -UID manipulation - + + + + + +Clipboard +

The Symbian platform supports the concept of cut, copy and +paste by providing a clipboard. An application can copy data to the clipboard +and the same data can then be pasted in by the same application or by any +other application.

+

The clipboard is a resource which is shared by all applications. An application +must, therefore, hold the clipboard for the minimum time possible.

+
Cut, copy and paste

The clipboard is encapsulated +by the CClipboard class. Applications use this class when +they place data on, or retrieve data from the clipboard.

It is implemented +as a direct file store. When the data is placed on the clipboard, it is stored +in the clipboard's store as a stream or a network of streams. Every data type +placed on the clipboard is identified by a UID. This allows a pasting application +to identify the required data.

It uses a stream dictionary to maintain +UID and stream ID pairs, and always makes the stream dictionary the root stream +of the store.

The essential features of the CClipboard class +are shown in the following diagram:

+ Clipboard class structure + +

Any type of data can be placed on the clipboard. When retrieving +data, applications check the UID in the stream dictionary to determine whether +there is any data relevant to them. The following diagram illustrates a typical +situation:

+ Clipboard store + +
+
+Using Clipboard + +Direct file +stores +Dictionary +stores +UID manipulation +
\ No newline at end of file