Components All New MacOS Windows Linux iOS
Examples Mac & Win Server Client Guides Statistic FMM Blog Deprecated Old

DynaPDF.Table.SetColorFloat

Sets or changes the specified color and color space.

Component Version macOS Windows Linux Server iOS SDK
DynaPDF 3.5 ✅ Yes ✅ Yes ✅ Yes ✅ Yes ✅ Yes
MBS( "DynaPDF.Table.SetColorFloat"; Table; Row; Col; Type; CS; CSHandle; Colors )   More

Parameters

Parameter Description Example
Table The identifier for the table. $Table
Row The row number. Range from 0 to DynaPDF.Table.GetNumRows-1. Pass -1 for all rows. 0
Col The column number. Range from 0 to DynaPDF.Table.GetNumCols-1. Pass -1 for all columns. 0
Type Which table color. Can be BackColor, BorderColor, GridHorzColor, GridVertColor, ImageColor or TextColor. "TextColor"
CS The colorspace to use. Can be DeviceRGB, DeviceCMYK, DeviceGray. "DeviceRGB"
CSHandle Color space handle of non-device color space.
Colors Color values. Pass as many parameters as needed. Range from 0 to 1. 0

Result

Returns OK or error.

Description

Sets or changes the specified color and color space.
The number of color components must match the number of components of the color space. The text color is inherited from the table, column, and row, in this order. The border color is inherited from columns and rows but not from the table since the table has its own border.
Extended color spaces will be deleted when the PDF file in memory is closed or when DynaPDF.Release was called. The color spaces must be recreated when the table should be drawn in another PDF file. Color space handles may change when recreated in another PDF file. All such colors should be set again to avoid issues with invalid color space handles.
Width exception of Lab colors, color values are in the range 0 through 1. Lab colors support different ranges for the L*, a*, and b* components:
L*-> 0..100
a* -> -128 .. 127
b* -> -128 .. 127

Examples

Set green text color:

MBS( "DynaPDF.Table.SetColorFloat"; $table; $Row; $Col; "TextColor"; "DeviceRGB"; 0; 1; 0 )

See also

Release notes

Blog Entries

This function checks for a license.

Created 18th August 2014, last changed 10th December 2021


DynaPDF.Table.SetColor - DynaPDF.Table.SetFlags