รับคุณสมบัติรูปร่างที่มีผลจากงานนำเสนอใน PHP

ภาพรวม

หัวข้อนี้อธิบายความแตกต่างระหว่างคุณสมบัติ local และ effective ค่า local คือค่าที่ตั้งโดยตรงที่ระดับการจัดรูปแบบเฉพาะ เช่น

คุณสมบัติ Portion บนสไลด์
สไตล์ข้อความของรูปร่างต้นแบบบนเลย์เอาต์หรือสไลด์มาสเตอร์ เมื่อรูปร่างกรอบข้อความของ Portion มีสไตล์นั้น
การตั้งค่าข้อความระดับทั่วโลกในงานนำเสนอ

ค่า local สามารถกำหนดหรือไม่กำหนดได้ที่ระดับใดก็ได้ เมื่อ Aspose.Slides ต้องการการจัดรูปแบบขั้นสุดท้าย “as rendered” มันจะแกะสานโซ่การสืบทอดและคืนค่า effective คุณสามารถรับค่าเหล่านั้นโดยเรียกเมธอด getEffective บนวัตถุ format ระดับ local

ตัวอย่างต่อไปนี้แสดงวิธีการรับค่า effective ค่า มันสมมติว่า รูปร่างแรกบนสไลด์แรกคือ AutoShape ที่มีกรอบข้อความและอย่างน้อยหนึ่ง Portion

$presentation = new Presentation("sample.pptx");
try {
    $slide = $presentation->getSlides()->get_Item(0);
    $shape = $slide->getShapes()->get_Item(0);

    $localTextFrameFormat = $shape->getTextFrame()->getTextFrameFormat();
    $effectiveTextFrameFormat = $localTextFrameFormat->getEffective();

    $paragraph = $shape->getTextFrame()->getParagraphs()->get_Item(0);
    $portion = $paragraph->getPortions()->get_Item(0);

    $localPortionFormat = $portion->getPortionFormat();
    $effectivePortionFormat = $localPortionFormat->getEffective();
} finally {
    $presentation->dispose();
}

ข้อมูลการจัดรูปแบบที่เป็น effective แสดงถึงการจัดรูปแบบที่คำนวณแล้วหลังจากที่ได้ทำการสืบทอดแล้ว ในการนำไปใช้ปัจจุบันบางวัตถุข้อมูลที่เป็น effective ที่ได้จากเมธอดเช่น PortionFormat.getEffective อาจถูกเก็บแคชภายใน การเรียก getEffective อีกครั้งหลังจากเปลี่ยนแปลงการจัดรูปแบบของพาเรนท์หรือที่สืบทอดมาจะทำให้ข้อมูลแคชถูกรีเฟรช และวัตถุที่ได้ก่อนหน้านั้นอาจไม่แสดงสถานะเดิมอีกต่อไป หากต้องการเก็บค่าที่เป็น effective ไว้ใช้ในภายหลัง ให้คัดลอกคุณสมบัติที่ต้องการ เช่น ความสูงของฟอนต์ สีเติม รูปแบบฟอนต์ หรือการจัดแนว ไปยังอ็อบเจ็กต์ข้อมูลของคุณเอง

รับคุณสมบัติที่มีผลของกล้อง

Aspose.Slides อนุญาตให้คุณรับคุณสมบัติที่มีผลของกล้อง ข้อมูลที่เป็น effective ที่ได้จาก ThreeDFormat.getEffective จะมีคุณสมบัติกล้องขั้นสุดท้ายสำหรับ ThreeDFormat

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีการรับคุณสมบัติที่มีผลของกล้อง มันสมมติว่ารูปร่างแรกบนสไลด์แรกมีการจัดรูปแบบ 3D

$presentation = new Presentation("sample.pptx");
try {
    $slide = $presentation->getSlides()->get_Item(0);
    $shape = $slide->getShapes()->get_Item(0);

    $threeDEffectiveData = $shape->getThreeDFormat()->getEffective();
    $camera = $threeDEffectiveData->getCamera();
    $cameraType = $camera->getCameraType();
    $fieldOfViewAngle = $camera->getFieldOfViewAngle();
    $zoom = $camera->getZoom();

    echo "= Effective camera properties =" . PHP_EOL;
    echo "Type: " . $cameraType . PHP_EOL;
    echo "Field of view: " . $fieldOfViewAngle . PHP_EOL;
    echo "Zoom: " . $zoom . PHP_EOL;
} finally {
    $presentation->dispose();
}

