Note

Access to this page requires authorization. You can try signing in or .

Access to this page requires authorization. You can try .

Panel.Background Property

Definition

Namespace:
System.Windows.Controls
Assembly:
PresentationFramework.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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

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

Item Value
Identifier field BackgroundProperty
Metadata properties set to true AffectsRender, SubPropertiesDoNotAffectRender

Applies to

See also


Feedback

Was this page helpful?