الموصل

موصل PowerPoint هو خط خاص يربط شكلين معًا ويظل متصلًا بالأشكال حتى عند تحريكها أو إعادة وضعها على شريحة معينة.

عادةً ما تكون الموصلات متصلة بـ نقاط الاتصال (نقاط خضراء) التي توجد على جميع الأشكال افتراضيًا. تظهر نقاط الاتصال عندما يقترب المؤشر منها.

تستخدم نقاط التعديل (نقاط برتقالية)، التي توجد فقط على موصلات معينة، لتعديل مواضع وأشكال الموصلات.

أنواع الموصلات

في PowerPoint، يمكنك استخدام موصلات مستقيمة، وزاوية (مائلة)، ومنحنية.

تقدم Aspose.Slides هذه الموصلات:

الموصل	الصورة	عدد نقاط التعديل
`ShapeType.Line`		0
`ShapeType.StraightConnector1`		0
`ShapeType.BentConnector2`		0
`ShapeType.BentConnector3`		1
`ShapeType.BentConnector4`		2
`ShapeType.BentConnector5`		3
`ShapeType.CurvedConnector2`		0
`ShapeType.CurvedConnector3`		1
`ShapeType.CurvedConnector4`		2
`ShapeType.CurvedConnector5`		3

ربط الأشكال باستخدام الموصلات

أنشئ مثيلًا من فئة Presentation.
احصل على مرجع الشريحة من خلال فهرسها.
أضف شكلين AutoShape إلى الشريحة باستخدام طريقة AddAutoShape المعلنة بواسطة كائن Shapes.
أضف موصلًا باستخدام طريقة AddConnector المعلنة بواسطة كائن Shapes من خلال تحديد نوع الموصل.
ربط الأشكال باستخدام الموصل.
استدعِ طريقة Reroute لتطبيق أقصر مسار اتصال.
احفظ العرض التقديمي.

هذا الكود C# يوضح لك كيفية إضافة موصل (موصل معقوق) بين شكلين (بيضاوي ومستطيل):

// ينشئ مثيلًا من فئة العرض التقديمي التي تمثل ملف PPTX
using (Presentation input = new Presentation())
{                
    // يصل إلى مجموعة الأشكال لشريحة معينة
    IShapeCollection shapes = input.Slides[0].Shapes;

    // يضيف شكل بيضاوي
    IAutoShape ellipse = shapes.AddAutoShape(ShapeType.Ellipse, 0, 100, 100, 100);

    // يضيف شكل مستطيل
    IAutoShape rectangle = shapes.AddAutoShape(ShapeType.Rectangle, 100, 300, 100, 100);

    // يضيف شكل موصل إلى مجموعة أشكال الشريحة
    IConnector connector = shapes.AddConnector(ShapeType.BentConnector2, 0, 0, 10, 10);

    // يربط الأشكال باستخدام الموصل
    connector.StartShapeConnectedTo = ellipse;
    connector.EndShapeConnectedTo = rectangle;

    // يستدعي إعادة التوجيه التي تضبط المسار التلقائي الأقصر بين الأشكال
    connector.Reroute();

    // يحفظ العرض التقديمي
    input.Save("Shapes-connector.pptx", SaveFormat.Pptx);
}

ملاحظة

تقوم طريقة Connector.Reroute بإعادة توجيه الموصل وتفرض عليه أن يأخذ أقصر مسار ممكن بين الأشكال. لتحقيق هدفها، قد تقوم الطريقة بتغيير نقاط StartShapeConnectionSiteIndex وEndShapeConnectionSiteIndex.

تحديد نقطة الاتصال

إذا كنت ترغب في ربط موصل بين شكلين باستخدام نقاط محددة على الأشكال، عليك تحديد نقاط الاتصال المفضلة لديك بهذه الطريقة:

أنشئ مثيلًا من فئة Presentation.
احصل على مرجع الشريحة من خلال فهرسها.
أضف شكلين AutoShape إلى الشريحة باستخدام طريقة AddAutoShape المعلنة بواسطة كائن Shapes.
أضف موصلًا باستخدام طريقة AddConnector المعلنة بواسطة كائن Shapes عبر تحديد نوع الموصل.
ربط الأشكال باستخدام الموصل.
حدد نقاط الاتصال المفضلة لديك على الأشكال.
احفظ العرض التقديمي.

