Custom fonts and colors

Main Features ››
Parent Previous Next

Custom fonts and colors

With M!Table you can define individual fonts and colors for almost every table item.

Functions and flags

MTblSetCellFont / MTblGetCellFont / MTblGetEffCellFont
MTblSetCellTextColor / MTblGetCellTextColor / MTblGetEffCellTextColor
MTblSetCellBackColor / MTblGetCellBackColor / MTblGetEffCellBackColor

MTblSetColumnFont / MTblGetColumnFont
MTblSetColumnTextColor / MTblGetColumnTextColor
MTblSetColumnBackColor / MTblGetColumnBackColor

Column lines
MTblDefineColLines / MTblQueryColLines
MTblDefineLastLockedColLine / MTblQueryLastLockedColLine

Column header
MTblSetColumnHdrFont / MTblGetColumnHdrFont / MTblGetEffColumnHdrFont
MTblSetColumnHdrTextColor / MTblGetColumnHdrTextColor / MTblGetEffColumnHdrTextColor
MTblSetColumnHdrBackColor / MTblGetColumnHdrBackColor / MTblGetEffColumnHdrBackColor
MTblSetColumnHdrFreeBackColor / MTblGetColumnHdrFreeBackColor / MTblGetEffColumnHdrFreeBackColor

Column header group
MTblSetColHdrGrpFont / MTblGetColHdrGrpFont / MTblGetEffColHdrGrpFont
MTblSetColHdrGrpTextColor / MTblGetColHdrGrpTextColor / MTblGetEffColHdrGrpTextColor
MTblSetColHdrGrpBackColor / MTbGetColHdrGrpBackColor / MTblGetEffColHdrGrpBackColor

Focus frame
MTblDefineFocusFrame / MTblQueryFocusFrame

MTblSetHeadersBackColor / MTblGetHeadersBackColor

MTblSetAltRowBackColors / MTblGetAltRowBackColors
MTblSetRowFont / MTblGetRowFont
MTblSetRowTextColor / MTblGetRowTextColor
MTblSetRowBackColor / MTblGetRowBackColor

Row lines
MTblDefineRowLines / MTblQueryRowLines

Row header
MTblSetRowHdrBackColor / MTblGetRowHdrBackColor / MTblGeEffRowHdrBackColor

MTblSetCornerBackColor / MTblGetCornerBackColor / MTblGetEffCornerBackColor

MTblSetTipFont / MTblGetTipFont
MTblSetTipTextColor / MTblGetTipTextColor
MTblSetTipBackColor / MTblGetTipBackColor
MTblSetTipFrameColor / MTblGetTipFrameColor

Tree nodes
MTblSetTreeNodeColors / MTblGetTreeNodeColors

Tree lines
MTblDefineTreeLines / MTblQueryTreeLines


Hints and tips

How the effective font/color is determined
What the hell means effective? Effective means "actually used".
Let's have a look at a case study:

! Set the cell font, size and enhancements are undefined
Call MTblSetCellFont( tbl1.col1, 2, "Arial", MTBL_UNDEF_FONT_SIZE, MTBL_UNDEF_FONT_ENH, 0 )
! Set the column font, enhancements are undefined
Call MTblSetColumnFont( tbl1.col1, "Courier New", 10, MTBL_UNDEF_FONT_ENH, 0 )
! Set the row font, enhancements are undefined
Call MTblSetRowFont( tbl1, 2, MTBL_FONT_UNDEF_NAME, 12, MTBL_UNDEF_FONT_ENH, 0 )
! Set the table font
Call SalFontSet( tbl1, "MS Sans Serif", 8, FONT_EnhBold )

What is the effective cell font??
First M!Table checks the cell's font definition. In this case it founds that the name is defined, so the name ( "Arial" ) is used.
Then the column's font definition is checked. It has a defined size, so it's used ( 10 ).
Now the row's font definition is checked, but the missing font enhancements are not defined here.
Finally the table's font is used to get the missing definitions, so our effective cell font is "Arial", 10, FONT_EnhBold.

With MTblDefineEffCellPropDet you can control how the effective font/color is determined, e.g. you can define that M!Table checks the row font definition prior to the column font definition and/or that font enhancements are combined.

M!Table provides functions to get the effective font/color, e.g. MTblGetEffCellFont.

Created with the Personal Edition of HelpNDoc: Easily create EPub books