مدیریت جداول ارائه در PHP

این صفحه درباره چیست

ایجاد و ویرایش جداول در اسلایدهای PowerPoint با Aspose.Slides برای PHP از طریق Java. مثال‌های ساده کد را کشف کنید تا جریان کاری جداول خود را بهبود بخشید.

معرفی

یک جدول در PowerPoint روشی کارآمد برای نمایش و ارائه اطلاعات است. اطلاعات در یک شبکه از سلول‌ها (چینیده‌شده در سطرها و ستون‌ها) ساده و به‌راحتی قابل درک هستند.

Aspose.Slides کلاس Table، کلاس Cell و انواع دیگر را فراهم می‌کند تا بتوانید جدول‌ها را در انواع ارائه‌ها ایجاد، به‌روزرسانی و مدیریت کنید.

ایجاد جدول از ابتدا

یک نمونه از کلاس Presentation ایجاد کنید.
مرجع یک اسلاید را از طریق شمارهٔ آن دریافت کنید.
یک آرایه از columnWidth تعریف کنید.
یک آرایه از rowHeight تعریف کنید.
یک شیء Table را به اسلاید اضافه کنید با استفاده از متد addTable.
در هر Cell تکرار کنید تا قالب‌بندی برای حاشیه‌های بالا، پایین، راست و چپ اعمال شود.
دو سلول اول ردیف اول جدول را ادغام کنید.
به TextFrame یک Cell دسترسی پیدا کنید.
متنی به TextFrame اضافه کنید.
ارائهٔ تغییر یافته را ذخیره کنید.

  # یک شیء از کلاس Presentation که نمایانگر یک فایل PPTX است ایجاد می‌کند
  $pres = new Presentation();
  try {
    # به اسلاید اول دسترسی می‌یابد
    $sld = $pres->getSlides()->get_Item(0);
    # ستون‌ها را با عرض‌ها و ردیف‌ها را با ارتفاع‌ها تعریف می‌کند
    $dblCols = array(50, 50, 50 );
    $dblRows = array(50, 30, 30, 30, 30 );
    # یک شکل جدول را به اسلاید اضافه می‌کند
    $tbl = $sld->getShapes()->addTable(100, 50, $dblCols, $dblRows);
    # قالب حاشیه را برای هر سلول تنظیم می‌کند
    for($row = 0; $row < java_values($tbl->getRows()->size()) ; $row++) {
      for($cell = 0; $cell < java_values($tbl->getRows()->get_Item($row)->size()) ; $cell++) {
        $cellFormat = $tbl->getRows()->get_Item($row)->get_Item($cell)->getCellFormat();
        $cellFormat::getBorderTop()->getFillFormat()->setFillType(FillType::Solid);
        $cellFormat::getBorderTop()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->RED);
        $cellFormat::getBorderTop()->setWidth(5);
        $cellFormat::getBorderBottom()->getFillFormat()->setFillType(FillType::Solid);
        $cellFormat::getBorderBottom()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->RED);
        $cellFormat::getBorderBottom()->setWidth(5);
        $cellFormat::getBorderLeft()->getFillFormat()->setFillType(FillType::Solid);
        $cellFormat::getBorderLeft()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->RED);
        $cellFormat::getBorderLeft()->setWidth(5);
        $cellFormat::getBorderRight()->getFillFormat()->setFillType(FillType::Solid);
        $cellFormat::getBorderRight()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->RED);
        $cellFormat::getBorderRight()->setWidth(5);
      }
    }
    # سلول‌های 1 و 2 ردیف 1 را ادغام می‌کند
    $tbl->mergeCells($tbl->getRows()->get_Item(0)->get_Item(0), $tbl->getRows()->get_Item(1)->get_Item(1), false);
    # متنی به سلول ادغام‌شده اضافه می‌کند
    $tbl->getRows()->get_Item(0)->get_Item(0)->getTextFrame()->setText("Merged Cells");
    # ارائه را بر روی دیسک ذخیره می‌کند
    $pres->save("table.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

شماره‌گذاری در جدول استاندارد

در یک جدول استاندارد، شماره‌گذاری سلول‌ها ساده و مبتنی بر صفر است. اولین سلول در جدول به صورت 0,0 (ستون 0، سطر 0) ایندکس می‌شود.

به عنوان مثال، سلول‌های یک جدول با 4 ستون و 4 سطر به این شکل شماره‌گذاری می‌شوند:

(0, 0)	(1, 0)	(2, 0)	(3, 0)
(0, 1)	(1, 1)	(2, 1)	(3, 1)
(0, 2)	(1, 2)	(2, 2)	(3, 2)
(0, 3)	(1, 3)	(2, 3)	(3, 3)

  # یک شیء از کلاس Presentation که نمایانگر یک فایل PPTX است ایجاد می‌کند
  $pres = new Presentation();
  try {
    # به اولین اسلاید دسترسی می‌یابد
    $sld = $pres->getSlides()->get_Item(0);
    # ستون‌ها را با عرض‌ها و ردیف‌ها را با ارتفاع‌ها تعریف می‌کند
    $dblCols = array(70, 70, 70, 70 );
    $dblRows = array(70, 70, 70, 70 );
    # یک شکل جدول را به اسلاید اضافه می‌کند
    $tbl = $sld->getShapes()->addTable(100, 50, $dblCols, $dblRows);
    # قالب حاشیه را برای هر سلول تنظیم می‌کند
    $rows = $tbl->getRows();
    foreach($rows as $row) {
      foreach($row as $cell) {
        $cell->getCellFormat()->getBorderTop()->getFillFormat()->setFillType(FillType::Solid);
        $cell->getCellFormat()->getBorderTop()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->RED);
        $cell->getCellFormat()->getBorderTop()->setWidth(5);
        $cell->getCellFormat()->getBorderBottom()->getFillFormat()->setFillType(FillType::Solid);
        $cell->getCellFormat()->getBorderBottom()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->RED);
        $cell->getCellFormat()->getBorderBottom()->setWidth(5);
        $cell->getCellFormat()->getBorderLeft()->getFillFormat()->setFillType(FillType::Solid);
        $cell->getCellFormat()->getBorderLeft()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->RED);
        $cell->getCellFormat()->getBorderLeft()->setWidth(5);
        $cell->getCellFormat()->getBorderRight()->getFillFormat()->setFillType(FillType::Solid);
        $cell->getCellFormat()->getBorderRight()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->RED);
        $cell->getCellFormat()->getBorderRight()->setWidth(5);
      }
    }
    # ارائه را بر روی دیسک ذخیره می‌کند
    $pres->save("StandardTables_out.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

دسترسی به جدول موجود

یک نمونه از کلاس Presentation ایجاد کنید.
مرجع اسلایدی که شامل جدول است را از طریق شمارهٔ آن دریافت کنید.
یک شیء Table ایجاد کنید و آن را به null تنظیم کنید.
از میان تمام اشیاء Shape تا زمانی که جدول پیدا شود، تکرار کنید.
اگر گمان می‌کنید اسلاید مورد نظر تنها یک جدول دارد، می‌توانید تمام اشکال موجود در آن را بررسی کنید. وقتی یک شکل به عنوان جدول شناسایی شد، می‌توانید آن را به شیء Table تبدیل کنید. اما اگر اسلاید شامل چندین جدول باشد، بهتر است جدول مورد نیاز را از طریق متد setAlternativeText(String value) جستجو کنید.
از شیء Table برای کار با جدول استفاده کنید. در مثال زیر یک ردیف جدید به جدول اضافه کردیم.
ارائهٔ تغییر یافته را ذخیره کنید.

  # یک شیء از کلاس Presentation که نمایانگر یک فایل PPTX است ایجاد می‌کند
  $pres = new Presentation("UpdateExistingTable.pptx");
  try {
    # به اولین اسلاید دسترسی می‌یابد
    $sld = $pres->getSlides()->get_Item(0);
    # TableEx را به null مقداردهی می‌کند
    $tbl = null;
    # از اشکال عبور می‌کند و مرجع جدول پیدا شده را تنظیم می‌کند
    $shapes = $sld->getShapes();
    foreach($shapes as $shp) {
      if (java_instanceof($shp, new JavaClass("com.aspose.slides.Table"))) {
        $tbl = $shp;
        # متن ستون اول ردیف دوم را تنظیم می‌کند
        $tbl->get_Item(0, 1)->getTextFrame()->setText("New");
      }
    }
    # ارائه اصلاح‌شده را بر روی دیسک ذخیره می‌کند
    $pres->save("table1_out.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

یافتن سلولی که یک TextFrame را در خود دارد

زمانی که کد عمومی پردازش متن یک TextFrame را از یک جدول دریافت می‌کند، از متد TextFrame::getParentCell برای بازیابی Cell مالک استفاده کنید. برای یک فریم متن در سلول جدول، TextFrame::getParentCell مالک را برمی‌گرداند و TextFrame::getParentShape مقدار null می‌دهد، حتی اگر جدول خود یک شکل باشد.

مختصات سلول از طریق متدهای فقط‑خواندنی Cell::getFirstColumnIndex و Cell::getFirstRowIndex در دسترس هستند. TextFrame::getParentCell همچنین ناوبری فقط‑خواندنی فراهم می‌کند: مالک را برمی‌گرداند اما مالکیت را تغییر نمی‌دهد. قبل از استفاده، همیشه سلول بازگردانده‌شده را با java_is_null بررسی کنید.

برای مثال کامل که صاحبان سلول‑جدول و شکل‌ها را شناسایی می‌کند، از جمله شکل‌های مرتبط با گره‌های SmartArt، به بخش Search and Replace Text مراجعه کنید.

ترازبندی متن در جدول

یک نمونه از کلاس Presentation ایجاد کنید.
مرجع یک اسلاید را از طریق شمارهٔ آن دریافت کنید.
یک شیء Table را به اسلاید اضافه کنید.
یک شیء TextFrame را از جدول دسترسی پیدا کنید.
به Paragraph دسترسی پیدا کنید.
متن را به صورت عمودی ترازبندی کنید.
ارائهٔ تغییر یافته را ذخیره کنید.

  # یک نمونه از کلاس Presentation ایجاد می‌کند
  $pres = new Presentation();
  try {
    # اسلاید اول را دریافت می‌کند
    $slide = $pres->getSlides()->get_Item(0);
    # ستون‌ها را با عرض‌ها و ردیف‌ها را با ارتفاع‌ها تعریف می‌کند
    $dblCols = array(120, 120, 120, 120 );
    $dblRows = array(100, 100, 100, 100 );
    # شکل جدول را به اسلاید اضافه می‌کند
    $tbl = $slide->getShapes()->addTable(100, 50, $dblCols, $dblRows);
    $tbl->get_Item(1, 0)->getTextFrame()->setText("10");
    $tbl->get_Item(2, 0)->getTextFrame()->setText("20");
    $tbl->get_Item(3, 0)->getTextFrame()->setText("30");
    # به فریم متن دسترسی می‌یابد
    $txtFrame = $tbl->get_Item(0, 0)->getTextFrame();
    # شیء Paragraph را برای فریم متن ایجاد می‌کند
    $paragraph = $txtFrame->getParagraphs()->get_Item(0);
    # شیء Portion را برای پاراگراف ایجاد می‌کند
    $portion = $paragraph->getPortions()->get_Item(0);
    $portion->setText("Text here");
    $portion->getPortionFormat()->getFillFormat()->setFillType(FillType::Solid);
    $portion->getPortionFormat()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->BLACK);
    # متن را به صورت عمودی ترازبندی می‌کند
    $cell = $tbl->get_Item(0, 0);
    $cell->setTextAnchorType(TextAnchorType::Center);
    $cell->setTextVerticalType(TextVerticalType::Vertical270);
    # ارائه را بر روی دیسک ذخیره می‌کند
    $pres->save("Vertical_Align_Text_out.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

تنظیم قالب‌بندی متن در سطح جدول

یک نمونه از کلاس Presentation ایجاد کنید.
مرجع یک اسلاید را از طریق شمارهٔ آن دریافت کنید.
یک شیء Table را از اسلاید دسترسی پیدا کنید.
برای متن متد setFontHeight(float value) را تنظیم کنید.
متدهای setAlignment(int value) و setMarginRight(float value) را تنظیم کنید.
متد setTextVerticalType(byte value) را تنظیم کنید.
ارائهٔ تغییر یافته را ذخیره کنید.

  # یک نمونه از کلاس Presentation ایجاد می‌کند
  $pres = new Presentation("simpletable.pptx");
  try {
    # فرض می‌کنیم اولین شکل در اولین اسلاید یک جدول است
    $someTable = $pres->getSlides()->get_Item(0)->getShapes()->get_Item(0);
    # ارتفاع فونت سلول‌های جدول را تنظیم می‌کند
    $portionFormat = new PortionFormat();
    $portionFormat::setFontHeight(25);
    $someTable->setTextFormat($portionFormat);
    # تراز متن سلول‌های جدول و حاشیه راست را در یک فراخوانی تنظیم می‌کند
    $paragraphFormat = new ParagraphFormat();
    $paragraphFormat::setAlignment(TextAlignment->Right);
    $paragraphFormat::setMarginRight(20);
    $someTable->setTextFormat($paragraphFormat);
    # نوع متن عمودی سلول‌های جدول را تنظیم می‌کند
    $textFrameFormat = new TextFrameFormat();
    $textFrameFormat::setTextVerticalType(TextVerticalType::Vertical);
    $someTable->setTextFormat($textFrameFormat);
    $pres->save("result.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

دریافت ویژگی‌های سبک جدول

Aspose.Slides به شما امکان می‌دهد ویژگی‌های سبک یک جدول را بازیابی کنید تا بتوانید این جزئیات را برای جدول دیگری یا در مکان دیگری استفاده کنید. این کد PHP نشان می‌دهد چگونه ویژگی‌های سبک را از یک پیش‌تنظیم سبک جدول دریافت کنید:

  $pres = new Presentation();
  try {
    $table = $pres->getSlides()->get_Item(0)->getShapes()->addTable(10, 10, array(100, 150 ), array(5, 5, 5 ));
    $table->setStylePreset(TableStylePreset->DarkStyle1);// تغییر تم پیش‌فرض پیش‌تنظیم سبک

    $pres->save("table.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

قفل کردن نسبت ابعاد جدول

نسبت ابعاد یک شکل هندسی، نسبت اندازه‌های آن در ابعاد مختلف است. Aspose.Slides متد setAspectRatioLocked را فراهم کرده است تا بتوانید تنظیم قفل نسبت ابعاد را برای جدول‌ها و سایر اشکال اعمال کنید.

  $pres = new Presentation("pres.pptx");
  try {
    $table = $pres->getSlides()->get_Item(0)->getShapes()->get_Item(0);
    echo("Lock aspect ratio set: " . $table->getGraphicalObjectLock()->getAspectRatioLocked());
    $table->getGraphicalObjectLock()->setAspectRatioLocked(!$table->getGraphicalObjectLock()->getAspectRatioLocked());// invert

    echo("Lock aspect ratio set: " . $table->getGraphicalObjectLock()->getAspectRatioLocked());
    $pres->save("pres-out.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

سوالات متداول

آیا می‌توانم جهت خواندن راست به چپ (RTL) را برای تمام جدول و متن داخل سلول‌های آن فعال کنم؟

بله. جدول متد setRightToLeft را ارائه می‌دهد و پاراگراف‌ها متد ParagraphFormat::setRightToLeft دارند. استفاده از هر دو اطمینان می‌دهد ترتیب RTL درست و رندر صحیح داخل سلول‌ها باشد.

چگونه می‌توانم از جابجا یا تغییر اندازه جدول توسط کاربران در فایل نهایی جلوگیری کنم؟

از قفل‌های شکل استفاده کنید تا جابجایی، تغییر اندازه، انتخاب و غیره غیرفعال شوند. این قفل‌ها برای جدول‌ها نیز اعمال می‌شود.

آیا قراردادن تصویر به عنوان پس‌زمینه داخل یک سلول پشتیبانی می‌شود؟

بله. می‌توانید برای یک سلول picture fill تنظیم کنید؛ تصویر بر حسب حالت انتخابی (کشیدنی یا کاشی) کل ناحیه سلول را پوشش می‌دهد.

مدیریت ردیف‌ها و ستون‌ها در جداول PowerPoint با استفاده از PHP