هذا الكود C# يوضح عملية حيث يتم تحديد نقطة الاتصال المفضلة:

// ينشئ مثيلًا من فئة العرض التقديمي التي تمثل ملف PPTX
using (Presentation presentation = new Presentation())
{
    // يصل إلى مجموعة الأشكال لشريحة معينة
    IShapeCollection shapes = presentation.Slides[0].Shapes;

    // يضيف شكل موصل إلى مجموعة أشكال الشريحة
    IConnector connector = shapes.AddConnector(ShapeType.BentConnector3, 0, 0, 10, 10);

    // يضيف شكل بيضاوي
    IAutoShape ellipse = shapes.AddAutoShape(ShapeType.Ellipse, 0, 100, 100, 100);

    // يضيف شكل مستطيل
    IAutoShape rectangle = shapes.AddAutoShape(ShapeType.Rectangle, 100, 200, 100, 100);

    // يربط الأشكال باستخدام الموصل
    connector.StartShapeConnectedTo = ellipse;
    connector.EndShapeConnectedTo = rectangle;

    // يحدد مؤشر نقطة الاتصال المفضلة على الشكل البيضاوي
    uint wantedIndex = 6;

    // يتحقق مما إذا كان المؤشر المفضل أقل من الحد الأقصى لعدد مواقع الاتصال
    if (ellipse.ConnectionSiteCount > wantedIndex)
    {
        // يشترط النقطة المفضلة على الشكل البيضاوي
        connector.StartShapeConnectionSiteIndex = wantedIndex;
    }

    // يحفظ العرض التقديمي
    presentation.Save("Connecting_Shape_on_desired_connection_site_out.pptx", SaveFormat.Pptx);
}

تعديل نقطة الموصل

يمكنك تعديل موصل موجود من خلال نقاط التعديل الخاصة به. فقط الموصلات ذات نقاط التعديل يمكن تعديلها بهذه الطريقة. انظر الجدول تحت أنواع الموصلات.

حالة بسيطة

افترض حالة حيث يمر موصل بين شكلين (A و B) عبر شكل ثالث (C):

connector-obstruction

الكود:

Presentation pres = new Presentation();
ISlide sld = pres.Slides[0];
IShape shape = sld.Shapes.AddAutoShape(ShapeType.Rectangle, 300, 150, 150, 75);
IShape shapeFrom = sld.Shapes.AddAutoShape(ShapeType.Rectangle, 500, 400, 100, 50);
IShape shapeTo = sld.Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 70, 30);
 
IConnector connector = sld.Shapes.AddConnector(ShapeType.BentConnector5, 20, 20, 400, 300);
 
connector.LineFormat.EndArrowheadStyle = LineArrowheadStyle.Triangle;
connector.LineFormat.FillFormat.FillType = FillType.Solid;
connector.LineFormat.FillFormat.SolidFillColor.Color = Color.Black;
 
connector.StartShapeConnectedTo = shapeFrom;
connector.EndShapeConnectedTo = shapeTo;
connector.StartShapeConnectionSiteIndex = 2;

لتجنب أو تجاوز الشكل الثالث، يمكننا تعديل الموصل عن طريق تحريك خطه العمودي إلى اليسار بهذه الطريقة:

connector-obstruction-fixed

IAdjustValue adj2 = connector.Adjustments[1];
adj2.RawValue += 10000;

حالات معقدة

لإجراء تعديلات أكثر تعقيدًا، عليك أن تأخذ هذه الأمور في الاعتبار:

نقطة تعديل الموصل مرتبطة ارتباطًا وثيقًا بصيغة تحسب وتحدد موضعها. لذا قد تؤدي التغييرات على موقع النقطة إلى تغيير شكل الموصل.
يتم تعريف نقاط تعديل الموصل بترتيب صارم في مصفوفة. يتم ترقيم نقاط التعديل من نقطة بداية الموصل إلى نقطة نهايته.
تعكس قيم نقطة التعديل نسبة عرض/ارتفاع شكل الموصل.
- الشكل مقيد بواسطة نقاط بداية ونهاية الموصل مضروبة في 1000.
- النقطة الأولى، النقطة الثانية، والنقطة الثالثة تحدد النسبة من العرض، النسبة من الارتفاع، والنسبة من العرض (مرة أخرى) على التوالي.
لحسابات تحدد إحداثيات نقاط تعديل الموصل، يجب أن تأخذ في الاعتبار دوران الموصل وانعكاسه. ملاحظات أن زاوية الدوران لجميع الموصلات المعروضة تحت أنواع الموصلات هي 0.

