モジュール java.desktop
パッケージ javax.print

クラスServiceUIFactory

  • public abstract class ServiceUIFactory
extends Object
    サービスは、オプションでUIを提供することができます。 UIを使用すると、ロールごとに異なるスタイルの対話処理を実行できます。 あるロールではエンド・ユーザーによるブラウズおよび印刷オプションの設定を行い、別のロールでは印刷サービスの管理を行うことができます。

    現在のところ、Print Service APIは印刷サービス管理の標準化されたサポートを提供していませんが、印刷サービスの監視、およびUIを利用した非公開の更新メカニズムを提供可能です。

    基本的な設計目的は、必要な場合にだけ、APIに依存しない方法で(使用環境を除く)、アプリケーションからのサービスの遅延検出および初期化を実行可能にすることです。

    Swing UIはより一貫したL&Fを提供し、Accessibility APIをサポート可能であるため、Swing UIの使用をお薦めします。

    使用例: 

      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
      UIがAWTダイアログとして実装されていることを示します。
      static String JCOMPONENT_UI
      UIがSwingコンポーネントとして実装されていることを示します。
      static String JDIALOG_UI
      UIがSwingダイアログとして実装されていることを示します。
      static int MAIN_UIROLE
      通常のエンドユーザー・ロールを実行するUIであることを示します。
      static String PANEL_UI
      UIがAWTパネルとして実装されていることを示します。
      static int RESERVED_UIROLE
      有効なロールではなく、これよりも値の大きなロールIDを、サービスのサポートする非公開ロールで使用できます。

    • コンストラクタのサマリー

      コンストラクタ 
      コンストラクタ 説明
      ServiceUIFactory()  

    • メソッドのサマリー

      修飾子と型 メソッド 説明
      abstract Object getUI​(int role, String ui)
      アプリケーションにより要求されるUIタイプにキャスト可能で、そのユーザー・インタフェースで使用可能なUIオブジェクトを取得します。
      abstract String[] getUIClassNamesForRole​(int role)
      このファクトリから取得したUIロールを指定すると、このロールを実装するこのファクトリから利用可能なUIタイプが取得されます。

    • フィールドの詳細

      • JCOMPONENT_UI

        public static final String JCOMPONENT_UI
        UIがSwingコンポーネントとして実装されていることを示します。 文字列の値は完全修飾クラス名です : "javax.swing.JComponent"。
        関連項目:
        定数フィールド値

      • PANEL_UI

        public static final String PANEL_UI
        UIがAWTパネルとして実装されていることを示します。 文字列の値は完全修飾クラス名です : "java.awt.Panel"
        関連項目:
        定数フィールド値

      • DIALOG_UI

        public static final String DIALOG_UI
        UIがAWTダイアログとして実装されていることを示します。 文字列の値は完全修飾クラス名です : "java.awt.Dialog"
        関連項目:
        定数フィールド値

      • JDIALOG_UI

        public static final String JDIALOG_UI
        UIがSwingダイアログとして実装されていることを示します。 文字列の値は完全修飾クラス名です : "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 - ロールまたはUIが、標準ロールのどれでもなく、ファクトリがサポートする非公開ロールでもない場合

      • getUIClassNamesForRole

        public abstract String[] getUIClassNamesForRole​(int role)
        このファクトリから取得したUIロールを指定すると、このロールを実装するこのファクトリから利用可能なUIタイプが取得されます。 返されるStringsは、このクラスで定義された静的変数を参照する必要があります。これにより、アプリケーションは、参照の等価性を使用できます。("==")。
        パラメータ:
        role - ルックアップ対象のロール
        戻り値:
        指定されたロールでこのクラスでサポートされているUIのタイプ、ロールで使用できるUIがない場合はnull
        例外:
        IllegalArgumentException - ロールが、このファクトリでサポートされていない非標準ロールの場合