خصائص الشكل الفعالة

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

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

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

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

// The path to the documents directory.
const String templatePath = u"../templates/Presentation1.pptx";

System::SharedPtr<Presentation> pres = System::MakeObject<Presentation>(templatePath);
System::SharedPtr<IAutoShape> shape = System::DynamicCast_noexcept<Aspose::Slides::IAutoShape>(pres->get_Slides()->idx_get(0)->get_Shapes()->idx_get(0));

System::SharedPtr<ITextFrameFormat> localTextFrameFormat = shape->get_TextFrame()->get_TextFrameFormat();
System::SharedPtr<ITextFrameFormatEffectiveData> effectiveTextFrameFormat = localTextFrameFormat->GetEffective();

System::SharedPtr<IPortionFormat> localPortionFormat = shape->get_TextFrame()->get_Paragraphs()->idx_get(0)->get_Portions()->idx_get(0)->get_PortionFormat();
System::SharedPtr<IPortionFormatEffectiveData> effectivePortionFormat = localPortionFormat->GetEffective();

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

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

المثال البرمجي التالي يوضح كيفية الحصول على الخصائص الفعالة للكاميرا.

	// The path to the documents directory.
	const String templatePath = u"../templates/Presentation1.pptx";

	System::SharedPtr<Presentation> pres = System::MakeObject<Presentation>(templatePath);

	System::SharedPtr<IThreeDFormatEffectiveData> threeDEffectiveData = pres->get_Slides()->idx_get(0)->get_Shapes()->idx_get(0)->get_ThreeDFormat()->GetEffective();

	System::Console::WriteLine(u"= Effective camera properties =");
	System::Console::WriteLine(System::String(u"Type: ") + System::ObjectExt::ToString((int)threeDEffectiveData->get_Camera()->get_CameraType()));
	System::Console::WriteLine(System::String(u"Field of view: ") + threeDEffectiveData->get_Camera()->get_FieldOfViewAngle());
	System::Console::WriteLine(System::String(u"Zoom: ") + threeDEffectiveData->get_Camera()->get_Zoom());

	

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

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

المثال البرمجي التالي يوضح كيفية الحصول على الخصائص الفعالة لجهاز الإضاءة.

	// The path to the documents directory.
	const String templatePath = u"../templates/Presentation1.pptx";

	System::SharedPtr<Presentation> pres = System::MakeObject<Presentation>(templatePath);

	System::SharedPtr<IThreeDFormatEffectiveData> threeDEffectiveData = pres->get_Slides()->idx_get(0)->get_Shapes()->idx_get(0)->get_ThreeDFormat()->GetEffective();

	System::Console::WriteLine(u"= Effective light rig properties =");
	System::Console::WriteLine(System::String(u"Type: ") + System::ObjectExt::ToString((int)threeDEffectiveData->get_LightRig()->get_LightType()));
	System::Console::WriteLine(System::String(u"Direction: ") + System::ObjectExt::ToString((int)threeDEffectiveData->get_LightRig()->get_Direction()));

الحصول على الخصائص الفعالة بشكل محدب

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

المثال البرمجي التالي يوضح كيفية الحصول على الخصائص الفعالة بشكل محدب.

	// The path to the documents directory.
	const String templatePath = u"../templates/Presentation1.pptx";

	System::SharedPtr<Presentation> pres = System::MakeObject<Presentation>(templatePath);

	System::SharedPtr<IThreeDFormatEffectiveData> threeDEffectiveData = pres->get_Slides()->idx_get(0)->get_Shapes()->idx_get(0)->get_ThreeDFormat()->GetEffective();

	System::Console::WriteLine(u"= Effective shape's top face relief properties =");
	System::Console::WriteLine(System::String(u"Type: ") + System::ObjectExt::ToString((int)threeDEffectiveData->get_BevelTop()->get_BevelType()));
	System::Console::WriteLine(System::String(u"Width: ") + threeDEffectiveData->get_BevelTop()->get_Width());
	System::Console::WriteLine(System::String(u"Height: ") + threeDEffectiveData->get_BevelTop()->get_Height());

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

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

