.. highlightlang:: us

.. _xyzsetmatrixrange:

XYZSetMatrixRange
=================

.. index:: XYZSetMatrixRange

.. us.tag  XYZSetMatrixRange ENGLISH XYZSet_data

:ref:`XYZSetMatrixRange` sets the range of the data matrix in the x/y-plane.

.. function::  bool = XYZSetMatrixRange(hData, rvRect)

.. us.return

**Return Value**

If the function succeeds, the return value *bool* is TRUE (1); otherwise
it is FALSE (0).

.. us.params

**Parameters**

.. uparam:: hData

   Is the handle of a dataset created with :ref:`XYZCreate`.

.. uparam:: rvRect

   *rvRect* is a vector with 4 elements:

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

      * - Value
        - Meaning
      * - rvRect[1]
        - x-coordinate
      * - rvRect[2]
        - y-coordinate
      * - rvRect[3]
        - x-coordinate
      * - rvRect[4]
        - y-coordinate

.. seealso::
   :ref:`overview-xyz-datasets`,
   :ref:`XYZCreateFromMatrix`

:sub:`id-805574`