Volume 2 — Interfacce desktop

Indice dei capitoli

Prima di cominciare ✔

Prefazione · la collana · A chi è rivolto · Come è fatto il libro e i percorsi di lettura · Le regole della casa · Gli strumenti e il codice degli esempi · Convenzioni tipografiche.

Ripasso

Il C# del volume 1 ✔ — quello che i capitoli II.1–II.41 usano dei capitoli I.1–I.18, con il rimando al capitolo che lo spiega per intero.

Parte prima — Avalonia: le basi in codice

19. Avalonia e la programmazione desktop multipiattaforma ✔ — cos'è un'interfaccia grafica; Avalonia e le alternative; come disegna; cosa è gratuito e cosa no; perché senza XAML.
20. Il progetto Avalonia ✔ — i pacchetti NuGet di Avalonia; il progetto degli esempi; RAVAL.
21. Il primo progetto senza XAML ✔ — il .csproj; Program.Main; la finestra.
22. Struttura e ciclo di vita ✔ — AppBuilder; Application.Initialize; OnFrameworkInitializationCompleted; i lifetime; chiudere il programma.
23. Application, Window e controlli solo in C# ✔ — il contenuto a mano; il contenuto fluente con RAVAL; quando usare l'uno o l'altro.
24. Organizzare il progetto ✔ — namespace, cartelle, una classe per vista, nomi.
25. Gli eventi di Avalonia ✔ — gestori con un nome; lo stato in una classe; eventi instradati, Tunnel e Bubble; Invio nella TextBox.
26. Le proprietà di Avalonia ✔ — StyledProperty, DirectProperty, proprietà associate, precedenze dei valori, proprietà di stile.
27. Visual tree e logical tree ✔ — l'albero dei controlli; i due alberi; un solo genitore; TopLevel.
28. Il layout e i pannelli ✔ — Measure e Arrange; StackPanel, Grid, DockPanel, WrapPanel, UniformGrid, Border, Canvas.
29. Dimensioni, margini, allineamenti ✔ — margini e padding; allineamenti e Stretch; misure fisse, minime, massime; ridimensionare la finestra.
30. DPI, scaling e schermi ad alta densità ✔ — pixel indipendenti dal dispositivo; RenderScaling; immagini nitide; più schermi.
31. Risorse, temi e stili in C# ✔ — risorse; ThemeDictionaries; legare una proprietà a una risorsa; stili e selettori scritti in codice.

Parte seconda — Controlli e interfacce

32. Testo, etichette, pulsanti e input ✔ — TextBlock, TextBox, Button, NumericUpDown.
33. Scelte: CheckBox, RadioButton, liste, selettori ✔ — CheckBox, ToggleSwitch, RadioButton, ComboBox, ListBox, CalendarDatePicker.
34. Tabelle e DataGrid ✔ — DataGrid (MIT): colonne in codice, ordinamento, modifica.
35. Menu, toolbar, barra di stato, menu contestuali ✔ — Menu, tasti rapidi, ContextMenu, barre.
36. TabControl, Expander, navigazione ✔ — schede, sezioni espandibili, pagine dentro una finestra.
37. Dialoghi, modali, notifiche, file ✔ — finestre modali con risultato; StorageProvider; notifiche.
38. Stili dinamici, temi chiaro e scuro ✔ — cambiare tema; colori del tema in controlli propri.
39. Interfacce responsive ✔ — layout che si adattano alla larghezza; finestre piccole e grandi.
40. Drag & drop, appunti, selezione ✔ — trascinare file e testo; Clipboard.
41. Tastiera, mouse, touch, gesture, fuoco ✔ — eventi del puntatore; gesture; ordine del fuoco.
42. Accessibilità ✔ — nomi accessibili, navigazione da tastiera, contrasto.
43. Localizzazione ✔ — testi in più lingue, formati di numeri e date, lingue da destra a sinistra.

Parte terza — Architetture