المثال البرمجي التالي يوضح كيفية الحصول على خصائص تنسيق إطار النص الفعالة.

	// The path to the documents directory.	
	const String templatePath = u"../templates/Presentation1.pptx";

	System::SharedPtr<Presentation> pres = System::MakeObject<Presentation>(templatePath);
	System::SharedPtr<IAutoShape> shape = System::DynamicCast_noexcept<Aspose::Slides::IAutoShape>(pres->get_Slides()->idx_get(0)->get_Shapes()->idx_get(0));
	System::SharedPtr<ITextFrameFormatEffectiveData> effectiveTextFrameFormat = shape->get_TextFrame()->get_TextFrameFormat()->GetEffective();

	System::Console::WriteLine(System::String(u"Anchoring type: ") + System::ObjectExt::ToString((int)effectiveTextFrameFormat->get_AnchoringType()));
	System::Console::WriteLine(System::String(u"Autofit type: ") + System::ObjectExt::ToString((int)effectiveTextFrameFormat->get_AutofitType()));
	System::Console::WriteLine(System::String(u"Text vertical type: ") + System::ObjectExt::ToString((int)effectiveTextFrameFormat->get_TextVerticalType()));
	System::Console::WriteLine(u"Margins");
	System::Console::WriteLine(System::String(u"   Left: ") + effectiveTextFrameFormat->get_MarginLeft());
	System::Console::WriteLine(System::String(u"   Top: ") + effectiveTextFrameFormat->get_MarginTop());
	System::Console::WriteLine(System::String(u"   Right: ") + effectiveTextFrameFormat->get_MarginRight());
	System::Console::WriteLine(System::String(u"   Bottom: ") + effectiveTextFrameFormat->get_MarginBottom());

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

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

المثال البرمجي التالي يوضح كيفية الحصول على خصائص نمط النص الفعالة.

	// The path to the documents directory.	
	const String templatePath = u"../templates/Presentation1.pptx";

	System::SharedPtr<Presentation> pres = System::MakeObject<Presentation>(templatePath);
	System::SharedPtr<IAutoShape> shape = System::DynamicCast_noexcept<Aspose::Slides::IAutoShape>(pres->get_Slides()->idx_get(0)->get_Shapes()->idx_get(0));
	System::SharedPtr<ITextStyleEffectiveData> effectiveTextStyle = shape->get_TextFrame()->get_TextFrameFormat()->get_TextStyle()->GetEffective();

	for (int32_t i = 0; i <= 8; i++)
	{
		System::SharedPtr<IParagraphFormatEffectiveData> effectiveStyleLevel = effectiveTextStyle->GetLevel(i);
		System::Console::WriteLine(System::String(u"= Effective paragraph formatting for style level #") + i + u" =");

		System::Console::WriteLine(System::String(u"Depth: ") + effectiveStyleLevel->get_Depth());
		System::Console::WriteLine(System::String(u"Indent: ") + effectiveStyleLevel->get_Indent());
		System::Console::WriteLine(System::String(u"Alignment: ") + System::ObjectExt::ToString(effectiveStyleLevel->get_Alignment()));
		System::Console::WriteLine(System::String(u"Font alignment: ") + System::ObjectExt::ToString(effectiveStyleLevel->get_FontAlignment()));
	}

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

باستخدام Aspose.Slides لـ C++، يمكنك الحصول على الخصائص الفعالة لارتفاع الخط. هنا هو الكود الذي يوضح تغيير القيمة الفعالة لارتفاع الخط للجزء بعد تعيين قيم ارتفاع الخط المحلية على مستويات هيكل العروض التقديمية المختلفة.

// The path to the documents directory.
const String outPath = u"../out/SetLocalFontHeightValues.pptx";

System::SharedPtr<Presentation> pres = System::MakeObject<Presentation>();
System::SharedPtr<IAutoShape> newShape = pres->get_Slides()->idx_get(0)->get_Shapes()->AddAutoShape(Aspose::Slides::ShapeType::Rectangle, 100.0f, 100.0f, 400.0f, 75.0f, false);
newShape->AddTextFrame(u"");
newShape->get_TextFrame()->get_Paragraphs()->idx_get(0)->get_Portions()->Clear();

System::SharedPtr<IPortion> portion0 = System::MakeObject<Portion>(u"Sample text with first portion");
System::SharedPtr<IPortion> portion1 = System::MakeObject<Portion>(u" and second portion.");

