Control.BackColor Proprietà

Riferimento

Definizione

Spazio dei nomi:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Ottiene o imposta il colore di sfondo del controllo.

public:
 virtual property System::Drawing::Color BackColor { System::Drawing::Color get(); void set(System::Drawing::Color value); };

public virtual System.Drawing.Color BackColor { get; set; }

member this.BackColor : System.Drawing.Color with get, set

Public Overridable Property BackColor As Color

Valore della proprietà

Color

Oggetto Color che rappresenta il colore di sfondo del controllo. Il valore predefinito corrisponde al valore della proprietà DefaultBackColor.

Esempio

Nell'esempio di codice seguente vengono impostati gli BackColor elementi e ForeColor dei controlli sui colori di sistema predefiniti. Il codice chiama in modo ricorsivo se il controllo ha controlli figlio. In questo esempio di codice è necessario disporre di almeno un Form controllo figlio. Tuttavia, un controllo contenitore figlio, ad esempio un Panel oggetto o GroupBox, con i propri controlli figlio, dimostrerebbe meglio la ricorsione.

   // Reset all the controls to the user's default Control color.
private:
   void ResetAllControlsBackColor( Control^ control )
   {
      control->BackColor = SystemColors::Control;
      control->ForeColor = SystemColors::ControlText;
      if ( control->HasChildren )
      {
         // Recursively call this method for each child control.
         IEnumerator^ myEnum = control->Controls->GetEnumerator();
         while ( myEnum->MoveNext() )
         {
            Control^ childControl = safe_cast<Control^>(myEnum->Current);
            ResetAllControlsBackColor( childControl );
         }
      }
   }

// Reset all the controls to the user's default Control color. 
private void ResetAllControlsBackColor(Control control)
{
   control.BackColor = SystemColors.Control;
   control.ForeColor = SystemColors.ControlText;
   if(control.HasChildren)
   {
      // Recursively call this method for each child control.
      foreach(Control childControl in control.Controls)
      {
         ResetAllControlsBackColor(childControl);
      }
   }
}

' Reset all the controls to the user's default Control color. 
Private Sub ResetAllControlsBackColor(control As Control)
   control.BackColor = SystemColors.Control
   control.ForeColor = SystemColors.ControlText
   If control.HasChildren Then
      ' Recursively call this method for each child control.
      Dim childControl As Control
      For Each childControl In  control.Controls
         ResetAllControlsBackColor(childControl)
      Next childControl
   End If
End Sub

Commenti

La BackColor proprietà non supporta i colori trasparenti a meno che il SupportsTransparentBackColor valore di System.Windows.Forms.ControlStyles sia impostato su true.

La BackColor proprietà è una proprietà di ambiente. Una proprietà ambient è una proprietà di controllo che, se non è impostata, viene recuperata dal controllo padre. Ad esempio, un Button avrà lo stesso valore BackColor padre Form per impostazione predefinita. Per altre informazioni sulle proprietà dell'ambiente, vedere la classe o la AmbientProperties panoramica della Control classe.

Note per gli eredi

Quando si esegue l'override della proprietà in una classe derivata, usare la BackColor proprietà della BackColor classe di base per estendere l'implementazione di base. In caso contrario, è necessario fornire tutte le implementazioni. Non è necessario eseguire l'override di entrambe le get funzioni di accesso e set della proprietà. È possibile eseguire l'override BackColor di uno solo se necessario.

Si applica a

Prodotto	Versioni
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
Windows Desktop	3.0, 3.1, 5, 6, 7

Condividi tramite