VisualStyleRenderer Конструкторы

Определение

Пространство имен:

System.Windows.Forms.VisualStyles

Сборка:

System.Windows.Forms.dll

Инициализирует новый экземпляр класса VisualStyleRenderer.

Перегрузки

Имя.	Описание
VisualStyleRenderer(VisualStyleElement)	Инициализирует новый экземпляр VisualStyleRenderer класса с помощью заданного VisualStyleElement.
VisualStyleRenderer(String, Int32, Int32)	Инициализирует новый экземпляр класса с помощью заданных значений VisualStyleRenderer класса, части и состояния.

VisualStyleRenderer(VisualStyleElement)

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

VisualStyleRenderer.cs

Инициализирует новый экземпляр VisualStyleRenderer класса с помощью заданного VisualStyleElement.

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

То VisualStyleElement , что это VisualStyleRenderer будет представлять.

Исключения

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

Комментарии

Этот конструктор использует VisualStyleElement.ClassNameVisualStyleElement.Partсвойства и VisualStyleElement.State свойства параметра для инициализации element свойств и инициализации ClassPartсвойств.State

Перед использованием этого конструктора необходимо вызвать staticIsElementDefined метод, чтобы проверить, предоставляет ли текущий визуальный стиль определение элемента, указанного параметром element .

VisualStyleRenderer(String, Int32, Int32)

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

VisualStyleRenderer.cs

Инициализирует новый экземпляр класса с помощью заданных значений 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и partstate параметры для инициализации инициализации ClassPartсвойств и State свойств.

Перед использованием этого конструктора необходимо вызвать staticIsElementDefined метод, чтобы проверить, предоставляет ли текущий визуальный стиль определение элемента, указанного параметром className, partи state параметрами.