TextElement.Foreground TextElement.Foreground TextElement.Foreground TextElement.Foreground Property

Définition

Obtient ou définit le Brush à appliquer au contenu de l’élément.Gets or sets the Brush to apply to the content of the element.

public:
 property System::Windows::Media::Brush ^ Foreground { System::Windows::Media::Brush ^ get(); void set(System::Windows::Media::Brush ^ value); };
public System.Windows.Media.Brush Foreground { get; set; }
member this.Foreground : System.Windows.Media.Brush with get, set
Public Property Foreground As Brush

Valeur de propriété

Pinceau à appliquer au contenu de texte.The brush used to apply to the text contents. La valeur par défaut est Black.The default is Black.

Exemples

L’exemple suivant montre comment définir l' Foreground attribut à l’aide Paragraph de comme exemple d’élément.The following example shows how to set the Foreground attribute, using Paragraph as the example element.

<FlowDocumentReader>
  <FlowDocument>
    <Paragraph
      Background="Bisque"
      Foreground="DarkGreen"
      Padding="4"
    >
      <Run>
        This text has a foreground color of dark green, and a background color of bisque.
      </Run>
    </Paragraph>
  </FlowDocument>
</FlowDocumentReader>

L’illustration suivante montre le rendu de l’exemple précédent.The following figure shows how the preceding example renders.

![Capture d’écran Capture d’écran de premier plan]de vert et d’arrière-plan bisque(~/add/media/textelement-foreback.png ": Premier plan du vert, arrière-plan bisque")Screenshot: Foreground of green, background bisque

L’exemple suivant montre comment définir la Foreground propriété par programmation.The following example shows how to set the Foreground property programmatically.

Run run = new Run(
    "This text has a foreground color of dark green, and a background color of bisque.");
Paragraph par = new Paragraph(run);

par.Background = Brushes.Bisque;
par.Foreground = Brushes.DarkGreen;
Dim run As New Run("This text has a foreground color of dark green, and a background color of bisque.")
Dim par As New Paragraph(run)

par.Background = Brushes.Bisque
par.Foreground = Brushes.DarkGreen

Remarques

Pour obtenir un tableau des nuanciers montrant les couleurs de pinceau prédéfinies disponibles, Brushesconsultez.For a table of swatches that shows the available predefined brush colors, see Brushes.

Cette propriété de dépendance a également une utilisation de propriété jointe.This dependency property also has an attached property usage. Dans XAMLXAML, l’utilisation est <object TextElement.Foreground="value".../>, où Object est un élément objet (en général un élément Flow) contenu dans TextElementun, et value est une chaîne qui correspond à une Brush valeur d’implémentation.In XAMLXAML, the usage is <object TextElement.Foreground="value".../>, where object is an object element (typically a flow element) contained within a TextElement, and value is a string that resolves to a Brush implementation value. Dans le code, l’utilisation de la propriété jointe GetForeground est SetForeground prise en charge par les méthodes et.In code, the attached property usage is supported by the GetForeground and SetForeground methods. L’utilisation de la propriété jointe n’est pas courante, car la plupart des éléments TextElement qui peuvent être contenus dans Foreground un prennent en charge une propriété analogue non jointe, que l’hôte de contenu utilise pour le rendu.The attached property usage is not common, because most elements that can be contained in a TextElement support an analogous nonattached Foreground property, which the content host uses for rendering.

Informations sur les propriétés de dépendanceDependency Property Information

Champ d’identificateurIdentifier field ForegroundProperty
Propriétés de métadonnées définies surtrueMetadata properties set to true AffectsRender, Inherits, SubPropertiesDoNotAffectRenderAffectsRender, Inherits, SubPropertiesDoNotAffectRender

S’applique à

Voir aussi