Ajouter des équations mathématiques aux présentations PowerPoint en .NET

Vue d’ensemble

Dans PowerPoint, vous pouvez écrire une équation ou une formule mathématique et l’afficher dans votre présentation. Divers symboles mathématiques sont disponibles et peuvent être ajoutés au texte ou aux équations. Le constructeur d’équations mathématiques est utilisé pour créer des formules complexes telles que :

Fraction mathématique
Racine mathématique
Fonction mathématique
Limites et fonctions log
Opérations n‑aires
Matrice
Opérateurs larges
Fonctions sin, cos

Pour ajouter une équation mathématique dans PowerPoint, le menu Insertion → Équation est utilisé :

$todo:image_alt_text$

Cela crée un texte mathématique en XML qui peut être affiché dans PowerPoint comme suit :

$todo:image_alt_text$

PowerPoint prend en charge un large éventail de symboles mathématiques pour créer des équations. Cependant, la génération d’équations complexes dans PowerPoint ne donne souvent pas un résultat soigné et professionnel. En conséquence, les utilisateurs qui créent fréquemment des présentations mathématiques se tournent souvent vers des solutions tierces pour obtenir des formules plus esthétiques.

En utilisant l’Aspose.Slides API, vous pouvez travailler programmatiquement avec des équations mathématiques dans les présentations PowerPoint en C#. Créez de nouvelles expressions mathématiques ou modifiez celles existantes. Un support partiel est disponible pour l’exportation des structures mathématiques sous forme d’images.

Comment créer une équation mathématique

Les éléments mathématiques sont utilisés pour bâtir toute construction mathématique, quel que soit le niveau d’imbrication. Un ensemble linéaire de ces éléments forme un bloc mathématique, représenté par la classe MathBlock. La classe MathBlock représente une expression, une formule ou une équation mathématique autonome. MathPortion est utilisé pour contenir du texte mathématique (différent de la classe régulière Portion), tandis que MathParagraph vous permet de manipuler un ensemble d’objets MathBlock. Ces classes sont essentielles pour travailler avec les équations mathématiques PowerPoint via l’Aspose.Slides API.

Voyons comment créer l’équation mathématique suivante à l’aide de l’Aspose.Slides API :

$todo:image_alt_text$

Pour ajouter une expression mathématique à la diapositive, ajoutez d’abord une forme qui contiendra le texte mathématique :

using (var presentation = new Presentation())
{
    var mathShape = presentation.Slides[0].Shapes.AddMathShape(0, 0, 720, 150);
}

Après la création de la forme, elle contient déjà un paragraphe avec une portion mathématique par défaut. La classe MathPortion représente une portion contenant du texte mathématique. Pour accéder au contenu mathématique d’une MathPortion, référez‑vous à la variable MathParagraph :

var mathParagraph = (mathShape.TextFrame.Paragraphs[0].Portions[0] as MathPortion).MathParagraph;

La classe MathParagraph vous permet de lire, ajouter, modifier et supprimer des blocs mathématiques (MathBlock), qui sont composés d’une combinaison d’éléments mathématiques. Par exemple, créez une fraction et placez‑la dans la présentation :

var fraction = new MathematicalText("x").Divide("y");

mathParagraph.Add(new MathBlock(fraction));

Chaque élément mathématique est représenté par une classe qui implémente l’interface IMathElement. Cette interface fournit de nombreuses méthodes pour créer facilement des expressions mathématiques, vous permettant de construire des équations assez complexes en une seule ligne de code. Par exemple, le théorème de Pythagore s’écrirait ainsi :

var mathBlock = new MathematicalText("c")
    .SetSuperscript("2")
    .Join("=")
    .Join(new MathematicalText("a").SetSuperscript("2"))
    .Join("+")
    .Join(new MathematicalText("b").SetSuperscript("2"));

Les opérations de l’interface IMathElement sont implémentées dans chaque type d’élément, y compris la classe MathBlock.

Voici le code source complet :

