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

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 ten VisualStyleRenderer element na element stylu wizualizacji reprezentowany przez określony VisualStyleElementelement .

SetParameters(String, Int32, Int32)

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 wizualizacji 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)

Ustawia ten VisualStyleRenderer element na element 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 wizualizacji 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 za pomocą SetParameters(VisualStyleElement) metody ustawić VisualStyleRenderer metodę na nową VisualStyleElementwartość . Ten przykład kodu jest częścią większego przykładu udostępnionego VisualStyleRenderer do omówienia 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 .