Export (0) Print
Expand All

TextBlock.Background Property

Gets or sets the Brush used to fill the background of content area.

Namespace:  System.Windows.Controls
Assembly:  PresentationFramework (in PresentationFramework.dll)

'Declaration
Public Property Background As Brush

Property Value

Type: System.Windows.Media.Brush
The brush used to fill the background of the content area, or Nothing to not use a background brush. The default is Nothing.

Identifier field

BackgroundProperty

Metadata properties set to true

AffectsRender

Any Background settings on child elements override this top-level setting.

For a table of swatches that show the available predefined brush colors, see Brushes.

The following example shows how to set the Background attribute of a TextBlock element.

<TextBlock 
  Name="textBlock"

  Background="AntiqueWhite" 
  Foreground="Navy" 

  FontFamily="Century Gothic"
  FontSize="12"
  FontStretch="UltraExpanded"
  FontStyle="Italic"
  FontWeight="UltraBold"

  LineHeight="Auto"
  Padding="5,10,5,10"
  TextAlignment="Center"
  TextWrapping="Wrap"

  Typography.NumeralStyle="OldStyle"
  Typography.SlashedZero="True"
>
  <Run Background="LightGreen">Text run 1.</Run>
  <LineBreak/><Run Background="LightBlue">Text run 2.</Run>
  <LineBreak/><Run Background="LightYellow">Text run 3.</Run>
</TextBlock>

The following example shows how to set the Background property programmatically.

			Dim textBlock As New TextBlock(New Run("A bit of text content..."))

			textBlock.Background = Brushes.AntiqueWhite
			textBlock.Foreground = Brushes.Navy

			textBlock.FontFamily = New FontFamily("Century Gothic")
			textBlock.FontSize = 12
			textBlock.FontStretch = FontStretches.UltraExpanded
			textBlock.FontStyle = FontStyles.Italic
			textBlock.FontWeight = FontWeights.UltraBold

			textBlock.LineHeight = Double.NaN
			textBlock.Padding = New Thickness(5, 10, 5, 10)
			textBlock.TextAlignment = TextAlignment.Center
			textBlock.TextWrapping = TextWrapping.Wrap

			textBlock.Typography.NumeralStyle = FontNumeralStyle.OldStyle
			textBlock.Typography.SlashedZero = True

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Show:
© 2015 Microsoft