Compartilhar via


Elemento FontControl

Representa um Controle de Fonte, que é um contêiner especializado de controles individuais dedicados à manipulação de fontes.

Uso

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

Atributos

Atributo Tipo Obrigatório Descrição
CommandName
xs:positiveInteger ou xs:string
Não
Associa o elemento a um Command.

(xs:positiveInteger ou xs:string)
Uma cadeia de caracteres, um valor inteiro entre 2 e 59999, inclusive ou um valor hexadecimal entre 0x2 e 0xea5f, inclusive.
O valor deve ser exclusivo no documento XML da Faixa de Opções.
Comprimento máximo: 100 caracteres.
FontType
xs:string
Não
Restrito a um dos seguintes valores:

(FontOnly)
Padrão.
Captura de tela do elemento FontControl com o atributo FontOnly definido como true.
Definir o atributo FontType como FontOnly habilita a seguinte funcionalidade:
  • Caixa de combinação família de fontes.
  • Caixa de combinação Tamanho da Fonte.
  • Botões de alternância negrito, itálico, sublinhadoe tachado.

    Observação:
    Os botões de alternância Tachado e Sublinhado são exibidos por padrão, mas podem ser ocultos definindo os atributos IsStrikethroughButtonVisible e IsUnderlineButtonVisible como false.


(FontWithColor)
Captura de tela do elemento FontControl com o atributo FontWithColor definido como true.
Definir o atributo FontType como FontWithColor habilita a seguinte funcionalidade:
  • Caixa de combinação família de fontes.
  • Caixa de combinação tamanho da fonte.
  • Aumentar a fonte e reduzir os botões de incremento e decremento do tamanho da fonte da fonte .
  • Botões de alternância negrito, itálico, sublinhadoe tachado.

    Observação:
    Os botões de alternância Tachado e Sublinhado são exibidos por padrão, mas podem ser ocultos definindo os atributos IsStrikethroughButtonVisible e IsUnderlineButtonVisible como false.


  • Seletor de cores de texto .
  • Seletor de cores de realce de texto .

    Observação:
    Esse controle está oculto por padrão, mas pode ser exibido definindo o atributo IsHighlightButtonVisible como true.


(RichFont)
Captura de tela do elemento FontControl com o atributo RichFont definido como true.
Definir o atributo FontType como RichFont habilita a seguinte funcionalidade:
  • Caixa de combinação família de fontes.
  • Caixa de combinação tamanho da fonte.
  • Aumentar a fonte e reduzir os botões de incremento e decremento do tamanho da fonte da fonte .
  • Botões de alternância negrito, itálico, sublinhadoe tachado.

    Observação:
    Os botões de alternância Tachado e Sublinhado são exibidos por padrão e não podem ser ocultos definindo os atributos IsStrikethroughButtonVisible e IsUnderlineButtonVisible como false.


  • Seletor de cores de texto .
  • Seletor de cores de realce de texto .

    Observação:
    Esse controle é exibido por padrão e não pode ser oculto definindo o atributo IsHighlightButtonVisible como false.


  • Botões de alternância Subscrito e Sobrescrito .
IsGrowShrinkButtonGroupVisible
Boolean
Não
Windows 8 e mais recente
Restrito a um dos seguintes valores:

Observação:
Os botões Crescer/Reduzir nunca são exibidos na MiniToolbar.



(true)
Padrão quando o valor de FontType é FontWithColor igual a ou RichFont.
(false)
Padrão quando o valor de FontType é FontOnlyigual a .
IsHighlightButtonVisible
Boolean
Não
Restrito a um dos seguintes valores (0 e 1 não são válidos):

Observação:
O realce de cores só estará disponível em um FontControl quando o valor do atributo FontType for igual FontWithColor a ou RichFont.



(true)
Padrão quando o valor de FontType é FontWithColor igual a ou RichFont.
Válido somente quando o valor de FontType for FontWithColor igual a ou RichFont.
(false)
Padrão quando o valor de FontType é FontOnlyigual a .
Válido somente quando o valor de FontType for FontOnly igual a ou FontWithColor.
IsStrikethroughButtonVisible
Boolean
Não
Restrito a um dos seguintes valores (0 e 1 não são válidos):

(true)
Padrão.
(false)
Válido somente quando o valor de FontType for FontOnly igual a ou FontWithColor.
IsUnderlineButtonVisible
Boolean
Não
Restrito a um dos seguintes valores (0 e 1 não são válidos):

(true)
Padrão.
(false)
Válido somente quando o valor de FontType for FontOnly igual a ou FontWithColor.
MaximumFontSize
xs:positiveInteger
Não
O tamanho máximo do ponto a ser exibido.

(xs:positiveInteger)
Um valor inteiro entre 1 e 9999, inclusive.
O padrão é 9999.
MinimumFontSize
xs:positiveInteger
Não
O tamanho mínimo do ponto a ser exibido.

(xs:positiveInteger)
Um valor inteiro entre 1 e 9999, inclusive.
O padrão é 1.
ShowTrueTypeOnly
Boolean
Não
Restrito a um dos seguintes valores (0 e 1 não são válidos):

(true)
Exibe somente fontes TrueType e OpenType.
(false)
Padrão. Nenhuma restrição é colocada no tipo de fontes exibidas.
ShowVerticalFonts
Boolean
Não
Restrito a um dos seguintes valores (0 e 1 não são válidos):

Observação:
Fontes verticais são precedidas por um símbolo @ na lista Família de fontes.



(true)
Padrão. Exibe as fontes verticais definidas como Mostrar no painel de controle Fontes .
(false)
Permite que um aplicativo que não dá suporte ao texto vertical oculte as fontes verticais definidas como Mostrar no painel de controle Fontes .

Observação:
No Windows Vista, o painel de controle Fontes não oferece a funcionalidade Mostrar ou Ocultar . Nesse caso, o atributo ShowVerticalFonts deve ser definido Falsecomo .


Elementos filho

Não há elementos filho.

Elementos pai

Elemento
ControlGroup
Grupo
Menugroup

Comentários

Opcional.

Pode ocorrer no máximo uma vez para cada elemento ControlGroup, Group ou MenuGroup .

Todos os atributos de Comando FontControl declarados na marcação, como Command.LabelTitle ou Command.TooltipTitle, são substituídos pelos atributos dos controles individuais que compõem o FontControl.

Qualquer tentativa de selecionar uma amostra de cor no seletor de cores de um Controle de Fonte poderá resultar em uma violação de acesso se nenhum manipulador de comando estiver associado ao controle.

Exemplos

O exemplo a seguir demonstra a marcação básica para os três tipos de Controle de Fonte.

Esta seção de código mostra as declarações de Comando FontControl , cada uma com uma declaração de contêiner de grupo .

<!-- 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"/>

Esta seção de código mostra as declarações de controle FontControl em que cada FontControl e Group são declarados em uma única Guia.

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

Informações do elemento

  • Sistema mínimo com suporte: Windows 7
  • Pode estar vazio: Sim

Confira também

Controle de controle de fonte

Propriedades de controle de fonte

Exemplo de FontControl