.. highlightlang:: us

.. _tablesetattrib:

TableSetAttrib
==============

.. index:: TableSetAttrib

.. us.tag  TableSetAttrib table.get New400

:ref:`TableSetAttrib` setzt für jede Zelle einen Attributwert.

.. function::  bool = TableSetAttrib(hTable, rmAttrib)
    bool = TableSetAttrib(hTable, rmAttrib, rvSel)

.. us.return

**Returnwert**

*bool* ist TRUE (1), wenn die Funktion erfolgreich war und
FALSE (0), wenn ein Fehler aufgetreten ist.

.. us.params

**Parameter**

.. uparam:: hTable

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

.. uparam:: rmAttrib

   *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.

.. 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:`TableGetAttrib`,
   :ref:`TableGetAlign`

:sub:`id-1076107`