Legato
Legato

GoFiler Legato Script Reference

 

Legato v 1.5b

Application v 5.24b

  

 

Chapter ElevenSGML Functions (continued)

HTMLColumnSetWidth Function

Overview

The HTMLColumnSetWidth function sets the width of a column for a managed table.

Syntax/Parameters

Syntax

int = HTMLColumnSetWidth ( handle hObject, int column, pvalue width | string width );

Parameters

hObject

A handle to an HTML Writer Object.

column

An int specifying the zero-based column index to which to apply the width value. The column position must have already been defined.

width

A pvalue (dword) or a string specifying the width as a measurement. See PVALUE Data Type in Section 11.1 Introduction to SGML Support.

Return Value

An int as a ERROR_NONE (0) for no error or a formatted error code.

Remarks

Generally, if percentages are used as widths, each column should have a percent and all percent values should add to 100%. For other measurements, the overall width of the table will be governed by the specified width. In all cases, the end browser rendering agent will determine the final width of a column based on the specifications (or lack thereof) and the content of the table column as well as other columns.

Widths can be set at any time during the life of the table. However, the column must have been instantiated either by defining the total columns in the table or by adding cells.

If percentages are used, they are translated into physical widths internally and translated back to percentages and the table is rendered in code. As a consequence, rounding errors may result in the percentages not matching exactly. In addition, if the percentages do not add to 100%, they are weighted and apportioned appropriately.

Spanned columns cannot have a width set.

Related Functions 

Platform Support

Go13, Go16, GoFiler Complete, GoFiler Corporate, GoFiler, GoFiler Lite, GoXBRL

Legato IDE, Legato Basic