FontControl-Element

Artikel
09/03/2023

Stellt ein Schriftartensteuerelement dar, bei dem es sich um einen speziellen Container mit einzelnen Steuerelementen handelt, die für die Bearbeitung von Schriftarten bestimmt sind.

Verbrauch

<FontControl
  CommandName = "xs:positiveInteger or xs:string"
  FontType = "xs:string"
  IsGrowShrinkButtonGroupVisible = "Boolean"
  IsStrikethroughButtonVisible = "Boolean"
  IsUnderlineButtonVisible = "Boolean"
  IsHighlightButtonVisible = "Boolean"
  ShowVerticalFonts = "Boolean"
  ShowTrueTypeOnly = "Boolean"
  MinimumFontSize = "xs:positiveInteger"
  MaximumFontSize = "xs:positiveInteger"/>

Attribute

attribute	type	Erforderlich	BESCHREIBUNG
CommandName	xs:positiveInteger oder xs:string	Nein	Ordnet das Element einem Command zu. (xs:positiveInteger oder xs:string) Eine Zeichenfolge, ein ganzzahliger Wert zwischen 2 und 59999 inklusive oder ein Hexadezimalwert zwischen 0x2 und 0xea5f, inklusive. Der Wert muss innerhalb des XML-Dokuments des Menübands eindeutig sein. Maximale Länge: 100 Zeichen.
FontType	xs:string	Nein	Beschränkt auf einen der folgenden Werte: (FontOnly) Standard. Wenn Sie das FontType-Attribut auf festlegen, `FontOnly` werden die folgenden Funktionen aktiviert: Kombinationsfeld "Schriftfamilie". Kombinationsfeld "Schriftgrad". Umschaltflächen fett, kursiv, unterstrichen und durchgestrichen . Hinweis: Die Umschaltflächen Durchgestrichen und Unterstrichen werden standardmäßig angezeigt, können jedoch ausgeblendet werden, indem die Attribute IsStrikethroughButtonVisible und IsUnderlineButtonVisible auf `false`festgelegt werden. (FontWithColor) Wenn Sie das FontType-Attribut auf festlegen, `FontWithColor` werden die folgenden Funktionen aktiviert: Kombinationsfeld "Schriftfamilie". Kombinationsfeld "Schriftgrad". Vergrößern der Schriftart und Verkleinern des Schriftgrads inKrement- und Dekrementschaltflächen Umschaltflächen fett, kursiv, unterstrichen und durchgestrichen . Hinweis: Die Umschaltflächen Durchgestrichen und Unterstrichen werden standardmäßig angezeigt, können jedoch ausgeblendet werden, indem die Attribute IsStrikethroughButtonVisible und IsUnderlineButtonVisible auf `false`festgelegt werden. Textfarbenfarbauswahl . Farbauswahl für Textherhöhen . Hinweis: Dieses Steuerelement ist standardmäßig ausgeblendet, kann aber angezeigt werden, indem das IsHighlightButtonVisible-Attribut auf `true`festgelegt wird. (RichFont) Wenn Sie das FontType-Attribut auf festlegen, `RichFont` werden die folgenden Funktionen aktiviert: Kombinationsfeld "Schriftfamilie". Kombinationsfeld "Schriftgrad". Vergrößern der Schriftart und Verkleinern des Schriftgrads inKrement- und Dekrementschaltflächen Umschaltflächen fett, kursiv, unterstrichen und durchgestrichen . Hinweis: Die Umschaltflächen Durchgestrichen und Unterstrichen werden standardmäßig angezeigt und können nicht ausgeblendet werden, indem die Attribute IsStrikethroughButtonVisible und IsUnderlineButtonVisible auf `false`festgelegt werden. Textfarbenfarbauswahl . Farbauswahl für Textherhöhen . Hinweis: Dieses Steuerelement wird standardmäßig angezeigt und kann nicht ausgeblendet werden, indem das IsHighlightButtonVisible-Attribut auf `false`festgelegt wird. Tiefgestellte und hochgestellte Umschaltflächen.
IsGrowShrinkButtonGroupVisible	Boolesch	Nein	Windows 8 und höher Beschränkt auf einen der folgenden Werte: Hinweis: Die Schaltflächen "Vergrößern/Verkleinern" werden in der MiniToolbar nie angezeigt. (true) Standardwert, wenn der Wert von FontType gleich oder `RichFont`ist`FontWithColor`. (false) Standardwert, wenn der Wert von FontType gleich ist `FontOnly`.
IsHighlightButtonVisible	Boolesch	Nein	Beschränkt auf einen der folgenden Werte (0 und 1 sind ungültig): Hinweis: Die Farbherunterhebung ist nur in einem FontControl-Steuerelement verfügbar, wenn der Wert des FontType-Attributs`FontWithColor` gleich oder `RichFont`ist. (true) Standardwert, wenn der Wert von FontType gleich oder `RichFont`ist`FontWithColor`. Nur gültig, wenn der Wert von FontType gleich `FontWithColor` oder `RichFont`ist. (false) Standardwert, wenn der Wert von FontType gleich ist `FontOnly`. Nur gültig, wenn der Wert von FontType gleich `FontOnly` oder `FontWithColor`ist.
IsStrikethroughButtonVisible	Boolesch	Nein	Beschränkt auf einen der folgenden Werte (0 und 1 sind ungültig): (true) Standard. (false) Nur gültig, wenn der Wert von FontType gleich `FontOnly` oder `FontWithColor`ist.
IsUnderlineButtonVisible	Boolesch	Nein	Beschränkt auf einen der folgenden Werte (0 und 1 sind ungültig): (true) Standard. (false) Nur gültig, wenn der Wert von FontType gleich `FontOnly` oder `FontWithColor`ist.
MaximumFontSize	xs:positiveInteger	Nein	Die maximale anzuzeigende Punktgröße. (xs:positiveInteger) Ein ganzzahliger Wert zwischen 1 und 9999 einschließlich. Der Standardwert ist 9999.
MinimumFontSize	xs:positiveInteger	Nein	Die minimale anzuzeigende Punktgröße. (xs:positiveInteger) Ein ganzzahliger Wert zwischen 1 und 9999 einschließlich. Der Standardwert ist 1.
ShowTrueTypeOnly	Boolesch	Nein	Beschränkt auf einen der folgenden Werte (0 und 1 sind ungültig): (true) Zeigt nur TrueType- und OpenType-Schriftarten an. (false) Standard. Der Typ der angezeigten Schriftarten wird nicht eingeschränkt.
ShowVerticalFonts	Boolesch	Nein	Beschränkt auf einen der folgenden Werte (0 und 1 sind ungültig): Hinweis: Vertikale Schriftarten werden durch ein @-Symbol in der Liste Schriftfamilie vorangestellt. (true) Standard. Zeigt die vertikalen Schriftarten an, die in der Schriftarten-Systemsteuerung auf Anzeigen festgelegt sind. (false) Ermöglicht einer Anwendung, die vertikalen Text nicht unterstützt, das Ausblenden vertikaler Schriftarten, die in der Schriftarten-Systemsteuerung auf Anzeigen festgelegt sind. Hinweis: In Windows Vista bietet die Schriftarten-Systemsteuerung keine Funktionen zum Ein- oder Ausblenden . In diesem Fall muss das ShowVerticalFonts-Attribut auf `False`festgelegt werden.

