.. highlightlang:: us

.. _pagepaste:

PagePaste
=========

.. index:: PagePaste

.. us.tag  PagePaste NOTREADYENGLISH PageSet clipboard New590

:ref:`PagePaste` inserts clipboard data into a UniPlot document page.
The function supports only the OLE format and the UniPlot format.

.. function::  bool = PagePaste(hPage)

.. us.return

**Return Value**

*bool* TRUE if the function is successfully; otherwise FALSE.

.. us.params

**Parameters**

.. uparam:: hPage

   Identifies the page.

.. us.comment

**Comment**

:ref:`PagePaste` is used internally by :ref:`PageInsertFromClipboard` for 
OLE- and UniPlot data.

. us.example

**Example**

Copies all given pages into one page

::

   // hvSourcePage: Vector with page handles to copy 
   // hDestPage: page handle of the destination page
   def my_copy_pages(hvSourcePage, hDestPage)
   {
      EmptyClipboard();
      for (h in hvSourcePage) {
         b = PageCopyToClipboard(h);
         b = PagePaste(hDestPage);
      }
      EmptyClipboard();
      PageReplot(hDestPage);
      return b;
   }

.. us.history

**History**

.. list-table::
   :header-rows: 1

   * - Version
     - Description
   * - 5.9
     - New

.. seealso::
   :ref:`overview-document-pages`,
   :ref:`overview-clipboard`,
   :ref:`PageCopyToClipboard`,
   :ref:`PageInsertFromClipboard`

:sub:`id-1231727`