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.cs

Задает этот 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 метод, чтобы убедиться, что текущий визуальный стиль предоставляет определение элемента, заданного classNameпараметром , partи state параметрами.

SetParameters(VisualStyleElement)

Исходный код:

VisualStyleRenderer.cs

Задает этот 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 указывающее новые значения ClassPartсвойств и State свойств.

Исключения

ArgumentException

element не определяется текущим визуальным стилем.

InvalidOperationException

Операционная система не поддерживает визуальные стили.

–или–

Визуальные стили отключены пользователем в операционной системе.

–или–

Визуальные стили не применяются к клиентской области окон приложений.

Примеры

В следующем примере кода показано, как использовать SetParameters(VisualStyleElement) метод для задания VisualStyleRenderer нового VisualStyleElement. Этот пример кода является частью более крупного примера, предоставленного для 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 .