Usar los editores de subpropiedades y colecciones

En el panel Propiedades, algunas propiedades son más complejas que un único valor. Por ejemplo, algunas propiedades representan una colección de valores o bien un objeto con propiedades propias. Puede utilizar el editor de colecciones y el editor de subpropiedades para modificar estos valores.

El siguiente procedimiento se sirve de los editores de subpropiedades y colecciones para mostrarle cómo agregar contenido a un control FlowDocumentReader.

Nota No es necesario usar este procedimiento para modificar el texto de un control FlowDocumentScrollViewer; puede usar los procedimiento de Editar texto, Dar formato al texto y los otros temas que se muestran en la sección de procedimientos de Texto.

Para agregar contenido a un control FlowDocumentReader

  1. El control FlowDocumentReader está disponible en el Panel biblioteca. En el cuadro de herramientas, haga clic en el botón Panel biblioteca Botón Panel biblioteca.
  2. Active la casilla de verificación Mostrar todo para ver todos los controles disponibles.
  3. En la ficha Controles, seleccione Controles del sistema (predeterminado) y, a continuación, seleccione el control FlowDocumentReader.
    Aparecerá un icono genérico, encima del botón Panel biblioteca en el cuadro de herramientas, seleccionado y listo para agregarse al área de diseño.
  4. Dibuje un objeto FlowDocumentReader en el área de diseño.

    Control FlowDocumentReader dibujado en el área de diseño

    Control FlowDocumentReader dibujado en el área de diseño

  5. Con el objeto FlowDocumentReader seleccionado en Objetos y escala de tiempo, expanda la categoría Varios en el panel Propiedades.
  6. Haga clic en el botón Nuevo junto a la propiedad Document.
    La propiedad Document se rellena con un objeto FlowDocument y se abre el editor de subpropiedades para FlowDocument. Puede expandir y contraer el editor de subpropiedades. La propiedad Document sólo puede contener un objeto FlowDocument.
    Sugerencia Las propiedades que muestren un editor de subpropiedades suelen identificarse porque tienen al lado un botón Nuevo y una flecha de expansión Botón Panel biblioteca (siempre que la propiedad tenga contenido).
    Si la propiedad tiene subpropiedades predeterminadas asociadas, también habrá una flecha de lista desplegable al lado de la propiedad. Por ejemplo, la propiedad BitmapEffect tiene una lista desplegable en la que podrá elegir las subpropiedades BevelBitmapEffect, BlurBitmapEffect, etc.

    Editor de subpropiedades de la propiedad Document que muestra la propiedad Blocks (Collection)

    Editor de subpropiedades de la propiedad Document que muestra la propiedad Blocks (Collection)

  7. En el editor de subpropiedades para la propiedad Document, haga clic en el botón Editar elementos de esta colección Botón Editar elementos de esta colección junto a la propiedad Blocks (Collection).
    El editor de colecciones se abre para la propiedad Blocks.
    Sugerencia Las propiedades que muestren un editor de colecciones se suelen identificar con la palabra (Collection) junto al nombre de la propiedad y un botón Editar elementos de esta colección.

    Editor de colecciones de la subpropiedad Blocks

    Editor de colecciones de la subpropiedad Blocks

  8. En el editor de colecciones de la subpropiedad Blocks, haga clic en el botón Agregar otro elemento.
    Aparecerá la ventana Seleccionar objeto, desde la que puede seleccionar cualquier objeto de Windows Presentation Foundation (WPF).
  9. En el cuadro de texto Buscar, escriba Paragraph para encontrar rápidamente la clase Paragraph. Seleccione Paragraph en la lista, debajo de System.Windows.Documents, y haga clic en Aceptar.
    Se cerrará la ventana Seleccionar objeto y un elemento Paragraph se habrá agregado al editor de colecciones en el índice 0. Las propiedades del objeto Paragraph se muestran a la derecha.
    Sugerencia Puede resultar difícil entender qué objetos son válidos para una colección determinada. Para propiedades de colección de controles comunes (como la propiedad de colección Items del control ListBox), el editor de colecciones proporciona una lista desplegable de elementos sugeridos y el botón Agregar otro elemento. Sin embargo, en el caso de controles menos comunes (como el control FlowDocumentReader), puede consultar la documentación de MSDN sobre el tipo de control para entender qué elementos son válidos para la colección. Por ejemplo, en la sección acerca de clases de contenido dinámico del tema de información general sobre los documentos dinámicos de MSDN (en inglés), hay un diagrama que muestra la estructura de controles de documentos dinámicos. En este diagrama, puede ver que la propiedad Blocks puede contener un elemento Paragraph, Section, List, Table o BlockUIContainer. En los siguientes pasos, agregará un elemento Run a la propiedad de colección Inlines del objeto Paragraph.
  10. En la ventana Propiedades del objeto Paragraph, haga clic en el botón Editar elementos de esta colección junto a la propiedad Inlines.
    El editor de colecciones cambia al ámbito de la propiedad Inlines.
  11. Haga clic en el botón Agregar otro elemento y, a continuación, seleccione la clase Run en la ventana Seleccionar objeto.
    Se habrá agregado un objeto Run al editor de colecciones en el índice 0.
  12. En la ventana Propiedades del objeto Run, agregue contenidos escribiendo en la propiedad Text. Asimismo, puede utilizar algunas de las propiedades de las categorías Pinceles y Texto para aplicar estilo al texto. Las otras propiedades están deshabilitadas porque deben establecerse en el nivel del control FlowDocumentViewer.

    Editor de colecciones de la propiedad Inlines después de agregar un objeto Run y editar el texto

    Editor de colecciones de la propiedad Inlines después de agregar un objeto Run y editar el texto

  13. Haga clic en Aceptar para salir del editor de colecciones de la propiedad Inlines y, a continuación, haga clic en Aceptar para salir del editor de colecciones de la propiedad Blocks.
    El texto que escribió en el paso anterior se muestra en el control FlowDocumentViewer.
    Advertencia No haga clic en el botón Nuevo junto a la propiedad Document del objeto FlowDocumentViewer a menos que desee eliminar el contenido que acaba de crear, porque la propiedad Document sólo puede contener un objeto FlowDocument. A menos que el nombre de la propiedad incluya la palabra (Collection), la propiedad sólo puede contener un objeto.
Nota Si está editando un objeto FlowDocumentScrollViewer o RichTextBox, puede utilizar el editor de texto de Expression Blend, al que puede obtener acceso si selecciona el objeto y presiona F2. Para obtener más información, vea Editar texto en este manual del usuario.
Si está editando un objeto DocumentViewer o FlowDocumentPageViewer, el contenido se agregará mediante programación. Para obtener más información, vea el tema de información general sobre los documentos dinámicos y el tema sobre documentos en Windows Presentation Foundation en MSDN (en inglés). Vea también los ejemplos de DocumentViewer y los ejemplos de FlowDocumentReader que pueden descargarse de la página de ejemplos de Windows SDK .NET Framework 3.0 (en inglés).