Click here to Skip to main content
13,860,894 members
Click here to Skip to main content
Add your own
alternative version


118 bookmarked
Posted 27 Apr 2002
Licenced CPOL

Clipboard handling with .NET

, 27 Apr 2002
Rate this:
Please Sign up or sign in to vote.
An introduction to using the clipboard

The Clipboard

The clipboard is where your data is stored when you copy or cut some text or an image or a file or a folder. The clipboard is common across processes, which means we can use the clipboard as a mechanism to transfer data between two processes. Win32 gave us a Clipboard API with functions like OpenClipboard and GetClipboardData which most of you might be familiar with. In .NET Microsoft has encapsulated the functionality of most of these functions into some classes. The most prominent of these classes is a class which has been named aptly as Clipboard. It's a very simple class with just two functions. In this article, we'll see how to copy/paste text, images and also how to maintain clipboard data in multiple formats.

I'd like to thank James Johnson for his amazing help while I was fiddling with the clipboard. I didn't have a reference book to help me, but that didn't matter much as James more than made up for it. Poor Mike Dunn had to suffer some .NET talk when he walked into Bob's HungOut just as I was discussing an issue with James. Anyway let's get on with things now.

Copying text into the clipboard

The Clipboard class has a SetDataObject function which is used to insert clipboard data. It takes an Object as argument in the single argument overload. In the other overload it takes both an Object and a bool variable, which we can set to true if we want the clipboard to persist even after our application has exited. In our example program we'll use the second overload as that seems to be the more common situation, where we would want other programs to access what we have copied onto the clipboard.


Retrieving text from the clipboard

The Clipboard class also has a

function which returns an IDataObject. The IDataObject interface has a function called GetDataPresent which we use to determine if the IDataObject has data of a specific format.  We can use the static fields of the DataFormats class to verify that the format we expect is indeed available in the
. If GetDataPresent returns true, we can then use the GetData function to retrieve the data format that we are expecting.

    textBox1.Text = Clipboard.GetDataObject().GetData(DataFormats.Text).ToString();
    textBox1.Text  = "The clipboad does not contain any text";

Observe how I have copied some text from Notepad and pasted it into our sample program. You can also copy text from our program and paste it into Notepad. And I hope you like my XP theme and colors as well.

Copying/Retrieving images from the Clipboard

This is exactly the same as in copying and pasting text except that we use the DataFormats.Bitmap format instead of DataFormats.Text

    pictureBox1.Image = (Bitmap)Clipboard.GetDataObject().GetData(DataFormats.Bitmap);

I have copied from Paint Brush into our sample program. You can then copy something else using Paint Brush, come back to our program, copy the image and paste back into Paint Brush. The image has stretched a bit because I have set the SizeMode  property of the Picture control to StretchImage.

Maintain multiple formats in the Clipboard

There are situations where you are not sure what kind of data the target application of a copy/paste cycle is expecting in the clipboard. In such cases we can maintain multiple data formats in the clipboard, so that the target application can retrieve the data format it's expecting. In our sample, we'll copy both the text in the edit box as well as the image in the picture control into the clipboard. Now you can open Notepad and paste into it the text as well as open Paint Brush and paste into it the bitmap. I have provided a [Paste Both] button for ease of demonstration. Just run a second instance of the sample program and we can paste both the text and the image into the respective controls.

We make use of the DataObject class which implements the IDataObject interface. We call the SetData function twice, each time passing in a different format data. We use the following override of the function :-

public virtual void SetData(
   string format, //This indicates what type of data this is going to be
   bool autoConvert, //Set this true to allow automatic data format conversions
   object data //The actual data [which is in the format specified above]

The code is very straightforward. We create a DataObject object, use SetData twice, once with the text and then with the image, then we add this DataObject to the clipboard.

DataObject m_data = new DataObject();

Now you can paste both into Notepad as well as into any Graphics application that allows you to paste a Bitmap into it.


This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


About the Author

Nish Nishant
United States United States
Nish Nishant is a Principal Software Architect based out of Columbus, Ohio. He has over 17 years of software industry experience in various roles including Lead Software Architect, Principal Software Engineer, and Product Manager. Nish was a Microsoft Visual C++ MVP between 2002 and 2015.

Nish is an industry acknowledged expert in the Microsoft technology stack. He authored C++/CLI in Action for Manning Publications in 2005, and had previously co-authored Extending MFC Applications with the .NET Framework for Addison Wesley in 2003. In addition, he has over 140 published technology articles on and another 250+ blog articles on his WordPress blog. Nish is vastly experienced in team management, mentoring teams, and directing all stages of software development.

Contact Nish : If you are interested in hiring Nish as a consultant, you can reach him via his google email id voidnish.

Company Website :

You may also be interested in...

Comments and Discussions

GeneralInstructive article! Pin
Martin Haesemeyer30-Apr-02 23:53
memberMartin Haesemeyer30-Apr-02 23:53 
GeneralRe: Instructive article! Pin
Nish Nishant3-Jun-02 23:51
sitebuilderNish Nishant3-Jun-02 23:51 
GeneralNot strictly about this article, but Drag and Drop Pin
Paul Ingles29-Apr-02 6:07
memberPaul Ingles29-Apr-02 6:07 
GeneralRe: Not strictly about this article, but Drag and Drop Pin
Paul Ingles14-May-02 23:11
memberPaul Ingles14-May-02 23:11 
GeneralNice work Nish! Pin
Ernest Laurentin29-Apr-02 5:38
memberErnest Laurentin29-Apr-02 5:38 
GeneralRe: Nice work Nish! Pin
Nish Nishant29-Apr-02 5:51
sitebuilderNish Nishant29-Apr-02 5:51 
GeneralNice work Pin
Michael P Butler28-Apr-02 5:02
memberMichael P Butler28-Apr-02 5:02 
GeneralRe: Nice work Pin
David Wulff28-Apr-02 6:25
memberDavid Wulff28-Apr-02 6:25 
GeneralRe: Nice work Pin
Michael P Butler28-Apr-02 6:29
memberMichael P Butler28-Apr-02 6:29 
GeneralRe: Nice work Pin
David Wulff28-Apr-02 6:36
memberDavid Wulff28-Apr-02 6:36 
GeneralRe: Nice work Pin
Nish Nishant30-Apr-02 16:04
sitebuilderNish Nishant30-Apr-02 16:04 
GeneralRe: Nice work Pin
Nish Nishant28-Apr-02 7:35
sitebuilderNish Nishant28-Apr-02 7:35 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

Permalink | Advertise | Privacy | Cookies | Terms of Use | Mobile
Web03 | 2.8.190214.1 | Last Updated 28 Apr 2002
Article Copyright 2002 by Nish Nishant
Everything else Copyright © CodeProject, 1999-2019
Layout: fixed | fluid