44. Perché un'architettura; gli strati ✔ — accoppiamento e coesione; vista, logica, dati; le dipendenze che vanno verso il basso.
45. Il modello: dati senza grafica ✔ — record, immutabilità, validazione.
46. Viste come classi ✔ — controlli in campi, eventi in metodi, un solo Mostra(); quando basta questo.
47. Macchine a stati ✔ — stati, eventi, transizioni, azioni d'ingresso e d'uscita; diagrammi di stato; scriverle con enum e switch, con una tabella delle transizioni, con una classe per stato; stati annidati; vantaggi (un comportamento prevedibile, provabile, documentabile), svantaggi (l'esplosione degli stati, la rigidità) e quando usarle. Esempi: il semaforo; la connessione a un dispositivo (spento, connessione, pronto, errore, riconnessione); il lettore multimediale; la procedura guidata di più pagine; l'interfaccia che abilita e disabilita i comandi secondo lo stato; i test di ogni transizione.
48. MVC: modello, vista, controllore ✔ — chi fa cosa; il flusso di un'azione; una versione semplice per Avalonia scritta in codice; dove sta la logica; errori tipici (il controllore che diventa enorme, la vista che legge il modello di nascosto); quando usarlo. Esempi: la rubrica in MVC; lo stesso esempio con le viste come classi, a confronto.
49. MVVM: il modello più usato con Avalonia ✔ — modello, vista, ViewModel; perché i modelli di progetto e la documentazione di Avalonia lo usano (Avalonia però non lo impone); INotifyPropertyChanged; binding scritti in codice; dove mettere la logica e dove no; una base semplice per i ViewModel, senza librerie, e cosa aggiungono CommunityToolkit.Mvvm e ReactiveUI; quando MVVM conviene e quando è troppo. Esempi: la rubrica in MVVM; un modulo con la validazione; la macchina a stati del capitolo II.29 dentro un ViewModel. Diagrammi: le tre architetture a confronto sullo stesso clic.
50. Collezioni osservabili, comandi, validazione ✔ — ObservableCollection; ICommand e lo stato abilitato; INotifyDataErrorInfo ed errori mostrati nei controlli.
51. Interfacce, servizi e Dependency Injection ✔ — archivi intercambiabili; iniezione nel costruttore; un contenitore semplice.
52. Comunicazione fra componenti ✔ — eventi, messaggi, event aggregator; come evitare che tutti conoscano tutti.
53. Configurazione, registro ed errori ✔ — impostazioni in JSON, registro su file, errori mostrati all'utente.
54. Provare il codice ✔ — xUnit; logica, macchine a stati e ViewModel senza finestre; viste con Avalonia.Headless.

Parte quarta — Thread, Task e concorrenza

Thread, task e await come strumenti del linguaggio sono nei capitoli I.15–I.18; qui si applicano a una finestra.

55. Il thread dell'interfaccia e il Dispatcher ✔ — perché la finestra si blocca; un solo thread per i controlli; Dispatcher.UIThread, Post e InvokeAsync; i controlli toccati dal thread sbagliato.
56. await nei gestori ✔ — gestori async; SynchronizationContext e il ritorno sul thread della finestra; ConfigureAwait(false) nelle librerie; il deadlock di .Result in una finestra; pulsanti da disabilitare durante il lavoro.
57. Cancellazione, avanzamento, timer ✔ — CancellationToken con il pulsante Annulla, IProgress<T> con la barra, DispatcherTimer, PeriodicTimer.
58. Lavori lunghi e dati che arrivano ✔ — letture da un altro thread verso la finestra con Channel<T>; raccolte aggiornate dal thread giusto; Parallel e la finestra che resta viva.

Progetto

59. Il cruscotto in tempo reale ✔ — elenco di macchine con la loro macchina a stati, schede, grafici con DrawingContext, letture in un altro thread, MVVM, temi, impostazioni.

Appendici

A. Gli inciampi di Avalonia 12 ✔ · B. Riferimento rapido e le estensioni di RAVAL ✔ · C. Come sono fatte le figure ✔ · D. Glossario ✔

Stato dei capitoli: ✔ scritto · ✎ in bozza · ○ da scrivere.