تدوير النص مع شكل داخل ورقة العمل باستخدام C++

سيناريوهات الاستخدام المحتملة

يمكنك إضافة نص داخل أي شكل باستخدام Microsoft Excel. إذا قمت بإضافة شكل باستخدام إصدار قديم جداً من Microsoft Excel 2003، فلن يدور النص مع الشكل. ومع ذلك، إذا قمت بإضافة شكل باستخدام إصدارات أحدث من Microsoft Excel، مثل 2007، 2010، 2013، أو 2016، فإن النص سوف يدور مع الشكل. يمكنك التحكم فيما إذا كان النص يجب أن يدور مع الشكل أم لا باستخدام الخاصية ShapeTextAlignment.GetRotateTextWithShape(). القيمة الافتراضية لهذه الخاصية هي true، مما يعني أن النص سيدور مع الشكل. إذا قمت بضبطها على false، فلن يدور النص مع الشكل.

تدوير النص مع الشكل داخل ورقة العمل

الكود النموذجي التالي يحمّل ملف إكسل النموذجي الذي يحتوي على شكل مثلث، ويدور النص مع الشكل. إذا قمت بفتح ملف إكسل النموذجي في Microsoft Excel ودوران شكل المثلث، فإن النص سيدور معه أيضاً. ثم يتم ضبط الخاصية ShapeTextAlignment.GetRotateTextWithShape() على false وحفظه باسم ملف إكسل الناتج. إذا قمت الآن بفتح ملف إكسل الناتج في Microsoft Excel ودوران شكل المثلث، فإن النص لن يدور معه. رجاءً اطلع على الصورة التالية التي تظهر تأثير الكود على ملف إكسل النموذجي للمرجعية.

الكود المثالي

#include <iostream>
#include "Aspose.Cells.h"
using namespace Aspose::Cells;
using namespace Aspose::Cells::Drawing;
using namespace Aspose::Cells::Drawing::Texts;

int main()
{
    Aspose::Cells::Startup();

    // Source directory path
    U16String srcDir(u"..\\Data\\01_SourceDirectory\\");

    // Output directory path
    U16String outDir(u"..\\Data\\02_OutputDirectory\\");

    // Load sample Excel file
    Workbook wb(srcDir + u"sampleRotateTextWithShapeInsideWorksheet.xlsx");

    // Access first worksheet
    Worksheet ws = wb.GetWorksheets().Get(0);

    // Access cell B4 and add message inside it
    Cell b4 = ws.GetCells().Get(u"B4");
    b4.PutValue(u"Text is not rotating with shape because RotateTextWithShape is false.");

    // Access first shape
    Shape sh = ws.GetShapes().Get(0);

    // Access shape text alignment
    ShapeTextAlignment shapeTextAlignment = sh.GetTextBody().GetTextAlignment();

    // Do not rotate text with shape by setting RotateTextWithShape as false
    shapeTextAlignment.SetRotateTextWithShape(false);

    // Save the output Excel file
    wb.Save(outDir + u"outputRotateTextWithShapeInsideWorksheet.xlsx");

    Aspose::Cells::Cleanup();
}