DataGrid REALbasic Plugin

DataGridStyle.Mutate Method

Internally constructs a style as specified previously by setting the class properties.

Mutate()

Parameters

Remarks

ALWAYS use this after setting properties of the DataGridStyle class, if not then Styles will not work on Win32 and Linux systems, and also not on OS X in future versions.

We could have done this automatically internally, but for speed reasons its much better to leave this to the user.

Concept Example if we would have done it internally:
  1. The programmer sets font to Bold.
  2. DataGrid constructs a Win32 or ATSUI font.
  3. The programmer sets font size on the same style object.
  4. DataGrid constructs a Win32 or ATSUI font.
  5. The programmer sets font color on the same style object.
  6. DataGrid constructs a Win32 or ATSUI font.

The concept as it is with the Mutate method:
  1. The programmer sets font to Bold.
  2. The programmer sets font size on the same style object.
  3. The programmer sets font color on the same style object.
  4. The programmer tells the DataGrid to construct a Win32 or ATSUI font by calling the Mutate method.

Bottom line is that the mutate method is needed to maintain optimal speed, as this way Win32 or ATSUI font is only constructed once for the style rather than once for every property set on the style.

See Also

DataGridStyle Class