TextElement.Foreground Eigenschaft

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 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.

Bildschirm Abbildung von : Vordergrund von Grün, Background BisqueScreenshot: 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 werden, finden Sie unter Brushes.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 XAMLXAMLwird die Verwendung <object TextElement.Foreground="value".../>, wobei Object ein Objekt Element (in der Regel ein Fluss Element) ist, das in einem TextElemententhalten ist, und value eine Zeichenfolge ist, die zu einem Brush 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 durch die Methoden GetForeground und SetForeground 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 einem TextElement enthalten sein können, eine analoge nicht angefügte Foreground Eigenschaft unterstützen, die der Inhalts Host zum Rendering 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