Obtenir les propriétés effectives des formes à partir des présentations en .NET

Dans ce sujet, nous aborderons les propriétés effectives et locales. Lorsque nous définissons des valeurs directement à ces niveaux

Dans les propriétés de portion sur la diapositive de la portion.
Dans le style de texte de forme prototype sur la diapositive de disposition ou maître (si la forme du cadre de texte de la portion en possède un).
Dans les paramètres de texte globaux de la présentation.

alors ces valeurs sont appelées valeurs locales. À chaque niveau, les valeurs locales peuvent être définies ou omises. Mais finalement, lorsqu’il faut savoir à quoi doit ressembler la portion, l’application utilise les valeurs effectives. Vous pouvez obtenir les valeurs effectives en utilisant la méthode getEffective() du format local.

L’exemple suivant montre comment obtenir les valeurs effectives.

using (Presentation pres = new Presentation("Presentation1.pptx"))
{
    IAutoShape shape = pres.Slides[0].Shapes[0] as IAutoShape;

    ITextFrameFormat localTextFrameFormat = shape.TextFrame.TextFrameFormat;
    ITextFrameFormatEffectiveData effectiveTextFrameFormat = localTextFrameFormat.GetEffective();

    IPortionFormat localPortionFormat = shape.TextFrame.Paragraphs[0].Portions[0].PortionFormat;
    IPortionFormatEffectiveData effectivePortionFormat = localPortionFormat.GetEffective();
}

Obtenir les propriétés effectives d’une caméra

Aspose.Slides for .NET permet aux développeurs d’obtenir les propriétés effectives de la caméra. À cette fin, la classe CameraEffectiveData a été ajoutée dans Aspose.Slides. La classe CameraEffectiveData représente un objet immutable qui contient les propriétés effectives de la caméra. Une instance de la classe CameraEffectiveData est utilisée comme partie de la classe ThreeDFormatEffectiveData, qui constitue une paire de valeurs effectives pour la classe ThreeDFormat.

Le fragment de code suivant montre comment obtenir les propriétés effectives de la caméra.

using (Presentation pres = new Presentation("Presentation1.pptx"))
{
	IThreeDFormatEffectiveData threeDEffectiveData = pres.Slides[0].Shapes[0].ThreeDFormat.GetEffective();

	Console.WriteLine("= Effective camera properties =");
	Console.WriteLine("Type: " + threeDEffectiveData.Camera.CameraType);
	Console.WriteLine("Field of view: " + threeDEffectiveData.Camera.FieldOfViewAngle);
	Console.WriteLine("Zoom: " + threeDEffectiveData.Camera.Zoom);
}

Obtenir les propriétés effectives d’un système d’éclairage

Aspose.Slides for .NET permet aux développeurs d’obtenir les propriétés effectives du Light Rig. À cette fin, la classe LightRigEffectiveData a été ajoutée dans Aspose.Slides. La classe LightRigEffectiveData représente un objet immutable qui contient les propriétés effectives du système d’éclairage. Une instance de la classe LightRigEffectiveData est utilisée comme partie de la classe ThreeDFormatEffectiveData, qui constitue une paire de valeurs effectives pour la classe ThreeDFormat.

Le fragment de code suivant montre comment obtenir les propriétés effectives du Light Rig.

using (Presentation pres = new Presentation("Presentation1.pptx"))
{
	IThreeDFormatEffectiveData threeDEffectiveData = pres.Slides[0].Shapes[0].ThreeDFormat.GetEffective();

	Console.WriteLine("= Effective light rig properties =");
	Console.WriteLine("Type: " + threeDEffectiveData.LightRig.LightType);
	Console.WriteLine("Direction: " + threeDEffectiveData.LightRig.Direction);
}

Obtenir les propriétés effectives d’une forme biseautée

Aspose.Slides for .NET permet aux développeurs d’obtenir les propriétés effectives d’une forme biseautée. À cette fin, la classe ShapeBevelEffectiveData a été ajoutée dans Aspose.Slides. La classe ShapeBevelEffectiveData représente un objet immutable qui contient les propriétés effectives du relief de face de la forme. Une instance de la classe ShapeBevelEffectiveData est utilisée comme partie de la classe ThreeDFormatEffectiveData, qui constitue une paire de valeurs effectives pour la classe ThreeDFormat.

Le fragment de code suivant montre comment obtenir les propriétés effectives de la forme biseautée.

using (Presentation pres = new Presentation("Presentation1.pptx"))
{
	IThreeDFormatEffectiveData threeDEffectiveData = pres.Slides[0].Shapes[0].ThreeDFormat.GetEffective();

	Console.WriteLine("= Effective shape's top face relief properties =");
	Console.WriteLine("Type: " + threeDEffectiveData.BevelTop.BevelType);
	Console.WriteLine("Width: " + threeDEffectiveData.BevelTop.Width);
	Console.WriteLine("Height: " + threeDEffectiveData.BevelTop.Height);
}

