TextElement.Foreground Property

Definition

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

Property Value

Brush

Pinceau à appliquer au contenu de texte.The brush used to apply to the text contents. Par défaut, il s’agit de Black.The default is Black.

Examples

L’exemple suivant montre comment définir l’attribut Foreground à l’aide de Paragraph 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 : premier plan de vert, arrière-plan bisqueScreenshot: Foreground of green, background bisque

L’exemple suivant montre comment définir la propriété Foreground 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

Remarks

Pour obtenir un tableau des nuanciers montrant 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 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 Object (généralement un élément Flow) contenu dans un TextElement, et value est une chaîne qui correspond à une valeur d’implémentation Brush.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 prise en charge par les méthodes GetForeground et SetForeground.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 une TextElement prennent en charge une propriété de Foreground non attachée analogue, 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 sur trueMetadata properties set to true AffectsRender, Inherits, SubPropertiesDoNotAffectRenderAffectsRender, Inherits, SubPropertiesDoNotAffectRender

Applies to

See also