SetGridRowColFontByColumnName Method (WinStudio Scripts)

Applies To

IWSFormComponent interface, grid objects

Definition

Assigns a font face and size to be used in a specified cell, and automatically adjusts the height of the row, if necessary, to accommodate the assigned font.

Syntax

object.SetGridRowColFont( integer, string1, string2, Boolean )

  Part   Description
object Required. A reference to a grid component.
integer Required. Indicates the row number.

Row numbering is 1-based.

string1 Required. The name of the column component, as it is known in the WinStudio form metadata.
string2 Required. Font descriptor string consisting of fourteen comma-separated values:

    Size,0,0,0,Weight,Italic,Underline,Strikethrough,0,0,0,0,0,FontFamily

For more information about these values, see "Settings" below.

Boolean Required. Determines whether the system should adjust the height of the row, if necessary, to accommodate the font face and size being assigned.
  • TRUE: The system is to adjust the row height if necessary.
  • FALSE: The system should not adjust the row height.

Unless you have specific reasons for doing otherwise, you should use a value of TRUE.

Settings

  Setting   Description
Size A decimal value representing the point size.
Weight Range from 0 (non-bold) to 700 (bold).
Italic 0 = Normal text.

1 = Italicized text.

Underline 0 = Text not underlined.

1 = Text underlined.

Strikethrough 0 = Normal text.

1 = Text struck through.

FontFamily Name of the font to be used.

Example

Sub Main()
   'Sets the font for specified cells to 12-point bold Times New Roman.
   Dim fontDescriptor As String = "12,0,0,0,700,0,0,0,0,0,0,0,0,Times New Roman"  
   ThisForm.Components("grid").SetGridRowColFontByColumnName(4, "custName", fontDescriptor, True)
End Sub
Related topics