العمل مع Cells GridWeb
الوصول إلى Cells في ورقة العمل
يناقش هذا الموضوع الخلايا ، ويبحث في الميزة الأساسية لـ GridWeb: الوصول إلى الخلايا.
تحتوي كل ورقة عمل على كائن GridCells ، وهو مجموعة من كائنات GridCell. يمثل كائن GridCell خلية في Aspose.Cells.GridWeb. من الممكن الوصول إلى أي خلية باستخدام GridWeb. هناك طريقتان مفضلتان:
أدناه ، تتم مناقشة كل نهج.
باستخدام Cell الاسم
جميع الخلايا لها اسم فريد. على سبيل المثال ، A1 ، A2 ، B1 ، B2 ، إلخ. Aspose.Cells.GridWeb يسمح للمطورين بالوصول إلى أي خلية مرغوبة باستخدام اسم الخلية. ما عليك سوى تمرير اسم الخلية (كمؤشر) إلى مجموعة GridCells من GridWorksheet.
استخدام فهارس الصفوف والعمود
يمكن أيضًا التعرف على الخلية من خلال موقعها من حيث فهارس الصفوف والأعمدة. ما عليك سوى تمرير فهارس الصفوف والأعمدة الخاصة بالخلية إلى مجموعة GridCells من GridWorksheet. هذا النهج أسرع من الأسلوب أعلاه.
الوصول إلى وتعديل قيمة Cell
الوصول إلى Cells في ورقة العمل ناقش الوصول إلى الخلايا. يوسع هذا الموضوع المناقشة لإظهار كيفية الوصول إلى قيم الخلايا وتعديلها باستخدام GridWeb API.
الوصول إلى قيمة Cell وتعديلها
قيم السلسلة
قبل الوصول إلى قيمة الخلية وتعديلها ، تحتاج إلى معرفة كيفية الوصول إلى الخلايا. للحصول على تفاصيل حول الأساليب المختلفة للوصول إلى الخلايا ، يرجى الرجوع إلىالوصول إلى Cells في ورقة العمل.
تحتوي كل خلية على خاصية تسمى getStringValue (). بمجرد الوصول إلى الخلية ، يمكن للمطورين الوصول إلى طريقة getStringValue () للوصول إلى قيمة سلسلة الخلايا.
جميع أنواع القيم
Aspose.Cells.GridWeb يوفر أيضًا طريقة خاصة ، putValue ، لكل خلية. باستخدام هذه الطريقة ، من الممكن إدراج أو تعديل أي نوع من القيم (Boolean و int و double و DateTime و string) في خلية.
هناك أيضًا نسخة محملة بشكل زائد من طريقة putValue يمكن أن تأخذ أي نوع من القيمة في تنسيق سلسلة وتحويلها إلى نوع بيانات مناسب تلقائيًا. لتحقيق ذلك ، مرر القيمة المنطقية “صواب” إلى معلمة أخرى لطريقة putValue كما هو موضح أدناه في المثال.
إضافة الصيغ إلى Cells
الميزة الأكثر قيمة التي يقدمها Aspose.Cells.GridWeb هي دعم الصيغ أو الوظائف. Aspose.Cells.GridWeb له Formula Engine الخاص به الذي يحسب الصيغ في أوراق العمل. Aspose.Cells.GridWeb يدعم كلا من الوظائف أو الصيغ المضمنة والمعرفة من قبل المستخدم. يناقش هذا الموضوع إضافة الصيغ إلى الخلايا باستخدام Aspose.Cells.GridWeb API بالتفصيل.
كيف تضيف وتحسب صيغة؟
من الممكن إضافة الصيغ والوصول إليها وتعديلها في الخلايا باستخدام خاصية الصيغة للخلية. Aspose.Cells.GridWeb يدعم الصيغ المعرفة من قبل المستخدم والتي تتراوح من البسيط إلى المعقد. ومع ذلك ، يتم أيضًا توفير عدد كبير من الوظائف أو الصيغ المضمنة (على غرار Microsoft Excel) مع Aspose.Cells.GridWeb. للاطلاع على القائمة الكاملة للوظائف المضمنة ، يرجى الرجوع إلى هذاقائمة الوظائف المدعومة.
يجب أن يكون بناء جملة الصيغة متوافقًا مع بناء جملة Microsoft Excel. على سبيل المثال ، يجب أن تبدأ جميع الصيغ بعلامة يساوي (=).
لإضافة صيغة برمجيًا ، سيتعرف عليها Aspose.Cells.GridWeb كصيغة حتى إذا لم تستخدم علامة ** = ** ، ولكن إذا كان يجب على المستخدمين النهائيين الذين يعملون في واجهة المستخدم الرسومية استخدامها.
تمت إضافة الصيغة إلى خلية B3 ولكن لم يتم حسابها بواسطة GridWeb
في لقطة الشاشة أعلاه ، يمكنك أن ترى أنه تمت إضافة صيغة إلى B3 ولكن لم يتم حسابها بعد. لحساب جميع الصيغ ، قم باستدعاء أسلوب GridWorksheetCollection’s calculateFormula الخاص بعنصر التحكم GridWeb بعد إضافة الصيغ إلى أوراق العمل كما هو موضح أدناه.
يمكن للمستخدمين أيضًا حساب الصيغ بالنقر فوقيُقدِّم.
النقر فوق الزر إرسال من GridWeb
الأهمية : إذا قام المستخدم بالنقر فوقيحفظ أوالغاء التحميل الأزرار ، أو علامات تبويب الأوراق ، يتم حساب جميع الصيغ بواسطة GridWeb تلقائيًا.
نتيجة الصيغة بعد الحساب
الرجوع إلى Cells من أوراق العمل الأخرى
باستخدام Aspose.Cells.GridWeb ، من الممكن الإشارة إلى القيم المخزنة في أوراق عمل مختلفة في صيغها ، وإنشاء صيغ معقدة.
بناء الجملة للإشارة إلى قيمة خلية من ورقة عمل مختلفة هو اسم الورقة! اسم الخلية.
إنشاء التحقق من صحة البيانات في GridCell من GridWeb
Aspose.Cells.GridWeb يسمح لك بإضافة ملفاتتأكيد صحة البيانات باستخدام طريقة GridWorksheet.getValidations (). add (). باستخدام هذه الطريقة ، يجب عليك تحديدنطاق Cell . ولكن إذا كنت ترغب في إنشاء التحقق من صحة البيانات في GridCell واحدة ، فيمكنك القيام بذلك مباشرةً باستخدام طريقة GridCell.createValidation (). وبالمثل ، يمكنك إزالة ملفاتتأكيد صحة البيانات من GridCell باستخدام أسلوب GridCell.removeValidation ().
يقوم نموذج التعليمات البرمجية التالي بإنشاء ملفتأكيد صحة البيانات في الخلية B3. إذا أدخلت أي قيمة ليست بين 20 و 40 ، فستظهر الخلية B3خطئ في التحقق في شكلأحمر XXXX كما هو موضح في لقطة الشاشة هذه.
إنشاء أزرار أوامر مخصصة
Aspose.Cells.GridWeb يحتوي على أزرار خاصة مثل إرسال وحفظ وتراجع. كل هذه الأزرار تؤدي مهام محددة لـ Aspose.Cells.GridWeb. من الممكن أيضًا إضافة أزرار مخصصة تؤدي مهامًا مخصصة. يشرح هذا الموضوع كيفية استخدام هذه الميزة.
يوضح نموذج التعليمات البرمجية التالي كيفية إنشاء زر أمر مخصص وكيفية معالجة حدث النقر الخاص به. يمكنك استخدام أي رمز لزر الأمر المخصص الخاص بك. لغرض التوضيح ، استخدمنا أيقونة الصورة هذه.
كما ترى في لقطة الشاشة التالية ، عندما ينقر المستخدم على زر الأمر المخصص ، فإنه يضيف نصًا في الخلية A1 يقول**“تم النقر فوق زر الأمر المخصص الخاص بي."**
معالجة الحدث لزر الأمر المخصص
يشرح نموذج التعليمات البرمجية التالي كيفية تنفيذ معالجة الحدث لزر الأمر المخصص.
تنسيق الخلايا لـ GridWeb
سيناريوهات الاستخدام الممكنة
يدعم GridWeb الآن المستخدمين لإدخال بيانات الخلية بتنسيق النسبة المئوية مثل 3٪ وسيتم تنسيق البيانات الموجودة في الخلية تلقائيًا كـ 3.00٪. ومع ذلك ، سيتعين عليك تعيين نمط الخلية إلى تنسيق النسبة المئوية وهو إما GridTableItemStyle.NumberType a 9 أو 10. سيتم تنسيق الرقم 9 3٪ كـ 3٪ ولكن الرقم 10 سيتم تنسيقه 3٪ كـ 3.00٪.
أدخل Cell بيانات ورقة عمل GridWeb بتنسيق النسبة المئوية
يعين نموذج التعليمات البرمجية التالي الخلية A1 GridTableItemStyle.NumberType كـ 10 ، وبالتالي يتم تنسيق بيانات الإدخال 3٪ تلقائيًا كـ 3.00٪ كما هو موضح في لقطة الشاشة.
