إدارة أشكال العرض التقديمي في PHP

العثور على شكل في شريحة

ستصف هذه المقالة تقنية بسيطة لتسهيل عملية العثور على شكل محدد في شريحة دون الحاجة إلى معرفه الداخلي. من المهم معرفة أن ملفات PowerPoint Presentation لا توفر طريقة لتحديد الأشكال في الشريحة إلا من خلال معرف فريد داخلي. يبدو أن المطورين يواجهون صعوبة في العثور على شكل باستخدام معرفه الفريد الداخلي. جميع الأشكال المضافة إلى الشرائح لديها بعض النص البديل. نوصي المطورين باستخدام النص البديل للعثور على شكل محدد. يمكنك استخدام MS PowerPoint لتحديد النص البديل للكائنات التي تخطط لتغييرها في المستقبل.

بعد ضبط النص البديل لأي شكل مرغوب، يمكنك فتح تلك العروض باستخدام Aspose.Slides for PHP via Java والمرور عبر جميع الأشكال المضافة إلى شريحة. خلال كل دورة، يمكنك فحص النص البديل للشكل والشكل الذي يطابق النص البديل سيكون هو الشكل المطلوب. لتوضيح هذه التقنية بطريقة أفضل، أنشأنا طريقة findShape تقوم بالعثور على شكل محدد في شريحة وتعيد ذلك الشكل ببساطة.

  # إنشاء كائن من فئة Presentation يمثل ملف العرض التقديمي
  $pres = new Presentation("FindingShapeInSlide.pptx");
  try {
    $slide = $pres->getSlides()->get_Item(0);
    # النص البديل للشكل المراد العثور عليه
    $shape = findShape($slide, "Shape1");
    if (!java_is_null($shape)) {
      echo("Shape Name: " . $shape->getName());
    }
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

نسخ شكل

لنسخ شكل إلى شريحة باستخدام Aspose.Slides for PHP via Java:

  1. إنشاء مثال من الفئة Presentation.
  2. الحصول على مرجع الشريحة باستخدام فهرستها.
  3. الوصول إلى مجموعة أشكال الشريحة المصدر.
  4. إضافة شريحة جديدة إلى العرض.
  5. نسخ الأشكال من مجموعة أشكال الشريحة المصدر إلى الشريحة الجديدة.
  6. حفظ العرض المعدل كملف PPTX.

المثال أدناه يضيف مجموعة أشكال إلى شريحة.

  # إنشاء كائن من فئة Presentation
  $pres = new Presentation("Source Frame.pptx");
  try {
    $sourceShapes = $pres->getSlides()->get_Item(0)->getShapes();
    $blankLayout = $pres->getMasters()->get_Item(0)->getLayoutSlides()->getByType(SlideLayoutType::Blank);
    $destSlide = $pres->getSlides()->addEmptySlide($blankLayout);
    $destShapes = $destSlide->getShapes();
    $destShapes->addClone($sourceShapes->get_Item(1), 50, 150 + $sourceShapes->get_Item(0)->getHeight());
    $destShapes->addClone($sourceShapes->get_Item(2));
    $destShapes->insertClone(0, $sourceShapes->get_Item(0), 50, 150);
    # حفظ ملف PPTX على القرص
    $pres->save("CloneShape_out.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

إزالة شكل

يسمح Aspose.Slides for PHP via Java للمطورين بإزالة أي شكل. لإزالة الشكل من أي شريحة، يرجى اتباع الخطوات التالية:

  1. إنشاء مثال من الفئة Presentation.
  2. الوصول إلى الشريحة الأولى.
  3. العثور على الشكل باستخدام AlternativeText محدد.
  4. إزالة الشكل.
  5. حفظ الملف على القرص.
  # إنشاء كائن Presentation
  $pres = new Presentation();
  try {
    # الحصول على الشريحة الأولى
    $sld = $pres->getSlides()->get_Item(0);
    # إضافة شكل تلقائي من نوع مستطيل
    $sld->getShapes()->addAutoShape(ShapeType::Rectangle, 50, 40, 150, 50);
    $sld->getShapes()->addAutoShape(ShapeType::Moon, 160, 40, 150, 50);
    $altText = "User Defined";
    $iCount = $sld->getShapes()->size();
    for($i = 0; $i < java_values($iCount) ; $i++) {
      $ashp = $sld->getShapes()->get_Item(0);
      if ($alttext->equals($ashp->getAlternativeText())) {
        $sld->getShapes()->remove($ashp);
      }
    }
    # حفظ العرض التقديمي على القرص
    $pres->save("RemoveShape_out.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

إخفاء شكل

يسمح Aspose.Slides for PHP via Java للمطورين بإخفاء أي شكل. لإخفاء الشكل من أي شريحة، يرجى اتباع الخطوات التالية:

  1. إنشاء مثال من الفئة Presentation.
  2. الوصول إلى الشريحة الأولى.
  3. العثور على الشكل باستخدام AlternativeText محدد.
  4. إخفاء الشكل.
  5. حفظ الملف على القرص.
  # إنشاء فئة Presentation التي تمثل ملف PPTX
  $pres = new Presentation();
  try {
    # الحصول على الشريحة الأولى
    $sld = $pres->getSlides()->get_Item(0);
    # إضافة شكل تلقائي من نوع مستطيل
    $sld->getShapes()->addAutoShape(ShapeType::Rectangle, 50, 40, 150, 50);
    $sld->getShapes()->addAutoShape(ShapeType::Moon, 160, 40, 150, 50);
    $alttext = "User Defined";
    $iCount = $sld->getShapes()->size();
    for($i = 0; $i < java_values($iCount) ; $i++) {
      $ashp = $sld->getShapes()->get_Item($i);
      if ($alttext->equals($ashp->getAlternativeText())) {
        $ashp->setHidden(true);
      }
    }
    # حفظ العرض التقديمي على القرص
    $pres->save("Hiding_Shapes_out.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

تغيير ترتيب الشكل

يسمح Aspose.Slides for PHP via Java للمطورين بإعادة ترتيب الأشكال. تحديد ترتيب الشكل يحدد أي شكل يكون في المقدمة أو في الخلفية. لإعادة ترتيب الشكل من أي شريحة، يرجى اتباع الخطوات التالية:

  1. إنشاء مثال من الفئة Presentation.
  2. الوصول إلى الشريحة الأولى.
  3. إضافة شكل.
  4. إضافة بعض النص إلى إطار النص الخاص بالشكل.
  5. إضافة شكل آخر بنفس الإحداثيات.
  6. إعادة ترتيب الأشكال.
  7. حفظ الملف على القرص.
  $pres = new Presentation("ChangeShapeOrder.pptx");
  try {
    $slide = $pres->getSlides()->get_Item(0);
    $shp3 = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 200, 365, 400, 150);
    $shp3->getFillFormat()->setFillType(FillType::NoFill);
    $shp3->addTextFrame(" ");
    $para = $shp3->getTextFrame()->getParagraphs()->get_Item(0);
    $portion = $para->getPortions()->get_Item(0);
    $portion->setText("Watermark Text Watermark Text Watermark Text");
    $shp3 = $slide->getShapes()->addAutoShape(ShapeType::Triangle, 200, 365, 400, 150);
    $slide->getShapes()->reorder(2, $shp3);
    $pres->save("Reshape_out.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

الحصول على معرف الشكل Interop

يسمح Aspose.Slides for PHP via Java للمطورين بالحصول على معرف فريد للشكل ضمن نطاق الشريحة مقارنة بطريقة getUniqueId التي توفر معرفًا فريدًا ضمن نطاق العرض. تم إضافة الطريقة getOfficeInteropShapeId إلى فئة Shape على التوالي. القيمة المرجعة بواسطة الطريقة getOfficeInteropShapeId تتطابق مع قيمة Id لكائن Microsoft.Office.Interop.PowerPoint.Shape. أدناه مثال على الكود.

  $pres = new Presentation("Presentation.pptx");
  try {
    # الحصول على معرف الشكل الفريد في نطاق الشريحة
    $officeInteropShapeId = $pres->getSlides()->get_Item(0)->getShapes()->get_Item(0)->getOfficeInteropShapeId();
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

تعيين النص البديل لشكل

يسمح Aspose.Slides for PHP via Java للمطورين بتعيين AlternateText لأي شكل. يمكن تمييز الأشكال في عرض باستخدام Alternative Text أو طريقة Shape Name. يمكن قراءة أو تعيين الطريقتين setAlternativeText وgetAlternativeText باستخدام Aspose.Slides وكذلك Microsoft PowerPoint. باستخدام هذه الطريقة، يمكنك وضع علامة على الشكل وإجراء عمليات مختلفة مثل إزالة الشكل، إخفاء الشكل أو إعادة ترتيب الأشكال في شريحة. لتعيين AlternateText لشكل، يرجى اتباع الخطوات التالية:

  1. إنشاء مثال من الفئة Presentation.
  2. الوصول إلى الشريحة الأولى.
  3. إضافة أي شكل إلى الشريحة.
  4. القيام ببعض الأعمال مع الشكل المضاف حديثًا.
  5. التجول عبر الأشكال للعثور على الشكل.
  6. تعيين AlternativeText.
  7. حفظ الملف على القرص.
  # إنشاء كائن Presentation الذي يمثل ملف PPTX
  $pres = new Presentation();
  try {
    # الحصول على الشريحة الأولى
    $sld = $pres->getSlides()->get_Item(0);
    # إضافة شكل تلقائي من نوع مستطيل
    $shp1 = $sld->getShapes()->addAutoShape(ShapeType::Rectangle, 50, 40, 150, 50);
    $shp2 = $sld->getShapes()->addAutoShape(ShapeType::Moon, 160, 40, 150, 50);
    $shp2->getFillFormat()->setFillType(FillType::Solid);
    $shp2->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->GRAY);
    for($i = 0; $i < java_values($sld->getShapes()->size()) ; $i++) {
      $shape = $sld->getShapes()->get_Item($i);
      if (!java_is_null($shape)) {
        $shape->setAlternativeText("User Defined");
      }
    }
    # حفظ العرض التقديمي على القرص
    $pres->save("Set_AlternativeText_out.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

الوصول إلى تنسيقات التخطيط لشكل

يوفر Aspose.Slides for PHP via Java واجهة برمجة تطبيقات بسيطة للوصول إلى تنسيقات التخطيط لشكل. يوضح هذا المقال كيف يمكنك الوصول إلى تنسيقات التخطيط.

الكود النموذجي أدناه.

  $pres = new Presentation("pres.pptx");
  try {
    foreach($pres->getLayoutSlides() as $layoutSlide) {
      foreach($layoutSlide->getShapes() as $shape) {
        $fillFormats = $shape->getFillFormat();
        $lineFormats = $shape->getLineFormat();
      }
    }
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

تصدير شكل كملف SVG

الآن يدعم Aspose.Slides for PHP via Java تصدير شكل كملف SVG. تمت إضافة الطريقة writeAsSvg (وأحمالها) إلى فئة Shape. تسمح هذه الطريقة بحفظ محتوى الشكل كملف SVG. يُظهر المقتطف البرمجي أدناه كيفية تصدير شكل شريحة إلى ملف SVG.

  $pres = new Presentation("TestExportShapeToSvg.pptx");
  try {
    $stream = new Java("java.io.FileOutputStream", "SingleShape.svg");
    try {
      $pres->getSlides()->get_Item(0)->getShapes()->get_Item(0)->writeAsSvg($stream);
    } finally {
      if (!java_is_null($stream)) {
        $stream->close();
      }
    }
  } catch (JavaException $e) {
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

محاذاة شكل

يسمح Aspose.Slides بمحاذاة الأشكال إما بالنسبة إلى هوامش الشريحة أو بالنسبة إلى بعضها البعض. لهذا الغرض، تمت إضافة الطريقة المُحمّلة SlidesUtil::alignShapes. تحدد تعداد ShapesAlignmentType خيارات المحاذاة الممكنة.

مثال 1

الكود المصدر أدناه يُحاذي الأشكال ذات الفهارس 1 و2 و4 على الحد العلوي للشريحة.

  $pres = new Presentation("example.pptx");
  try {
    $slide = $pres->getSlides()->get_Item(0);
    $shape1 = $slide->getShapes()->get_Item(1);
    $shape2 = $slide->getShapes()->get_Item(2);
    $shape3 = $slide->getShapes()->get_Item(4);
    SlideUtil->alignShapes(ShapesAlignmentType::AlignTop, true, $pres->getSlides()->get_Item(0), array($slide->getShapes()->indexOf($shape1), $slide->getShapes()->indexOf($shape2), $slide->getShapes()->indexOf($shape3) ));
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

مثال 2

المثال أدناه يوضح كيفية محاذاة مجموعة الأشكال بالكامل بالنسبة إلى الشكل الأسفل في المجموعة.

  $pres = new Presentation("example.pptx");
  try {
    SlideUtil->alignShapes(ShapesAlignmentType::AlignBottom, false, $pres->getSlides()->get_Item(0));
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

خصائص الانعكاس

في Aspose.Slides، توفر فئة ShapeFrame التحكم في انعكاس الأشكال أفقيًا وعموديًا عبر خصائص flipH وflipV. كلا الخصائصين من نوع NullableBool، وتقبل القيم True للانعكاس، False لعدم الانعكاس، أو NotDefined لاستخدام السلوك الافتراضي. يمكن الوصول إلى هذه القيم من خلال Frame الخاص بالشكل.

لتعديل إعدادات الانعكاس، تُنشأ مثيل جديد من ShapeFrame باستخدام موضع وحجم الشكل الحالي، والقيم المطلوبة لـ flipH وflipV، وزاوية الدوران. يُعيّن هذا المثيل إلى Frame الخاص بالشكل ثم يُحفظ العرض لتطبيق التحولات المرآوية وتضمينها في ملف الإخراج.

لنفترض أن لدينا ملف sample.pptx يحتوي على الشريحة الأولى شكلًا واحدًا بإعدادات انعكاس افتراضية، كما هو موضح أدناه.

The shape to be flipped

الكود التالي يسترجع خصائص الانعكاس الحالية للشكل ويقلبه أفقيًا وعموديًا.

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

    // استرجاع خاصية انعكاس الشكل أفقيًا.
    $horizontalFlip = $shape->getFrame()->getFlipH();
    echo "Horizontal flip: ", $horizontalFlip, "\n";

    // استرجاع خاصية انعكاس الشكل عموديًا.
    $verticalFlip = $shape->getFrame()->getFlipV();
    echo "Vertical flip: ", $verticalFlip, "\n";

    $x = $shape->getFrame()->getX();
    $y = $shape->getFrame()->getY();
    $width = $shape->getFrame()->getWidth();
    $height = $shape->getFrame()->getHeight();
    $flipH = NullableBool::True; // انعكاس أفقي.
    $flipV = NullableBool::True; // انعكاس أفقي.
    $rotation = $shape->getFrame()->getRotation();

    $shape->setFrame(new ShapeFrame($x, $y, $width, $height, $flipH, $flipV, $rotation));

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

النتيجة:

The flipped shape

الأسئلة الشائعة

هل يمكنني دمج الأشكال (union/intersect/subtract) في شريحة كما في محرر سطح المكتب؟

لا توجد واجهة برمجة تطبيقات مدمجة للعمليات البوليانية. يمكنك تقريب ذلك بإنشاء المخطط المطلوب يدويًا—مثلاً حساب الهندسة الناتجة عبر GeometryPath وإنشاء شكل جديد بهذا المخطط، مع حذف الأشكال الأصلية إذا رغبت.

كيف يمكنني التحكم في ترتيب الطبقات (z-order) بحيث يبقى الشكل دائمًا “في المقدمة”?

غيّر ترتيب الإدراج/النقل داخل مجموعة shapes الخاصة بالشريحة. للحصول على نتائج متوقعة، قم بإنهاء ترتيب z بعد جميع التعديلات الأخرى على الشريحة.

هل يمكنني “قفل” شكل لمنع المستخدمين من تعديلها في PowerPoint؟

نعم. عيّن علامات حماية على مستوى الشكل (مثل قفل التحديد، الحركة، تغيير الحجم، تحرير النص). إذا لزم الأمر، نفّذ قيودًا مماثلة على القالب أو التخطيط. تجدر الإشارة إلى أن هذه الحماية على مستوى واجهة المستخدم ولا تُعد ميزة أمان؛ للحصول على حماية أقوى، يمكن دمجها مع قيود على مستوى الملف مثل التوصيات للقراءة فقط أو كلمات المرور [/slides/php-java/password-protected-presentation/].

تطبيق تأثيرات الشكل في العروض التقديمية باستخدام PHP الحصول على الخصائص الفعّالة للشكل من العروض التقديمية في PHP