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, указывающий новые значения свойств Class, Part и 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 .