using (var presentation = new Presentation())
{
    var mathShape = presentation.Slides[0].Shapes.AddMathShape(0, 0, 720, 150);
    var mathParagraph = (mathShape.TextFrame.Paragraphs[0].Portions[0] as MathPortion).MathParagraph;

    var fraction = new MathematicalText("x").Divide("y");

    mathParagraph.Add(new MathBlock(fraction));

    var mathBlock = new MathematicalText("c")
        .SetSuperscript("2")
        .Join("=")
        .Join(new MathematicalText("a").SetSuperscript("2"))
        .Join("+")
        .Join(new MathematicalText("b").SetSuperscript("2"));

    mathParagraph.Add(mathBlock);

    presentation.Save("math.pptx", SaveFormat.Pptx);
}

Types d’éléments mathématiques

Les expressions mathématiques sont composées de séquences d’éléments mathématiques. Un bloc mathématique représente une telle séquence, et les arguments de ces éléments forment une structure arborescente imbriquée.

Il existe de nombreux types d’éléments mathématiques qui peuvent être utilisés pour construire un bloc mathématique. Chaque élément peut être agrégé dans un autre, formant ainsi une structure en arbre. Le type le plus simple est celui qui ne contient aucun autre élément de texte mathématique.

Chaque type d’élément implémente l’interface IMathElement, ce qui vous permet d’utiliser un ensemble commun d’opérations mathématiques sur différents types d’éléments.

Classe MathematicalText

La classe MathematicalText représente un texte mathématique — l’élément sous‑jacent de toutes les constructions mathématiques. Le texte mathématique peut représenter des opérandes et des opérateurs, des variables ou tout autre texte linéaire.

Exemple : 𝑎=𝑏+𝑐

Classe MathFraction

La classe MathFraction spécifie un objet fraction composé d’un numérateur et d’un dénominateur séparés par une barre de fraction. La barre peut être horizontale ou diagonale, selon les propriétés de la fraction. L’objet fraction est également utilisé pour représenter la fonction « stack », qui place un élément au-dessus d’un autre sans barre de fraction.

Exemple :

$todo:image_alt_text$

Classe MathRadical

La classe MathRadical spécifie la fonction radicale (racine mathématique), composée d’une base et d’un degré optionnel.

Exemple :

$todo:image_alt_text$

Classe MathFunction

La classe MathFunction spécifie une fonction d’un argument. Elle possède des propriétés telles que Name, qui représente le nom de la fonction, et Base, qui représente l’argument de la fonction.

Exemple :

$todo:image_alt_text$

Classe MathNaryOperator

La classe MathNaryOperator spécifie un objet mathématique n‑aire, tel qu’une sommation ou une intégrale. Elle comprend un opérateur, une base (ou opérande) et des limites supérieure et inférieure optionnelles. Des exemples d’opérateurs n‑aires sont la sommation, l’union, l’intersection et l’intégrale.

Cette classe n’inclut pas les opérateurs simples comme l’addition ou la soustraction ; ils sont représentés par un texte unique MathematicalText.

Exemple :

$todo:image_alt_text$

Classe MathLimit

La classe MathLimit crée une limite supérieure ou inférieure. Elle spécifie l’objet limite, composé d’un texte sur la ligne de base et d’un texte de taille réduite placé immédiatement au-dessus ou en dessous. Cet élément n’inclut pas le mot « lim », mais permet de placer du texte en haut ou en bas de l’expression. Ainsi, l’expression

$todo:image_alt_text$

est créée à l’aide d’une combinaison des éléments MathFunction et MathLimit comme suit :

var funcName = new MathLimit(new MathematicalText("lim"), new MathematicalText("𝑥→∞"));
var mathFunc = new MathFunction(funcName, new MathematicalText("𝑥"));

Classes MathSubscriptElement, MathSuperscriptElement, MathRightSubSuperscriptElement, MathLeftSubSuperscriptElement

Ces classes spécifient un indice inférieur ou supérieur. Vous pouvez définir simultanément un indice et un exposant du même côté d’un argument, mais un seul indice ou exposant est supporté uniquement du côté droit. La classe MathSubscriptElement peut également être utilisée pour définir le degré mathématique d’un nombre.

Exemple :

$todo:image_alt_text$

Classe MathMatrix

La classe MathMatrix spécifie l’objet matrice, composé d’éléments enfants disposés en une ou plusieurs lignes et colonnes. Il est important de noter que les matrices ne possèdent pas de délimiteurs intégrés. Pour entourer la matrice de crochets, utilisez l’objet délimiteur IMathDelimiter. Des arguments nuls peuvent être utilisés pour créer des espaces dans les matrices.