รับคุณสมบัติที่มีผลของ Light Rig

Aspose.Slides อนุญาตให้คุณรับคุณสมบัติที่มีผลของ Light Rig ข้อมูลที่เป็น effective ที่ได้จาก ThreeDFormat.getEffective จะมีคุณสมบัติ Light Rig ขั้นสุดท้ายสำหรับ ThreeDFormat

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีการรับคุณสมบัติที่มีผลของ Light Rig มันสมมติว่ารูปร่างแรกบนสไลด์แรกมีการจัดรูปแบบ 3D

$presentation = new Presentation("sample.pptx");
try {
    $slide = $presentation->getSlides()->get_Item(0);
    $shape = $slide->getShapes()->get_Item(0);

    $threeDEffectiveData = $shape->getThreeDFormat()->getEffective();
    $lightRig = $threeDEffectiveData->getLightRig();
    $lightType = $lightRig->getLightType();
    $direction = $lightRig->getDirection();

    echo "= Effective light rig properties =" . PHP_EOL;
    echo "Type: " . $lightType . PHP_EOL;
    echo "Direction: " . $direction . PHP_EOL;
} finally {
    $presentation->dispose();
}

รับคุณสมบัติที่มีผลของ Bevel Shape

Aspose.Slides อนุญาตให้คุณรับคุณสมบัติที่มีผลของ bevel รูปร่าง ข้อมูลที่เป็น effective ที่ได้จาก ThreeDFormat.getEffective จะมีคุณสมบัติ relief ของหน้าให้กับ ThreeDFormat

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีการรับคุณสมบัติที่มีผลของ bevel ด้านบนของรูปร่าง มันสมมติว่ารูปร่างแรกบนสไลด์แรกมีการจัดรูปแบบ 3D

$presentation = new Presentation("sample.pptx");
try {
    $slide = $presentation->getSlides()->get_Item(0);
    $shape = $slide->getShapes()->get_Item(0);

    $threeDEffectiveData = $shape->getThreeDFormat()->getEffective();
    $bevelTop = $threeDEffectiveData->getBevelTop();
    $bevelType = $bevelTop->getBevelType();
    $bevelWidth = $bevelTop->getWidth();
    $bevelHeight = $bevelTop->getHeight();

    echo "= Effective shape's top face relief properties =" . PHP_EOL;
    echo "Type: " . $bevelType . PHP_EOL;
    echo "Width: " . $bevelWidth . PHP_EOL;
    echo "Height: " . $bevelHeight . PHP_EOL;
} finally {
    $presentation->dispose();
}

รับคุณสมบัติที่มีผลของ Text Frame

โดยใช้ Aspose.Slides คุณสามารถรับคุณสมบัติที่มีผลของ Text Frame ข้อมูลที่เป็น effective ที่ได้จาก TextFrameFormat.getEffective จะมีคุณสมบัติการจัดรูปแบบของ Text Frame

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีการรับคุณสมบัติการจัดรูปแบบ Text Frame ที่เป็น effective มันสมมติว่า รูปร่างแรกบนสไลด์แรกคือ AutoShape ที่มีกรอบข้อความ

$presentation = new Presentation("sample.pptx");
try {
    $slide = $presentation->getSlides()->get_Item(0);
    $shape = $slide->getShapes()->get_Item(0);

    $effectiveTextFrameFormat = $shape->getTextFrame()->getTextFrameFormat()->getEffective();
    $anchoringType = $effectiveTextFrameFormat->getAnchoringType();
    $autofitType = $effectiveTextFrameFormat->getAutofitType();
    $textVerticalType = $effectiveTextFrameFormat->getTextVerticalType();
    $marginLeft = $effectiveTextFrameFormat->getMarginLeft();
    $marginTop = $effectiveTextFrameFormat->getMarginTop();
    $marginRight = $effectiveTextFrameFormat->getMarginRight();
    $marginBottom = $effectiveTextFrameFormat->getMarginBottom();

    echo "Anchoring type: " . $anchoringType . PHP_EOL;
    echo "Autofit type: " . $autofitType . PHP_EOL;
    echo "Text vertical type: " . $textVerticalType . PHP_EOL;
    echo "Margins" . PHP_EOL;
    echo "   Left: " . $marginLeft . PHP_EOL;
    echo "   Top: " . $marginTop . PHP_EOL;
    echo "   Right: " . $marginRight . PHP_EOL;
    echo "   Bottom: " . $marginBottom . PHP_EOL;
} finally {
    $presentation->dispose();
}

