GroupBoxRenderer.RenderMatchingApplicationState Property

Reference

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Gets or sets a value indicating whether the renderer uses the application state to determine rendering style.

public:
 static property bool RenderMatchingApplicationState { bool get(); void set(bool value); };

public static bool RenderMatchingApplicationState { get; set; }

static member RenderMatchingApplicationState : bool with get, set

Public Shared Property RenderMatchingApplicationState As Boolean

Property Value

Boolean

true if the application state is used to determine rendering style; otherwise, false. The default is true.

Examples

The following code example uses the RenderMatchingApplicationState property to change whether a group box is rendered using visual styles. This code example is part of a larger example provided for the GroupBoxRenderer class.


// Match application style and toggle visual styles off
// and on for the application.
    private void button1_Click(object sender, EventArgs e)
    {
        GroupBoxRenderer.RenderMatchingApplicationState = true;
        Application.VisualStyleState = 
            Application.VisualStyleState ^ 
            VisualStyleState.ClientAndNonClientAreasEnabled;

        if (Application.RenderWithVisualStyles)
            this.Text = "Visual Styles Enabled";
        else
            this.Text = "Visual Styles Disabled";
    }

' Match application style and toggle visual styles off
' and on for the application.
Private Sub button1_Click(ByVal sender As Object, ByVal e As EventArgs) _
    Handles button1.Click

    GroupBoxRenderer.RenderMatchingApplicationState = True

    Application.VisualStyleState = _
        Application.VisualStyleState Xor _
        VisualStyleState.ClientAndNonClientAreasEnabled

    If Application.RenderWithVisualStyles Then
        Me.Text = "Visual Styles Enabled"
    Else
        Me.Text = "Visual Styles Disabled"
    End If

End Sub

Remarks

If RenderMatchingApplicationState is true, the GroupBoxRenderer uses the setting from Application.RenderWithVisualStyles to determine the rendering style. If RenderMatchingApplicationState is false, the renderer will always render using visual styles.

Applies to