VisualStyleRenderer.SetParameters Metoda

Definicja

Przestrzeń nazw:

System.Windows.Forms.VisualStyles

Zestaw:

System.Windows.Forms.dll

Ustawia bieżący element stylu wizualizacji tego VisualStyleRendererelementu .

Przeciążenia

Nazwa	Opis
SetParameters(String, Int32, Int32)	Ustawia ten VisualStyleRenderer element na element stylu wizualizacji reprezentowany przez określoną klasę, część i wartości stanu.
SetParameters(VisualStyleElement)	Ustawia element VisualStyleRenderer stylu wizualizacji reprezentowany przez określony VisualStyleElementelement .

SetParameters(String, Int32, Int32)

Źródło:

VisualStyleRenderer.cs

Ustawia ten VisualStyleRenderer element na element stylu wizualizacji reprezentowany przez określoną klasę, część i wartości stanu.

public:
 void SetParameters(System::String ^ className, int part, int state);

public void SetParameters(string className, int part, int state);

member this.SetParameters : string * int * int -> unit

Public Sub SetParameters (className As String, part As Integer, state As Integer)

Parametry

className

String

Nowa wartość Class właściwości.

part

Int32

Nowa wartość Part właściwości.

state

Int32

Nowa wartość State właściwości.

Wyjątki

ArgumentException

Kombinacja elementów className, parti state nie jest zdefiniowana przez bieżący styl wizualizacji.

InvalidOperationException

System operacyjny nie obsługuje stylów wizualnych.

— lub —

Style wizualne są wyłączone przez użytkownika w systemie operacyjnym.

— lub —

Style wizualne nie są stosowane do obszaru klienta okien aplikacji.

Uwagi

Ta metoda sprawdza wartość IsSupported właściwości wewnętrznie. Przed wywołaniem tej metody należy wywołać metodę IsElementDefined , aby sprawdzić, czy bieżący styl wizualizacji zawiera definicję elementu określonego classNameprzez parametry , parti state .

SetParameters(VisualStyleElement)

Źródło:

VisualStyleRenderer.cs

Ustawia element VisualStyleRenderer stylu wizualizacji reprezentowany przez określony VisualStyleElementelement .

public:
 void SetParameters(System::Windows::Forms::VisualStyles::VisualStyleElement ^ element);

public void SetParameters(System.Windows.Forms.VisualStyles.VisualStyleElement element);

member this.SetParameters : System.Windows.Forms.VisualStyles.VisualStyleElement -> unit

Public Sub SetParameters (element As VisualStyleElement)

Parametry

element

VisualStyleElement

Element VisualStyleElement określający nowe wartości Classwłaściwości , Parti State .

Wyjątki

ArgumentException

element nie jest definiowany przez bieżący styl wizualizacji.

InvalidOperationException

System operacyjny nie obsługuje stylów wizualnych.

— lub —

Style wizualne są wyłączone przez użytkownika w systemie operacyjnym.

— lub —

Style wizualne nie są stosowane do obszaru klienta okien aplikacji.

Przykłady

W poniższym przykładzie kodu pokazano, jak użyć SetParameters(VisualStyleElement) metody w celu ustawienia wartości na VisualStyleRenderer nową VisualStyleElement. Ten przykład kodu jest częścią większego przykładu udostępnionego VisualStyleRenderer dla przeglądu klasy.

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

Uwagi

Ta metoda sprawdza wartość IsSupported właściwości wewnętrznie. Przed wywołaniem tej metody należy wywołać metodę IsElementDefined , aby sprawdzić, czy bieżący styl wizualizacji zawiera definicję elementu określonego element przez parametr .