.. highlightlang:: us .. _tablesetalign: TableSetAlign ============= .. index:: TableSetAlign .. us.tag TableSetAlign table.set New400 :ref:`TableSetAlign` setzt die Textausrichtung für die Tabelle oder für einen Ausschnitt der Tabelle. .. function:: bool = TableSetAlign(hTable, rmAlign) bool = TableSetAlign(hTable, rmAlign, 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:: rmAlign *rmAlign* ist eine Matrix mit den Textausrichtungen. Jedes Element kann eine der folgenden Kombinationen enthalten: .. list-table:: :header-rows: 1 * - Wert - Bedeutung * - LEFT | TOP - Linksoben * - LEFT | MIDDLE - Links-Mitte * - LEFT | BOTTOM - Linksunten * - CENTER | TOP - Mitte-Oben * - CENTER | MIDDLE - Mitte * - CENTER | BOTTOM - Mitte-Unten * - RIGHT | TOP - Rechtsoben * - RIGHT | MIDDLE - Rechts-Mitte * - RIGHT | BOTTOM - Rechtsunten .. uparam:: rvSel *rvSel* ist ein Vektor mit vier Elementen, der einen Zellenbereich 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 werden alle Texte am oberen Rand ausgerichtet, ohne das die horizontale Ausrichtung geändert wird. :: rmAlign = TableGetAlign(hTable); rmAlign = rmAlign & ~(TOP | MIDDLE | BOTTOM) | TOP; TableSetAlign(hTable, rmAlign); .. seealso:: :ref:`uberblick-tabellenobjekt`, :ref:`TableGetAlign` :sub:`id-425530`