รับคุณสมบัติที่มีผลของ Text Style

โดยใช้ Aspose.Slides คุณสามารถรับคุณสมบัติที่มีผลของ Text Style ข้อมูลที่เป็น effective ที่ได้จาก TextStyle.getEffective จะมีคุณสมบัติของ Text Style

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีการรับคุณสมบัติ Text Style ที่เป็น effective มันสมมติว่า รูปร่างแรกบนสไลด์แรกคือ AutoShape ที่มีกรอบข้อความ

$presentation = new Presentation("sample.pptx");
try {
    $slide = $presentation->getSlides()->get_Item(0);
    $shape = $slide->getShapes()->get_Item(0);

    $textFrameFormat = $shape->getTextFrame()->getTextFrameFormat();
    $textStyle = $textFrameFormat->getTextStyle();
    $effectiveTextStyle = $textStyle->getEffective();
    $levelCount = 9;

    for ($levelIndex = 0; $levelIndex < $levelCount; $levelIndex++) {
        $effectiveStyleLevel = $effectiveTextStyle->getLevel($levelIndex);
        $depth = $effectiveStyleLevel->getDepth();
        $indent = $effectiveStyleLevel->getIndent();
        $alignment = $effectiveStyleLevel->getAlignment();
        $fontAlignment = $effectiveStyleLevel->getFontAlignment();

        echo "= Effective paragraph formatting for style level #" . $levelIndex . " =" . PHP_EOL;

        echo "Depth: " . $depth . PHP_EOL;
        echo "Indent: " . $indent . PHP_EOL;
        echo "Alignment: " . $alignment . PHP_EOL;
        echo "Font alignment: " . $fontAlignment . PHP_EOL;
    }
} finally {
    $presentation->dispose();
}

รับค่า Effective Font Height

โดยใช้ Aspose.Slides คุณสามารถรับค่า font height ที่เป็น effective ตัวอย่างโค้ดต่อไปนี้แสดงว่าค่า font height ของ Portion ที่เป็น effective จะเปลี่ยนแปลงอย่างไรเมื่อมีการตั้งค่าค่า font height ระดับ local ที่ระดับโครงสร้างต่าง ๆ ของงานนำเสนอ