Untergeordnete Elemente

Es gibt keine untergeordneten Elemente.

Übergeordnete Elemente

Element
ControlGroup
Gruppe
Menugroup

Hinweise

Optional.

Kann höchstens einmal für jedes ControlGroup-, Group- oder MenuGroup-Element auftreten.

Alle im Markup deklarierten FontControl-Befehlsattribute, z . B. Command.LabelTitle oder Command.TooltipTitle, werden von den Attributen der einzelnen Steuerelemente überschrieben, aus denen fontControl besteht.

Jeder Versuch, ein Farbfeld aus der Farbauswahl eines Schriftartensteuerelements auszuwählen, kann zu einer Zugriffsverletzung führen, wenn dem Steuerelement kein Befehlshandler zugeordnet ist.

Beispiele

Im folgenden Beispiel wird das grundlegende Markup für die drei Typen von Schriftartsteuerelementen veranschaulicht.

In diesem Codeabschnitt werden die FontControl Command-Deklarationen mit jeweils einer Gruppencontainerdeklaration angezeigt.

<!-- A FontOnly FontControl -->
<Command Name="cmdFontOnlyGroup"
         Symbol="cmdFontOnlyGroup"
         Comment="FontOnlyGroup"
         Id="50001"
         LabelTitle="FontOnly"/>
<Command Name="cmdFontOnly"
         Symbol="cmdFontOnly"
         Comment="FontOnly"
         Id="50010"/>

<!-- A FontWithColor FontControl -->
<Command Name="cmdFontWithColorGroup"
         Symbol="cmdFontWithColorGroup"
         Comment="FontWithColorGroup"
         Id="50002"
         LabelTitle="FontWithColor"/>
<Command Name="cmdFontWithColor"
         Symbol="cmdFontWithColor"
         Comment="FontWithColor"
         Id="50020"/>

<!-- A RichFont FontControl -->
<Command Name="cmdRichFontGroup"
         Symbol="cmdRichFontGroup"
         Comment="RichFontGroup"
         Id="50003"
         LabelTitle="RichFont"
         Keytip="ZF"/>
<Command Name="cmdRichFont"
         Symbol="cmdRichFont"
         Comment="RichFont"
         Id="50030"
         Keytip="RF"
         LabelTitle="test"
         TooltipTitle="test"/>

Dieser Codeabschnitt zeigt die FontControl-Steuerelementdeklarationen , bei denen jedes FontControl und jede Gruppe auf einer einzelnen Registerkarte deklariert wird.

<Tab CommandName="cmdTab1">
  <Group CommandName="cmdFontOnlyGroup"
         SizeDefinition="OneFontControl">
    <FontControl CommandName="cmdFontOnly"
                 FontType="FontOnly"
                 IsUnderlineButtonVisible="false"
                 IsStrikethroughButtonVisible="false"
                 MinimumFontSize="15"/>
  </Group>
  <Group CommandName="cmdFontWithColorGroup"
         SizeDefinition="OneFontControl">
    <FontControl CommandName="cmdFontWithColor"
                 FontType="FontWithColor"
                 IsUnderlineButtonVisible="false"
                 IsStrikethroughButtonVisible="false"
                 IsHighlightButtonVisible="true"
                 MinimumFontSize="15"/>
  </Group>
  <Group CommandName="cmdRichFontGroup"
         SizeDefinition="OneFontControl">
    <FontControl CommandName="cmdRichFont"
                 FontType="RichFont"
                 IsHighlightButtonVisible="true"
                 IsUnderlineButtonVisible="true"
                 IsStrikethroughButtonVisible="true"
                 ShowVerticalFonts="true"
                 MinimumFontSize="15"/>
  </Group>

Elementinformationen

Unterstützte Mindestsystem: Windows 7
Kann leer sein: Ja

Weitere Informationen

Steuerelement für Schriftarten
Eigenschaften des Schriftartsteuerelements
FontControl-Beispiel

Freigeben über