TextElement.Foreground Свойство

Определение

Возвращает или задает кисть, которая применяется к содержимому элемента.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

Значение свойства

Brush

Кисть, применяемая к текстовому содержимому.The brush used to apply to the text contents. Значение по умолчанию — Black.The default is Black.

Примеры

В следующем примере показано, как задать Foreground атрибут, используя в Paragraph качестве элемента example.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>

На следующем рисунке показано, как отображается предыдущий пример.The following figure shows how the preceding example renders.

Снимок экрана: зеленый передний план, светло-коричневый фонScreenshot: Foreground of green, background bisque

В следующем примере показано, как задать Foreground свойство программным способом.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

Комментарии

Таблицу образцов, в которых показаны доступные стандартные цвета кисти, см. в разделе Brushes .For a table of swatches that shows the available predefined brush colors, see Brushes.

Это свойство зависимостей также имеет присоединенные свойства.This dependency property also has an attached property usage. В XAML используется <object TextElement.Foreground="value".../> , где Object — это объектный элемент (обычно элемент Flow), содержащийся в TextElement , а значение — это строка, которая разрешается в Brush значение реализации.In XAML, 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. В коде использование присоединенного свойства поддерживается GetForeground SetForeground методами и.In code, the attached property usage is supported by the GetForeground and SetForeground methods. Использование присоединенного свойства не является распространенным, так как большинство элементов, которые могут содержаться в, TextElement поддерживают аналогичное неприсоединенное Foreground свойство, которое узел содержимого использует для отрисовки.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.

Сведения о свойстве зависимостейDependency Property Information

Поле идентификатораIdentifier field ForegroundProperty
Свойства метаданных, для которых задано значение trueMetadata properties set to true AffectsRender, Inherits, SubPropertiesDoNotAffectRenderAffectsRender, Inherits, SubPropertiesDoNotAffectRender

Применяется к

См. также раздел