Condividi tramite

Controlli FlowDocument

WPF offre tre controlli specializzati per la visualizzazione del FlowDocument contenuto, ognuno ottimizzato per diversi scenari di presentazione. Questi controlli consentono di visualizzare contenuti ricchi e reflowable nelle applicazioni offrendo agli utenti diversi modi per interagire con tale contenuto.

Screenshot del controllo FlowDocumentReader con un documento di esempio aperto.

I tre controlli FlowDocument sono:

  • FlowDocumentScrollViewer: visualizza il contenuto in una visualizzazione a scorrimento continuo, ideale per la lettura di documenti lunghi senza impaginazione.
  • FlowDocumentPageViewer: presenta la pagina del contenuto per pagina, simile a un layout di un libro o di una rivista.
  • FlowDocumentReader: offre la massima flessibilità consentendo agli utenti di passare da una modalità di visualizzazione all'altra, tra cui lo scorrimento, la pagina per pagina e le visualizzazioni distribuite a due pagine.

Tutti e tre i controlli condividono lo scopo comune di visualizzare FlowDocument il contenuto, che si adatta automaticamente all'area di visualizzazione disponibile. Scegliere il controllo più adatto alle esigenze dell'applicazione: usare FlowDocumentScrollViewer per semplici scenari di scorrimento, FlowDocumentPageViewer per presentazioni a pagina fissa o FlowDocumentReader quando si vuole concedere agli utenti il controllo sulla modalità di visualizzazione del contenuto.

Per informazioni dettagliate sulla creazione e sull'uso di documenti di flusso, vedere Cenni preliminari sui documenti di Flow.

FlowDocumentScrollViewer

Il controllo FlowDocumentScrollViewer visualizza il contenuto FlowDocument in un contenitore di scorrimento. Questo controllo è ideale per le esperienze di lettura continue in cui si desidera che gli utenti scorrono il contenuto anziché spostarsi tra le pagine. Contrasto con FlowDocumentPageViewer, che visualizza il contenuto in base a ogni pagina.

Proprietà Content

La proprietà content per FlowDocumentScrollViewer è Document, che specifica l'oggetto FlowDocument da visualizzare.

Parti

Nella tabella seguente sono elencate le parti denominate del controllo FlowDocumentScrollViewer.

Nome parte Tipo di parte Description
PART_ContentHost ScrollViewer Host di scorrimento per i contenuti di un documento a scorrimento.
PART_FindToolBarHost Decorator Host per la barra degli strumenti di ricerca.
PART_ToolBarHost Decorator Host per la barra degli strumenti.

Stati di visualizzazione

Nella tabella seguente sono elencati gli stati di visualizzazione per il FlowDocumentScrollViewer controllo .

Nome VisualState Nome VisualStateGroup Description
Valido StatiDiValidazione Il controllo è valido e non presenta errori di convalida.
FuocoNonValido StatiDiValidazione Il controllo ha un errore di convalida ed è attivato dalla tastiera.
Non valido se non focalizzato StatiDiValidazione Il controllo presenta un errore di convalida ma non ha lo stato attivo della tastiera.

FlowDocumentPageViewer

Il FlowDocumentPageViewer controllo visualizza FlowDocument il contenuto per pagina. Questo controllo offre un'esperienza di lettura simile a un libro con i controlli di spostamento delle pagine. In contrasto con FlowDocumentScrollViewer, che presenta il contenuto FlowDocument in un visualizzatore di scorrimento.

Proprietà Content

La proprietà Document è la proprietà di contenuto del controllo FlowDocumentPageViewer e contiene il documento di flusso visualizzato nel visualizzatore.

Parti

Nella tabella seguente sono elencate le parti denominate del controllo FlowDocumentPageViewer.

Nome parte Tipo di parte Description
PART_FindToolBarHost Decorator L'elemento decoratore che ospita la barra degli strumenti di ricerca.

Stati di visualizzazione

Nella tabella seguente sono elencati gli stati di visualizzazione per il FlowDocumentPageViewer controllo .

Stato di visualizzazione Gruppo di stati di visualizzazione Description
Valido StatiDiValidazione Il controllo è valido e non presenta errori di convalida.
FuocoNonValido StatiDiValidazione Il controllo ha un errore di convalida ed è attivato dalla tastiera.
Non valido se non focalizzato StatiDiValidazione Il controllo presenta un errore di convalida ma non ha lo stato attivo della tastiera.

FlowDocumentReader

Il FlowDocumentReader controllo visualizza FlowDocument il contenuto e supporta più modalità di visualizzazione. Questo controllo offre la massima flessibilità consentendo agli utenti di scegliere l'esperienza di lettura preferita, spostandosi tra le visualizzazioni a scorrimento, a pagina singola e a due pagine.

Proprietà Content

La Document proprietà è la proprietà content e definisce il FlowDocument contenuto visualizzato dal lettore.

Parti

Nella tabella seguente sono elencate le parti denominate del controllo FlowDocumentReader.

Nome parte Tipo di parte Description
PART_ContentHost Decorator Il decoratore che ospita il visualizzatore di contenuti per diverse modalità di visualizzazione.
PART_FindToolBarHost Decorator Elemento decoratore che ospita la barra degli strumenti di ricerca quando la funzionalità di ricerca è attiva.

Stati di visualizzazione

Nella tabella seguente sono elencati gli stati di visualizzazione per il FlowDocumentReader controllo .

Nome stato di visualizzazione Nome gruppo di stati di visualizzazione Description
Valido StatiDiValidazione Il controllo è valido e non presenta errori di convalida.
FuocoNonValido StatiDiValidazione Il controllo ha un errore di convalida ed è attivato dalla tastiera.
Non valido se non focalizzato StatiDiValidazione Il controllo presenta un errore di convalida ma non ha lo stato attivo della tastiera.

Stili e modelli

È possibile modificare l'impostazione predefinita ControlTemplate per questi controlli per dare loro un aspetto univoco. Per altre informazioni, vedere Che cosa sono gli stili e i modelli? e Come creare un modello per un controllo.

Vedere anche

  • Last updated on