Windowsデスクトップ関連のプロパティのサポート
この機能は、次の2つの分野に関連します。
ユーザーの設定をさらに尊重する
Windowsプラットフォームでは、ユーザーは、デスクトップのポップアップ・メニューにある「プロパティ」オプション経由で、GUIをカスタマイズできます。Swingのルック・アンド・フィールがユーザーの視覚および動作の設定を正しく実装しているかを確認するために、システム・レジストリからUIプロパティの値を取得する必要があります。これらのプロパティの値は、java.awt.ToolkitのgetDesktopProperty()メソッドで検索可能です。
このメソッドでアクセス可能なプロパティのほとんどはWindowsプラットフォームに特有なプロパティであり、「win.」という接頭辞が付いています。サポートされるWindowsプロパティのリストは、「win.propNames」プロパティをプログラムで問い合わせて取得できます。
String propnames[] = (String[])Toolkit.getDefaultToolkit().getDesktopProperty("win.propNames");
System.out.println("Supported windows property names:");
for(int i = 0; i < propnames.length; i++) {
System.out.println(propnames[i]);
}
すべてのプラットフォームでサポートされるプロパティは、接頭辞の「awt.」で始まります。
プログラムでこれらのプロパティに直接アクセスする必要はなく、Windowsのルック・アンド・フィールが自動的に読み取られ、これらのプロパティがコンポーネントに適切な視覚効果と動作を提供するように解釈されます。
配色に関するプロパティ
|
ユーザーの設定 |
Javaプロパティ名 |
型 |
|---|---|---|
| 3Dオブジェクトのバックグラウンド・カラー | "win.3d.backgroundColor" | java.awt.Color |
| 3Dオブジェクトの強調表示 | "win.3d.highlightColor" | java.awt.Color |
| 3Dオブジェクトのハイライト | "win.3d.lightColor" | java.awt.Color |
| 3Dオブジェクトの陰影 | "win.3d.shadowColor" | java.awt.Color |
| アクティブなタイトル・バー・カラー1 | "win.frame.activeCaptionColor" | java.awt.Color |
| アクティブなタイトル・バー・カラー2 | "win.frame.activeCaptionGradientColor"(TBI) | java.awt.Color |
| アクティブなタイトル・バーのフォント・カラー | "win.frame.captionTextColor" | java.awt.Color |
| アクティブなウィンドウのボーダー・カラー | "win.frame.activeBorderColor" | java.awt.Color |
| アプリケーションの背景色 | "win.mdi.backgroundColor" | java.lang.Color |
| デスクトップ・カラー | "win.desktop.backgroundColor" | java.awt.Color |
| アクティブでないタイトル・バー・カラー1 | "win.frame.inactiveCaptionColor" | java.awt.Color |
| アクティブでないタイトル・バー・カラー2 | "win.frame.inactiveCaptionGradientColor"(TBI) | java.awt.Color |
| アクティブでないタイトル・バーのフォント・カラー | "win.frame.inactiveCaptionTextColor" | java.awt.Color |
| アクティブでないウィンドウのボーダー・カラー | "win.frame.inactiveBorderColor" | java.awt.Color |
| メニューのカラー | "win.menu.backgroundColor" | java.awt.Color |
| メニューのフォント・カラー | "win.menu.textColor" | java.awt.Color |
| メッセージ・ボックスのフォント・カラー | "win.frame.textColor?????" | java.awt.Color |
| 選択された項目のカラー | "win.item.highlightColor" | java.awt.Color |
| 選択された項目のフォント・カラー | "win.item.highlightTextColor" | java.awt.Color |
| ツールチップのカラー | "win.tooltip.backgroundColor" | java.awt.Color |
| ツールチップのフォント・カラー | "win.tooltip.textColor" | java.awt.Color |
| ウィンドウ・カラー | "win.frame.backgroundColor" | java.awt.Color |
| ウィンドウのフォント・カラー | "win.frame.textColor" | java.awt.Color |
| ホットトラッキングのカラー | "win.item.hotTrackedColor" | java.awt.Color |
外形に関するプロパティ
|
ユーザーの設定 |
Javaプロパティ名 |
型 |
|---|---|---|
| アクティブなタイトル・バーのサイズ | "win.frame.captionHeight" | java.lang.Integer |
| アクティブなウィンドウ・ボーダーのサイズ | "win.frame.sizingBorderWidth" | java.lang.Integer |
| キャプション・ボタンのサイズ | "win.frame.captionButtonHeight" "win.frame.captionButtonWidth" win.frame.captionHeight" |
java.lang.Integer |
| アイコンのサイズ | "win.icon.hspacing" "win.icon.vspacing"??? |
java.lang.Integer |
| アイコンの横の間隔 | "win.icon.hspacing" | java.lang.Integer |
| アイコンの縦の間隔 | "win.icon.vspacing" | java.lang.Integer |
| アクティブでないタイトル・バーのサイズ | "win.frame.captionButtonHeight" "win.frame.captionButtonWidth" "win.frame.captionHeight" |
java.lang.Integer |
| アクティブでないウィンドウのボーダーのサイズ | "win.frame.sizingBorderWidth" | java.lang.Integer |
| メニューのフォント・サイズ | "win.menu.font" "win.menu.height" |
java.lang.Integer |
| メニューのサイズ | "win.menu.height" "win.menu.buttonWidth" |
java.awt.Integer |
| パレット・タイトルのサイズ | "win.frame.smallCaptionHeight" "win.frame.smallCaptionButtonHeight" "win.frame.smallCaptionButtonWidth" |
java.lang.Integer |
| スクロール・バーの幅 | "win.scrollbar.width" | java.lang.Integer |
| スクロール・バーの高さ | "win.scrollbar.height" | java.lang.Integer |
| 選択項目のサイズ | "win.menu.height" "win.menu.buttonWidth" |
java.lang.Integer |
フォント・プロパティ
|
ユーザーの設定 |
Javaプロパティ名 |
型 |
|---|---|---|
| アクティブなタイトル・バーのフォント | "win.frame.captionFont" | java.awt.Font |
| アイコンのフォント | "win.icon.font" | java.awt.Font |
| アクティブでないタイトル・バーのフォント | "win.frame.captionFont" | java.awt.Font |
| メニューのフォント | "win.menu.font" | java.awt.Font |
| メッセージ・ボックスのフォント | "win.messagebox.font" | java.awt.Font |
| パレット・タイトルのフォント | "win.frame.smallCaptionFont" | java.awt.Font |
| 選択された項目のフォント | "win.menu.font" | java.awt.Font |
| ツールチップのフォント | "win.tooltip.font" | java.awt.Font |
フォントの互換性
現在、Windowsのルック・アンド・フィール内で実行されているSwingプログラムは、Java定義のシステム・フォントではなく、ユーザーが設定したシステム・フォントで描画します。このため、従来の動作に基づいているプログラムとの間に互換性の問題が発生する可能性があるので(外形上の問題や特定のフォント・グリフに依存するローカリゼーションの設定などが原因)、必要に応じてこの機能をオフにする、次の実行時のプロパティが用意されています。
java -Dswing.useSystemFontSettings=false MyJavaProgram
視覚効果に関するプロパティ
|
ユーザーの設定 |
Javaプロパティ名 |
型 |
|---|---|---|
| アイコンのタイトルの折返し | "win.icon.titleWrappingOn" | java.lang.Boolean |
| ウィンドウのドラッグ機能 | "win.frame.fullWindowDragOn" | java.lang.Boolean |
| キーボード・ナビゲーションの表示 | "win.menu.keyboardCuesOn"(TBI) | java.lang.Boolean |
| ツールバー/メニュー・バーのホットトラッキング | "win.item.hotTrackingOn" | java.lang.Boolean |
| タイトル・バーのグラデーション | "win.frame.captionGradientsOn" | java.lang.Boolean |
音声フィードバックに関するプロパティ
|
ユーザーの設定 |
Javaプロパティ名 |
型 |
|---|---|---|
| デフォルトのサウンド | "win.sound.default" | java.lang.Runnable |
| サウンドを閉じる | "win.sound.close" | java.lang.Runnable |
| サウンドの最大化 | "win.sound.maximize" | java.lang.Runnable |
| サウンドの最小化 | "win.sound.minimize" | java.lang.Runnable |
| メニュー・コマンドのサウンド | "win.sound.menuCommand" | java.lang.Runnable |
| メニュー・ポップアップのサウンド | "win.sound.menuPopup" | java.lang.Runnable |
| サウンドを開く | "win.sound.open" | java.lang.Runnable |
| サウンドを低く復元 | "win.sound.restoreDown" | java.lang.Runnable |
| サウンドを高く復元 | "win.sound.restoreUp" | java.lang.Runnable |
| システム・アスタリスク・サウンド | "win.sound.asterisk" | java.lang.Runnable |
| システム・エクスクラメーション・サウンド | "win.sound.exclamation" | java.lang.Runnable |
| システム終了サウンド | "win.sound.exit" | java.lang.Runnable |
| システム・ハンド・サウンド | "win.sound.hand" | java.lang.Runnable |
| システム・クエスチョン・サウンド | "win.sound.question" | java.lang.Runnable |
| システム開始サウンド | "win.sound.start" | java.lang.Runnable |
サウンドの動的変更
サウンド・プロパティに返されるオブジェクトは、そのプロパティ用に現在のオーディオ・クリップを再生する単なるRunnableです。つまり、サウンドのプロパティ値は現在のサウンド設定へのライブ・リンクであるため、サウンドに関するプロパティへの動的変更を監視する必要はありません。
入力に関するプロパティ
|
ユーザーの設定 |
Javaプロパティ名 |
型 |
|---|---|---|
| ダブルクリックの間隔 | "awt.multiClickInterval" | java.lang.Integer |
| カーソルの点滅間隔 | "awt.cursorBlinkRate"(TBI) | java.lang.Integer |
動的変更に対する応答
JDK 1.3では、デスクトップに関するプロパティ値の1つが変化すると通知を受け取るように登録しておく機能が、AWTによって追加されました。これは、java.awt.ToolkitのaddPropertyChangeListener()メソッド経由でサポートされます。Swingのルック・アンド・フィールでは、このメカニズムを使用して視覚に関するプロパティの動的な変更イベントを監視し、コンポーネントが最新の視覚に関するプロパティ値を持てるように、UIをアンインストールしたり再インストールしたりして、GUIを更新します。この動的な動作は、Windowsのルック・アンド・フィールを実行中のすべてのSwingプログラムで自動的に行われます。
このメカニズムは、GUIの階層をFrame.getFrames()で始めてそこからすべてのウィンドウ/コンテナ/コンポーネントをトラバースすることで、GUIコンポーネントを更新します。トラバースが行われるときにクライアントに表示不能なコンポーネントがある場合(コンポーネントが表示可能である場合の定義については、java.awt.ComponentのisDisplayable()メソッドを参照)、このようなコンポーネントは自動的には更新されません。これらのコンポーネントのルック・アンド・フィールが最新のものであることを保証するために、クライアント・プログラムでコンポーネントのUIを更新する必要があります。たとえばこのようなことは、SwingSet2のデモで発生します。デモ・ウィンドウが作成されても、デモのタブ付きペインから選択されるまで、ウィンドウがGUIの階層に追加されないからです。したがって、新しく選択したデモ・ウィンドウが階層に追加される前に、最新のプロパティ設定値になっていることを保証するために、UIを更新します。
fragment from SwingSet2.java: // Ensure panel's UI is current before making visible
JComponent currentDemoPanel = demo.getDemoPanel();
SwingUtilities.updateComponentTreeUI(currentDemoPanel);
// Replace current demo with newly selected demo
demoPanel.removeAll();
demoPanel.add(currentDemoPanel, BorderLayout.CENTER);