Control.BackColor プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
コントロールの背景色を取得または設定します。
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
プロパティ値
コントロールの背景色を表す Color。 既定値は DefaultBackColor プロパティの値です。
例
次のコード例では、 BackColor コントロールと ForeColor コントロールの色を既定のシステムカラーに設定します。 コントロールに子コントロールがある場合、コードは再帰的に自身を呼び出します。 このコード例では、少なくとも 1 つの子コントロールを持Formつ必要があります。ただし、子コンテナー コントロール (PanelGroupBoxたとえば、独自の子コントロール) を持つ子コンテナー コントロールは、再帰を示す方が適しています。
// 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
注釈
このプロパティは BackColor 、値が 〘 に設定されている場合を SupportsTransparentBackColor
除き、透明色 System.Windows.Forms.ControlStyles を true
サポートしていません。
プロパティは BackColor アンビエント プロパティです。 アンビエント プロパティは、設定されていない場合は親コントロールから取得されるコントロール プロパティです。 たとえば、a Button は既定で親Formと同じBackColorになります。 アンビエント プロパティの詳細については、クラスまたはクラスの AmbientProperties 概要を Control 参照してください。
注意 (継承者)
派生クラスのプロパティをオーバーライドする BackColor 場合は、基底クラスの BackColor プロパティを使用して基本実装を拡張します。 それ以外の場合は、すべての実装を指定する必要があります。 プロパティのアクセサーとset
アクセサーのBackColor両方をget
オーバーライドする必要はありません。必要に応じて 1 つだけオーバーライドできます。