الحصول على خصائص الشكل الفعالة من العروض التقديمية في .NET

في هذا الموضوع، سنناقش الخصائص الفعّالة و المحلية. عندما نُعيّن القيم مباشرةً على هذه المستويات

  1. في خصائص الجزء على شريحة الجزء.
  2. في نمط نص شكل النموذج الأولي على الشريحة النمطية أو الشريحة الرئيسية (إذا كان لشكل إطار النص للجزء واحد).
  3. في إعدادات النص العامة للعرض التقديمي.

ثم تُسمى تلك القيم قيمة محلية. على أي مستوى، يمكن تعريف القيم المحلية أو إغفالها. ولكن في النهاية، عندما يلزم التطبيق معرفة كيف يجب أن يبدو الجزء، يستخدم القيم الفعّالة. يمكنك الحصول على القيم الفعّالة باستخدام طريقة getEffective() من التنسيق المحلي.

المثال التالي يوضح كيفية الحصول على القيم الفعّالة.

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();
}

الحصول على الخصائص الفعّالة للكاميرا

Aspose.Slides for .NET يتيح للمطورين الحصول على الخصائص الفعّالة للكاميرا. لهذا الغرض، تمت إضافة الفئة CameraEffectiveData في Aspose.Slides. تمثّل فئة CameraEffectiveData كائنًا غير قابل للتغيير يحتوي على الخصائص الفعّالة للكاميرا. تُستخدم نسخة من فئة CameraEffectiveData كجزء من فئة ThreeDFormatEffectiveData التي تمثل زوج قيم فعّالة لفئة ThreeDFormat.

الكود التالي يوضح كيفية الحصول على الخصائص الفعّالة للكاميرا.

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);
}

الحصول على الخصائص الفعّالة لتجهيز الإضاءة

Aspose.Slides for .NET يتيح للمطورين الحصول على الخصائص الفعّالة لتجهيز الإضاءة. لهذا الغرض، تمت إضافة الفئة LightRigEffectiveData في Aspose.Slides. تمثّل فئة LightRigEffectiveData كائنًا غير قابل للتغيير يحتوي على الخصائص الفعّالة لتجهيز الإضاءة. تُستخدم نسخة من فئة LightRigEffectiveData كجزء من فئة ThreeDFormatEffectiveData التي تمثل زوج قيم فعّالة لفئة ThreeDFormat.

الكود التالي يوضح كيفية الحصول على الخصائص الفعّالة لتجهيز الإضاءة.

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);
}

الحصول على الخصائص الفعّالة لشكل الحافة

Aspose.Slides for .NET يتيح للمطورين الحصول على الخصائص الفعّالة لشكل الحافة. لهذا الغرض، تم إضافة الفئة ShapeBevelEffectiveData في Aspose.Slides. تمثّل فئة ShapeBevelEffectiveData كائنًا غير قابل للتغيير يحتوي على الخصائص الفعّالة لتضاريس وجه الشكل. تُستخدم نسخة من فئة ShapeBevelEffectiveData كجزء من فئة ThreeDFormatEffectiveData التي تمثل زوج قيم فعّالة لفئة ThreeDFormat.

الكود التالي يوضح كيفية الحصول على الخصائص الفعّالة لشكل الحافة.

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);
}

الحصول على الخصائص الفعّالة لإطار النص

باستخدام Aspose.Slides for .NET، يمكنك الحصول على الخصائص الفعّالة لإطار النص. لهذا الغرض، تم إضافة الفئة TextFrameFormatEffectiveData في Aspose.Slides والتي تحتوي على خصائص تنسيق إطار النص الفعّالة.

الكود التالي يوضح كيفية الحصول على خصائص تنسيق إطار النص الفعّالة.

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);
}

الحصول على الخصائص الفعّالة لنمط النص

باستخدام Aspose.Slides for .NET، يمكنك الحصول على الخصائص الفعّالة لنمط النص. لهذا الغرض، تم إضافة الفئة TextStyleEffectiveData في Aspose.Slides والتي تحتوي على خصائص نمط النص الفعّالة.

الكود التالي يوضح كيفية الحصول على خصائص نمط النص الفعّالة.

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);
    }
}

الحصول على قيمة ارتفاع الخط الفعّالة

