TextElement.FontFamily Proprietà

Definizione

Spazio dei nomi:

System.Windows.Documents

Assembly:

PresentationFramework.dll

Ottiene o imposta la famiglia di caratteri di primo livello preferita per il contenuto dell'elemento.

public:
 property System::Windows::Media::FontFamily ^ FontFamily { System::Windows::Media::FontFamily ^ get(); void set(System::Windows::Media::FontFamily ^ value); };

[System.Windows.Localizability(System.Windows.LocalizationCategory.Font, Modifiability=System.Windows.Modifiability.Unmodifiable)]
public System.Windows.Media.FontFamily FontFamily { get; set; }

[<System.Windows.Localizability(System.Windows.LocalizationCategory.Font, Modifiability=System.Windows.Modifiability.Unmodifiable)>]
member this.FontFamily : System.Windows.Media.FontFamily with get, set

Public Property FontFamily As FontFamily

Valore della proprietà

FontFamily

Famiglia di caratteri preferita o famiglia di caratteri preferita principale con una o più famiglie di caratteri di fallback. Il valore predefinito è il tipo di carattere determinato dal valore di MessageFontFamily.

Attributi

LocalizabilityAttribute

Esempio

Nell'esempio seguente viene illustrato come impostare l'attributo FontFamily usando Paragraph come elemento di esempio.

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

Nella figura seguente viene illustrato il rendering dell'esempio precedente.

Nell'esempio seguente viene illustrato come impostare la FontFamily proprietà a livello di codice.

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

Commenti

Quando si specificano più famiglie di tipi di carattere, la seconda e le famiglie di caratteri successive fungono da famiglie di fallback da usare nei casi in cui la famiglia di caratteri principale non è disponibile o non è applicabile.

Questa proprietà specifica solo una preferenza. Se la famiglia di caratteri specificata non è disponibile, restituisce FlowDocument automaticamente il tipo di carattere determinato dal MessageFontFamily valore .

Questa proprietà di dipendenza ha anche un utilizzo delle proprietà associate. In XAML l'utilizzo è <object TextElement.FontFamily="value".../>, dove object è un elemento oggetto (in genere un elemento di flusso) contenuto in un TextBlockoggetto e il valore è uno dei valori in formato stringa, come illustrato in Valori XAML. Nel codice l'utilizzo delle GetFontFamily proprietà associate è supportato dai metodi e SetFontFamily . L'utilizzo della proprietà associata non è comune, perché la maggior parte degli elementi che possono essere contenuti in un supporto di una TextElement proprietà analoga non collegata FontFamily , usata dall'host del contenuto per il rendering.

Uso della sintassi XAML per gli attributi

<object FontFamily="fontFamilyName"/>  
- or -  
<object FontFamily="fontFamilyNamesList"/>  
- or -  
<object FontFamily="fontFamilyFolderReference"/>  
- or -  
<object FontFamily="fontFamilyUriReference"/>  

Valori XAML

fontFamilyName
Stringa che specifica un nome di famiglia di caratteri. Ad esempio, "Arial" o "Century Gothic".

fontFamilyNamesList
Stringa che specifica più nomi di famiglia di caratteri, ognuno separato da una virgola (qualsiasi spazio vuoto dopo una virgola viene ignorato). La prima famiglia di caratteri specificata funge da famiglia di caratteri principale; le famiglie di caratteri successive fungono da famiglie di fallback da usare nei casi in cui la famiglia di caratteri principale non è disponibile o non è applicabile. Ad esempio, "Arial, Century Gothic" specifica Arial come famiglia di caratteri principale, con Century Gothic come famiglia di caratteri di fallback.

fontFamilyFolderReference
Stringa che specifica una cartella contenente il tipo di carattere, insieme a un nome di famiglia di caratteri. Il nome della famiglia di caratteri e della cartella è delimitato da un carattere #. Il riferimento alla cartella può essere assoluto o relativo. Ad esempio: "Custom Fonts\#My Custom Font".

fontFamilyUriReference
Stringa che specifica un URI (Uniform Resource Identifier) per il tipo di carattere, insieme a un nome di famiglia di caratteri. L'URI e il nome della famiglia di caratteri sono delimitati da un carattere #. Ad esempio: "http://MyFontServer/Fonts/#My Custom Font".

Informazioni proprietà di dipendenza

Campo Identificatore	FontFamilyProperty
Proprietà dei metadati impostate su true	AffectsMeasure, AffectsRender, Inherits