Legato
Legato

GoFiler Legato Script Reference

 

Legato v 1.5b

Application v 5.24b

  

 

Chapter EightData Functions (continued)

DataSheetGetColumnProps Function

Overview

The DataSheetGetColumnProps function returns key properties for a specified column.

Syntax/Parameters

Syntax

string[] = DataSheetGetColumnProps ( handle hSheet, int column );

Parameters

hSheet

A handle to a Data Sheet Object.

column

An int specifying a zero-based column index.

Return Value

Returns a string array containing various data fields related to the column or an empty array on failure. Use the GetLastError function to retrieve error information.

Remarks

Not all Data Sheet Objects have a column array. If there is no column array, an empty array will be returned and the GetLastError function will report the error code ERROR_FUNCTION_NOT_SUPPORTED.

The following fields are returned:

  Element Key Name   Description  
  ColumnIndex   Current zero-based index of column.  
  ColumnName   The name of the column. If not specified, a viewer/editor such as Data View will letter the columns starting with ‘A’.  
  InitialIndex   The initial zero-based position.  
  ControlFlags   A hex representation of the bitwise column flags in the form of DS_CC_. See introduction to this section for details.  
  Tip   Hover popup tip.†  
  pxPosition   Absolute position of column in default units.  
  pxRelative   Relative position of column in default units. This only applies if the sheet is being displayed and will differ from pxPosition if scrolled.  
  pxMeasured   The measured width of the legend text in default units.  
  pxWidth   Width as adjusted and displayed in default units.  
  pxHeight   Measured height in default units.  
  pvWidth   Specified width as a pvalue.  
  Width   Specified width as a a CSS measurement.  
  Color   Color of text in hex as RGB.  

 

† Not supported in Data Control GUI.

Related Functions

Platform Support

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

Legato IDE, Legato Basic

Page revised 2024-10-21