Gestion de SmartArt dans les présentations PowerPoint en .NET

Obtenir le texte d’un objet SmartArt

La propriété TextFrame a maintenant été ajoutée à l’interface ISmartArtShape et à la classe SmartArtShape respectivement. Cette propriété vous permet d’obtenir tout le texte du SmartArt même s’il ne contient pas seulement le texte des nœuds. Le code d’exemple suivant vous aidera à récupérer le texte d’un nœud SmartArt.

using (Presentation pres = new Presentation("Presentation.pptx"))
{
	ISlide slide = pres.Slides[0];
	ISmartArt smartArt = (ISmartArt)slide.Shapes[0];

	ISmartArtNodeCollection smartArtNodes = smartArt.AllNodes;
	foreach (ISmartArtNode smartArtNode in smartArtNodes)
	{
		foreach (ISmartArtShape nodeShape in smartArtNode.Shapes)
		{
			if (nodeShape.TextFrame != null)
				Console.WriteLine(nodeShape.TextFrame.Text);
		}
	}
}

Modifier le type de mise en page d’un objet SmartArt

Pour modifier le type de mise en page du SmartArt, veuillez suivre les étapes ci-dessous :

• Créer une instance de la classe Presentation.
• Obtenir la référence d’une diapositive en utilisant son Index.
• Ajouter un SmartArt BasicBlockList.
• Modifier LayoutType en BasicProcess.
• Enregistrer la présentation en tant que fichier PPTX. Dans l’exemple ci‑dessous, nous avons ajouté un connecteur entre deux formes.

using (Presentation presentation = new Presentation())
{
    // Ajouter SmartArt BasicProcess 
    ISmartArt smart = presentation.Slides[0].Shapes.AddSmartArt(10, 10, 400, 300, SmartArtLayoutType.BasicBlockList);

    // Modifier LayoutType en BasicProcess
    smart.Layout = SmartArtLayoutType.BasicProcess;

    // Enregistrement de la présentation
    presentation.Save("ChangeSmartArtLayout_out.pptx", SaveFormat.Pptx);
}

Vérifier la propriété Hidden d’un objet SmartArt

Veuillez noter que la méthode com.aspose.slides.ISmartArtNode.isHidden() renvoie true si ce nœud est masqué dans le modèle de données. Pour vérifier la propriété hidden de n’importe quel nœud du SmartArt, veuillez suivre les étapes ci‑dessus :

• Créer une instance de la classe Presentation.
• Ajouter un SmartArt RadialCycle.
• Ajouter un nœud au SmartArt.
• Vérifier la propriété isHidden.
• Enregistrer la présentation en tant que fichier PPTX. Dans l’exemple ci‑dessous, nous avons ajouté un connecteur entre deux formes.

using (Presentation presentation = new Presentation())
{
    // Ajouter SmartArt BasicProcess 
    ISmartArt smart = presentation.Slides[0].Shapes.AddSmartArt(10, 10, 400, 300, SmartArtLayoutType.RadialCycle);

    // Ajouter un nœud au SmartArt 
    ISmartArtNode node = smart.AllNodes.AddNode();

    // Vérifier la propriété isHidden
    bool hidden = node.IsHidden; // Retourne true

    if (hidden)
    {
        // Faire certaines actions ou notifications
    }
    // Enregistrement de la présentation
    presentation.Save("CheckSmartArtHiddenProperty_out.pptx", SaveFormat.Pptx);
}

Obtenir ou définir le type de diagramme organisationnel

Les méthodes com.aspose.slides.ISmartArtNode.getOrganizationChartLayout() et setOrganizationChartLayout(int) permettent d’obtenir ou de définir le type de diagramme organisationnel associé au nœud actuel. Pour obtenir ou définir le type de diagramme organisationnel, veuillez suivre les étapes ci‑dessous :

• Créer une instance de la classe Presentation.
• Ajouter un SmartArt sur la diapositive.
• Obtenir ou définir le type de diagramme organisationnel.
• Enregistrer la présentation en tant que fichier PPTX. Dans l’exemple ci‑dessous, nous avons ajouté un connecteur entre deux formes.

using (Presentation presentation = new Presentation())
{
    // Ajouter SmartArt BasicProcess 
    ISmartArt smart = presentation.Slides[0].Shapes.AddSmartArt(10, 10, 400, 300, SmartArtLayoutType.OrganizationChart);

    // Obtenir ou définir le type de diagramme organisationnel 
    smart.Nodes[0].OrganizationChartLayout = OrganizationChartLayoutType.LeftHanging;

    // Enregistrement de la présentation
    presentation.Save("OrganizeChartLayoutType_out.pptx", SaveFormat.Pptx);
}

Créer un diagramme organisationnel d’image

Aspose.Slides for .NET fournit une API simple pour créer des graphiques PictureOrganization de manière facile. Pour créer un graphique sur une diapositive :

1. Créer une instance de la classe Presentation.
2. Obtenir la référence d’une diapositive par son index.
3. Ajouter un graphique avec des données par défaut ainsi que le type souhaité (ChartType.PictureOrganizationChart).
4. Enregistrer la présentation modifiée dans un fichier PPTX

Le code suivant est utilisé pour créer un graphique.

public static void Run()
{
	using (Presentation pres = new Presentation("test.pptx"))
	{
		ISmartArt smartArt = pres.Slides[0].Shapes.AddSmartArt(0, 0, 400, 400, SmartArtLayoutType.PictureOrganizationChart);
		pres.Save("OrganizationChart.pptx", SaveFormat.Pptx);
	}			
}

FAQ

Le SmartArt prend‑il en charge le miroir/inversion pour les langues RTL ?
Oui. La propriété IsReversed change la direction du diagramme (LTR/RTL) si le type de SmartArt sélectionné prend en charge l’inversion.

Comment copier le SmartArt sur la même diapositive ou dans une autre présentation tout en conservant le formatage ?
Vous pouvez cloner la forme SmartArt via la collection de formes (ShapeCollection.AddClone) ou cloner la diapositive entière contenant cette forme. Les deux approches conservent la taille, la position et le style.

Comment rendre le SmartArt en image raster pour un aperçu ou une exportation web ?
Rendre la diapositive (ou la présentation entière) en PNG/JPEG via l’API qui convertit les diapositives/présentations en images — le SmartArt sera dessiné comme partie de la diapositive.

Comment sélectionner programmatiquement un SmartArt spécifique sur une diapositive s’il y en a plusieurs ?
Une pratique courante consiste à utiliser le texte alternatif (Alt Text) ou un Nom et à rechercher la forme par cet attribut dans Slide.Shapes, puis à vérifier le type pour confirmer qu’il s’agit d’un SmartArt. La documentation décrit les techniques typiques pour trouver et travailler avec les formes.