.. highlightlang:: us

.. _pagesetforegroundpagename:

PageSetForegroundPageName
=========================

.. index:: PageSetForegroundPageName

.. us.tag  PageSetForegroundPageName ENGLISH PageSet New400

:ref:`PageSetForegroundPageName` selects the page given by its name to be displayed 
in the foreground. The page must belong to the same document. 

.. function::  bool = PageSetForegroundPageName(hPage, ssName)

.. us.return

**Return Value**

If the function succeeds, the return value *bool* is TRUE (1); otherwise
it is FALSE (0). The function fails to set a foreground page if the foreground
page itself contains a foreground page or the foreground page is identical with
*hPage*.

.. us.params

**Parameters**

.. uparam:: hPage

   Identifies the page.

.. uparam:: ssName

   *ssName* is the name of the page that is used as a foreground.

.. seealso::
   :ref:`pagesetbackgroundpagename`,
   :ref:`overview-document-pages`,
   :ref:`page-select-master-page`,
   :ref:`PageCreate`,
   :ref:`PageGetTitle`
   :ref:`PageGetForegroundPageName`

:sub:`id-966895`