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

Definition

Ruft den Brush ab oder legt ihn fest, der auf den Inhalt des Elements angewendet werden soll.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

Eigenschaftswert

Der Pinsel, der auf den Textinhalt angewendet werden soll.The brush used to apply to the text contents. Die Standardeinstellung ist Black.The default is Black.

Beispiele

Im folgenden Beispiel wird gezeigt, wie das Foreground -Attribut mithilfe Paragraph von als Beispiel Element festgelegt wird.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>

Die folgende Abbildung zeigt, wie das vorherige Beispiel gerendert wird.The following figure shows how the preceding example renders.

![Verschaffen Vordergrund des grünen, Background-]Bisque(~/add/media/textelement-foreback.png "-Screenshots: Vordergrund von Grün, Hintergrund-Bisque")Screenshot: Foreground of green, background bisque

Im folgenden Beispiel wird gezeigt, wie die Foreground -Eigenschaft Programm gesteuert festgelegt wird.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

Hinweise

Eine Tabelle mit Dragquellen, in der die verfügbaren vordefinierten Pinsel Farben angezeigt Brusheswerden, finden Sie unter.For a table of swatches that shows the available predefined brush colors, see Brushes.

Diese Abhängigkeits Eigenschaft verfügt auch über eine angefügte Eigenschaften Verwendung.This dependency property also has an attached property usage. In XAMLXAMList die <object TextElement.Foreground="value".../>Verwendung, wobei Object ein Objekt Element (in der Regel ein Flow-Element) ist, TextElementdas in einer enthalten ist, und value eine Zeichen Brush Folge ist, die zu einem Implementierungs Wert aufgelöst wird.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. Im Code wird die Verwendung der angefügten Eigenschaft von der GetForeground - SetForeground Methode und der-Methode unterstützt.In code, the attached property usage is supported by the GetForeground and SetForeground methods. Die Verwendung der angefügten Eigenschaft ist nicht üblich, weil die meisten Elemente, die in TextElement einer enthalten sein können, Foreground eine analoge nicht angefügte Eigenschaft unterstützen, die der Inhalts Host zum Rendern verwendet.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.

Informationen zur AbhängigkeitseigenschaftDependency Property Information

BezeichnerfeldIdentifier field ForegroundProperty
Metadateneigenschaften auf true festgelegtMetadata properties set to true AffectsRender, Inherits, SubPropertiesDoNotAffectRenderAffectsRender, Inherits, SubPropertiesDoNotAffectRender

Gilt für:

Siehe auch