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 le Foreground d’attribut, à l’aide de Paragraph en tant que l’élément de l’exemple.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>

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

Capture d’écran : Premier plan vert, arrière-plan beige-roséScreenshot: Foreground of green, background bisque

L’exemple suivant montre comment définir le 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 une table de nuancier qui affiche les couleurs de pinceau prédéfinies disponibles, consultez Brushes.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 la propriété jointe.This dependency property also has an attached property usage. Dans XAMLXAML, l’utilisation est <object TextElement.Foreground="value".../>, où objet est un élément objet (en général un élément de flux) contenu dans un TextElement, et valeur est une chaîne qui correspond à un Brush en 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 est pris en charge par le GetForeground et SetForeground méthodes.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 qui peuvent être contenus dans un TextElement prennent en charge une analogue non jointes Foreground propriété, qui utilise de l’hôte de contenu 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
La valeur des propriétés de métadonnées trueMetadata properties set to true AffectsRender, Inherits, SubPropertiesDoNotAffectRenderAffectsRender, Inherits, SubPropertiesDoNotAffectRender

S’applique à

Voir aussi