Fontes e formatação para Visual Studio

Artigo
10/10/2023

A fonte do ambiente

Todas as fontes no Visual Studio devem ser expostas ao usuário para personalização. Isso é feito principalmente por meio da página Fontes e Cores na caixa de diálogo Opções de Ferramentas>. As três principais categorias de configurações de fonte são:

Fonte do ambiente - a fonte primária para o IDE (ambiente de desenvolvimento integrado), usada para todos os elementos da interface, incluindo caixas de diálogo, menus, janelas de ferramentas e janelas de documentos. Por padrão, a fonte do ambiente está vinculada a uma fonte do sistema que aparece como 9 pt Segoe UI nas versões atuais do Windows. O uso de uma fonte para todos os elementos da interface ajuda a garantir uma aparência de fonte consistente em todo o IDE.
Editor de texto - os elementos que aparecem no código e em outros editores baseados em texto podem ser personalizados na página Editor de texto em > Opções de ferramentas.
Coleções específicas - as janelas de designer que oferecem personalização ao usuário de seus elementos de interface podem expor fontes específicas de sua superfície de design em sua própria página de configurações em Opções de Ferramentas>.

Personalização e redimensionamento de fontes do editor

Os usuários geralmente ampliam ou ampliam o tamanho e/ou a cor do texto no editor de acordo com sua preferência, independentemente da interface geral do usuário. Como a fonte do ambiente é usada em elementos que podem aparecer dentro ou como parte de um editor/designer, é importante observar o comportamento esperado quando uma dessas classificações de fonte é alterada.

Ao criar elementos da interface do usuário que aparecem no editor, mas não fazem parte do conteúdo, é importante usar a fonte do ambiente e não a fonte do texto para que os elementos sejam redimensionados de maneira previsível.

Para texto de código no editor, redimensione com a configuração de fonte de texto de código e responda ao nível de zoom do texto do editor.
Todos os outros elementos da interface devem estar vinculados à configuração da fonte do ambiente e responder a quaisquer alterações globais no ambiente. Isso inclui (entre outros):
- Texto em menus de contexto
- Texto em um adorno do editor, como texto do menu da lâmpada, painel do editor de localização rápida e navegue até o painel
- Rotular texto em caixas de diálogo, como Localizar em Arquivos ou Refatorar

Acessando a fonte do ambiente

No código Native ou WinForms, a fonte do ambiente pode ser acessada chamando o método IUIHostLocale::GetDialogFont depois de consultar a interface do SID_SUIHostLocale serviço.

Para o Windows Presentation Foundation (WPF), derive sua classe de janela de diálogo da DialogWindow classe do shell em vez da classe do Window WPF.

Em XAML, o código tem a seguinte aparência:

<ui:DialogWindow
    x:Class"MyNameSpace.MyWindow"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:s="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:ui="clr-namespace:Microsoft.VisualStudio.PlatformUI;assembly=Microsoft.VisualStudio.Shell.11.0"
    ShowInTaskbar="False"
    WindowStartupLocation="CenterOwner"
    Title="My Dialog">
</ui:DialogWindow>

Código por trás:

internal partial class WebConfigModificationWindow : DialogWindow
{
}

(Substitua Microsoft.VisualStudio.Shell.11.0 pela versão atual da dll do MPF.)

Para exibir a caixa de diálogo, chame ""ShowModal() na classe sobre ShowDialog(). ShowModal() define o estado modal correto no shell, garante que a caixa de diálogo esteja centralizada na janela pai e assim por diante.

O código será o seguinte:

MyWindow window = new MyWindow();
window.ShowModal()

ShowModal devolve uma bool? (booleano anulável) com o DialogResult, que pode ser usado se necessário. O valor de retorno será true se a caixa de diálogo foi fechada com OK.

Se você precisar exibir alguma interface do usuário do WPF que não seja uma caixa de diálogo e esteja hospedada em sua própria HwndSource, como uma janela pop-up ou uma janela filho do WPF de uma janela pai do Win32/WinForms, será necessário definir o FontFamily e FontSize no elemento raiz do elemento WPF. (O shell define as propriedades na janela principal, mas elas não serão herdadas depois de um HWND). O shell fornece recursos aos quais as propriedades podem ser vinculadas, como este:

<Setter Property="FontFamily" Value="{DynamicResource VsFont.EnvironmentFontFamily}" />
<Setter Property="FontSize" Value="{DynamicResource VsFont.EnvironmentFontSize}" />

Referência de formatação (dimensionamento/negrito)

Algumas caixas de diálogo exigem que o texto específico esteja em negrito ou em um tamanho diferente da fonte do ambiente. Anteriormente, fontes maiores que a fonte do ambiente eram codificadas como ""environment font +2 ou similar. O uso dos trechos de código fornecidos oferecerá suporte a monitores de alto DPI e garantirá que o texto de exibição sempre apareça no tamanho e peso corretos (como Light ou Semilight).

Observação

Antes de aplicar a formatação, verifique se você está seguindo as orientações encontradas no estilo Texto.**

Para dimensionar a fonte do ambiente, defina o estilo do TextBlock ou Label conforme indicado. Cada um desses trechos de código, usados corretamente, gerará a fonte correta, incluindo as variações de tamanho e peso apropriadas.

Onde ""vsui é uma referência ao namespace Microsoft.VisualStudio.Shell:

xmlns:vsui="clr-namespace:Microsoft.VisualStudio.Shell;assembly=Microsoft.VisualStudio.Shell.14.0"