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свойства element , VisualStyleElement.Partи VisualStyleElement.State параметра для инициализации 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 и более поздних версий: className имеет значение null.

Комментарии

Этот конструктор использует classNameпараметры , partи state для инициализации Classсвойств , Partи State .

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