- 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 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コンポーネントとして実装されていることを示します。 Stringの値は、完全指定されたクラス名"javax.swing.JComponent"になります。- 関連項目:
- 定数フィールド値
-
PANEL_UI
public static final String PANEL_UI
UIがAWTパネルとして実装されていることを示します。 Stringの値は、完全指定されたクラス名"java.awt.Panel"になります。- 関連項目:
- 定数フィールド値
-
DIALOG_UI
public static final String DIALOG_UI
UIがAWTダイアログとして実装されていることを示します。 Stringの値は、完全指定されたクラス名"java.awt.Dialog"になります。- 関連項目:
- 定数フィールド値
-
JDIALOG_UI
public static final String JDIALOG_UI
UIがSwingダイアログとして実装されていることを示します。 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を、サービスのサポートする非公開ロールで使用できます。 このロールを適切に使用するには、ロールが実行する関数に関する知識が必要です。- 関連項目:
- 定数フィールド値
-
-
メソッドの詳細
-
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タイプが取得されます。 返されるStringは、アプリケーションが"==" (参照が等しい)を使用できるようにするため、このクラス内で定義されるstatic変数を参照しなければいけません。- パラメータ:
role
- ルックアップ対象のロール。- 戻り値:
- 指定されたロールで、このクラスがサポートするUIタイプ。ロールで使用可能なUIが存在しない場合はnull。
- 例外:
IllegalArgumentException
- ロールが、このファクトリでサポートされていない非標準ロールの場合。
-
-