تغيير عرض الأعمدة داخل نطاق|مستند

تقوم هذه الواجهة REST بتحديد عرض العمود لنطاق معين.

الأمان والمصادقة

واجهات Aspose.Cells Cloud API آمنة وتحتاج إلى مصادقة تعتمد على رمز JWT.

واجهة REST

POST http://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/ranges/columnWidth

المتطلبات المسبقة – قبل استدعاء نقطة النهاية، يجب أن تقوم بما يلي:

إنشاء حساب Aspose Cloud والحصول على مُعرّف العميل وسر العميل.
طلب رمز JWT من خلال استدعاء نقطة النهاية OAuth (/connect/token)؛ يُعاد الرمز في حقل access_token.
رفع ملف المصنف المستهدف إلى مساحة التخزين الخاصة بـ Aspose Cloud (أو التأكد من وجوده مسبقًا في المجلد المحدد).

معطيات الطلب هي:

اسم المعطى	النوع	الموقع	الوصف
name	نص	المسار	اسم ملف المصنف
sheetName	نص	المسار	اسم ورقة العمل
value	رقم	الاستعلام	القيمة المطلوبة لعرض العمود
range	كائن	الجسم	كائن النطاق الذي يُعرّف الخلايا المستهدفة
folder	نص	الاستعلام	مسار المجلد الذي يُخزّن فيه المصنف
storageName	نص	الاستعلام	اسم خدمة التخزين

يُعرّف مواصفات OpenAPI واجهة برمجة تطبيقات قابلة للوصول العام وتتيح لك إجراء تفاعلات REST مباشرة من متصفح الويب.

يمكنك استخدام أداة سطر الأوامر cURL للوصول بسهولة إلى خدمات Aspose.Cells عبر الويب. يوضح المثال التالي كيفية إجراء مكالمات لواجهة Cloud API باستخدام cURL.

الطلب

# استدعاء نقطة النهاية لعرض العمود لمصنف *test.xlsx*،
# ورقة العمل *Sheet1*، وضبط عرض الأعمدة المحددة على 20 نقطة.
curl -v "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/ranges/columnWidth?value=20" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>" \
  -d '{
        "ColumnCount": 7,
        "ColumnWidth": 19,
        "FirstColumn": 0,
        "FirstRow": 9,
        "Name": "string",
        "RefersTo": "string",
        "RowCount": 1,
        "RowHeight": 15,
        "Worksheet": "Sheet1"
      }'

الاستجابة

{
  "Code": 200,
  "Status": "OK"
}

ردود الأخطاء المحتملة

رمز HTTP	الوصف
400	طلب غير صالح – JSON أو معطيات غير صحيحة
401	غير مخوّل – نقص أو صلاحية رمز غير صحيحة
404	غير موجود – غياب المصنف أو ورقة العمل

عائلة SDK السحابية

استخدام SDK هو أفضل طريقة لتسريع عملية التطوير؛ حيث يتعامل SDK مع التفاصيل منخفضة المستوى، مما يمكّنك من التركيز على مهام مشروعك. يُرجى الاطلاع على مستودع GitHub للاطلاع على قائمة كاملة بـ SDKs الخاصة بـ Aspose.Cells Cloud.

تُظهر أمثلة الكود التالية كيفية استدعاء خدمات Aspose.Cells عبر SDKs مختلفة:

الأسئلة الشائعة

س: ما نقطة النهاية التي يجب استدعاؤها لضبط عرض عمود في نطاق داخل ملف Excel؟
ج: POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/ranges/columnWidth، حيث يُشير {name} إلى اسم ملف المصنف، و{sheetName} إلى ورقة العمل المستهدفة.

س: كيف أُصادق الطلب عند استخدام واجهة ضبط عرض الأعمدة؟
ج: تضمين رأس Authorization: Bearer <jwt token>؛ احصل على رمز JWT عبر تدفق OAuth لـ Aspose Cloud (/connect/token) باستخدام مُعرّف العميل وسر العميل.

س: ما محتوى JSON الذي يجب إرساله لتغيير عرض الأعمدة من A إلى C إلى 25 نقطة؟
ج:

{
  "FirstColumn": 0,
  "ColumnCount": 3,
  "FirstRow": 0,
  "RowCount": 1
}

أضف معطى الاستعلام value=25 إلى عنوان URL للطلب.