VisualStyleRenderer 생성자

정의

네임스페이스:

System.Windows.Forms.VisualStyles

어셈블리:

System.Windows.Forms.dll

VisualStyleRenderer 클래스의 새 인스턴스를 초기화합니다.

오버로드

VisualStyleRenderer(VisualStyleElement)	지정된 VisualStyleElement사용하여 VisualStyleRenderer 클래스의 새 인스턴스를 초기화합니다.
VisualStyleRenderer(String, Int32, Int32)	지정된 클래스, 파트 및 상태 값을 사용하여 VisualStyleRenderer 클래스의 새 인스턴스를 초기화합니다.

VisualStyleRenderer(VisualStyleElement)

지정된 VisualStyleElement사용하여 VisualStyleRenderer 클래스의 새 인스턴스를 초기화합니다.

public:
 VisualStyleRenderer(System::Windows::Forms::VisualStyles::VisualStyleElement ^ element);

public VisualStyleRenderer (System.Windows.Forms.VisualStyles.VisualStyleElement element);

new System.Windows.Forms.VisualStyles.VisualStyleRenderer : System.Windows.Forms.VisualStyles.VisualStyleElement -> System.Windows.Forms.VisualStyles.VisualStyleRenderer

Public Sub New (element As VisualStyleElement)

매개 변수

element

VisualStyleElement

이 VisualStyleRenderer 나타내는 VisualStyleElement.

예외

InvalidOperationException

운영 체제는 비주얼 스타일을 지원하지 않습니다.

-또는-

운영 체제의 사용자가 비주얼 스타일을 사용하지 않도록 설정합니다.

-또는-

시각적 스타일은 애플리케이션 창의 클라이언트 영역에 적용되지 않습니다.

ArgumentException

element 현재 비주얼 스타일에 의해 정의되지 않습니다.

예제

다음 코드 예제에서는 VisualStyleRenderer(VisualStyleElement) 생성자를 사용하여 VisualStyleRenderer만드는 방법을 보여 줍니다. 이 코드 예제는 VisualStyleRenderer 클래스 개요에 제공된 더 큰 코드 예제의 일부입니다.

    // Set the VisualStyleRenderer to a new element.
private:
    bool SetRenderer(VisualStyleElement^ element)
    {
        if (!VisualStyleRenderer::IsElementDefined(element))
        {
            return false;
        }

        if (renderer == nullptr)
        {
            renderer = gcnew VisualStyleRenderer(element);
        }
        else
        {
            renderer->SetParameters(element);
        }

        return true;
    }

// Set the VisualStyleRenderer to a new element.
private bool SetRenderer(VisualStyleElement element)
{
    if (!VisualStyleRenderer.IsElementDefined(element))
    {
        return false;
    }

    if (renderer == null)
    {
        renderer = new VisualStyleRenderer(element);
    }
    else
    {
        renderer.SetParameters(element);
    }

    return true;
}

' Set the VisualStyleRenderer to a new element.
Private Function SetRenderer(ByVal element As _
    VisualStyleElement) As Boolean

    If Not VisualStyleRenderer.IsElementDefined(element) Then
        Return False
    End If

    If renderer Is Nothing Then
        renderer = New VisualStyleRenderer(element)
    Else
        renderer.SetParameters(element)
    End If

    Return True
End Function

설명

이 생성자는 element 매개 변수의 VisualStyleElement.ClassName, VisualStyleElement.Part및 VisualStyleElement.State 속성을 사용하여 Class, Part및 State 속성을 초기화합니다.

이 생성자를 사용하기 전에 staticIsElementDefined 메서드를 호출하여 현재 비주얼 스타일이 element 매개 변수로 지정된 요소에 대한 정의를 제공하는지 확인해야 합니다.

VisualStyleRenderer(String, Int32, Int32)

지정된 클래스, 파트 및 상태 값을 사용하여 VisualStyleRenderer 클래스의 새 인스턴스를 초기화합니다.

public:
 VisualStyleRenderer(System::String ^ className, int part, int state);

public VisualStyleRenderer (string className, int part, int state);

new System.Windows.Forms.VisualStyles.VisualStyleRenderer : string * int * int -> System.Windows.Forms.VisualStyles.VisualStyleRenderer

Public Sub New (className As String, part As Integer, state As Integer)

매개 변수

className

String

이 VisualStyleRenderer 나타낼 요소의 클래스 이름입니다.

part

Int32

이 VisualStyleRenderer 나타낼 요소의 부분입니다.

state

Int32

이 VisualStyleRenderer 나타낼 요소의 상태입니다.

예외

InvalidOperationException

운영 체제는 비주얼 스타일을 지원하지 않습니다.

-또는-

운영 체제의 사용자가 비주얼 스타일을 사용하지 않도록 설정합니다.

-또는-

시각적 스타일은 애플리케이션 창의 클라이언트 영역에 적용되지 않습니다.

ArgumentException

className, part및 state 조합은 현재 비주얼 스타일에 의해 정의되지 않습니다.

ArgumentNullException

.NET 5 이상: classNamenull.

설명

이 생성자는 className, part및 state 매개 변수를 사용하여 Class, Part및 State 속성을 초기화합니다.

이 생성자를 사용하기 전에 staticIsElementDefined 메서드를 호출하여 현재 비주얼 스타일이 className, part및 state 매개 변수로 지정된 요소에 대한 정의를 제공하는지 확인해야 합니다.