Panel.Background Property

Definition

Namespace:

System.Windows.Controls

Assembly:

PresentationFramework.dll

Gets or sets a Brush that is used to fill the area between the borders of a Panel.

public:
 property System::Windows::Media::Brush ^ Background { System::Windows::Media::Brush ^ get(); void set(System::Windows::Media::Brush ^ value); };

public System.Windows.Media.Brush Background { get; set; }

member this.Background : System.Windows.Media.Brush with get, set

Public Property Background As Brush

Property Value

Brush

A Brush. This default value is null.

Examples

The following example sets the Background of a Grid to a RadialGradientBrush.

<Grid>
  <Grid.Background>
    <RadialGradientBrush 
        GradientOrigin="0.5,0.5" 
        Center="0.5,0.5" RadiusX="0.5" RadiusY="0.5">
      <RadialGradientBrush.GradientStops>
        <GradientStop Color="Yellow" Offset="0" />
        <GradientStop Color="Red" Offset="0.25" />
        <GradientStop Color="Blue" Offset="0.75" />
        <GradientStop Color="Green" Offset="1" />
      </RadialGradientBrush.GradientStops>
    </RadialGradientBrush>
  </Grid.Background>
</Grid>

Remarks

Panel elements do not receive mouse or stylus events if a Background is not defined. If you need to handle mouse or stylus events but do not want a background for your Panel, use Transparent.

Dependency Property Information

Identifier field	BackgroundProperty
Metadata properties set to true	AffectsRender, SubPropertiesDoNotAffectRender

See also

• Brush