Exemple :

$todo:image_alt_text$

Classe MathArray

La classe MathArray spécifie un tableau vertical d’équations ou de tout objet mathématique.

Exemple :

$todo:image_alt_text$

Mise en forme des éléments mathématiques

Classe MathBorderBox : Dessine une bordure rectangulaire ou alternative autour de l’IMathElement.

Exemple :

$todo:image_alt_text$

Classe MathBox : Spécifie le conditionnement logique (encapsulation) d’un élément mathématique. Un objet encadré peut servir d’émulateur d’opérateur—avec ou sans point d’alignement—fonctionner comme point de rupture de ligne, ou être groupé pour empêcher les sauts de ligne à l’intérieur. Par exemple, l’opérateur « == » doit être encadré pour éviter les ruptures de ligne.
Classe MathDelimiter : Spécifie l’objet délimiteur, qui comprend des caractères ouvrants et fermants (parenthèses, accolades, crochets ou barres verticales) ainsi qu’un ou plusieurs éléments mathématiques séparés par un caractère spécifié. Exemple : (𝑥²); [𝑥²|𝑦²].

Exemple :

$todo:image_alt_text$

Classe MathAccent : Spécifie la fonction accent, composée d’une base et d’un signe diacritique combiné.

Exemple : 𝑎́.

Classe MathBar : Spécifie la fonction barre, composée d’un argument de base et d’une barre supérieure ou inférieure.

Exemple :

$todo:image_alt_text$

Classe MathGroupingCharacter : Spécifie un symbole de regroupement placé au-dessus ou au-dessous d’une expression, généralement pour mettre en évidence les relations entre les éléments.

Exemple :

$todo:image_alt_text$

Opérations mathématiques

Chaque élément mathématique et chaque expression mathématique (via MathBlock) implémente l’interface IMathElement. Cela vous permet d’effectuer des opérations sur la structure existante et de former des expressions plus complexes. Toutes les opérations disposent de deux jeux de paramètres : soit des arguments [IMathElement], soit des chaînes de caractères. Les instances de la classe MathematicalText sont créées implicitement à partir des chaînes spécifiées lorsqu’on utilise des arguments de type string. Les opérations mathématiques disponibles dans Aspose.Slides sont listées ci‑dessous.

Méthode Join

Ces méthodes joignent un élément mathématique et forment un bloc mathématique. Exemple :

IMathElement element1 = new MathematicalText("x");
IMathElement element2 = new MathematicalText("y");

IMathBlock block = element1.Join(element2);

Méthode Divide

Ces méthodes créent une fraction du type spécifié avec un numérateur et le dénominateur indiqué. Exemple :

IMathElement numerator = new MathematicalText("x");
IMathFraction fraction = numerator.Divide("y", MathFractionTypes.Linear);

Méthode Enclose

Ces méthodes entourent l’élément de caractères spécifiés, tels que des parenthèses ou d’autres caractères d’encadrement. Exemple :

IMathDelimiter delimiter = new MathematicalText("x"). Enclose('[', ']');
IMathDelimiter delimiter2 = new MathematicalText("elem1").Join("elem2").Enclose();

Méthode Function

Ces méthodes prennent une fonction d’un argument en utilisant l’objet actuel comme nom de fonction. Exemple :

IMathFunction func = new MathematicalText("sin").Function("x");

Méthode AsArgumentOfFunction

Ces méthodes utilisent l’instance actuelle comme argument de la fonction spécifiée. Vous pouvez :

spécifier une chaîne comme nom de fonction, par exemple « cos » ;
sélectionner une des valeurs prédéfinies des énumérations MathFunctionsOfOneArgument ou MathFunctionsOfTwoArguments, par exemple MathFunctionsOfOneArgument.ArcSin ;
sélectionner l’instance de l’IMathElement.

Exemple :

var funcName = new MathLimit(new MathematicalText("lim"), new MathematicalText("𝑛→∞"));
var func1 = new MathematicalText("2x").AsArgumentOfFunction(funcName);
var func2 = new MathematicalText("x").AsArgumentOfFunction("sin");
var func3 = new MathematicalText("x").AsArgumentOfFunction(MathFunctionsOfOneArgument.Sin);
var func4 = new MathematicalText("x").AsArgumentOfFunction(MathFunctionsOfTwoArguments.Log, "3")

