En savoir plus sur Xeed Workbooks pour .NET

Maintenant que nous connaissons les bases de la création et de l'édition de notre classeur, y compris l'utilisation de la fonction Tableaux, Styles et Vues de feuillesSi l'on ne peut pas se contenter d'un seul élément, il convient d'en ajouter un autre : Les images.

Qu'est-ce qu'une image ?

A Photo représente un élément d'image dans le classeur, il est également appelé élément de dessin.

La classe Picture possède les propriétés suivantes :

• Description: the description of the picture.
• DrawingClientData: the information of the ClientData, which is how the picture should behave when the worksheet is protected or printed.
• PictureLocks: the information of the PictureLocks, which are the manipulations allowed on the picture.

Accès aux images

Les images d'un cahier de travail sont accessibles par l'intermédiaire de la fonction Collection d'images sur un Feuille de travail. La classe PictureCollection contiendra toutes les images de la feuille de travail et permettra également à l'utilisateur d'ajouter de nouvelles images et de les manipuler.

La classe PictureCollection possède les propriétés suivantes :

• Count: returns the number of Pictures in the current Worksheet.
• Item: returns the Picture located at the specified index.

using( var document = Workbook.Load( "testDoc.xlsx" ));
{
	var worksheet = document.Worksheets[ 0 ];
	var pictureQty = worksheet.Pictures.Count;
	var firstPicture = worksheet.Pictures[ 0 ];
}

Ajouter des images à une feuille de calcul

Pour ajouter des images à une feuille de travail, nous utilisons la fonction Ajouter disponible dans la classe PictureCollection.

La méthode Add offre plusieurs surcharges, ce qui permet une certaine souplesse dans le type d'image à ajouter et dans son emplacement.

Note:

• For the overloads that have a scale parameter, the value must be 1 or greater (100 by default).

Ajouter des images à une feuille de travail :

using( var document = Workbook.Load( "testDoc.xlsx" ));
{
	var srcFile = PictureSampleResourcesDirectory + @"balloon.jpg";
	var srcStream = new FileStream( PictureSampleResourcesDirectory + @"balloon.jpg", FileMode.Open, FileAccess.Read );

	var worksheet = document.Worksheets[ 0 ];

	// Overload 1: filename and scale
	var pic1 = worksheet.Pictures.Add( srcFile, 50 );

	// Overload 2: stream and scale
	var pic2 = worksheet.Pictures.Add( srcStream, 50 );

	// Overload 3: filename, top left position (coordinates), scale
	var pic3 = worksheet.Pictures.Add( srcFile, 14, 0, 50 );

	// Overload 4: stream, top left position (coordinates), scale
	var pic4 = worksheet.Pictures.Add( srcStream, 14, 0, 50 );

	// Overload 5: filename, top left position (address), scale
	var pic5 = worksheet.Pictures.Add( srcFile, "A4", 50 );

	// Overload 6: stream, top left position (address), scale
	var pic6 = worksheet.Pictures.Add( srcStream, "A4", 50 );

	// Overload 7: filename, top left and bottom right positions (coordinates)
	var pic7 = worksheet.Pictures.Add( srcFile, 14, 0, 30, 15 );

	// Overload 8: stream, top left and bottom right positions (coordinates)
	var pic8 = worksheet.Pictures.Add( srcStream, 14, 0, 30, 15 );

	// Overload 9: filename, top left and bottom right positions (addresses)
	var pic9 = worksheet.Pictures.Add( srcFile, "A4", "E12");

	// Overload 10: stream, top left and bottom right positions (addresses)
	var pic10 = worksheet.Pictures.Add( srcStream, "A4", "E12" );

	document.Save();
}

Définir des restrictions sur une image

Le Verrous d'image permet de supprimer l'autorisation de modifier certaines propriétés de l'image dans Microsoft Excel. Par défaut, toutes les valeurs sont fixées à false.

Paramètres disponibles (réglez-les sur "vrai" pour appliquer le comportement correspondant) :

• NoAdjustHandles: removes the authorization to use the adjust handles.
• NoChangeArrowheads: removes the authorization to change Arrowheads.
• NoChangeAspect: removes the authorization to change the ratio.
• NoChangeShapeType: removes the authorization to change the connection shape.
• NoCrop: removes the authorization to crop the picture.
• NoEditPoints: removes the authorization to edit the connection shape point.
• NoGrp: removes the authorization to group shapes.
• NoMove: removes the authorization to move the picture.
• NoRot: removes the authorization to rotate the picture.
• NoSelect: removes the authorization to select the picture.

Pour plus d'informations, veuillez vous référer à la la documentation.