Object Model - Common Methods and Functions - ApplyBorderOverrides

This method applies a border-layout stored in a TTBorderOverride-object to the tooltip-component.

[Visual Basic]
Public Sub ApplyBorderOverrides( _
	ByVal BorderOverride As TTBorderOverride
public void ApplyBorderOverrides(
	TTBorderOverride borderOverride



A TTBorderOverride-object which contains a tooltip border-layout.


This method applies a border-layout stored in a TTBorderOverride-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 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).

ApplyBorderOverrides() does not make such a copy of the layout-values it is going to change! If ApplyBorderOverrides() is going to be used directly to apply a new border-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 ApplyBorderOverrides() could be useful, is if the override-values specified for a control should also dynamically be overridden. (E.G. the tooltip-border for a specific control should look different every time the tooltip does pop-up.) 


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

'Declare and create an instance of TTBorderOverride...

Dim myBorder As ToolTipsFactory.Shared.TTBorderOverride

myBorder = New ToolTipsFactory.Shared.TTBorderOverride

'Assign values to the properties to be overridden..

myBorder.Border = BorderStyleOverride.Normal

myBorder.BorderWith = 5

myBorder.BorderColor = Color.Yellow

'Apply the new border-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 border. If the original border-layout has not been saved somehow, the applied border will become the default border layout for the tooltips of all controls on the same form.