TextElement.Foreground Właściwość

Definicja

Pobiera lub ustawia Brush do zastosowania do zawartości elementu.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

Wartość właściwości

Pędzel używany do zastosowania do zawartości tekstowej.The brush used to apply to the text contents. Wartość domyślna to Black.The default is Black.

Przykłady

Poniższy przykład pokazuje, jak ustawić atrybut Foreground, używając Paragraph jako elementu przykładu.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>

Na poniższej ilustracji przedstawiono sposób renderowania powyższego przykładu.The following figure shows how the preceding example renders.

Zrzut ekranu: pierwszy plan zielony, Bisque w tleScreenshot: Foreground of green, background bisque

Poniższy przykład pokazuje, jak ustawić właściwość Foreground programowo.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

Uwagi

Aby uzyskać tabelę próbek pokazującą dostępne wstępnie zdefiniowane kolory pędzla, zobacz Brushes.For a table of swatches that shows the available predefined brush colors, see Brushes.

Ta właściwość zależności ma również przypisane użycie właściwości.This dependency property also has an attached property usage. W XAMLXAML, użycie jest <object TextElement.Foreground="value".../>, gdzie obiekt jest elementem obiektu (zazwyczaj jest to element przepływu) zawarty w TextElement, a wartość jest ciągiem, który jest rozpoznawany jako wartość implementacji 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. W kodzie użycie dołączonej właściwości jest obsługiwane przez metody GetForeground i SetForeground.In code, the attached property usage is supported by the GetForeground and SetForeground methods. Użycie dołączonej właściwości nie jest wspólne, ponieważ większość elementów, które mogą być zawarte w TextElement obsługują analogiczne, niedołączone właściwości Foreground, których host zawartości używa do renderowania.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.

Informacje dotyczące właściwości zależnościDependency Property Information

Pole identyfikatoraIdentifier field ForegroundProperty
Właściwości metadanych ustawione na trueMetadata properties set to true AffectsRender, Inherits, SubPropertiesDoNotAffectRenderAffectsRender, Inherits, SubPropertiesDoNotAffectRender

Dotyczy

Zobacz też