.. highlightlang:: us

.. _tablegetattrib:

TableGetAttrib
==============

.. index:: TableGetAttrib

.. us.tag  TableGetAttrib table.get New400

:ref:`TableGetAttrib` liefert für jede Zelle einen Attributwert als Matrix der
gesamten Tabelle oder eines Ausschnitts

.. function::  rmAttrib = TableGetAttrib(hTable)
    rmAttrib = TableGetAttrib(hTable, rvSel)

.. us.return

**Returnwert**

*rmAttrib* ist eine Matrix mit den Attributwerten. Jedes Element
kann eine der folgenden Kombinationen enthalten:

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

      * - Wert
        - Bedeutung
      * - TABLE_CLIPTEXT
        - Text am Zellenrand abschneiden
      * - TABLE_AUTOSIZE_WIDTH
        - Zellenbreite automatisch berechnen
      * - TABLE_AUTOSIZE_HEIGHT
        - Zellenhöhe automatisch berechnen
      * - TABLE_WORDWRAP
        - Automatischer Zeilenumbruch an Leerzeichen
      * - TABLE_SHRINKFONT
        - Verkleinert die Schriftgröße, damit der Text horizontal in 
          die Zelle paßt.

.. us.params

**Parameter**

.. uparam:: hTable

   *hTable* ist die Zugriffsnummer (Handle) des mit
   :ref:`TableCreate` erzeugten Tabellen-Objekts.

.. uparam:: rvSel

   *rvSel* ist ein Vektor mit vier Elementen, der einen Bereich
   der Tabelle auswählt:

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

      * - Element
        - Beschreibung
      * - rvSel[1]
        - Linke Zelle der Selektion
      * - rvSel[2]
        - Obere Zelle der Selektion
      * - rvSel[3]
        - Rechte Zelle der Selektion
      * - rvSel[4]
        - Untere Zelle der Selektion

   Die Spalten- und Zeilennummerierung beginnt mit 1. 

.. us.example

**Beispiel**

Im folgenden Beispiel wird das Clippen am Zellenrand abgeschaltet:

::

   rmAttrib = TableGetAttrib(hTable);
   rmAttrib = rmAttrib & ~TABLE_CLIPTEXT;
   TableSetAttrib(hTable, rmAttrib);

Im folgenden Beispiel wird die Größe automatisch berechnet:

::

   rmAttrib = TableGetAttrib(hTable);
   rmAttrib = rmAttrib | (TABLE_AUTOSIZE_WIDTH | TABLE_AUTOSIZE_HEIGHT);
   TableSetAttrib(hTable, rmAttrib);

.. seealso::
   :ref:`uberblick-tabellenobjekt`,
   :ref:`TableSetAlign`

:sub:`id-1957019`