AppendStyle(Style,String) Method

Merges a repository-managed Style instance with a structural Style.

Syntax

Visual Basic

'Declaration
 
Protected Overloads Function AppendStyle( _
   ByVal style1 As Style, _
   ByVal structuralKey As String _
) As Style

C#

protected Style AppendStyle( 
   Style style1,
   string structuralKey
)

Parameters

style1

The primary Style instance.

structuralKey

A string identifying the structural style, this must be the same key that was used when the structural style was registered within the SmartRenderer, typically as part of it's InitializeStyles method.

Remarks

Inheritors of UIElement use this method to append a structural style to an existing, repository-managed style. Appending the styles means appending the CSS class name of the structural style to the CSS class attribute that will be rendered at run-time. Structural style rules are meant to take precedence over other styles, because they ensure the layout and functional behavior needed by the view element. For this reason, the StyleRepository is responsible for ensuring their CSS class definitions appear at the top of the embedded CSS style sheet rendered into the HTML at run-time.

Before AppendStyle can be called, the SmartRenderer must be initialized on the UI elements' scene graph. AppendStyle returns the primary style, style1, unchanged when this prerequisite isn't met.

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