• Article

TextBox.SelectionBackground Property

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Gets or sets the brush that fills the background of the selected text.

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

Syntax

'Declaration
Public Property SelectionBackground As Brush

public Brush SelectionBackground { get; set; }

<TextBox>
  <TextBox.SelectionBackground>
    singleBrush
  </TextBox.SelectionBackground>
</TextBox>

<TextBox SelectionBackground="colorString"/>

XAML Values

  • singleBrush
    Within opening and closing property elements for object.SelectionBackground, exactly one object element for an object that derives from Brush. The object element is typically one of the following Silverlight classes: LinearGradientBrush, RadialGradientBrush, ImageBrush, SolidColorBrush, or VideoBrush.

  • colorString
    The Color for a SolidColorBrush expressed as an attribute string. This can be a named color, an RGB value, or an ScRGB value. RGB or ScRGB may also specify alpha information. See Color.

Property Value

Type: System.Windows.Media.Brush
The brush that fills the background of the selected text.

Remarks

Dependency property identifier field: SelectionBackgroundProperty.

Use the SelectionBackground property to change the background of the selected text in the text box control.

Examples

The following code snippet shows how you can use the SelectionBackground property to set the background of the selected text in a TextBox. This example is part of a larger example available in the TextBox class overview.

<TextBlock Margin="20,40,0,0" Text="Demonstrating styles for TextBox" />

<TextBlock Margin="20,0,0,0" FontSize="11">
    Select the following text to view the results of SelectionForeground and SelectionBackground properties.
</TextBlock>

<TextBox Text="Styles" Margin="20,5,0,0" HorizontalAlignment="Left" Width="200" Height="35" FontFamily="Arial" FontSize="15" Foreground="White" Background="Black" BorderBrush="White" SelectionForeground="Black">
    <TextBox.SelectionBackground>
        <LinearGradientBrush StartPoint="0,0" EndPoint="0,1">
            <GradientStop Color="Gray" Offset="0.0" />
            <GradientStop Color="White" Offset="1.0" />
        </LinearGradientBrush>
    </TextBox.SelectionBackground>
</TextBox>

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.