RadioButtonRenderer.RenderMatchingApplicationState Property

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

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 show the render style is changed depending on the application state. This code example is part of a larger example provided for the RadioButtonRenderer class.

private void button1_Click(object sender, EventArgs e)
{
    Application.VisualStyleState =
        Application.VisualStyleState ^
        VisualStyleState.ClientAndNonClientAreasEnabled;

    GroupBoxRenderer.RenderMatchingApplicationState = true;
    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

    RadioButtonRenderer.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 the RenderMatchingApplicationState property is true, the RadioButtonRenderer uses the setting from the Application.RenderWithVisualStyles property to determine the rendering style. If RenderMatchingApplicationState is false, the renderer will always render using visual styles.