VisualStyleRenderer.SetParameters 메서드

정의

네임스페이스:

System.Windows.Forms.VisualStyles

어셈블리:

System.Windows.Forms.dll

이 VisualStyleRenderer의 현재 비주얼 스타일 요소를 설정합니다.

오버로드

SetParameters(String, Int32, Int32)	이 VisualStyleRenderer를 지정된 클래스, 파트 및 상태 값에서 나타내는 비주얼 스타일 요소로 설정합니다.
SetParameters(VisualStyleElement)	이 VisualStyleRenderer를 지정된 VisualStyleElement에서 나타내는 비주얼 스타일 요소로 설정합니다.

SetParameters(String, Int32, Int32)

이 VisualStyleRenderer를 지정된 클래스, 파트 및 상태 값에서 나타내는 비주얼 스타일 요소로 설정합니다.

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

public void SetParameters (string className, int part, int state);

member this.SetParameters : string * int * int -> unit

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

매개 변수

className

String

Class 속성의 새 값입니다.

part

Int32

Part 속성의 새 값입니다.

state

Int32

State 속성의 새 값입니다.

예외

ArgumentException

className, part 및 state의 조합이 현재 비주얼 스타일로 정의되지 않는 경우

InvalidOperationException

운영 체제에서 비주얼 스타일을 지원하지 않는 경우

또는

운영 체제에서 사용자가 비주얼 스타일을 사용하지 않도록 설정한 경우

또는

비주얼 스타일이 애플리케이션 창의 클라이언트 영역에 적용되지 않은 경우

설명

이 메서드는 내부적으로 속성의 IsSupported 값을 확인합니다. 이 메서드를 호출하기 전에 메서드를 IsElementDefined 호출하여 현재 비주얼 스타일이 , part및 state 매개 변수로 지정된 요소에 className대한 정의를 제공하는지 확인해야 합니다.

SetParameters(VisualStyleElement)

이 VisualStyleRenderer를 지정된 VisualStyleElement에서 나타내는 비주얼 스타일 요소로 설정합니다.

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

public void SetParameters (System.Windows.Forms.VisualStyles.VisualStyleElement element);

member this.SetParameters : System.Windows.Forms.VisualStyles.VisualStyleElement -> unit

Public Sub SetParameters (element As VisualStyleElement)

매개 변수

element

VisualStyleElement

VisualStyleElement, Class 및 Part 속성의 새 값을 지정하는 State입니다.

예외

ArgumentException

element가 현재 비주얼 스타일로 정의되지 않는 경우

InvalidOperationException

운영 체제에서 비주얼 스타일을 지원하지 않는 경우

또는

운영 체제에서 사용자가 비주얼 스타일을 사용하지 않도록 설정한 경우

또는

비주얼 스타일이 애플리케이션 창의 클라이언트 영역에 적용되지 않은 경우

예제

다음 코드 예제에서는 메서드를 사용하여 SetParameters(VisualStyleElement) 새 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

설명

이 메서드는 내부적으로 속성의 IsSupported 값을 확인합니다. 이 메서드를 호출하기 전에 메서드를 IsElementDefined 호출하여 현재 비주얼 스타일이 매개 변수로 지정된 element 요소에 대한 정의를 제공하는지 확인해야 합니다.