WinStudio

SetGridRowColFontByColumnName Method

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

SetGridRowColFont Method

SetGridRowColColor Method

SetGridRowColColorByColumnName Method

SetGridRowColImage Method

SetGridRowColImageByColumnName Method