الحالة 1

افترض حالة حيث يتم ربط كائنين إطار نص معًا من خلال موصل:

connector-shape-complex

الكود:

// ينشئ مثيلًا من فئة العرض التقديمي التي تمثل ملف PPTX
Presentation pres = new Presentation();
// يحصل على الشريحة الأولى في العرض التقديمي
ISlide sld = pres.Slides[0];
// يضيف أشكالًا سيتم ربطها معًا من خلال موصل
IAutoShape shapeFrom = sld.Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 60, 25);
shapeFrom.TextFrame.Text = "من";
IAutoShape shapeTo = sld.Shapes.AddAutoShape(ShapeType.Rectangle, 500, 100, 60, 25);
shapeTo.TextFrame.Text = "إلى";
// يضيف موصل
IConnector connector = sld.Shapes.AddConnector(ShapeType.BentConnector4, 20, 20, 400, 300);
// يحدد اتجاه الموصل
connector.LineFormat.EndArrowheadStyle = LineArrowheadStyle.Triangle;
// يحدد لون الموصل
connector.LineFormat.FillFormat.FillType = FillType.Solid;
connector.LineFormat.FillFormat.SolidFillColor.Color = Color.Crimson;
// يحدد سمك خط الموصل
connector.LineFormat.Width = 3;

// يربط الأشكال معًا باستخدام الموصل
connector.StartShapeConnectedTo = shapeFrom;
connector.StartShapeConnectionSiteIndex = 3;
connector.EndShapeConnectedTo = shapeTo;
connector.EndShapeConnectionSiteIndex = 2;

// يحصل على نقاط التعديل للموصل
IAdjustValue adjValue_0 = connector.Adjustments[0];
IAdjustValue adjValue_1 = connector.Adjustments[1];

التعديل

يمكننا تغيير قيم نقاط تعديل الموصل عن طريق زيادة نسبة العرض والارتفاع المقابلة بنسبة 20% و200% على التوالي:

// يغير قيم نقاط التعديل
adjValue_0.RawValue += 20000;
adjValue_1.RawValue += 200000;

النتيجة:

connector-adjusted-1

لتحديد نموذج يسمح لنا بتحديد إحداثيات وشكل أجزاء الموصل الفردية، دعنا ننشئ شكلًا يتوافق مع المكون الأفقي للموصل عند النقطة connector.Adjustments[0]:

// رسم المكون العمودي للموصل

float x = connector.X + connector.Width * adjValue_0.RawValue / 100000;
float y = connector.Y;
float height = connector.Height * adjValue_1.RawValue / 100000;
sld.Shapes.AddAutoShape( ShapeType .Rectangle, x, y, 0, height);

النتيجة:

connector-adjusted-2

الحالة 2

في الحالة 1، أظهرنا عملية تعديل موصل بسيطة باستخدام مبادئ أساسية. في الظروف العادية، يتعين عليك أخذ دوران الموصل وعرضه (الذي يتم تعيينه بواسطة connector.Rotation وconnector.Frame.FlipH وconnector.Frame.FlipV) في الاعتبار. سنوضح الآن العملية.

أولاً، دعنا نضيف كائن إطار نص جديد (إلى 1) إلى الشريحة (لأغراض الاتصال) وننشئ موصلًا جديدًا (أخضر) يربطه بالأشياء التي أنشأناها بالفعل.

// ينشئ كائن ربط جديد
IAutoShape shapeTo_1 = sld.Shapes.AddAutoShape(ShapeType.Rectangle, 100, 400, 60, 25);
shapeTo_1.TextFrame.Text = "إلى 1";
// ينشئ موصلًا جديدًا
connector = sld.Shapes.AddConnector(ShapeType.BentConnector4, 20, 20, 400, 300);
connector.LineFormat.EndArrowheadStyle = LineArrowheadStyle.Triangle;
connector.LineFormat.FillFormat.FillType = FillType.Solid;
connector.LineFormat.FillFormat.SolidFillColor.Color = Color.MediumAquamarine;
connector.LineFormat.Width = 3;
// يربط الكائنات باستخدام الموصل الذي تم إنشاؤه حديثًا
connector.StartShapeConnectedTo = shapeFrom;
connector.StartShapeConnectionSiteIndex = 2;
connector.EndShapeConnectedTo = shapeTo_1;
connector.EndShapeConnectionSiteIndex = 3;
// يحصل على نقاط تعديل الموصل
adjValue_0 = connector.Adjustments[0];
adjValue_1 = connector.Adjustments[1];
// يغير قيم نقاط التعديل 
adjValue_0.RawValue += 20000;
adjValue_1.RawValue += 200000;

