chrome.printerProvider

الوصف

تعرض واجهة برمجة التطبيقات chrome.printerProvider الأحداث التي يستخدمها مدير الطباعة للاستعلام عن الطابعات التي تتحكّم فيها الإضافات، والاستعلام عن إمكاناتها، وإرسال مهام الطباعة إلى هذه الطابعات.

الأذونات

printerProvider

مدى التوفّر

الإصدار 44 من Chrome أو الإصدارات الأحدث

الأنواع

PrinterInfo

أماكن إقامة

  • الوصف

    سلسلة اختيارية

    وصف الطابعة سهل القراءة للمستخدم

  • id

    سلسلة

    معرّف الطابعة الفريد.

  • الاسم

    سلسلة

    تمثّل هذه السمة اسم الطابعة ويمكن قراءته.

PrintError

تم عرض رموز خطأ استجابةً لحدث onPrintRequested.

Enum

"حسنًا"
يحدد هذا الإعداد أن العملية قد اكتملت بنجاح.

"تعذّر"
يحدد هذا الإعداد حدوث خطأ عام.

"DE_TICKET"
يحدد هذا الخيار أنّ تذكرة الطباعة غير صالحة. على سبيل المثال، لا يتوافق طلب الدعم مع بعض الإمكانات، أو لا يمكن للإضافة معالجة جميع الإعدادات من التذكرة.

"CREDIT_DATA"
تحدد أنّ المستند غير صالح. على سبيل المثال، قد تكون البيانات تالفة أو التنسيق غير متوافق مع الإضافة.

PrintJob

أماكن إقامة

  • contentType

    سلسلة

    نوع محتوى المستند. التنسيقات المتوافقة هي "application/pdf" و"image/pwg-raster".

  • مستند

    بلوب

    كمية كبيرة تحتوي على بيانات المستند المراد طباعتها يجب أن يتطابق التنسيق مع "contentType".

  • printerId

    سلسلة

    معرّف الطابعة التي من المفترض أن تعالج المهمة.

  • طلب دعم

    كائن

    اطبع طلب الدعم بتنسيق CJT.

    تم وضع علامة على مرجع CJT على أنّه متوقّف. وقد تم إيقافها نهائيًا لخدمة "الطباعة السحابية من Google". لن يتم إيقافها نهائيًا للطباعة في نظام التشغيل ChromeOS.

  • title

    سلسلة

    تمثّل هذه السمة عنوان مهمة الطباعة.

فعاليات

onGetCapabilityRequested

chrome.printerProvider.onGetCapabilityRequested.addListener(
  callback: function,
)

يتم تنشيط الحدث عندما يطلب مدير الطباعة إمكانات الطابعة.

المعلمات

  • رد الاتصال

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    (printerId: string, resultCallback: function) => void

    • printerId

      سلسلة

    • resultCallback

      دالة

      تظهر المَعلمة resultCallback على النحو التالي: 

      (capabilities: object) => void

onGetPrintersRequested

chrome.printerProvider.onGetPrintersRequested.addListener(
  callback: function,
)

تم تنشيط الحدث عندما يطلب مدير الطباعة الطابعات التي توفِّرها الإضافات.

المعلمات

  • رد الاتصال

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    (resultCallback: function) => void

    • resultCallback

      دالة

      تظهر المَعلمة resultCallback على النحو التالي: 

      (printerInfo: PrinterInfo[]) => void

onGetUsbPrinterInfoRequested

الإصدار 45 من Chrome أو الإصدارات الأحدث 
chrome.printerProvider.onGetUsbPrinterInfoRequested.addListener(
  callback: function,
)

يتم تنشيط الحدث عندما يطلب مدير الطباعة معلومات عن جهاز USB قد يكون طابعة.

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

المعلمات

  • رد الاتصال

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    (device: usb.Device, resultCallback: function) => void

    • جهاز

      usb.Device

    • resultCallback

      دالة

      تظهر المَعلمة resultCallback على النحو التالي: 

      (printerInfo?: PrinterInfo) => void

onPrintRequested

chrome.printerProvider.onPrintRequested.addListener(
  callback: function,
)

تم تنشيط الحدث عندما يطلب مدير الطباعة الطباعة.

المعلمات

  • رد الاتصال

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    (printJob: PrintJob, resultCallback: function) => void

    • printJob

      PrintJob

    • resultCallback

      دالة

      تظهر المَعلمة resultCallback على النحو التالي: 

      (result: PrintError) => void