VisualStyleRenderer Oluşturucular

Tanım

Ad Alanı:

System.Windows.Forms.VisualStyles

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

VisualStyleRenderer sınıfının yeni bir örneğini başlatır.

Aşırı Yüklemeler

VisualStyleRenderer(VisualStyleElement)	Verilen VisualStyleElementkullanarak sınıfının yeni bir örneğini VisualStyleRenderer başlatır.
VisualStyleRenderer(String, Int32, Int32)	Verilen sınıf, bölüm ve durum değerlerini kullanarak sınıfın yeni bir örneğini VisualStyleRenderer başlatır.

VisualStyleRenderer(VisualStyleElement)

Verilen VisualStyleElementkullanarak sınıfının yeni bir örneğini VisualStyleRenderer başlatır.

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)

Parametreler

element

VisualStyleElement

VisualStyleElement Bunun VisualStyleRenderer temsil edeceği bir.

Özel durumlar

InvalidOperationException

İşletim sistemi görsel stilleri desteklemez.

-veya-

Görsel stiller, işletim sistemindeki kullanıcı tarafından devre dışı bırakılır.

-veya-

Görsel stiller uygulama pencerelerinin istemci alanına uygulanmaz.

ArgumentException

element geçerli görsel stili tarafından tanımlanmamıştır.

Örnekler

Aşağıdaki kod örneğinde oluşturucunun VisualStyleRenderer(VisualStyleElement) bir oluşturmak için nasıl kullanılacağı gösterilmektedir VisualStyleRenderer. Bu kod örneği, sınıfa genel bakış için sağlanan daha büyük bir kod örneğinin VisualStyleRenderer bir parçasıdır.

    // 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

Açıklamalar

Bu oluşturucu , ve özelliklerini başlatmak Classiçin parametresinin element , Partve State özelliklerini kullanırVisualStyleElement.ClassName.VisualStyleElement.State VisualStyleElement.Part

Bu oluşturucuyu kullanmadan önce, geçerli görsel stilinin static IsElementDefined parametresi tarafından element belirtilen öğe için bir tanım sağlayıp sağlamadığını doğrulamak için yöntemini çağırmalısınız.

VisualStyleRenderer(String, Int32, Int32)

Verilen sınıf, bölüm ve durum değerlerini kullanarak sınıfın yeni bir örneğini VisualStyleRenderer başlatır.

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)

Parametreler

className

String

Bunun VisualStyleRenderer temsil edeceği öğenin sınıf adı.

part

Int32

Bu öğenin temsil edeceği bölümü VisualStyleRenderer .

state

Int32

Bunun VisualStyleRenderer temsil edeceği öğenin durumu.

Özel durumlar

InvalidOperationException

İşletim sistemi görsel stilleri desteklemez.

-veya-

Görsel stiller, işletim sistemindeki kullanıcı tarafından devre dışı bırakılır.

-veya-

Görsel stiller uygulama pencerelerinin istemci alanına uygulanmaz.

ArgumentException

, partve state birleşimi classNamegeçerli görsel stili tarafından tanımlanmamıştır.

ArgumentNullException

.NET 5 ve üzeri: className olur null.

Açıklamalar

Bu oluşturucu , part, ve state State özelliklerini başlatmak Classiçin , Partve parametrelerini kullanırclassName.

Bu oluşturucuyu kullanmadan önce, geçerli görsel stilinin static IsElementDefined , partve state parametreleri tarafından classNamebelirtilen öğe için bir tanım sağlayıp sağlamadığını doğrulamak için yöntemini çağırmalısınız.