クラスServiceUIFactory

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

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

    コンストラクタ
    修飾子
    コンストラクタ
    説明
    protected
    ServiceUIFactory()
    サブクラスが呼び出すためのコンストラクタ。

  • メソッドのサマリー

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

    クラスオブジェクトで宣言されたメソッド

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    修飾子と型
    メソッド
    説明
    protected Object
    clone()
    このオブジェクトのコピーを作成して、返します。
    boolean
    equals(Object obj)
    このオブジェクトと他のオブジェクトが等しいかどうかを示します。
    protected void
    finalize()
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    最終決定は非推奨であり、将来のリリースで削除される可能性があります。
    final Class<?>
    getClass()
    このObjectの実行時クラスを返します。
    int
    hashCode()
    このオブジェクトに対するハッシュ・コード値を返します。
    final void
    notify()
    このオブジェクトのモニターで待機中のスレッドを1つ再開します。
    final void
    notifyAll()
    このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
    String
    toString()
    オブジェクトの文字列表現を返します。
    final void
    wait()
    現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
    final void
    wait(long timeoutMillis)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
    final void
    wait(long timeoutMillis, int nanos)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

  • フィールド詳細

    • 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

      protected 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 - ロールが、このファクトリでサポートされていない非標準ロールの場合