En savoir plus sur Xceed Words pour .NET

Maintenant que nous connaissons les bases de la création d'un nouveau document et que nous savons comment utiliser les différentes sections, examinons les éléments qui peuvent être ajoutés dans un document. Il y a beaucoup de choses à couvrir, c'est pourquoi cet article sera divisé en plusieurs parties.

Pour l'instant, nous verrons comment ajouter des listes et des images.

Listes

L'ajout d'une liste se fait en appelant Liste d'ajout sur le document. Deux types de listes peuvent être ajoutés : les listes numérotées et les listes à puces. Une fois la liste créée, nous pouvons y ajouter des éléments en appelant AddListItem sur le document.

• Paramètres lors de la création d'une liste avec Liste d'ajoutCes paramètres sont les suivants : listText, level, listType, startNumber, trackChanges, continueNumbering et formatage. Tous ces paramètres sont facultatifs.
• Paramètres lors de l'ajout d'éléments à une liste avec AddListItemLes éléments de la liste sont les suivants : list, listText, level, listType, startNumber, trackChanges, continueNumbering et formatage. Seuls list et listText sont obligatoires, les autres sont facultatifs.

Note : si vous avez une liste existante, vous pouvez l'ajouter en appelant Liste d'ajout et en utilisant l'autre surcharge qui ne prend en paramètre qu'une liste existante.

Liste numérotée

// Create a document
using( var document = DocX.Create( “AddNumberedList.docx” ) )
{
	// Add a numbered list where the first ListItem starts with number 1
	var numberedList = document.AddList(“Berries”, 0, ListItemType,Numbered, 1);
	
	// Add sub-items (level 1) to the preceding ListItem
	document.AddListItem( numberedList, “Strawberries”, 1 );
	document.AddListItem( numberedList, “Blueberries”, 1 );
	
	// Add an item (level 0)
	document.AddListItem( numberedList, “Banana” );

	// Add an item (level 0)
	document.AddListItem( numberedList, “Apples” );

	// Add sub-items (level 1) to the preceding item
	document.AddListItem( numberedList, “Gala”, 1 );
	document.AddListItem( numberedList, “Honeycrisp”, 1 );

	// Insert the list into the document
	document.InsertParagraph( “This is a Numbered List:n” );
	document.InsertList( numberedList );

	// Save the document
	document.Save();
}

Liste à puces

// Create a document
using( var document = DocX.Create( “AddBulletedList.docx” ) )
{
	// Add a bulleted list with its first item
	var bulletedList = document.AddList(“Canada”, 0, ListItemType.Bulleted );

	// Add sub-items (level 1) to the preceding ListItem
	document.AddListItem( bulletedList, “Montreal”, 1 );
	document.AddListItem( bulletedList, “Toronto”, 1 );

	// Add an item (level 0)
	document.AddListItem( bulletedList, “Brazil” );

	// Add an item (level 0)
	document.AddListItem( bulletedList, “USA” );

	// Add sub-items (level 1) to the preceding item
	document.AddListItem( bulletedList, “New York”, 1 );
	document.AddListItem( bulletedList, “Los Angeles”, 1 );

	// Insert the list into the document
	document.InsertParagraph( “This is a Bulleted List:n” );
	document.InsertList( bulletedList );

	// Save the document
	document.Save();
}

Photos

L'ajout d'une image se fait en 3 étapes :

1. Ajoutez l'image au document à l'aide de la méthode AddImage.
2. Appelez la méthode CreatePicture de l'image pour créer un objet image.
3. Ajoutez l'image au document en appelant la méthode AppendPicture.

// Create a document
using( var document = DocX.Create( “AddPicture.docx” ) )
{
	// Add a simple image from disk
	var image = document.AddImage( “balloon.jpg”  );

	// Set Picture height and width
	var picture = image.CreatePicture( 150, 150 );

	// Insert Picture in paragraph
	var p = document.InsertParagraph( “Here is a simple picture added from disk:” );
	p.AppendPicture( picture );

	// Save the document
	document.Save();
}

En utilisant les propriétés disponibles sur un objet image, vous pouvez également personnaliser l'affichage d'une image.

Voici un exemple montrant comment vous pouvez ajouter une image avec un texte enveloppant :

// Create a document
using( var document = DocX.Create( "AddPictureWithTextWrapping.docx" ) )
{
	// Add a simple image from disk
	var image = document.AddImage( "WordsIcon.png" );

	// Set Picture height and width, and set its wrapping as Square
	var picture = image.CreatePicture( 60, 60 );
	picture.WrappingStyle = PictureWrappingStyle.WrapSquare;
	picture.WrapText = PictureWrapText.bothSides;

	// Set horizontal alignment with Alignement centered on the page.
	picture.HorizontalAlignment = PictureHorizontalAlignment.CenteredRelativeToPage;

	// Set vertical alignement with an offset from top of paragraph.
	picture.VerticalOffsetAlignmentFrom = PictureVerticalOffsetAlignmentFrom.Paragraph;
	picture.VerticalOffset = 25d;

	// Set a buffer on left and right of picture where no text will be drawn.
	picture.DistanceFromTextLeft = 5d;
	picture.DistanceFromTextRight = 5d;

	// Add a paragraph and the picture in it.
	var p = document.InsertParagraph( "With its easy to use API, Xceed Words for .NET lets your application create new Microsoft Word .docx or PDF documents, or modify existing .docx documents. It gives you complete control over all content in a Word document, and lets you add or remove all commonly used element types, such as paragraphs, bulleted or numbered lists, images, tables, charts, headers and footers, sections, bookmarks, and more. Create PDF documents using the same API for creating Word documents." );
	p.Alignment = Alignment.both;
	p.InsertPicture( picture );

	// Save the document
	document.Save();
}