النتيجة:

connector-adjusted-3

ثانيًا، دعنا ننشئ شكلًا يتوافق مع المكون الأفقي للموصل الذي يمر عبر نقطة تعديل الموصل الجديدة connector.Adjustments[0]. سنستخدم القيم من بيانات الموصل الخاصة بـ connector.Rotation وconnector.Frame.FlipH وconnector.Frame.FlipV ونطبق صيغة تحويل الإحداثيات الشهيرة للدوران حول نقطة معينة x0:

X = (x — x0) * cos(alpha) — (y — y0) * sin(alpha) + x0;

Y = (x — x0) * sin(alpha) + (y — y0) * cos(alpha) + y0;

في حالتنا، زاوية دوران الكائن هي 90 درجة والموصل معروض عموديًا، لذلك هذا هو الكود المقابل:

// يحفظ إحداثيات الموصل
x = connector.X;
y = connector.Y;
// يصحح إحداثيات الموصل في حال ظهوره
if (connector.Frame.FlipH == NullableBool.True)
{
    x += connector.Width;
}
if (connector.Frame.FlipV == NullableBool.True)
{
    y += connector.Height;
}
// يأخذ في قيمة نقطة التعديل كإحداثيات
x += connector.Width * adjValue_0.RawValue / 100000;
//  يحول الإحداثيات نظرًا لأن Sin(90) = 1 وCos(90) = 0
float xx = connector.Frame.CenterX - y + connector.Frame.CenterY;
float yy = x - connector.Frame.CenterX + connector.Frame.CenterY;
// يحدد عرض المكون الأفقي باستخدام قيمة نقطة التعديل الثانية
float width = connector.Height * adjValue_1.RawValue / 100000;
IAutoShape shape = sld.Shapes.AddAutoShape(ShapeType.Rectangle, xx, yy, width, 0);
shape.LineFormat.FillFormat.FillType = FillType.Solid;
shape.LineFormat.FillFormat.SolidFillColor.Color = Color.Red;

النتيجة:

connector-adjusted-4

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

العثور على زاوية خطوط الموصل

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

هذا الكود C# يظهر عملية حيث قمنا بحساب الزاوية لشكل خط موصل:

public static void Run()
{
    Presentation pres = new Presentation("ConnectorLineAngle.pptx");
    Slide slide = (Slide)pres.Slides[0];
    Shape shape;
    for (int i = 0; i < slide.Shapes.Count; i++)
    {
        double dir = 0.0;
        shape = (Shape)slide.Shapes[i];
        if (shape is AutoShape)
        {
            AutoShape ashp = (AutoShape)shape;
            if (ashp.ShapeType == ShapeType.Line)
            {
                dir = getDirection(ashp.Width, ashp.Height, Convert.ToBoolean(ashp.Frame.FlipH), Convert.ToBoolean(ashp.Frame.FlipV));
            }
        }
        else if (shape is Connector)
        {
            Connector ashp = (Connector)shape;
            dir = getDirection(ashp.Width, ashp.Height, Convert.ToBoolean(ashp.Frame.FlipH), Convert.ToBoolean(ashp.Frame.FlipV));
        }

        Console.WriteLine(dir);
    }

}
public static double getDirection(float w, float h, bool flipH, bool flipV)
{
    float endLineX = w * (flipH ? -1 : 1);
    float endLineY = h * (flipV ? -1 : 1);
    float endYAxisX = 0;
    float endYAxisY = h;
    double angle = (Math.Atan2(endYAxisY, endYAxisX) - Math.Atan2(endLineY, endLineX));
    if (angle < 0) angle += 2 * Math.PI;
    return angle * 180.0 / Math.PI;
}

شكل مخصص