Tipi di carattere e formattazione per Visual Studio

Articolo
10/10/2023

Tipo di carattere dell'ambiente

Tutti i tipi di carattere all'interno di Visual Studio devono essere esposti all'utente per la personalizzazione. Questa operazione viene eseguita principalmente tramite la pagina Tipi di carattere e colori nella finestra di dialogo Opzioni strumenti>. Le tre categorie principali di impostazioni dei tipi di carattere sono:

Tipo di carattere ambiente: tipo di carattere principale per l'IDE (ambiente di sviluppo integrato), usato per tutti gli elementi dell'interfaccia, inclusi dialoghi, menu, finestre degli strumenti e finestre dei documenti. Per impostazione predefinita, il tipo di carattere dell'ambiente è associato a un tipo di carattere di sistema visualizzato come 9 pt Segoe UI nelle versioni correnti di Windows. L'uso di un tipo di carattere per tutti gli elementi dell'interfaccia consente di garantire un aspetto coerente del tipo di carattere nell'IDE.
Editor di testo: gli elementi che eseguono il codice e altri editor basati su testo possono essere personalizzati nella pagina Editor di testo in Opzioni strumenti>.
Raccolte specifiche: le finestre della finestra di progettazione che offrono la personalizzazione degli elementi dell'interfaccia possono esporre tipi di carattere specifici all'area di progettazione nella pagina delle impostazioni in Opzioni strumenti>.

Personalizzazione e ridimensionamento dei tipi di carattere dell'editor

Gli utenti spesso ingrandiscono o zoomno le dimensioni e/o il colore del testo nell'editor in base alla preferenza, indipendentemente dall'interfaccia utente generale. Poiché il tipo di carattere dell'ambiente viene utilizzato su elementi che potrebbero essere visualizzati all'interno o come parte di un editor/finestra di progettazione, è importante notare il comportamento previsto quando una di queste classificazioni dei tipi di carattere viene modificata.

Quando si creano elementi dell'interfaccia utente visualizzati nell'editor ma non fanno parte del contenuto, è importante usare il tipo di carattere dell'ambiente e non il tipo di carattere di testo in modo che gli elementi vengano ridimensionati in modo prevedibile.

Per il testo del codice nell'editor, ridimensionare con l'impostazione del tipo di carattere del testo del codice e rispondere al livello di zoom del testo dell'editor.
Tutti gli altri elementi dell'interfaccia devono essere associati all'impostazione del tipo di carattere dell'ambiente e rispondere a eventuali modifiche globali nell'ambiente. includendo tra l'altro:
- Testo nei menu di scelta rapida
- Testo in un editor decorativo, ad esempio testo del menu lampadina, riquadro editor di ricerca veloce e passare al riquadro
- Etichettare il testo nelle finestre di dialogo, ad esempio Trova nei file o Refactoring

Accesso al tipo di carattere dell'ambiente

Nel codice Nativo o WinForms è possibile accedere al tipo di carattere dell'ambiente chiamando il metodo IUIHostLocale::GetDialogFont dopo aver eseguito una query sull'interfaccia dal SID_SUIHostLocale servizio.

Per Windows Presentation Foundation (WPF), derivare la classe della finestra di dialogo dalla classe della DialogWindow shell anziché dalla classe wpf Window .

In XAML il codice è simile al seguente:

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

Code-behind:

internal partial class WebConfigModificationWindow : DialogWindow
{
}

Sostituire Microsoft.VisualStudio.Shell.11.0 con la versione corrente della dll MPF.

Per visualizzare la finestra di dialogo, chiamare "ShowModal()" sulla classe su ShowDialog(). ShowModal() imposta lo stato modale corretto nella shell, assicura che il dialogo sia centrato nella finestra padre e così via.

Il codice è indicato di seguito:

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

ShowModal restituisce un valore bool? (booleano nullable) con DialogResult, che può essere usato se necessario. Il valore restituito è true se la finestra di dialogo è stata chiusa con OK.

Se è necessario visualizzare un'interfaccia utente WPF che non è una finestra di dialogo ed è ospitata nel proprio HwndSource, ad esempio una finestra popup o una finestra figlio WPF di una finestra padre Win32/WinForms, sarà necessario impostare FontFamily e FontSize sull'elemento radice dell'elemento WPF. La shell imposta le proprietà nella finestra principale, ma non verranno ereditate dopo un oggetto HWND. La shell fornisce risorse a cui è possibile associare le proprietà, come illustrato di seguito:

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

Riferimento alla formattazione (ridimensionamento/grassetto)

Alcune finestre di dialogo richiedono un testo specifico in grassetto o una dimensione diversa dal tipo di carattere dell'ambiente. In precedenza, i tipi di carattere maggiori del tipo di carattere dell'ambiente venivano codificati come "environment font +2" o simili. L'uso dei frammenti di codice forniti supporterà monitor con valori DPI elevati e garantisce che il testo visualizzato venga sempre visualizzato con le dimensioni e il peso corretti( ad esempio Light o Semilight).

Nota

Prima di applicare la formattazione, assicurarsi di seguire le indicazioni disponibili in Stile testo.**

Per ridimensionare il tipo di carattere dell'ambiente, impostare lo stile di TextBlock o Label come indicato. Ognuno di questi frammenti di codice, usati correttamente, genererà il tipo di carattere corretto, incluse le dimensioni e le variazioni di peso appropriate.

Dove "vsui" è un riferimento allo spazio dei nomi Microsoft.VisualStudio.Shell:

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