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 VisualStyleRenderer sınıfının yeni bir örneğini başlatır.
VisualStyleRenderer(String, Int32, Int32)	Verilen sınıf, bölüm ve durum değerlerini kullanarak VisualStyleRenderer sınıfının yeni bir örneğini başlatır.

VisualStyleRenderer(VisualStyleElement)

Verilen VisualStyleElementkullanarak VisualStyleRenderer sınıfının yeni bir örneğini 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

Bu VisualStyleRenderer temsil edeceği bir VisualStyleElement.

Ö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ği, VisualStyleRendereroluşturmak için VisualStyleRenderer(VisualStyleElement) oluşturucunun nasıl kullanılacağını gösterir. Bu kod örneği, VisualStyleRenderer sınıfına genel bakış için sağlanan daha büyük bir kod örneğinin 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, Class, Partve State özelliklerini başlatmak için element parametresinin VisualStyleElement.ClassName, VisualStyleElement.Partve VisualStyleElement.State özelliklerini kullanır.

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

VisualStyleRenderer(String, Int32, Int32)

Verilen sınıf, bölüm ve durum değerlerini kullanarak VisualStyleRenderer sınıfının yeni bir örneğini 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

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

part

Int32

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

state

Int32

Bu 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

className, partve state birleşimi geçerli görsel stili tarafından tanımlanmaz.

ArgumentNullException

.NET 5 ve üzeri: classNamenull.

Açıklamalar

Bu oluşturucu, Class, Partve State özelliklerini başlatmak için className, partve state parametrelerini kullanır.

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