Controles FlowDocument

WPF proporciona tres controles especializados para ver FlowDocument contenido, cada uno optimizado para diferentes escenarios de presentación. Estos controles le permiten mostrar contenido enriquecido y repetible en las aplicaciones, a la vez que ofrecen a los usuarios diferentes formas de interactuar con ese contenido.

Captura de pantalla del control FlowDocumentReader con un documento de ejemplo abierto.

Los tres controles FlowDocument son:

  • FlowDocumentScrollViewer: muestra contenido en una vista de desplazamiento continua, ideal para leer documentos largos sin paginación.
  • FlowDocumentPageViewer: presenta el contenido página por página, similar a un diseño de libro o revista.
  • FlowDocumentReader: ofrece la mayor flexibilidad al permitir que los usuarios cambien entre diferentes modos de visualización, como el desplazamiento, la página por página y las vistas de difusión de dos páginas.

Los tres controles comparten el propósito común de mostrar FlowDocument contenido, que se ajusta automáticamente para ajustarse al área de visualización disponible. Elija el control que mejor se adapte a las necesidades de la aplicación: use FlowDocumentScrollViewer para escenarios de desplazamiento simples, FlowDocumentPageViewer para presentaciones de página fija o FlowDocumentReader cuando quiera conceder a los usuarios control sobre cómo ven el contenido.

Para obtener información detallada sobre cómo crear y trabajar con documentos de flujo, consulte Información general del documento de flujo.

FlowDocumentScrollViewer

El control FlowDocumentScrollViewer muestra el contenido FlowDocument en un contenedor desplazable. Este control es ideal para experiencias de lectura continuas en las que desea que los usuarios se desplacen por el contenido en lugar de navegar entre páginas. Contrasta con FlowDocumentPageViewer, que visualiza el contenido por página.

Propiedad de contenido

La propiedad content de FlowDocumentScrollViewer es Document, que especifica el FlowDocument a mostrar.

Partes

En la tabla siguiente se enumeran las partes con nombre para el FlowDocumentScrollViewer control .

Nombre del elemento Tipo de elemento Description
PART_ContentHost ScrollViewer Anfitrión de desplazamiento para el contenido del documento de flujo de contenido.
PART_FindToolBarHost Decorator Anfitrión de la barra de herramientas de búsqueda.
PART_ToolBarHost Decorator El anfitrión de la barra de herramientas.

Estados visuales

En la tabla siguiente se enumeran los estados visuales del FlowDocumentScrollViewer control.

Nombre de VisualState Nombre de VisualStateGroup Description
Válido Estados de Validación El control es válido y no tiene errores de validación.
EnfoqueInválido Estados de Validación El control tiene un error de validación y tiene el foco del teclado.
InválidoSinEnfoque Estados de Validación El control presenta un error de validación, pero no tiene el enfoque del teclado.

FlowDocumentPageViewer

El control FlowDocumentPageViewer muestra el contenido FlowDocument por página. Este control proporciona una experiencia de lectura similar al libro con controles de navegación de página. Contrasta con FlowDocumentScrollViewer, que presenta FlowDocument contenido en un visor de desplazamiento.

Propiedad de contenido

La propiedad Document es la propiedad de contenido del control FlowDocumentPageViewer y contiene el documento de flujo mostrado en el visor.

Partes

En la tabla siguiente se enumeran las partes con nombre para el FlowDocumentPageViewer control .

Nombre del elemento Tipo de elemento Description
PART_FindToolBarHost Decorator El decorador que hospeda la barra de herramientas de búsqueda.

Estados visuales

En la tabla siguiente se enumeran los estados visuales del FlowDocumentPageViewer control.

Estado visual Grupo de estado visual Description
Válido Estados de Validación El control es válido y no tiene errores de validación.
EnfoqueInválido Estados de Validación El control tiene un error de validación y tiene el foco del teclado.
InválidoSinEnfoque Estados de Validación El control presenta un error de validación, pero no tiene el enfoque del teclado.

FlowDocumentReader

El FlowDocumentReader control muestra FlowDocument contenido y admite varios modos de visualización. Este control proporciona la mayor flexibilidad al permitir a los usuarios elegir su experiencia de lectura preferida, cambiar entre desplazamiento, página única y vistas de difusión de dos páginas.

Propiedad de contenido

La Document propiedad es la propiedad de contenido y define el FlowDocument contenido que muestra el lector.

Partes

En la tabla siguiente se enumeran las partes con nombre para el FlowDocumentReader control .

Nombre del elemento Tipo de elemento Description
PART_ContentHost Decorator Decorador que hospeda el visor de contenido para diferentes modos de visualización.
PART_FindToolBarHost Decorator El decorador que hospeda la barra de herramientas de búsqueda cuando está habilitada la funcionalidad de búsqueda.

Estados visuales

En la tabla siguiente se enumeran los estados visuales del FlowDocumentReader control.

Nombre del estado visual Nombre del grupo de estado visual Description
Válido Estados de Validación El control es válido y no tiene errores de validación.
EnfoqueInválido Estados de Validación El control tiene un error de validación y tiene el foco del teclado.
InválidoSinEnfoque Estados de Validación El control presenta un error de validación, pero no tiene el enfoque del teclado.

Estilos y plantillas

Puede modificar el valor predeterminado ControlTemplate de estos controles para darles una apariencia única. Para obtener más información, vea ¿Qué son los estilos y las plantillas? yCómo crear una plantilla para un control.

Consulte también

  • Last updated on