MergeWith(Style,Boolean) Method

Merges a supplied Style object into the current Style.

Syntax

Visual Basic

'Declaration
 
Public Overloads Sub MergeWith( _
   ByVal mergeStyle As Style, _
   ByVal noBorderColor As Boolean _
) 

C#

public void MergeWith( 
   Style mergeStyle,
   bool noBorderColor
)

Parameters

mergeStyle

The Style that is to be merged into the current instance.

noBorderColor

The BorderColor shall remain untouched during the merge.

Remarks

In general, this merge operation replaces any NotSet or empty properties of the current Style instance with those of the mergeStyle.

If any Font characteristics (i.e., boldness or underscore) are enabled on the current Style, then they remain enabled (even if they are disabled on the mergeStyle).

This merge method is not of sufficiently fine granularity to parse the CustomRules, and apply only differences or additions from the mergeStyle. If the current Style has no CustomRules, then it accepts the CustomRules of the mergeStyle, otherwise the mergeStyle's CustomRules are entirely disregarded.

Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2