Más información Xceed Words para .NET

Ahora que conocemos los conceptos básicos de la creación de un nuevo documento y cómo utilizar las diferentes Secciones, vamos a ver los elementos que se pueden añadir en un documento. Hay mucho que cubrir, así que esto se dividirá en varias partes.

En esta ocasión, veremos cómo añadir Listas e Imágenes.

Listas

Para añadir una lista, llame a AddList en el Documento. Hay 2 tipos de listas que se pueden añadir: Numeradas y con viñetas. Una vez creada la lista, podemos añadirle elementos llamando a AddListItem en el Documento.

• Parámetros al crear una lista con AddList: listText, level, listType, startNumber, trackChanges, continueNumbering y formatting. Todos estos parámetros son opcionales.
• Parámetros al añadir elementos a una lista con AddListItem: list, listText, level, listType, startNumber, trackChanges, continueNumbering y formatting. Sólo list y listText son obligatorios, los demás son opcionales.

Nota: si ya dispone de una lista, puede añadirla llamando a AddList y utilizando la otra sobrecarga que sólo toma como parámetro una lista existente.

Lista numerada

// Crear un documento
using( var document = DocX.Create( "AddNumberedList.docx" ) )
{
	// Añade una lista numerada donde el primer ListItem empieza por el número 1
	var numberedList = document.AddList("Berries", 0, ListItemType,Numbered, 1);
	
	// Añadir subelementos (nivel 1) al ListItem precedente
	document.AddListItem( numberedList, "Fresas", 1 );
	document.AddListItem( numberedList, "Arándanos", 1 );
	
	// Añadir un elemento (nivel 0)
	document.AddListItem( numberedList, "Plátano" );

	// Añadir un elemento (nivel 0)
	document.AddListItem( numberedList, "Manzanas" );

	// Añadir subelementos (nivel 1) al elemento anterior
	document.AddListItem( numberedList, "Gala", 1 );
	document.AddListItem( numberedList, "Honeycrisp", 1 );

	// Insertar la lista en el documento
	document.InsertParagraph( "Esto es una lista numerada:n" );
	document.InsertList( numberedList );

	// Guardar el documento
	document.Save();
}

Lista con viñetas

// Crear un documento
using( var document = DocX.Create( "AddBulletedList.docx" ) )
{
	// Añadir una lista con viñetas con su primer elemento
	var bulletedList = document.AddList("Canada", 0, ListItemType.Bulleted );

	// Añadir subelementos (nivel 1) al ListItem anterior
	document.AddListItem( bulletedList, "Montreal", 1 );
	document.AddListItem( bulletedList, "Toronto", 1 );

	// Añadir un elemento (nivel 0)
	document.AddListItem( bulletedList, "Brasil" );

	// Añadir un elemento (nivel 0)
	document.AddListItem( bulletedList, "USA" );

	// Añadir subelementos (nivel 1) al elemento anterior
	document.AddListItem( bulletedList, "Nueva York", 1 );
	document.AddListItem( bulletedList, "Los Angeles", 1 );

	// Insertar la lista en el documento
	document.InsertParagraph( "Esto es una lista con viñetas:n" );
	document.InsertList( bulletedList );

	// Guardar el documento
	document.Save();
}

Fotos

Añadir una imagen se hace en 3 pasos:

1. Añade la imagen al documento con el método AddImage.
2. Llama al método CreatePicture de la imagen para crear un objeto imagen.
3. Añade la imagen al documento llamando al método AppendPicture.

// Crear un documento
using( var document = DocX.Create( "AñadirImagen.docx" ) )
{
	// Añadir una imagen simple desde el disco
	var image = document.AddImage( "globo.jpg" );

	// Establecer la altura y la anchura de la imagen
	var picture = image.CreatePicture( 150, 150 );

	// Insertar la imagen en el párrafo
	var p = document.InsertParagraph( "He aquí una simple imagen añadida desde el disco:" );
	p.AppendPicture( imagen );

	// Guardar el documento
	document.Save();
}

Utilizando las propiedades disponibles en un objeto de imagen, también puede personalizar cómo se muestra una imagen.

Este es un ejemplo de cómo añadir una imagen con texto:

// Crear un documento
using( var document = DocX.Create( "AddPictureWithTextWrapping.docx" ) )
{
	// Añadir una imagen simple desde el disco
	var image = document.AddImage( "WordsIcon.png" );

	// Establecer la altura y la anchura de la imagen, y establecer su envoltura como Cuadrado
	var picture = image.CreatePicture( 60, 60 );
	picture.WrappingStyle = PictureWrappingStyle.WrapSquare;
	picture.WrapText = PictureWrapText.bothSides;

	// Establecer alineación horizontal con Alineación centrada en la página.
	picture.HorizontalAlignment = PictureHorizontalAlignment.CenteredRelativeToPage;

	// Establecer la alineación vertical con un desplazamiento desde la parte superior del párrafo.
	picture.VerticalOffsetAlignmentFrom = PictureVerticalOffsetAlignmentFrom.Paragraph;
	picture.VerticalOffset = 25d;

	// Establece un buffer a izquierda y derecha de la imagen donde no se dibujará texto.
	picture.DistanciaDelTextoIzquierda = 5d;
	picture.DistanciaDelTextoDerecha = 5d;

	// Añadir un párrafo y la imagen en él.
	var p = document.InsertParagraph( "Con su API fácil de usar, Xceed Words para .NET permite a su aplicación crear nuevos documentos .docx o PDF de Microsoft Word, o modificar documentos .docx existentes. Le ofrece un control total sobre todo el contenido de un documento Word, y le permite añadir o eliminar todos los tipos de elementos de uso común, como párrafos, listas numeradas o con viñetas, imágenes, tablas, gráficos, encabezados y pies de página, secciones, marcadores y mucho más. Cree documentos PDF utilizando la misma API de creación de documentos Word". );
	p.Alineación = Alineación.ambos;
	p.InsertarImagen( imagen );

	// Guardar el documento
	document.Save();
}