chrome.printerProvider

תיאור

ה-API של chrome.printerProvider חושף את האירועים שמשמשים את מנהל ההדפסות למדפסות שנשלטות על ידי תוספים, כדי לשלוח שאילתות לגבי היכולות שלהן וכדי לשלוח משימות הדפסה למדפסות האלה.

הרשאות

printerProvider

זמינות

Chrome 44 ואילך

סוגים

PrinterInfo

תכונות

• תיאור

  מחרוזת אופציונלי

  תיאור קריא (לבני אדם) של המדפסת.

• id

  מחרוזת

  מזהה מדפסת ייחודי.

• name

  מחרוזת

  השם הקריא לאנשים של המדפסת.

PrintError

הוחזרו קודי שגיאה בתגובה לאירוע onPrintRequested.

טיפוסים בני מנייה (enum)

"אישור"
מציין שהפעולה הושלמה בהצלחה.

"FAILED"
מציין שהתרחש כשל כללי.

"INVALID_TICKET"
מציין שכרטיס ההדפסה לא חוקי. לדוגמה, הכרטיס לא תואם ליכולות מסוימות, או שהתוסף לא יכול לטפל בכל ההגדרות שבכרטיס.

"INVALID_DATA"
מציין שהמסמך לא חוקי. לדוגמה, ייתכן שהנתונים פגומים או שהפורמט לא תואם לתוסף.

PrintJob

תכונות

• contentType

  מחרוזת

  סוג התוכן של המסמך. הפורמטים הנתמכים הם "application/pdf" ו-"image/pwg-raster".

• מסמך

  כתם

  אובייקט שמכיל את נתוני המסמך להדפסה. הפורמט חייב להתאים לcontentType.

• printerId

  מחרוזת

  מזהה המדפסת שאמורה לטפל במשימה.

• פנייה

  אובייקט

  אפשר להדפיס כרטיס בפורמט CJT.

  ההפניה ל-CJT מסומנת כהוצאה משימוש. היא הוצאה משימוש עבור Google Cloud Print בלבד. היא לא הוצאה משימוש עבור הדפסה של ChromeOS.

• title

  מחרוזת

  השם של משימת ההדפסה.

אירועים

onGetCapabilityRequested

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

האירוע הופעל כשמנהל ההדפסה מבקש יכולות של מדפסת.

פרמטרים

• קריאה חוזרת (callback)

  פונקציה

  הפרמטר callback נראה כך:

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

  • printerId

    מחרוזת

  • resultCallback

    פונקציה

    הפרמטר resultCallback נראה כך:

    (capabilities: object)=>void

    • capabilities

      אובייקט

      יכולות המכשיר בפורמט CDD.

onGetPrintersRequested

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

האירוע מופעל כשמנהל ההדפסה מבקש מדפסות שסופקו על ידי תוספים.

פרמטרים

• קריאה חוזרת (callback)

  פונקציה

  הפרמטר callback נראה כך:

  (resultCallback: function)=>void

  • resultCallback

    פונקציה

    הפרמטר resultCallback נראה כך:

    (printerInfo: PrinterInfo[])=>void

    • printerInfo

      PrinterInfo[]

onGetUsbPrinterInfoRequested

Chrome 45 ואילך

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

האירוע הופעל כשמנהל ההדפסה מבקש מידע על התקן USB שעשוי להיות מדפסת.

הערה: אסור שאפליקציה תסתמך על כך שהאירוע הזה יופעל יותר מפעם אחת בכל מכשיר. אם יש תמיכה במכשיר מחובר, יש להחזיר אותו באירוע onGetPrintersRequested.

פרמטרים

• קריאה חוזרת (callback)

  פונקציה

  הפרמטר callback נראה כך:

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

  • מכשיר

    usb.Device

  • resultCallback

    פונקציה

    הפרמטר resultCallback נראה כך:

    (printerInfo?: PrinterInfo)=>void

    • printerInfo

      PrinterInfo אופציונלי

onPrintRequested

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

האירוע הופעל כשמנהל ההדפסות מבקש להדפיס.

פרמטרים

• קריאה חוזרת (callback)

  פונקציה

  הפרמטר callback נראה כך:

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

  • printJob

    PrintJob

  • resultCallback

    פונקציה

    הפרמטר resultCallback נראה כך:

    (result: PrintError)=>void

    • תוצאה אחת

      PrintError