javax.print
類別 ServiceUIFactory

java.lang.Object
  javax.print.ServiceUIFactory

public abstract class ServiceUIFactory
extends Object

服務可以可選地提供 UI，這些 UI 允許以不同的角色進行不同樣式的交互。一種角色可以是瀏覽並設置列印選項的終端使用者。另一種角色可以是管理 PrintService。

雖然 PrintService API 目前不提供對管理 PrintService 的標準化支持，但是可以監視 PrintService 並且可以為專用的更新機制提供 UI。

基本的設計目的是允許應用程序僅在需要時以延遲方式尋找並初始化服務，而不依賴任何 API（但使用 API 的環境除外）。

首選使用 Swing UI，因為它提供了更為一致的 L&F 並且可支持可存取性 API。

用例：

  ServiceUIFactory factory = printService.getServiceUIFactory();
  if (factory != null) {
      JComponent swingui = (JComponent)factory.getUI(
                                         ServiceUIFactory.MAIN_UIROLE,
                                         ServiceUIFactory.JCOMPONENT_UI);
      if (swingui != null) {
          tabbedpane.add("Custom UI", swingui);
      }
  }
 

欄位摘要

static int	ABOUT_UIROLE 表示一個充當提供 "About" 資訊角色的 UI。
static int	ADMIN_UIROLE 表示一個充當管理角色的 UI。
static String	DIALOG_UI 表示一個作為 AWT 對話框實作的 UI。
static String	JCOMPONENT_UI 表示一個作為 Swing 元件實作的 UI。
static String	JDIALOG_UI 表示一個作為 Swing 對話框實作的 UI。
static int	MAIN_UIROLE 表示一個充當普通終端使用者角色的 UI。
static String	PANEL_UI 表示一個作為 AWT 面板實作的 UI。
static int	RESERVED_UIROLE 不是有效的角色，但是可將大於此的角色 ID 用於服務支持的專用角色。

建構子摘要

ServiceUIFactory()

方法摘要

abstract Object	getUI(int role, String ui) 獲得一個 UI 物件，它可能被應用程序強制轉換為所請求的 UI 型別並在該應用程序的使用者介面中使用。
abstract String[]	getUIClassNamesForRole(int role) 給定從此處理器獲取的 UI 角色，獲取實作此角色的此處理器可提供的 UI 型別。

從類別 java.lang.Object 繼承的方法

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

欄位詳細資訊

JCOMPONENT_UI

public static final String JCOMPONENT_UI

表示一個作為 Swing 元件實作的 UI。String 的值是完全限定類別名："javax.swing.JComponent"。

另請參見：

常數欄位值

PANEL_UI

public static final String PANEL_UI

表示一個作為 AWT 面板實作的 UI。String 的值是完全限定類別名："java.awt.Panel"。

另請參見：

常數欄位值

DIALOG_UI

public static final String DIALOG_UI

表示一個作為 AWT 對話框實作的 UI。String 的值是完全限定類別名："java.awt.Dialog"。

另請參見：

常數欄位值

JDIALOG_UI

public static final String JDIALOG_UI

表示一個作為 Swing 對話框實作的 UI。String 的值是完全限定類別名："javax.swing.JDialog"。

另請參見：

常數欄位值

ABOUT_UIROLE

public static final int ABOUT_UIROLE

表示一個充當提供 "About" 資訊角色的 UI。

另請參見：

常數欄位值

ADMIN_UIROLE

public static final int ADMIN_UIROLE

表示一個充當管理角色的 UI。

另請參見：

常數欄位值

MAIN_UIROLE

public static final int MAIN_UIROLE

表示一個充當普通終端使用者角色的 UI。

另請參見：

常數欄位值

RESERVED_UIROLE

public static final int RESERVED_UIROLE

不是有效的角色，但是可將大於此的角色 ID 用於服務支持的專用角色。要正確使用它，需要知道此角色所執行的功能。

另請參見：

常數欄位值

建構子詳細資訊

ServiceUIFactory

public ServiceUIFactory()

方法詳細資訊

getUI

public abstract Object getUI(int role,
                             String ui)

獲得一個 UI 物件，它可能被應用程序強制轉換為所請求的 UI 型別並在該應用程序的使用者介面中使用。

參數：

role - 所請求的角色。必須是此處理器支持的標準角色或某個專用角色。

ui - 所請求的角色的型別。

返回：

UI 角色，如果此處理器不提供所請求的 UI 角色，則返回 null

拋出：

IllegalArgumentException - 如果 role 或 ui 既不是標準的角色或 UI，也不是該處理器支持的專用角色或 UI。

getUIClassNamesForRole

public abstract String[] getUIClassNamesForRole(int role)

給定從此處理器獲取的 UI 角色，獲取實作此角色的此處理器可提供的 UI 型別。返回的 String 應該參考此類別中定義的靜態變數，這樣應用程序可以使用參考相等性 ("==")。

參數：

role - 要被尋找的角色。

返回：

此類別為指定角色所支持的 UI 型別，如果沒有用於此角色的 UI，則返回 null。

拋出：

IllegalArgumentException - 如果該 role 是非標準的角色，或者此處理器不支持該 role。