باستخدام Aspose.Slides for .NET، يمكنك الحصول على الخصائص الفعّالة لارتفاع الخط. إليك مثالًا يوضح تغير قيمة ارتفاع الخط الفعّالة للجزء بعد تعيين قيم ارتفاع الخط المحلية على مستويات مختلفة في بنية العرض التقديمي.

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);
}

الحصول على تنسيق التعبئة الفعّال لجدول

باستخدام Aspose.Slides for .NET، يمكنك الحصول على تنسيق التعبئة الفعّال لأجزاء منطقية مختلفة في الجدول. لهذا الغرض، تمت إضافة الواجهة IFillFormatEffectiveData في Aspose.Slides والتي تحتوي على خصائص تنسيق التعبئة الفعّالة. يرجى ملاحظة أن تنسيق الخلية له أولوية أعلى دائمًا من تنسيق الصف، والصف له أولوية أعلى من العمود، والعمود أعلى من الجدول بأكمله.

لذلك، تُستخدم دائمًا خصائص CellFormatEffectiveData لرسم الجدول. الكود التالي يوضح كيفية الحصول على تنسيق التعبئة الفعّال لأجزاء منطقية مختلفة في الجدول.

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;
}

الأسئلة المتكررة

كيف يمكنني معرفة أنني حصلت على “لقطة” بدلاً من “كائن حي”، ومتى يجب علي قراءة الخصائص الفعّالة مرة أخرى؟
كائنات EffectiveData هي لقطات غير قابلة للتغيير للقيم المحسوبة وقت الاستدعاء. إذا قمت بتغيير الإعدادات المحلية أو الموروثة للشكل، استرجع البيانات الفعّالة مرة أخرى للحصول على القيم المحدثة.

هل يؤثر تغيير شريحة النموذج/الرئيسية على الخصائص الفعّالة التي تم استرجاعها بالفعل؟
نعم، لكن فقط بعد قراءة القيم مرة أخرى. كائن EffectiveData المسترجع مسبقًا لا يحدّث نفسه—اطلبه مرة أخرى بعد تعديل النموذج أو الشريحة الرئيسية.

هل يمكنني تعديل القيم عبر EffectiveData؟
لا. EffectiveData للقراءة فقط. قم بإجراء التغييرات في كائنات التنسيق المحلية (الشكل/النص/3D، إلخ)، ثم استرجع القيم الفعّالة مرة أخرى.

ماذا يحدث إذا لم يتم تعيين خاصية على مستوى الشكل ولا في النموذج/الرئيسية ولا في الإعدادات العامة؟
تُحدد القيمة الفعّالة عبر آلية الافتراض (القيم الافتراضية لـ PowerPoint/Aspose.Slides). تلك القيمة المحسومة تصبح جزءًا من لقطة EffectiveData.

من قيمة الخط الفعّالة، هل يمكنني معرفة أي مستوى وفر الحجم أو نوع الخط؟
ليس مباشرة. EffectiveData تُعيد القيمة النهائية فقط. لتحديد المصدر، افحص القيم المحلية على مستوى الجزء/الفقرة/إطار النص والأنماط النصية على النموذج/الرئيسية/العرض التقديمي لتعرف أين ظهرت التعريف الصريح أولاً.

لماذا تبدو قيم EffectiveData أحيانًا مطابقة للقيم المحلية؟
لأن القيمة المحلية انتهت بأنها النهائية (لم تكن هناك حاجة لتوريث من مستوى أعلى). في هذه الحالات، تتطابق القيمة الفعّالة مع القيمة المحلية.

متى يجب استخدام الخصائص الفعّالة، ومتى أكتفي بالخصائص المحلية؟
استخدم EffectiveData عندما تحتاج إلى النتيجة “كما تُعرض” بعد تطبيق كل الوراثة (مثلاً لضبط الألوان أو الهوامش أو الأحجام). إذا كنت تريد تعديل التنسيق على مستوى معين، قم بتغيير الخصائص المحلية ثم، إذا لزم الأمر، أعد قراءة EffectiveData للتحقق من النتيجة.

إدارة أشكال العروض التقديمية في .NET تطبيق الرسوم المتحركة للأشكال في العروض التقديمية في .NET