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

Определение

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

System.Windows.Forms.VisualStyles

Сборка:

System.Windows.Forms.dll

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

Перегрузки

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

VisualStyleRenderer(VisualStyleElement)

Инициализирует новый экземпляр класса 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.ClassName, VisualStyleElement.Partи VisualStyleElement.State параметра element для инициализации свойств 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 параметров.