LanguageFontGroup Klasse

Definition

Namespace:

Windows.Globalization.Fonts

Stellt eine Reihe von Schriftartempfehlungen für eine bestimmte Sprache oder ein bestimmtes Skript für verschiedene Anwendungsfälle bereit.

public ref class LanguageFontGroup sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
/// [Windows.Foundation.Metadata.Activatable(Windows.Globalization.Fonts.ILanguageFontGroupFactory, 65536, "Windows.Foundation.UniversalApiContract")]
class LanguageFontGroup final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Globalization.Fonts.ILanguageFontGroupFactory), 65536, "Windows.Foundation.UniversalApiContract")]
public sealed class LanguageFontGroup

function LanguageFontGroup(languageTag)

Public NotInheritable Class LanguageFontGroup

Vererbung

Object Platform::Object IInspectable LanguageFontGroup

Attribute

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Beispiele

// Get the recommended Japanese fonts for traditional documents and modern documents.
var fonts = new Windows.Globalization.Fonts.LanguageFontGroup("ja-JP");
var traditionalDocumentFont = fonts.TraditionalDocumentFont;
var modernDocumentFont = fonts.ModernDocumentFont;

// Obtain two properties of the traditional document font.
var traditionalDocumentFontFontFamily = traditionalDocumentFont.FontFamily;   // "MS Mincho"
var traditionalDocumentFontScaleFactor = traditionalDocumentFont.ScaleFactor; // 100

// Obtain two properties of the modern document font.
var modernDocumentFontFontFamily = modernDocumentFont.FontFamily;             // "Meiryo"
var modernDocumentFontScaleFactor = modernDocumentFont.ScaleFactor;           // 90

Hinweise

Eine LanguageFontGroup stellt eine Reihe von Schriftartempfehlungen für eine bestimmte Sprache oder ein bestimmtes Skript bereit. Die verschiedenen Schriftarten, die von einer bestimmten LanguageFontGroup empfohlen werden und als separate LanguageFontGroup-Eigenschaften verfügbar gemacht werden, entsprechen unterschiedlichen Anwendungsfällen.

Jede LanguageFontGroup-Eigenschaft gibt ein LanguageFont-Objekt zurück, das die Details für diese bestimmte Schriftartempfehlung bereitstellt. Zu diesen Details gehören eine Schriftfamilie sowie Schriftartengewicht, Stil und Stretchattribute.

Die Gewichtungs-/Stil-/Stretchattribute sind für einige Anwendungsfälle von Bedeutung, für andere jedoch nicht. Für instance können die Schriftartempfehlungen für die verschiedenen Benutzeroberflächennutzungskategorien Schriftarten aus derselben Schriftartenfamilie verwenden, sich aber in der Gewichtung unterscheiden (z. B. Segoe UI Semilight für UITextFont, aber Segoe UI Regular für UICaptionFont). In einigen Anwendungsfällen können die Gewichtungs-/Stil-/Stretchattribute jedoch immer auf eine "normale" Schriftart (normale Gewichtung, normales Format, normale Dehnung) hinweisen. In diesen Fällen möchten Apps ggf. andere Formatierungen für Gewicht, Stil und Stretch anwenden, die für das App-Szenario geeignet sind. Weitere Informationen finden Sie in den Anmerkungen zu den einzelnen LanguageFontGroup-Eigenschaften.

Für einige Sprachen und Skripts bietet die LanguageFontGroup möglicherweise nicht für jeden Anwendungsfall eine Schriftartempfehlung. Für instance werden Schriftarten mit fester Breite nicht für jedes Skript in Windows bereitgestellt. Weitere Informationen finden Sie in den Anmerkungen zu den einzelnen LanguageFontGroup-Eigenschaften.

Hinweis

Wenn Ihre App in dieser Klasse verwendete Sprachtags an alle Funktionen der National Language Support übergeben, muss sie zuerst die Tags konvertieren, indem ResolveLocaleName aufgerufen wird.

Ab : Die LanguageFontGroup-Klasse gibt Schriftartgruppendaten zurück, die dem Zielbetriebssystem entsprechen, für das eine App entwickelt wurde. Wenn Sie Ihre Windows 8-App daher auf Windows 8.1 aktualisieren, ändern sich möglicherweise die schriftarten, die in Ihrer App verwendet werden, und Sie müssen möglicherweise Anpassungen am Ui-Layout vornehmen.

Konstruktoren

LanguageFontGroup(String)

Erstellt ein LanguageFontGroup-Objekt für eine bestimmte Sprache oder ein bestimmtes Skript.

Eigenschaften

DocumentAlternate1Font	Ruft eine Schriftart ab, die als zusätzliche Option für die Verwendung in Dokumenten über die Empfehlungen von DocumentHeadingFont, ModernDocumentFont und TraditionalDocumentFont hinaus empfohlen wird.
DocumentAlternate2Font	Ruft eine Schriftart ab, die als zusätzliche Option für die Verwendung in Dokumenten über die Empfehlungen von DocumentHeadingFont, ModernDocumentFont und TraditionalDocumentFont hinaus empfohlen wird.
DocumentHeadingFont	Ruft eine Schriftart ab, die für die Verwendung in Dokumentüberschriften empfohlen wird.
FixedWidthTextFont	Ruft eine Schriftart ab, die zum Anzeigen von Zeichen mit fester Breite empfohlen wird.
ModernDocumentFont	Ruft eine Schriftart ab, die für typische Dokumenttexttexte nach modernen Formatvorlagenkonventionen empfohlen wird.
TraditionalDocumentFont	Ruft eine Schriftart ab, die für typische Dokumenttexttexte nach herkömmlichen Formatvorlagenkonventionen empfohlen wird.
UICaptionFont	Ruft eine Schriftart ab, die für spezielle Ui-Elemente empfohlen wird, z. B. Beschriftungen, die kleiner als der typische Textkörper der Benutzeroberfläche angezeigt werden.
UIHeadingFont	Ruft eine Schriftart ab, die für spezielle Ui-Elemente empfohlen wird, z. B. Überschriften, die in Größen angezeigt werden, die etwas größer als der typische Text des Benutzeroberflächentexts sind.
UINotificationHeadingFont	Ruft eine Schriftart ab, die für spezielle UI-Elemente empfohlen wird, z. B. Überschriften in Benachrichtigungen oder anderen App-Nachrichten, die mit der Textgröße der Benutzeroberfläche angezeigt werden oder nur geringfügig größer sind, aber vom Textkörper der Benutzeroberfläche unterschieden werden müssen.
UITextFont	Ruft eine Schriftart ab, die für typischen Text der Benutzeroberfläche empfohlen wird.
UITitleFont	Ruft eine Schriftart ab, die für spezielle Ui-Elemente empfohlen wird, die mit einer größe größer als der typische Text des Benutzeroberflächentexts sind.

Weitere Informationen

• Beispiel für Sprachschriftartzuordnung
• Beispiel für die Sprachschriftartenzuordnung (Windows 10)