Click or drag to resize

HeightRule Enumeration

Specifies the rule for determining the height of an object.

Namespace: SautinSoft.Document
Assembly: SautinSoft.Document (in SautinSoft.Document.dll) Version: 2024.12.16
Syntax
public enum HeightRule
Members
Member nameValueDescription
Auto0 The height will grow automatically to accommodate all text inside an object.
AtLeast1 The height will be at least the specified height in points. It will grow, if needed, to accommodate all text inside an object.
Exact2 The height is specified exactly in points. Please note that if the text cannot fit inside the object of this height, it will appear truncated.
Example

See Developer Guide: Shows how to set a height for a table row

Shows how to set a height for a table row using C#
using SautinSoft.Document;
using SautinSoft.Document.Drawing;
using SautinSoft.Document.Tables;
using System.Linq;

namespace Example
{
    class Program
    {
        static void Main(string[] args)
        {
            // Get your free 100-day key here:   
            // https://sautinsoft.com/start-for-free/

            TableRowFormatting();
        }
        /// <summary>
        /// Shows how to set a height for a table row, repeat a row as header on each page, shift a row by N columns to the right.
        /// </summary>
        /// <remarks>
        /// Details: https://sautinsoft.com/products/document/help/net/developer-guide/tablerow-format.php
        /// </remarks>
        static void TableRowFormatting()
        {
            string docxPath = @"FormattedTable.docx";

            // Let's create document.
            DocumentCore dc = new DocumentCore();

            Section s = new Section(dc);
            dc.Sections.Add(s);


            int rows = 30;
            int columns = 5;

            Table t = new Table(dc, rows, columns);
            t.TableFormat.PreferredWidth = new TableWidth(100, TableWidthUnit.Percentage);
            t.TableFormat.Borders.SetBorders(MultipleBorderTypes.All, BorderStyle.Single, Color.DarkGray, 1);
            t.TableFormat.AutomaticallyResizeToFitContents = false;
            s.Blocks.Add(t);

            // Specify row height:
            // 10 mm - for odd rows.
            // 15 mm - for even rows.
            double oddHeight = LengthUnitConverter.Convert(10, LengthUnit.Millimeter, LengthUnit.Point);
            double evenHeight = LengthUnitConverter.Convert(15, LengthUnit.Millimeter, LengthUnit.Point);
            for (int r = 0; r < t.Rows.Count; r++)
            {
                TableRow row = t.Rows[r];
                if (r % 2 != 0)
                    row.RowFormat.Height = new TableRowHeight(evenHeight, HeightRule.AtLeast);
                else
                    row.RowFormat.Height = new TableRowHeight(oddHeight, HeightRule.AtLeast);
            }

            // Add the table caption - mark the specific row (for example: 0) to repeat on each page.
            TableRow firstRow = t.Rows[0];
            // Repeate as header row at the top of each page.
            // Note: Only the first row in the table can be set up as header.
            firstRow.RowFormat.RepeatOnEachPage = true;

            // Merge all cells into a one in the first row (Caption).
            int colSpan = firstRow.Cells.Count;
            for (int c = firstRow.Cells.Count - 1; c>=1; c--)
            {
                firstRow.Cells.RemoveAt(c);
            }
            // Specify how many columns this cell will take up.
            firstRow.Cells[0].ColumnSpan = colSpan;

            // Set the table caption in the first row and first cell. 
            Paragraph p = new Paragraph(dc);
            p.Inlines.Add(new Run(dc, "This is the Row 0 (RepeatOnEachPage = true)", new CharacterFormat() { FontColor = Color.Blue, Size = 20 }));
            p.ParagraphFormat.Alignment = HorizontalAlignment.Center;
            t.Rows[0].Cells[0].Blocks.Add(p);

            // Another interesting properties of TableRowFormat:
            // GridBefore and GridAfter
            // Add "Total" at the end of the table.
            TableRow rowTotal = new TableRow(dc);
            rowTotal.Cells.Add(new TableCell(dc));
            rowTotal.Cells[0].Content.Start.Insert(string.Format("Total rows: {0}", rows), new CharacterFormat() { FontColor = Color.Red, Size = 30 });

            // Shift the rowTotal to the right corner.
            // In our case, shift on 4 columns.
            rowTotal.RowFormat.GridBefore = columns-1;


            rowTotal.RowFormat.Height = new TableRowHeight(evenHeight, HeightRule.AtLeast);
            t.Rows.Add(rowTotal);            

            // Save our document into DOCX format.
            dc.Save(docxPath);

            // Open the result for demonstration purposes.
            System.Diagnostics.Process.Start(new System.Diagnostics.ProcessStartInfo(docxPath) { UseShellExecute = true });
        }
    }
}
Shows how to set a height for a table row using VB.Net
Imports SautinSoft.Document
Imports SautinSoft.Document.Drawing
Imports SautinSoft.Document.Tables
Imports System.Linq

