TableCell.PreferredWidth Property

Gets or sets the numerical value of the preferred width.

Namespace: DevExpress.XtraRichEdit.API.Native

Assembly: DevExpress.RichEdit.v19.1.Core.dll

Declaration

C#

float PreferredWidth { get; set; }

VB.NET

Property PreferredWidth As Single

Property Value

Type	Description
Single	A Single value specifying the cell width.

Remarks

How the PreferredWidth value is interpreted depends on other parameters, such as the TableCell.PreferredWidthType and the Document.Unit properties.

Note

If using the PreferredWidth property, specify the TableCell.PreferredWidthType beforehand.

We do not recommend setting different size to several cells within one column. It changes the layout of the whole column.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the PreferredWidth property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

tables-simple-example-t472346/CS/TablesSimpleExample/Form1.cs#L61

table.Rows[0].FirstCell.PreferredWidthType = WidthType.Fixed;
table.Rows[0].FirstCell.PreferredWidth = DevExpress.Office.Utils.Units.InchesToDocumentsF(0.8f);

word-document-api-table-examples/CS/TablesSimpleExample/Program.cs#L45

table.Rows[0].FirstCell.PreferredWidthType = WidthType.Fixed;
table.Rows[0].FirstCell.PreferredWidth = DevExpress.Office.Utils.Units.InchesToDocumentsF(0.8f);

gridview-how-to-copy-cells-data-to-clipboard-by-using-the-richeditdocumentserver-t257584/CS/Q577904/Form1.cs#L53

using(Graphics g = this.CreateGraphics()) {
    cell.PreferredWidth = Units.PixelsToDocumentsF(column.Key.VisibleWidth, g.DpiX);
}

how-to-generate-a-live-report-based-on-gridcontrol-content-t272175/CS/WindowsFormsApplication1/GridReportExtensions/SnapReportForGridGenerator.cs#L149

    cell.PreferredWidthType = WidthType.FiftiethsOfPercent;
    cell.PreferredWidth = (float)(50.0 * 100.0 / cell.Row.Cells.Count);
}

wpf-richedit-document-api-t213968/CS/DXRichEditControlAPISample/CodeExamples/TableActions.cs#L67

table[1, 1].PreferredWidthType = WidthType.Fixed;
table[1, 1].PreferredWidth = DevExpress.Office.Utils.Units.InchesToDocumentsF(1.5f);
#endregion #CreateFixedTable

VB.NET

tables-simple-example-t472346/VB/TablesSimpleExample/Form1.vb#L57

table.Rows(0).FirstCell.PreferredWidthType = WidthType.Fixed
table.Rows(0).FirstCell.PreferredWidth = DevExpress.Office.Utils.Units.InchesToDocumentsF(0.8F)

word-document-api-table-examples/VB/TablesSimpleExample/Program.vb#L36

table.Rows(0).FirstCell.PreferredWidthType = WidthType.Fixed
table.Rows(0).FirstCell.PreferredWidth = DevExpress.Office.Utils.Units.InchesToDocumentsF(0.8F)
'Set the second column width and cell height

gridview-how-to-copy-cells-data-to-clipboard-by-using-the-richeditdocumentserver-t257584/VB/Q577904/Form1.vb#L54

Using g As Graphics = Me.CreateGraphics()
    cell.PreferredWidth = Units.PixelsToDocumentsF(column.Key.VisibleWidth, g.DpiX)
End Using

how-to-generate-a-live-report-based-on-gridcontrol-content-t272175/VB/WindowsFormsApplication1/GridReportExtensions/SnapReportForGridGenerator.vb#L155

    cell.PreferredWidthType = WidthType.FiftiethsOfPercent
    cell.PreferredWidth = CSng(50.0 * 100.0 / cell.Row.Cells.Count)
End Sub

wpf-richedit-document-api-t213968/VB/DXRichEditControlAPISample/CodeExamples/TableActions.vb#L58

            table(1, 1).PreferredWidthType = WidthType.Fixed
            table(1, 1).PreferredWidth = DevExpress.Office.Utils.Units.InchesToDocumentsF(1.5F)
'            #End Region ' #CreateFixedTable