إدارة الضوابط
مقدمة
يمكن للمطورين إضافة أجسام رسم مختلفة مثل صناديق النص، صناديق الاختيار، أزرار الراديو، صناديق الاختيار المتعدد، تسميات الأزرار، الخطوط، المستطيلات، الأقواس، البيضاويات، الدوارات، شرائط التمرير، صور المجموعات الخ. Aspose.Cells توفر مساحة اسم Aspose.Cells.Drawing التي تحتوي على جميع أجسام الرسم. ومع ذلك، هناك بعض أجسام الرسم أو الأشكال التي لم يتم دعمها بعد. أنشئ هذه الأجسام الرسم في ورقة عمل مصممة باستخدام Microsoft Excel ثم استوردها إلى Aspose.Cells. تتيح لك Aspose.Cells تحميل هذه الأجسام الرسم من ورقة عمل مصممة وكتابتها إلى ملف مولد.
إضافة عنصر تحكم مربع النص إلى الورقة
طريقة واحدة لتحديد المعلومات الهامة في تقرير هي استخدام مربع نص. على سبيل المثال، إضافة نص لتسليط الضوء على اسم الشركة أو للإشارة إلى المنطقة الجغرافية ذات أعلى مبيعات الخ. Aspose.Cells توفر فئة TextBoxes، المستخدمة لإضافة مربع نص جديد إلى المجموعة. هناك فئة أخرى، TextBox، التي تمثل مربعًا نصيًا يستخدم لتحديد جميع أنواع الإعدادات. لديها بعض الأعضاء المهمة:
- تقوم الطريقة getTextFrame بإرجاع كائن MsoTextFrame المستخدم لتعديل محتويات مربع النص.
- تقوم الطريقة setPlacement بتحديد نوع الوضع.
- تقوم الطريقة setFont بتحديد سمات الخط.
- الطريقة addHyperlink تضيف ارتباطًا تشعبيًا لصندوق النص.
- تُعيد خاصية FillFormat كائن MsoFillFormat المستخدم لضبط تنسيق ملء مربع النص.
- تُعيد الخاصية LineFormat كائن MsoLineFormat المستخدم عادة لتنسيق ووزن خط مربع النص.
- تحدد الطريقة setText النص المدخل لمربع النص.
المثال التالي ينشئ مربعي نص في الورقة العمل الأولى من الدفتر. المربع النص الأول مؤثث جيدًا بإعدادات تنسيق مختلفة. الثاني بسيط.
الناتج التالي تم إنشاؤه بتنفيذ الكود:
تم إنشاء مربعي نص في الورقة العمل
التلاعب بضوابط مربع النص في جداول البيانات المصممة
تتيح Aspose.Cells أيضًا لك الوصول إلى مربعات النص في جداول البيانات المصممة والتلاعب بها. استخدم الخاصية Worksheet.getTextBoxes للحصول على مجموعة مربعات النص في الورقة.
المثال التالي يستخدم ملف Microsoft Excel – tsttextboxes.xls – الذي أنشأناه في المثال السابق. يحصل على السلاسل النصية للمربعي نص ويغير نص المربع النصي الثاني لحفظ الملف.
إضافة تحكم مربع الاختيار إلى الورقة العمل
تكون مربعات الاختيار مفيدة إذا كنت ترغب في توفير طريقة للمستخدم لاختيار بين خيارين، مثل صحيح أو خطأ؛ نعم أو لا. تسمح Aspose.Cells لك باستخدام مربعات الاختيار في جداول البيانات. على سبيل المثال، قد تكون قد وضعت ورقة عمل للتنبؤ المالي يمكنك فيها إما أن تأخذ في الاعتبار استحواذ معين أو لا. في هذه الحالة، قد ترغب في وضع مربع اختيار في أعلى الورقة. يمكنك بعد ذلك ربط حالة هذا المربع بخلية أخرى، بحيث إذا تم تحديده، يكون قيمة الخلية صحيحة؛ إذا لم يتم تحديده، تكون قيمة الخلية خاطئة.
استخدام Microsoft Excel
لوضع تحكم مربع الاختيار في ورقة العمل الخاصة بك، اتبع هذه الخطوات:
- تأكد من عرض شريط الأدوات النماذج.
- انقر على أداة مربع اختيار في شريط الأدوات النماذج.
- في منطقة ورقة العمل الخاصة بك، انقر واسحب لتحديد المستطيل الذي سيحتوي على مربع الاختيار والتسمية بجانب مربع الاختيار.
- بمجرد وضع مربع الاختيار، قم بتحريك مؤشر الماوس إلى منطقة التسمية وقم بتغيير التسمية.
- في حقل رابط الخلية، حدد عنوان الخلية التي يجب ربط مربع الاختيار بها.
- انقر فوق موافق.
استخدام Aspose.Cells
توفر Aspose.Cells الفئة CheckBoxCollection ، التي تُستخدم لإضافة مربع اختيار جديد إلى المجموعة. هناك فئة أخرى ، Aspose.Cells.Drawing.CheckBox ، التي تمثل مربع اختيار. لديها بعض الأعضاء المهمين:
- تحدد الطريقة setLinkedCell خلية مرتبطة بمربع الاختيار.
- تحدد الطريقة setText النص المرتبط بمربع الاختيار. إنها تسمية مربع الاختيار.
- تحدد الطريقة setValue ما إذا كان مربع الاختيار محددًا أم لا.
يُظهر المثال التالي كيفية إضافة مربع اختيار إلى ورقة العمل. يتم توليد الناتج أدناه بعد تنفيذ الكود.
تمت إضافة مربع اختيار في ورقة العمل
إضافة عنصر تحكم RadioButton إلى ورقة العمل
زر الراديو أو زر الخيار هو عنصر تحكم مكون من صندوق مستدير. يقوم المستخدم باتخاذ قراره عن طريق تحديد مربع المستدير. يتم عادةً ، إذا لم يكن دائمًا ، خيار زر الراديو مصحوبًا بآخرين. يظهر زر الراديو ويتصرف كمجموعة. يقرر المستخدم أي زر صالح عن طريق تحديد واحد فقط منها. عندما ينقر المستخدم على زر واحد ، يتم ملؤه. عند تحديد زر واحد في المجموعة ، تكون أزرار نفس المجموعة فارغة.
استخدام Microsoft Excel
لوضع عنصر تحكم زر الراديو في ورقتك العمل ، اتبع هذه الخطوات:
- تأكد من عرض شريط الأدوات النماذج.
- انقر على أداة Button الخيار.
- في ورقة العمل ، انقر واسحب لتحديد المستطيل الذي سيحتوي على زر الخيار والتسمية بجانب زر الخيار.
- بمجرد وضع زر الراديو في ورقة العمل ، قم بتحريك مؤشر الماوس إلى منطقة التسمية وقم بتغيير التسمية.
- في حقل رابط الخلية ، حدد عنوان الخلية التي يجب أن يكون مرتبطًا بها زر الراديو هذا.
- انقر على موافق.
استخدام Aspose.Cells
توفر الفئة ShapeCollection طريقة بإسم addShape التي يمكن استخدامها لإضافة عنصر تحكم زر الراديو إلى ورقة عمل. قد تعيد الطريقة كائن RadioButton. تمثل فئة RadioButton زر اختيار. لديها بعض الأعضاء المهمين:
- تحدد طريقة setLinkedCell الخلية المرتبطة بزر الراديو.
- تحدد طريقة setText سلسلة النص المرتبطة بزر الراديو. إنها تسمية زر الراديو.
- يحدد خاصية Checked ما إذا كان زر الراديو محددًا أم لا.
- تحدد طريقة setFillFormat تنسيق ملء زر الراديو.
- تحدد طريقة setLineFormat أساليب تنسيق الخط لزر الاختيار.
المثال التالي يوضح كيفية إضافة أزرار راديو إلى ورقة العمل. يضيف المثال ثلاثة أزرار راديو تمثل مجموعات عمر. سيتم إنشاء الناتج التالي بعد تنفيذ الكود.
تمت إضافة بعض أزرار الراديو في ورقة العمل
إضافة عنصر تحكم مربع القائمة المنسدلة إلى ورقة العمل
لتسهيل إدخال البيانات، أو لتقييد الإدخالات إلى بعض العناصر التي تعرفها، يمكنك إنشاء مربع قائمة منسدلة، أو قائمة منسدلة للإدخالات الصحيحة التي تتم تجميعها من خلايا في مكان آخر على ورقة العمل. عند إنشاء قائمة منسدلة لخلية، تظهر سهم بجانب تلك الخلية. لإدخال معلومات في تلك الخلية، انقر على السهم، ثم انقر على الإدخال الذي تريده.
استخدام Microsoft Excel
لوضع عنصر تحكم مربع الجمع في ورقة العمل الخاصة بك، اتبع هذه الخطوات:
- تأكد من عرض شريط الأدوات النماذج.
- انقر على أداة مربع الجمع.
- في منطقة ورقة العمل الخاصة بك، انقر واسحب لتعريف المستطيل الذي سيحمل مربع الجمع.
- بمجرد أن يتم وضع مربع الجمع في ورقة العمل، انقر بزر الماوس الأيمن على عنصر التحكم ثم انقر على تنسيق التحكم وحدد نطاق الإدخال.
- في حقل ارتباط الخلية، حدد عنوان الخلية التي يجب ربطها بهذا مربع الجمع.
- انقر فوق موافق.
استخدام Aspose.Cells
توفر فئة ShapeCollection طريقة تسمى addShape، والتي يمكن استخدامها لإضافة عنصر تحكم مربع اختيارات إلى ورقة العمل. يمكن أن تعيد الطريقة كائن ComboBox. تمثل فئة ComboBox مربع اختيارات. لها بعض الأعضاء الهامة:
تحدد طريقة setLinkedCell خلية مرتبطة بمربع الاختيار. تحدد طريقة setInputRange نطاق الخلايا في ورقة العمل المستخدمة لملء مربع الاختيار.
- يُحدد الأسلوب setDropDownLines عدد الخطوط المعروضة في جزء القائمة المنسدلة من مربع الأدوات المشترك.
- يُشير الأسلوب setShadow ما إذا كان مربع الأدوات المشترك له تظليل ثلاثي الأبعاد.
يظهر المثال التالي كيفية إضافة مربع أدوات مشترك إلى ورقة العمل. يتم إنشاء الناتج التالي عند تنفيذ الكود.
تمت إضافة مربع أدوات مشترك في ورقة العمل
إضافة عنصر تحكم تسمية إلى ورقة العمل
التسميات هي وسيلة لتزويد المستخدمين بمعلومات حول محتويات جدول بيانات. Aspose.Cells يجعل من الممكن إضافة وتلاعب بالتسميات في ورقة العمل. يوفر الفصيلة ShapeCollection طريقة تُسمى addShape ، مستخدمة لإضافة تحكم Label إلى ورقة العمل. يُعيد الأسلوب كائن Label. الفئة Label تُمثل تسمية في ورقة العمل. لديها بعض الأعضاء المهمة:
- يُحدد الأسلوب setText سلسلة التسمية الخاصة.
- يُحدد الأسلوب setPlacement PlacementType ، الطريقة التي تكون بها التسمية مرتبطة بالخلايا في ورقة العمل.
يظهر المثال التالي كيفية إضافة تسمية إلى ورقة العمل. يتم إنشاء الناتج التالي عند تنفيذ الكود.
تمت إضافة تسمية في ورقة العمل
إضافة عنصر تحكم مربع القائمة إلى ورقة العمل
ينشئ عنصر تحكم مربع القائمة عنصر تحكم يسمح باختيار عنصر واحد أو عدة عناصر.
استخدام Microsoft Excel
لوضع عنصر تحكم مربع القائمة في ورقة العمل:
- تأكد من عرض شريط الأدوات النماذج.
- انقر على أداة مربع القائمة.
- في منطقة ورقة العمل الخاصة بك، انقر واسحب لتعريف المستطيل الذي سيحتوي على مربع القائمة.
- بمجرد وضع مربع القائمة في ورقة العمل، انقر بزر الماوس الأيمن على العنصر التحكم للنقر فوق تنسيق العنصر التحكم وتحديد نطاق الإدخال.
- في حقل رابط الخلية، حدد عنوان الخلية التي يجب أن يكون مربع القائمة مرتبطًا بها وتعيين نوع الاختيار (فردي، متعدد، توسيع) السمة
- انقر على موافق.
استخدام Aspose.Cells
توفر فئة ShapeCollection طريقة تسمى addShape ، التي تُستخدم لإضافة عنصر تحكم لمربع القائمة إلى ورقة العمل. تُرجع الطريقة كائن ListBox. فئة ListBox تمثل مربع القائمة. لديها بعض الأعضاء الهامة:
- تحدد الطريقة setLinkedCell الخلية المرتبطة بمربع القائمة.
- تحدد الطريقة setInputRange مجموعة الخلايا في ورقة العمل المستخدمة لملء مربع القائمة.
- تحدد الطريقة setSelectionType وضعية التحديد لمربع القائمة.
- تشير الطريقة setShadow ما إذا كان مربع القائمة له تظليل ثلاثي الأبعاد.
المثال التالي يوضح كيفية إضافة مربع قوائم إلى ورقة العمل. يتم توليد الإخراج التالي عند تنفيذ الكود.
تمت إضافة مربع القائمة في ورقة العمل
إضافة عنصر تحكم زر إلى ورقة العمل
الأزرار مفيدة للقيام ببعض الإجراءات. في بعض الأحيان، من المفيد تعيين ماكرو VBA للزر أو تعيين ارتباط تشعبي لفتح صفحة ويب.
استخدام Microsoft Excel
لوضع عنصر تحكم زر في ورقة العمل الخاصة بك:
- تأكد من عرض شريط الأدوات النماذج.
- انقر على أداة الزر.
- في منطقة ورقة العمل الخاصة بك، انقر واسحب لتعريف المستطيل الذي سيحتوي على الزر.
- بمجرد وضع مربع القائمة في ورقة العمل، انقر بزر الماوس الأيمن على العنصر التحكم واختر تنسيق العنصر التحكم، ثم حدد ماكرو VBA وسمات تتعلق بالخط، التوضيب، الحجم، الهامش وما إلى ذلك.
- انقر فوق موافق.
استخدام Aspose.Cells
توفر فئة ShapeCollection طريقة تسمى addShape، المستخدمة لإضافة عنصر تحكم زر إلى ورقة العمل. قد تُرجع الطريقة كائن Button. فئة Button تمثل زراً. لديها بعض الأعضاء الهامة:
- تحدد الطريقة setText تسمية الزر.
- تحدد طريقة setPlacement PlacementType التي يتم بها ربط الزر بالخلايا في ورقة العمل.
- يضيف الطريقة addHyperlink ارتباطًا للزر التحكم. النقر على الزر سيتصفح إلى عنوان URL ذي صلة.
المثال التالي يوضح كيفية إضافة زر إلى ورقة العمل. يتم إنشاء الإخراج التالي عند تنفيذ الكود
تمت إضافة زر في ورقة العمل
إضافة أداة تحكم خطية إلى ورقة العمل
يسمح Aspose.Cells لك برسم الأشكال التلقائية في ورقات العمل الخاصة بك. يمكنك إنشاء خط بسهولة. كما يُسمح لك بتنسيق الخط. على سبيل المثال، يُمكنك تغيير لون الخط، وتحديد سمك ونمط الخط حسب احتياجاتك.
استخدام Microsoft Excel
- على شريط الأدوات الرسم، انقر على أشكال تلقائية, اشير إلى الخطوط, واختر نمط الخط الذي تريده.
- اسحب لرسم الخط.
- قم بإحدى الخطوتين أو كليهما:
- لتقييد رسم الخط لزوايا 15 درجة من نقطته الأولى، اضغط باستمرار على SHIFT أثناء السحب.
- لتمديد الخط في اتجاهين معاكسين من نقطة النهاية الأولى، اضغط باستمرار على CTRL أثناء السحب.
استخدام Aspose.Cells
يوفر الفئة ShapeCollection طريقة تُسمى addShape، التي يتم استخدامها لإضافة شكل خطي إلى ورقة العمل. قد تُرجع الطريقة كائن LineShape. تُمثل فئة LineShape خطًا. لديها بعض الأعضاء الهامة:
- تحدد طريقة setDashStyle تنسيق الخط.
- تحدد طريقة setPlacement PlacementType التي يتم بها ربط الخط بالخلايا في ورقة العمل.
المثال التالي يوضح كيفية إضافة خطوط إلى ورقة العمل. يتم إنشاء ثلاثة خطوط بأنماط مختلفة. يتم إنشاء الإخراج التالي بعد تنفيذ الكود
تمت إضافة عدة خطوط في ورقة العمل
إضافة زاوية مؤشر إلى خط
تسمح Aspose.Cells أيضًا برسم خطوط سهم. من الممكن إضافة رأس سهم إلى خط وتنسيق الخط. على سبيل المثال، يمكنك تغيير لون الخط أو تحديد وزن ونمط الخط.
المثال التالي يوضح كيفية إضافة رأس سهم إلى خط. يتم توليد الناتج التالي عند تنفيذ الكود.
يتم إضافة خط ذو رأس سهم في الورقة العمل
إضافة تحكم مستطيل إلى ورقة عمل
تسمح Aspose.Cells لك برسم أشكال مستطيلة في ورقة عملك. قد تقوم بإنشاء مستطيل، مربع وما إلى ذلك. كما يُسمح لك بتنسيق لون الملء ولون خط الحدود للتحكم. على سبيل المثال، يمكنك تغيير لون المستطيل، تحديد لون التظليل، تحديد وزن ونمط المستطيل حسب احتياجاتك.
استخدام Microsoft Excel
- في شريط الرسم، انقر فوق المستطيل.
- اسحب لرسم المستطيل.
- قم بإحدى الخطوتين أو كليهما:
- للقيد في رسم المستطيل لرسم مربع من نقطته البداية، اضغط باستمرار على SHIFT أثناء السحب.
- لرسم مستطيل من نقطة مركزية، اضغط باستمرار على CTRL أثناء السحب.
استخدام Aspose.Cells
يقدم الطبقة ShapeCollection طريقة مسماة addShape، والتي تُستخدم لإضافة شكل مستطيل إلى ورقة العمل. يمكن للطريقة أن ترجع كائن RectangleShape. تمثل الطبقة RectangleShape مستطيلًا. لديها بعض الأعضاء المهمة:
- يحدد الطريقة setLineFormat سمات تنسيق الخط لمستطيل.
- تحدد الطريقة setPlacement نوع الوضع، والطريقة التي يتم بها ربط المستطيل بالخلايا في ورقة العمل.
- تحدد خاصية FillFormat أنماط تنسيق التعبئة لمستطيل.
يوضح المثال التالي كيفية إضافة مستطيل إلى ورقة العمل. يتم توليد الناتج التالي عند تنفيذ الكود.
تمت إضافة مستطيل في الورقة العمل
إضافة تحكم بالقوس إلى ورقة العمل
تسمح Aspose.Cells لك برسم أشكال القوس في ورقة العمل الخاصة بك. يمكنك إنشاء أقواس بسيطة وممتلئة. يُسمح لك بتنسيق لون التعبئة ولون الخط الحدودي للتحكم. على سبيل المثال، يمكنك تحديد / تغيير لون القوس، تحديد لون الظلال، تحديد الوزن والنمط للشكل حسب احتياجك.
استخدام Microsoft Excel
- على شريط الأدوات الرسم، انقر على القوس في الأشكال التلقائية.
- اسحب لرسم القوس.
استخدام Aspose.Cells
تقدم فئة ShapeCollection طريقة تُسمى addShape، التي تُستخدم لإضافة شكل قوس إلى الورقة العمل. يمكن أن تُعيد الطريقة كائن ArcShape. تمثل فئة ArcShape قوسًا. لديها بعض الأعضاء المهمة:
- تحدد طريقة setLineFormat سمات تنسيق الخط لشكل القوس.
- تحدد طريقة setPlacement نوع الوضع، بالطريقة التي يتم بها ربط القوس بالخلايا في ورقة العمل.
- تحدد خصائص تنسيق التعبئة للشكل.
المثال التالي يوضح كيفية إضافة أشكال قوس إلى ورقة العمل. ينشئ المثال شكلي قوس: أحدهما ممتلئ والآخر بسيط. يتم إنشاء الناتج التالي عند تنفيذ الكود
تمت إضافة شكلين للقوس إلى ورقة العمل
إضافة تحكم بالشكل البيضوي إلى ورقة عمل
تسمح Aspose.Cells لك برسم أشكال بيضوية في ورقات العمل. يمكنك إنشاء أشكال بيضوية بسيطة وممتلئة وتنسيق لون التعبئة ولون الخط الحدودي للتحكم. على سبيل المثال، يمكنك تحديد / تغيير لون الشكل البيضوي، تحديد لون الظلال، تحديد الوزن والنمط للشكل حسب احتياجك.
استخدام Microsoft Excel
- على شريط الأدوات الرسم، انقر فوق بيضوي.
- اسحب لرسم البيضوي.
- قم بإحدى الخطوتين أو كليهما:
- للقيد البيضوي لرسم دائرة من نقطتها البدائية، اضغط باستمرار على SHIFT أثناء السحب.
- لرسم بيضوي من نقطة مركزية، اضغط باستمرار على CTRL أثناء السحب.
استخدام Aspose.Cells
توفر فئة ShapeCollection طريقة تُسمى addShape، التي تُستخدم لإضافة شكل بيضوي إلى ورقة العمل. قد تعيد الطريقة كائن Oval. تمثل فئة البيضوي Oval شكل بيضوي. لديها بعض الأعضاء المهمة:
- تحدد طريقة setLineFormat سمات تنسيق الخط لشكل بيضوي.
- تحدد طريقة الاقتران بين البيضاوية والخلايا في ورقة العمل.
- تحدد خصائص تنسيق التعبئة للشكل.
المثال التالي يوضح كيفية إضافة أشكال بيضاوية إلى ورقة العمل. ينشئ المثال شكلين بيضاويين: أحدهما بيضاوي مملوء والآخر دائرة بسيطة. يتم توليد الإخراج التالي عند تنفيذ الكود.
تمت إضافة شكلي بيضاوي في ورقة العمل.