Namespace Example
    Friend Class Program
        Shared Sub Main(ByVal args() As String)
            TableRowFormatting()
        End Sub
                ''' Get your free 100-day key here:   
                ''' https://sautinsoft.com/start-for-free/
        ''' <summary>
        ''' Shows how to set a height for a table row, repeat a row as header on each page, shift a row by N columns to the right.
        ''' </summary>
        ''' <remarks>
        ''' Details: https://sautinsoft.com/products/document/help/net/developer-guide/tablerow-format.php
        ''' </remarks>
        Private Shared Sub TableRowFormatting()
            Dim docxPath As String = "FormattedTable.docx"

            ' Let's create document.
            Dim dc As New DocumentCore()

            Dim s As New Section(dc)
            dc.Sections.Add(s)


            Dim rows As Integer = 30
            Dim columns As Integer = 5

            Dim t As New Table(dc, rows, columns)
            t.TableFormat.PreferredWidth = New TableWidth(100, TableWidthUnit.Percentage)
            t.TableFormat.Borders.SetBorders(MultipleBorderTypes.All, BorderStyle.Single, Color.DarkGray, 1)
            t.TableFormat.AutomaticallyResizeToFitContents = False
            s.Blocks.Add(t)

            ' Specify row height:
            ' 10 mm - for odd rows.
            ' 15 mm - for even rows.
            Dim oddHeight As Double = LengthUnitConverter.Convert(10, LengthUnit.Millimeter, LengthUnit.Point)
            Dim evenHeight As Double = LengthUnitConverter.Convert(15, LengthUnit.Millimeter, LengthUnit.Point)
            For r As Integer = 0 To t.Rows.Count - 1
                Dim row As TableRow = t.Rows(r)
                If r Mod 2 <> 0 Then
                    row.RowFormat.Height = New TableRowHeight(evenHeight, HeightRule.AtLeast)
                Else
                    row.RowFormat.Height = New TableRowHeight(oddHeight, HeightRule.AtLeast)
                End If
            Next r

            ' Add the table caption - mark the specific row (for example: 0) to repeat on each page.
            Dim firstRow As TableRow = t.Rows(0)
            ' Repeate as header row at the top of each page.
            ' Note: Only the first row in the table can be set up as header.
            firstRow.RowFormat.RepeatOnEachPage = True

            ' Merge all cells into a one in the first row (Caption).
            Dim colSpan As Integer = firstRow.Cells.Count
            For c As Integer = firstRow.Cells.Count - 1 To 1 Step -1
                firstRow.Cells.RemoveAt(c)
            Next c
            ' Specify how many columns this cell will take up.
            firstRow.Cells(0).ColumnSpan = colSpan

            ' Set the table caption in the first row and first cell. 
            Dim p As New Paragraph(dc)
            p.Inlines.Add(New Run(dc, "This is the Row 0 (RepeatOnEachPage = true)", New CharacterFormat() With {
                .FontColor = Color.Blue,
                .Size = 20
            }))
            p.ParagraphFormat.Alignment = HorizontalAlignment.Center
            t.Rows(0).Cells(0).Blocks.Add(p)

            ' Another interesting properties of TableRowFormat:
            ' GridBefore and GridAfter
            ' Add "Total" at the end of the table.
            Dim rowTotal As New TableRow(dc)
            rowTotal.Cells.Add(New TableCell(dc))
            rowTotal.Cells(0).Content.Start.Insert(String.Format("Total rows: {0}", rows), New CharacterFormat() With {
                .FontColor = Color.Red,
                .Size = 30
            })

            ' Shift the rowTotal to the right corner.
            ' In our case, shift on 4 columns.
            rowTotal.RowFormat.GridBefore = columns-1


            rowTotal.RowFormat.Height = New TableRowHeight(evenHeight, HeightRule.AtLeast)
            t.Rows.Add(rowTotal)

            ' Save our document into DOCX format.
            dc.Save(docxPath)

            ' Open the result for demonstration purposes.
            System.Diagnostics.Process.Start(New System.Diagnostics.ProcessStartInfo(docxPath) With {.UseShellExecute = True})
        End Sub
    End Class
End Namespace
See Also