Méthodes SetSubscript, SetSuperscript, SetSubSuperscriptOnTheRight, SetSubSuperscriptOnTheLeft

Ces méthodes définissent les indices et les exposants. Vous pouvez les définir simultanément des deux côtés d’un argument ; toutefois, un seul indice ou exposant est supporté uniquement du côté droit. Le Superscript peut également servir à définir le degré mathématique d’un nombre.

Exemple :

var script = new MathematicalText("y").SetSubSuperscriptOnTheLeft("2x", "3z");

Méthode Radical

Ces méthodes spécifient la racine mathématique du degré indiqué à partir de l’argument fourni.

Exemple :

var radical = new MathematicalText("x").Radical("3");

Méthodes SetUpperLimit et SetLowerLimit

Ces méthodes définissent une limite supérieure ou inférieure, où « upper » et « lower » indiquent la position de l’argument par rapport à la base.

Considérons l’expression :

$todo:image_alt_text$

De telles expressions peuvent être créées grâce à une combinaison des classes MathFunction et MathLimit, ainsi que des opérations de l’interface IMathElement, comme suit :

var mathExpression = MathText.Create("lim").SetLowerLimit("x→∞").Function("x");

Méthodes Nary et Integral

Les méthodes Nary et Integral créent et retournent l’opérateur n‑aire représenté par le type INaryOperator. Dans la méthode Nary, l’énumération MathNaryOperatorTypes indique le type d’opérateur—par exemple sommation ou union—à l’exclusion des intégrales. Dans la méthode Integral, une opération spécialisée pour les intégrales est fournie via l’énumération MathIntegralTypes.

Exemple :

IMathBlock baseArg = new MathematicalText("x").Join(new MathematicalText("dx").ToBox());
IMathNaryOperator integral = baseArg.Integral(MathIntegralTypes.Simple, "0", "1");

Méthode ToMathArray

ToMathArray place les éléments dans un tableau vertical. Si cette opération est appelée sur une instance de MathBlock, tous ses éléments enfants seront placés dans le tableau retourné.

Exemple :

var arrayFunction = new MathematicalText("x").Join("y").ToMathArray();

Opérations de mise en forme : Accent, Overbar, Underbar, Group, ToBorderBox, ToBox

Méthode Accent : ajoute un signe d’accent (un caractère au-dessus de l’élément).
Méthodes Overbar et Underbar : ajoutent une barre au-dessus ou en dessous.
Méthode Group : place dans un groupe en utilisant un caractère de regroupement tel qu’une accolade inférieure ou autre.
Méthode ToBorderBox : place dans une bordure.
Méthode ToBox : place dans une boîte logique non visuelle (groupement logique).

Exemples :

var accent = new MathematicalText("x").Accent('\u0303');
var bar = new MathematicalText("x").Overbar();
var groupChr = new MathematicalText("x").Join("y").Join("z").Group('\u23E1', MathTopBotPositions.Bottom, MathTopBotPositions.Top);
var borderBox = new MathematicalText("x+y+z").ToBorderBox();
var boxedOperator = new MathematicalText(":=").ToBox();

FAQ

Comment ajouter une équation mathématique à une diapositive PowerPoint ?

Pour ajouter une équation, créez un objet MathShape, qui contient automatiquement une portion mathématique. Ensuite, récupérez le MathParagraph depuis le MathPortion et ajoutez‑y des objets MathBlock.

Est‑il possible de créer des expressions mathématiques imbriquées complexes ?

Oui, Aspose.Slides permet de créer des expressions mathématiques complexes en imbriquant des MathBlock. Chaque élément mathématique implémente l’interface IMathElement, ce qui vous permet d’appliquer des opérations (Join, Divide, Enclose, etc.) afin de combiner les éléments en structures plus complexes.

Comment mettre à jour ou modifier une équation mathématique existante ?

Pour mettre à jour une équation, accédez aux MathBlock existants via le MathParagraph. Puis, à l’aide de méthodes telles que Join, Divide, Enclose, etc., modifiez les éléments individuels de l’équation. Après la modification, enregistrez la présentation pour appliquer les changements.

Créer et personnaliser des graphiques PowerPoint dans .NET Gérer les formes PowerPoint dans .NET