TextElement.FontStretch Propiedad

Definición

Obtiene o establece las características de ajuste de fuentes para el contenido del elemento.Gets or sets the font-stretching characteristics for the content of the element.

public:
 property System::Windows::FontStretch FontStretch { System::Windows::FontStretch get(); void set(System::Windows::FontStretch value); };
public System.Windows.FontStretch FontStretch { get; set; }
member this.FontStretch : System.Windows.FontStretch with get, set
Public Property FontStretch As FontStretch

Valor de propiedad

Una estructura FontStretch que especifica las características de ensanchamiento de fuente que se desea utilizar.A FontStretch structure that specifies the desired font-stretching characteristics to use. De manera predeterminada, es Normal.The default is Normal.

Ejemplos

En el ejemplo siguiente se muestra cómo establecer el atributo FontStretch, utilizando Paragraph como elemento de ejemplo.The following example shows how to set the FontStretch attribute, using Paragraph as the example element.

<Paragraph
  FontFamily="Century Gothic, Courier New"  
  FontSize="16pt"
  FontStretch="UltraExpanded"
  FontStyle="Italic"
  FontWeight="DemiBold"
>
  <Run>
    This text will use the Century Gothic font (if available), with fallback to Courier New.  It 
    will render with a font size of 16 points in ultra-expanded demi-bold italic.
  </Run>
</Paragraph>

En la ilustración siguiente se muestra cómo se representa el ejemplo anterior.The following figure shows how the preceding example renders.

captura de pantalla: Texto con propiedades de texto establecidasScreenshot: Text with text properties set

En el ejemplo siguiente se muestra cómo establecer la propiedad FontStretch mediante programación.The following example shows how to set the FontStretch property programmatically.

Run run = new Run(
    "This text will use the Century Gothic font (if available), with fallback to Courier New."
    + "It will render with a font size of 16 pixels in ultra-expanded demi-bold italic.");
Paragraph par = new Paragraph(run);

par.FontFamily = new FontFamily("Century Gothic, Courier New");
par.FontSize = 16;
par.FontStretch = FontStretches.UltraExpanded;
par.FontStyle = FontStyles.Italic;
par.FontWeight = FontWeights.DemiBold;
Dim run As New Run("This text will use the Century Gothic font (if available), with fallback to Courier New." & "It will render with a font size of 16 pixels in ultra-expanded demi-bold italic.")
Dim par As New Paragraph(run)

With par
    .FontFamily = New FontFamily("Century Gothic, Courier New")
    .FontSize = 16
    .FontStretch = FontStretches.UltraExpanded
    .FontStyle = FontStyles.Italic
    .FontWeight = FontWeights.DemiBold
End With

Comentarios

Esta propiedad de dependencia también tiene un uso de la propiedad adjunta.This dependency property also has an attached property usage. En XAMLXAML, el uso es <object TextElement.FontStretch="value".../>, donde el objeto es un elemento de objeto (normalmente un elemento de flujo) incluido en un TextElementy el valor es uno de los nombres de propiedad de formato de cadena de la clase FontStretch.In XAMLXAML, the usage is <object TextElement.FontStretch="value".../>, where object is an object element (typically a flow element) contained within a TextElement, and value is one of the string-format property names of the FontStretch class. En el código, el uso de la propiedad adjunta es compatible con los métodos GetFontStretch y SetFontStretch.In code, the attached property usage is supported by the GetFontStretch and SetFontStretch methods. El uso de la propiedad adjunta no es habitual, porque la mayoría de los elementos que se pueden incluir en un TextElement admiten una propiedad FontStretch análoga no adjunta, que el host de contenido utiliza para la representación.The attached property usage is not common, because most elements that can be contained in a TextElement support an analogous nonattached FontStretch property, which the content host uses for rendering.

Información sobre propiedades de dependenciaDependency Property Information

Campo de identificadorIdentifier field FontStretchProperty
Propiedades de metadatos establecidas en trueMetadata properties set to true AffectsMeasure, AffectsRender, InheritsAffectsMeasure, AffectsRender, Inherits

Se aplica a