newShape->get_TextFrame()->get_Paragraphs()->idx_get(0)->get_Portions()->Add(portion0);
newShape->get_TextFrame()->get_Paragraphs()->idx_get(0)->get_Portions()->Add(portion1);

System::Console::WriteLine(u"Effective font height just after creation:");
System::Console::WriteLine(System::String(u"Portion #0: ") + portion0->get_PortionFormat()->GetEffective()->get_FontHeight());
System::Console::WriteLine(System::String(u"Portion #1: ") + portion1->get_PortionFormat()->GetEffective()->get_FontHeight());

pres->get_DefaultTextStyle()->GetLevel(0)->get_DefaultPortionFormat()->set_FontHeight(24.0f);
System::Console::WriteLine(u"Effective font height after setting entire presentation default font height:");
System::Console::WriteLine(System::String(u"Portion #0: ") + portion0->get_PortionFormat()->GetEffective()->get_FontHeight());
System::Console::WriteLine(System::String(u"Portion #1: ") + portion1->get_PortionFormat()->GetEffective()->get_FontHeight());

newShape->get_TextFrame()->get_Paragraphs()->idx_get(0)->get_ParagraphFormat()->get_DefaultPortionFormat()->set_FontHeight(40.0f);
System::Console::WriteLine(u"Effective font height after setting paragraph default font height:");
System::Console::WriteLine(System::String(u"Portion #0: ") + portion0->get_PortionFormat()->GetEffective()->get_FontHeight());
System::Console::WriteLine(System::String(u"Portion #1: ") + portion1->get_PortionFormat()->GetEffective()->get_FontHeight());

newShape->get_TextFrame()->get_Paragraphs()->idx_get(0)->get_Portions()->idx_get(0)->get_PortionFormat()->set_FontHeight(55.0f);
System::Console::WriteLine(u"Effective font height after setting portion #0 font height:");
System::Console::WriteLine(System::String(u"Portion #0: ") + portion0->get_PortionFormat()->GetEffective()->get_FontHeight());
System::Console::WriteLine(System::String(u"Portion #1: ") + portion1->get_PortionFormat()->GetEffective()->get_FontHeight());

newShape->get_TextFrame()->get_Paragraphs()->idx_get(0)->get_Portions()->idx_get(1)->get_PortionFormat()->set_FontHeight(18.0f);
System::Console::WriteLine(u"Effective font height after setting portion #1 font height:");
System::Console::WriteLine(System::String(u"Portion #0: ") + portion0->get_PortionFormat()->GetEffective()->get_FontHeight());
System::Console::WriteLine(System::String(u"Portion #1: ") + portion1->get_PortionFormat()->GetEffective()->get_FontHeight());


pres->Save(outPath, Aspose::Slides::Export::SaveFormat::Pptx);

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

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

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

// The path to the documents directory.	
const String templatePath = u"../templates/Presentation1.pptx";


System::SharedPtr<Presentation> pres = System::MakeObject<Presentation>(templatePath);
System::SharedPtr<ITable> tbl = System::DynamicCast_noexcept<Aspose::Slides::ITable>(pres->get_Slides()->idx_get(0)->get_Shapes()->idx_get(0));
System::SharedPtr<ITableFormatEffectiveData> tableFormatEffective = tbl->get_TableFormat()->GetEffective();
System::SharedPtr<IRowFormatEffectiveData> rowFormatEffective = tbl->get_Rows()->idx_get(0)->get_RowFormat()->GetEffective();
System::SharedPtr<IColumnFormatEffectiveData> columnFormatEffective = tbl->get_Columns()->idx_get(0)->get_ColumnFormat()->GetEffective();
System::SharedPtr<ICellFormatEffectiveData> cellFormatEffective = tbl->idx_get(0, 0)->get_CellFormat()->GetEffective();

System::SharedPtr<IFillFormatEffectiveData> tableFillFormatEffective = tableFormatEffective->get_FillFormat();
System::SharedPtr<IFillFormatEffectiveData> rowFillFormatEffective = rowFormatEffective->get_FillFormat();
System::SharedPtr<IFillFormatEffectiveData> columnFillFormatEffective = columnFormatEffective->get_FillFormat();
System::SharedPtr<IFillFormatEffectiveData> cellFillFormatEffective = cellFormatEffective->get_FillFormat();