Partilhar via


Como: Usabilidade de auxílio de uma caixa de texto com uma imagem de plano de fundo

O exemplo a seguir mostra como auxiliar usabilidade de um TextBox ao exibir uma imagem de explicação de plano de fundo dentro do TextBox até o que o usuário entre com texto, quando a imagem é removida. Além disso, a imagem de plano de fundo é restaurada novamente se o usuário remove suas entradas. Veja a ilustração abaixo:

Uma TextBox com uma imagem de plano de fundo

ObservaçãoObservação:

O motivo pelo qual uma imagem de plano de fundo é usada neste exemplo, em seguida em vez disso, simplesmente manipulando o Text propriedade de TextBox, é que uma imagem de plano de fundo não interfere com a vinculação de dados.

Exemplo

<Page
  xmlns="https://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="https://schemas.microsoft.com/winfx/2006/xaml"
  x:Class="SDKSample.TextBoxBackgroundExample"
  >

  <StackPanel>
    <TextBox Name="myTextBox" TextChanged="OnTextBoxTextChanged" Width="200">
      <TextBox.Background>
        <ImageBrush ImageSource="TextBoxBackground.gif" AlignmentX="Left" Stretch="None" />
      </TextBox.Background>
    </TextBox>
  </StackPanel>
</Page>
using System;
using System.Windows;
using System.Windows.Input;
using System.Windows.Controls;
using System.Windows.Media;
using System.Windows.Media.Imaging;

namespace SDKSample
{
    public partial class TextBoxBackgroundExample : Page
    {

        void OnTextBoxTextChanged(object sender, TextChangedEventArgs e)
        {

            if (myTextBox.Text == "")
            {
                // Create an ImageBrush.
                ImageBrush textImageBrush = new ImageBrush();
                textImageBrush.ImageSource =
                    new BitmapImage(
                        new Uri(@"TextBoxBackground.gif", UriKind.Relative)
                    );
                textImageBrush.AlignmentX = AlignmentX.Left;
                textImageBrush.Stretch = Stretch.None;
                // Use the brush to paint the button's background.
                myTextBox.Background = textImageBrush;

            }
            else
            {

                myTextBox.Background = null;
            }

        }

    }

}

Consulte também

Conceitos

Visão geral sobre TextBox

Visão geral de RichTextBox