$presentation = new Presentation();
try {
    $slide = $presentation->getSlides()->get_Item(0);

    $autoShape = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 100, 100, 400, 75, false);
    $autoShape->addTextFrame("");

    $paragraph = $autoShape->getTextFrame()->getParagraphs()->get_Item(0);
    $paragraph->getPortions()->clear();

    $firstPortion = new Portion("Sample text with first portion");
    $secondPortion = new Portion(" and second portion.");

    $paragraph->getPortions()->add($firstPortion);
    $paragraph->getPortions()->add($secondPortion);

    $firstEffectivePortionFormat = $firstPortion->getPortionFormat()->getEffective();
    $secondEffectivePortionFormat = $secondPortion->getPortionFormat()->getEffective();

    $firstFontHeight = $firstEffectivePortionFormat->getFontHeight();
    $secondFontHeight = $secondEffectivePortionFormat->getFontHeight();
    echo "Effective font height just after creation:" . PHP_EOL;
    echo "Portion #0: " . $firstFontHeight . PHP_EOL;
    echo "Portion #1: " . $secondFontHeight . PHP_EOL;

    $defaultStyleLevel = $presentation->getDefaultTextStyle()->getLevel(0);
    $defaultPortionFormat = $defaultStyleLevel->getDefaultPortionFormat();
    $defaultPortionFormat->setFontHeight(24);
    $firstEffectivePortionFormat = $firstPortionFormat->getEffective();
    $secondEffectivePortionFormat = $secondPortionFormat->getEffective();

    $firstFontHeight = $firstEffectivePortionFormat->getFontHeight();
    $secondFontHeight = $secondEffectivePortionFormat->getFontHeight();
    echo "Effective font height after setting the presentation default font height:" . PHP_EOL;
    echo "Portion #0: " . $firstFontHeight . PHP_EOL;
    echo "Portion #1: " . $secondFontHeight . PHP_EOL;

    $paragraphDefaultPortionFormat = $paragraph->getParagraphFormat()->getDefaultPortionFormat();
    $paragraphDefaultPortionFormat->setFontHeight(40);
    $firstEffectivePortionFormat = $firstPortionFormat->getEffective();
    $secondEffectivePortionFormat = $secondPortionFormat->getEffective();

    $firstFontHeight = $firstEffectivePortionFormat->getFontHeight();
    $secondFontHeight = $secondEffectivePortionFormat->getFontHeight();
    echo "Effective font height after setting paragraph default font height:" . PHP_EOL;
    echo "Portion #0: " . $firstFontHeight . PHP_EOL;
    echo "Portion #1: " . $secondFontHeight . PHP_EOL;

    $firstPortionFormat->setFontHeight(55);
    $firstEffectivePortionFormat = $firstPortionFormat->getEffective();
    $secondEffectivePortionFormat = $secondPortionFormat->getEffective();

    $firstFontHeight = $firstEffectivePortionFormat->getFontHeight();
    $secondFontHeight = $secondEffectivePortionFormat->getFontHeight();
    echo "Effective font height after setting portion #0 font height:" . PHP_EOL;
    echo "Portion #0: " . $firstFontHeight . PHP_EOL;
    echo "Portion #1: " . $secondFontHeight . PHP_EOL;

    $secondPortionFormat->setFontHeight(18);
    $firstEffectivePortionFormat = $firstPortionFormat->getEffective();
    $secondEffectivePortionFormat = $secondPortionFormat->getEffective();

    $firstFontHeight = $firstEffectivePortionFormat->getFontHeight();
    $secondFontHeight = $secondEffectivePortionFormat->getFontHeight();
    echo "Effective font height after setting portion #1 font height:" . PHP_EOL;
    echo "Portion #0: " . $firstFontHeight . PHP_EOL;
    echo "Portion #1: " . $secondFontHeight . PHP_EOL;

    $presentation->save("SetLocalFontHeightValues.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

รับ Effective Fill Format สำหรับ Table

โดยใช้ Aspose.Slides คุณสามารถรับการจัดรูปแบบการเติม (Fill) ที่เป็น effective สำหรับส่วนต่าง ๆ ของตาราง ข้อมูลที่เป็น effective ที่ได้จากอ็อบเจ็กต์ format จะมีคุณสมบัติของ FillFormat การจัดรูปแบบของ Cell มีลำดับความสำคัญสูงกว่าการจัดรูปแบบของ Row, Row สูงกว่าคอลัมน์, และคอลัมน์สูงกว่าการจัดรูปแบบของตารางทั้งหมด

ผลลัพธ์คือคุณสมบัติของ CellFormat ที่เป็น effective จะถูกใช้ในการวาดเซลล์ของตาราง ตัวอย่างโค้ดต่อไปนี้แสดงวิธีการรับ Fill Format ที่เป็น effective สำหรับส่วนต่าง ๆ ของตาราง มันสมมติว่า รูปร่างแรกบนสไลด์แรกคือ Table

$presentation = new Presentation("sample.pptx");
try {
    $slide = $presentation->getSlides()->get_Item(0);

    $table = $slide->getShapes()->get_Item(0);
    $tableFormatEffective = $table->getTableFormat()->getEffective();

    $row = $table->getRows()->get_Item(0);
    $rowFormatEffective = $row->getRowFormat()->getEffective();

    $column = $table->getColumns()->get_Item(0);
    $columnFormatEffective = $column->getColumnFormat()->getEffective();

    $cell = $table->get_Item(0, 0);
    $cellFormatEffective = $cell->getCellFormat()->getEffective();

    $tableFillFormatEffective = $tableFormatEffective->getFillFormat();
    $rowFillFormatEffective = $rowFormatEffective->getFillFormat();
    $columnFillFormatEffective = $columnFormatEffective->getFillFormat();
    $cellFillFormatEffective = $cellFormatEffective->getFillFormat();
} finally {
    $presentation->dispose();
}

คำถามที่พบบ่อย

getEffective คืนค่าภาพรวมหรือไม่?

ไม่เสมอไป ข้อมูลที่เป็น effective แสดงการจัดรูปแบบที่คำนวณแล้วหลังจากสืบทอด แต่บางอ็อบเจ็กต์ข้อมูลที่เป็น effective อาจถูกเก็บแคชภายใน การเรียก getEffective ครั้งต่อมอาจคำนวณใหม่และรีเฟรชแคช ดังนั้นอ็อบเจ็กต์ที่ได้รับก่อนหน้านี้ไม่ควรถือเป็น snapshot ที่คงที่

ควรอ่านคุณสมบัติที่เป็น effective อีกครั้งเมื่อไหร่?

ให้เรียก getEffective อีกครั้งหลังจากเปลี่ยนแปลงการจัดรูปแบบระดับ local, สไตล์พาเรนท์, การจัดรูปแบบเลย์เอาต์, การจัดรูปแบบมาสเตอร์, หรือค่าเริ่มต้นระดับงานนำเสนอ การเรียกครั้งต่อไปจะประเมินลำดับการสืบทอดใหม่และคืนค่าผลลัพธ์ที่เป็น effective ปัจจุบัน

การเปลี่ยนหรือเอาออกเลย์เอาต์/มาสเตอร์สไลด์ส่งผลต่อคุณสมบัติที่เป็น effective ที่ได้แล้วหรือไม่?

ใช่ แต่การเปลี่ยนแปลงจะสะท้อนในการเรียก getEffective ครั้งต่อไป หากแหล่งข้อมูลการจัดรูปแบบของพาเรนท์ถูกเปลี่ยนหรือเอาออก ข้อมูลที่เป็น effective ที่ได้ก่อนหน้านั้นอาจล้าสมัย เมื่อเรียก getEffective อีกครั้ง Aspose.Slides จะประเมินต้นไม้การจัดรูปแบบใหม่และค่าฟอนต์ สี ขนาด หรือค่าอื่น ๆ ที่ได้อาจเปลี่ยนแปลง

สามารถแก้ไขค่าโดยตรงผ่านอ็อบเจ็กต์ข้อมูลที่เป็น effective ได้หรือไม่?

ไม่ได้ อ็อบเจ็กต์ข้อมูลที่เป็น effective เปิดเผยเฉพาะค่าที่คำนวณแล้ว ให้ทำการเปลี่ยนแปลงในอ็อบเจ็กต์การจัดรูปแบบระดับ local แล้วจึงดึงค่า effective อีกครั้ง

ถ้าคุณสมบัติไม่ได้ตั้งค่าที่ระดับรูปร่าง ไม่ได้ตั้งในเลย์เอาต์/มาสเตอร์ และไม่ได้ตั้งค่าแบบทั่วโลก จะเกิดอะไรขึ้น?

ค่าที่เป็น effective จะถูกกำหนดตามกลไกค่าเริ่มต้น ซึ่งรวมถึงค่าเริ่มต้นของ PowerPoint และ Aspose.Slides ค่าที่ได้จะเป็นส่วนหนึ่งของข้อมูลที่เป็น effective ปัจจุบัน

จากค่า font ที่เป็น effective ฉันจะทราบได้ว่ากลุ่มระดับใดให้ค่าขนาดหรือแบบอักษร?

ไม่ได้โดยตรง ข้อมูลที่เป็น effective จะคืนค่าที่สุดท้าย หากต้องการหาต้นทาง ให้ตรวจสอบค่าที่เป็น local ที่ Portion, Paragraph, Text Frame, และ Text Styles ที่ระดับเลย์เอาต์, มาสเตอร์, และงานนำเสนอ เพื่อดูว่าการกำหนดที่ชัดเจนแรกปรากฏที่ไหน

ทำไมค่าที่เป็น effective บางครั้งดูเหมือนกับค่าที่เป็น local?

เพราะค่าที่เป็น local กลายเป็นค่าที่สุดท้าย (ไม่ต้องสืบทอดจากระดับที่สูงกว่า) ในกรณีดังกล่าวค่า effective จึงตรงกับค่า local

ควรใช้คุณสมบัติที่เป็น effective เมื่อใด และควรใช้ค่า local เท่านั้นเมื่อใด?

ใช้ข้อมูลที่เป็น effective เมื่อต้องการผลลัพธ์ “as rendered” หลังจากการสืบทอดทั้งหมด เช่น การจัดสี การเยื้อง หรือขนาด หากต้องการเก็บค่าดังกล่าวโดยไม่ให้เปลี่ยนแปลงจากการจัดรูปแบบต่อ ๆ ไป ให้คัดลอกคุณสมบัติที่ต้องการไปยังอ็อบเจ็กต์ของคุณเอง หากต้องการเปลี่ยนการจัดรูปแบบที่ระดับใดระดับหนึ่ง ให้ปรับค่า local แล้วหากจำเป็นให้ดึงข้อมูลที่เป็น effective อีกครั้งเพื่อยืนยันผลลัพธ์

จัดการรูปร่างการนำเสนอใน PHP ใช้แอนิเมชันรูปทรงในงานนำเสนอด้วย PHP