Obtenir les propriétés effectives d’un cadre de texte

Avec Aspose.Slides for .NET, vous pouvez obtenir les propriétés effectives d’un cadre de texte. À cette fin, la classe TextFrameFormatEffectiveData a été ajoutée dans Aspose.Slides et contient les propriétés de formatage effectives du cadre de texte.

Le fragment de code suivant montre comment obtenir les propriétés de formatage effectif du cadre de texte.

using (Presentation pres = new Presentation("Presentation1.pptx"))
{
	IAutoShape shape = pres.Slides[0].Shapes[0] as IAutoShape;

	ITextFrameFormat textFrameFormat = shape.TextFrame.TextFrameFormat;
	ITextFrameFormatEffectiveData effectiveTextFrameFormat = textFrameFormat.GetEffective();


	Console.WriteLine("Anchoring type: " + effectiveTextFrameFormat.AnchoringType);
	Console.WriteLine("Autofit type: " + effectiveTextFrameFormat.AutofitType);
	Console.WriteLine("Text vertical type: " + effectiveTextFrameFormat.TextVerticalType);
	Console.WriteLine("Margins");
	Console.WriteLine("   Left: " + effectiveTextFrameFormat.MarginLeft);
	Console.WriteLine("   Top: " + effectiveTextFrameFormat.MarginTop);
	Console.WriteLine("   Right: " + effectiveTextFrameFormat.MarginRight);
	Console.WriteLine("   Bottom: " + effectiveTextFrameFormat.MarginBottom);
}

Obtenir les propriétés effectives d’un style de texte

Avec Aspose.Slides for .NET, vous pouvez obtenir les propriétés effectives d’un style de texte. À cette fin, la classe TextStyleEffectiveData a été ajoutée dans Aspose.Slides et contient les propriétés effectives du style de texte.

Le fragment de code suivant montre comment obtenir les propriétés effectives du style de texte.

using (Presentation pres = new Presentation("Presentation1.pptx"))
{
    IAutoShape shape = pres.Slides[0].Shapes[0] as IAutoShape;

    ITextStyleEffectiveData effectiveTextStyle = shape.TextFrame.TextFrameFormat.TextStyle.GetEffective();

    for (int i = 0; i <= 8; i++)
    {
        IParagraphFormatEffectiveData effectiveStyleLevel = effectiveTextStyle.GetLevel(i);
        Console.WriteLine("= Effective paragraph formatting for style level #" + i + " =");

        Console.WriteLine("Depth: " + effectiveStyleLevel.Depth);
        Console.WriteLine("Indent: " + effectiveStyleLevel.Indent);
        Console.WriteLine("Alignment: " + effectiveStyleLevel.Alignment);
        Console.WriteLine("Font alignment: " + effectiveStyleLevel.FontAlignment);
    }
}

Obtenir la valeur effective de la hauteur de police

Avec Aspose.Slides for .NET, vous pouvez obtenir les propriétés effectives de la hauteur de police. Voici un exemple de code montrant la valeur effective de la hauteur de police d’une portion qui change après avoir défini des valeurs de hauteur de police locales à différents niveaux de la structure de la présentation.

using (Presentation pres = new Presentation())
{
    IAutoShape newShape = pres.Slides[0].Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 400, 75, false);
    newShape.AddTextFrame("");
    newShape.TextFrame.Paragraphs[0].Portions.Clear();

    IPortion portion0 = new Portion("Sample text with first portion");
    IPortion portion1 = new Portion(" and second portion.");

    newShape.TextFrame.Paragraphs[0].Portions.Add(portion0);
    newShape.TextFrame.Paragraphs[0].Portions.Add(portion1);

    Console.WriteLine("Effective font height just after creation:");
    Console.WriteLine("Portion #0: " + portion0.PortionFormat.GetEffective().FontHeight);
    Console.WriteLine("Portion #1: " + portion1.PortionFormat.GetEffective().FontHeight);

    pres.DefaultTextStyle.GetLevel(0).DefaultPortionFormat.FontHeight = 24;

    Console.WriteLine("Effective font height after setting entire presentation default font height:");
    Console.WriteLine("Portion #0: " + portion0.PortionFormat.GetEffective().FontHeight);
    Console.WriteLine("Portion #1: " + portion1.PortionFormat.GetEffective().FontHeight);

    newShape.TextFrame.Paragraphs[0].ParagraphFormat.DefaultPortionFormat.FontHeight = 40;

    Console.WriteLine("Effective font height after setting paragraph default font height:");
    Console.WriteLine("Portion #0: " + portion0.PortionFormat.GetEffective().FontHeight);
    Console.WriteLine("Portion #1: " + portion1.PortionFormat.GetEffective().FontHeight);

    newShape.TextFrame.Paragraphs[0].Portions[0].PortionFormat.FontHeight = 55;

    Console.WriteLine("Effective font height after setting portion #0 font height:");
    Console.WriteLine("Portion #0: " + portion0.PortionFormat.GetEffective().FontHeight);
    Console.WriteLine("Portion #1: " + portion1.PortionFormat.GetEffective().FontHeight);

    newShape.TextFrame.Paragraphs[0].Portions[1].PortionFormat.FontHeight = 18;

    Console.WriteLine("Effective font height after setting portion #1 font height:");
    Console.WriteLine("Portion #0: " + portion0.PortionFormat.GetEffective().FontHeight);
    Console.WriteLine("Portion #1: " + portion1.PortionFormat.GetEffective().FontHeight);

    pres.Save("SetLocalFontHeightValues.pptx",SaveFormat.Pptx);
}

