Fungsi OleFlushClipboard (ole2.h)

Menjalankan urutan matikan clipboard. Ini juga merilis pointer IDataObject yang ditempatkan pada clipboard oleh fungsi OleSetClipboard .

Sintaks

HRESULT OleFlushClipboard();

Mengembalikan nilai

Fungsi ini mengembalikan S_OK pada keberhasilan. Nilai lain yang mungkin termasuk yang berikut ini.

Keterangan

OleFlushClipboard merender data dari objek data ke clipboard dan merilis penunjuk IDataObject ke objek data. Saat aplikasi yang meletakkan objek data pada clipboard sedang berjalan, clipboard hanya menyimpan penunjuk ke objek data, sehingga menyimpan memori. Jika Anda menulis aplikasi yang bertindak sebagai sumber operasi clipboard, Anda dapat memanggil fungsi OleFlushClipboard saat aplikasi Anda ditutup, seperti ketika pengguna keluar dari aplikasi Anda. Memanggil OleFlushClipboard memungkinkan penempelan dan penautan tempel objek OLE setelah pematian aplikasi.

Sebelum memanggil OleFlushClipboard, Anda dapat dengan mudah menentukan apakah data Anda masih berada di clipboard dengan panggilan ke fungsi OleIsCurrentClipboard .

OleFlushClipboard meninggalkan semua format yang ditawarkan oleh objek transfer data, termasuk format kompatibilitas OLE 1, pada clipboard sehingga tersedia setelah pematian aplikasi. Selain format kompatibilitas OLE 1, ini termasuk semua format yang ditawarkan pada media handel global (semua kecuali untuk TYMED_FILE) dan diformat dengan perangkat target NULL . Misalnya, jika aplikasi sumber data menawarkan format clipboard tertentu (misalnya cfFOO) pada objek IStorage , dan memanggil fungsi OleFlushClipboard , objek penyimpanan disalin ke dalam memori dan handel memori hglobal dimasukkan ke clipboard.

Untuk mengambil informasi di clipboard, Anda dapat memanggil fungsi OleGetClipboard dari aplikasi lain, yang membuat objek data default, dan hglobal dari clipboard lagi menjadi objek penyimpanan. Selain itu, enumerator FORMATETC dan metode IDataObject::QueryGetData semuanya akan menunjukkan dengan benar bahwa format clipboard asli (cfFOO) kembali tersedia di TYMED_ISTORAGE.

Untuk mengosongkan clipboard, panggil fungsi OleSetClipboard yang menentukan nilai NULL untuk parameternya. Aplikasi harus memanggil ini ketika ditutup jika tidak perlu meninggalkan data di clipboard setelah dimatikan, atau jika data akan ditempatkan pada clipboard menggunakan fungsi clipboard Windows standar.

Persyaratan

Lihat juga

IDataObject

OleGetClipboard

OleIsCurrentClipboard

OleSetClipboard