Object Model - Common Methods and Functions - ApplyFontOverrides

This method applies a font-layout stored in a TTFontLayoutOverride-object to the tooltip-component.

[Visual Basic]
Public Sub ApplyFontOverrides( _
	ByVal fontOverride As TTFontLayoutOverride
public void ApplyFontOverrides(
	TTFontLayoutOverride fontOverride 



A TTFontLayoutOverride-object which contains a tooltip font-layout.


This method applies a font-layout stored in a TTFontLayoutOverride-object to the tooltip-component in order to override the default values defined for the component. Usually this method is used internally by the ApplyOverrides()-method of the different components. Only ApplyOverrides() makes sure that the component saves the complete current layout before the override-values are applied. The saved layout can later be restored with a call to RestoreOriginalLayout(). This ApplyOverrides()-RestoreOriginalLayout()-cycle happens automatically for the override-values defined through the Override-property of a control (see Provided Properties).

ApplyFontOverrides() does not make such a copy of the layout-values it is going to change! If ApplyFontOverrides() is going to be used directly to apply a new font-layout, the application developer is responsible to make sure that the original (or default) values can be restored.

Actually, the only scenario, where the direct use of ApplyFontOverrides() could be useful, is if the override-values specified for a control should also dynamically be overridden. (E.G. the tooltip-font for a specific control should look different every time the tooltip does pop-up.) 


The following code creates a TTFontLayoutOverride-object, sets the values for the layout-properties to be overridden and applies it to the component.

'Declare and create an instance of TTFontLayoutOverride...

Dim myFontLayout As ToolTipsFactory.Shared.TTFontLayoutOverride

myFontLayout = New ToolTipsFactory.Shared.TTFontLayoutOverride

'Declare a color-array for the font gradient-colors...

Dim fontCols(2) As Color

fontCols(0) = Color.Indigo

fontCols(1) = Color.Red

'Assign values to the properties to be overridden..

myFontLayout.TextStyle = TextDrawingStyleOverride.LinearGradient

myFontLayout.FontGradientColors = fontCols

'Apply the new font-layout to the component...


After the execution of this code, the next time a tooltip, provided to a control by MultiLine, will be displayed, it will appear with the applied font. If the original font-layout has not been saved somehow, the applied font-layout will become the default font-layout for the tooltips of all controls on the same form.