Obtenir le format de remplissage effectif d’un tableau

Avec Aspose.Slides for .NET, vous pouvez obtenir le format de remplissage effectif pour différentes parties logiques d’un tableau. À cette fin, l’interface IFillFormatEffectiveData a été ajoutée dans Aspose.Slides et contient les propriétés de remplissage effectives. Notez que le format de cellule a toujours une priorité supérieure à celui de la ligne, la ligne a priorité sur la colonne et la colonne sur le tableau entier.

Ainsi, les propriétés CellFormatEffectiveData sont toujours utilisées pour dessiner le tableau. Le fragment de code suivant montre comment obtenir le format de remplissage effectif pour différentes parties logiques d’un tableau.

using (Presentation pres = new Presentation("pres.pptx"))
{
	ITable tbl = pres.Slides[0].Shapes[0] as ITable;
	ITableFormatEffectiveData tableFormatEffective = tbl.TableFormat.GetEffective();
	IRowFormatEffectiveData rowFormatEffective = tbl.Rows[0].RowFormat.GetEffective();
	IColumnFormatEffectiveData columnFormatEffective = tbl.Columns[0].ColumnFormat.GetEffective();
	ICellFormatEffectiveData cellFormatEffective = tbl[0, 0].CellFormat.GetEffective();

	IFillFormatEffectiveData tableFillFormatEffective = tableFormatEffective.FillFormat;
	IFillFormatEffectiveData rowFillFormatEffective = rowFormatEffective.FillFormat;
	IFillFormatEffectiveData columnFillFormatEffective = columnFormatEffective.FillFormat;
	IFillFormatEffectiveData cellFillFormatEffective = cellFormatEffective.FillFormat;
}

FAQ

Comment savoir si j’ai reçu un « instantané » plutôt qu’un « objet vivant », et quand devrais‑je relire les propriétés effectives ?

Les objets EffectiveData sont des instantanés immutables des valeurs calculées au moment de l’appel. Si vous modifiez les paramètres locaux ou hérités de la forme, récupérez à nouveau les EffectiveData pour obtenir les valeurs mises à jour.

La modification de la diapositive de disposition/maître affecte‑t‑elle les propriétés effectives déjà récupérées ?

Oui, mais uniquement après les avoir relues. Un EffectiveData déjà obtenu ne se met pas à jour — il faut le demander de nouveau après avoir changé la disposition ou le maître.

Puis‑je modifier les valeurs via EffectiveData ?

Non. EffectiveData est en lecture seule. Apportez les modifications aux objets de formatage locaux (forme/texte/3D, etc.), puis obtenez de nouveau les valeurs effectives.

Que se passe‑t‑il si une propriété n’est définie ni au niveau de la forme, ni dans la disposition/maître, ni dans les paramètres globaux ?

La valeur effective est déterminée par le mécanisme par défaut (défauts de PowerPoint/Aspose.Slides). Cette valeur résolue fait partie de l’instantané EffectiveData.

À partir d’une valeur de police effective, puis‑je identifier le niveau qui a fourni la taille ou la famille de caractères ?

Pas directement. EffectiveData renvoie la valeur finale. Pour connaître la source, examinez les valeurs locales au niveau de la portion/paragraph/texte et les styles de texte au niveau de la disposition/maître/présentation afin de repérer la première définition explicite.

Pourquoi les valeurs EffectiveData ressemblent parfois aux valeurs locales ?

Parce que la valeur locale s’est avérée finale (aucune héritage de niveau supérieur n’a été nécessaire). Dans ce cas, la valeur effective correspond à la valeur locale.

Quand faut‑il utiliser les propriétés effectives et quand travailler uniquement avec les locales ?

Utilisez EffectiveData lorsque vous avez besoin du résultat « tel qu’affiché » après application de tout l’héritage (par ex. pour aligner des couleurs, retraits ou tailles). Si vous devez modifier le formatage à un niveau précis, modifiez les propriétés locales puis, si nécessaire, relisez EffectiveData pour vérifier le résultat.

Gérer les formes de présentation dans .NET Appliquer des animations de forme dans les présentations en .NET