ComponentUI (Java Platform SE 8)

java.lang.Object
- javax.swing.plaf.ComponentUI

直系の既知のサブクラス:

ButtonUI, ColorChooserUI, ComboBoxUI, DesktopIconUI, DesktopPaneUI, FileChooserUI, InternalFrameUI, LabelUI, LayerUI, ListUI, MenuBarUI, OptionPaneUI, PanelUI, PopupMenuUI, ProgressBarUI, RootPaneUI, ScrollBarUI, ScrollPaneUI, SeparatorUI, SliderUI, SpinnerUI, SplitPaneUI, TabbedPaneUI, TableHeaderUI, TableUI, TextUI, ToolBarUI, ToolTipUI, TreeUI, ViewportUI
```
public abstract class ComponentUI
extends Object
```
Swingのプラグイン可能なLook & Feelアーキテクチャに含まれるすべてのUI委譲オブジェクトの基底クラスです。SwingコンポーネントのUI委譲オブジェクトはLook & Feelに依存するコンポーネントの側面の実装を扱います。JComponentクラスは、インストールしたLook & Feelによって異なる可能性があるオペレーション(ペイント、レイアウトの計算など)を委譲するために、このクラスからメソッドを呼び出します。クライアントのプログラムは、直接このクラスのメソッドを呼び出すべきではありません。

関連項目:

JComponent, UIManager

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

コンストラクタ
コンストラクタと説明

ComponentUI()
唯一のコンストラクタです。

コンストラクタ
コンストラクタと説明
`ComponentUI()` 唯一のコンストラクタです。

メソッドのサマリー

すべてのメソッド静的メソッドインスタンス・メソッド具象メソッド
修飾子と型	メソッドと説明
`boolean`	`contains(JComponent c, int x, int y)` 指定された x,yの位置が、指定されたコンポーネントのLook & Feel定義の形状内にある場合は、`true`を返します。
`static ComponentUI`	`createUI(JComponent c)` 指定されたコンポーネントのUI委譲のインスタンスを返します。
`Accessible`	`getAccessibleChild(JComponent c, int i)` オブジェクトの`i`番目の`Accessible`の子を返します。
`int`	`getAccessibleChildrenCount(JComponent c)` オブジェクト内のアクセシビリティ対応の子の数を返します。
`int`	`getBaseline(JComponent c, int width, int height)` ベースラインを返します。
`Component.BaselineResizeBehavior`	`getBaselineResizeBehavior(JComponent c)` サイズの変化に合わせてコンポーネントのベースラインがどのように変化するかを示す列挙を返します。
`Dimension`	`getMaximumSize(JComponent c)` 指定されたコンポーネントの、Look & Feelに適した最大サイズを返します。
`Dimension`	`getMinimumSize(JComponent c)` 指定されたコンポーネントの、Look & Feelに適した最小サイズを返します。
`Dimension`	`getPreferredSize(JComponent c)` 指定されたコンポーネントの、Look & Feelに適した推奨サイズを返します。
`void`	`installUI(JComponent c)` 指定されたコンポーネントをLook & Feelに応じて適切に構成します。
`void`	`paint(Graphics g, JComponent c)` 指定されたコンポーネントをLook & Feelに合わせてペイントします。
`void`	`uninstallUI(JComponent c)` `installUI`時に、指定されたコンポーネントに対して行われた構成を取り消します。
`void`	`update(Graphics g, JComponent c)` 指定されたコンポーネントをペイントする時間になったことを、このUI委譲に通知します。

クラス java.lang.Objectから継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- コンストラクタの詳細
  - ComponentUI
```
public ComponentUI()
```
    唯一のコンストラクタです。サブクラスのコンストラクタによる呼出し用で、通常は暗黙的に呼び出されます。
- メソッドの詳細
  - installUI
```
public void installUI(JComponent c)
```
    指定されたコンポーネントをLook & Feelに応じて適切に構成します。このメソッドは、ComponentUIインスタンスが、指定されたコンポーネントのUI委譲としてインストールされているときに呼び出されます。このメソッドは、次を含むLook & Feel用のコンポーネントを完全に構成するべきです。
    1. カラー、フォント、ボーダー、アイコン、不透明さなどのデフォルト・プロパティ値をコンポーネントにインストールする。可能な場合は常に、クライアント・プログラムによって初期化されたプロパティの値をオーバーライドするべきではない。
    2. 必要に応じて、コンポーネントにLayoutManagerをインストールする。
    3. 必要なサブコンポーネントを作成して、コンポーネントに追加する。
    4. イベント・リスナーを作成して、コンポーネントにインストールする。
    5. コンポーネントのプロパティの変更を適切に検出し、応答するために、PropertyChangeListenerを作成してコンポーネントにインストールする。
    6. キーボードUI (ニーモニック、トラバーサルなど)を、コンポーネントにインストールする。
    7. 適切なインスタンスのデータを初期化する。
    パラメータ:
    
    c - UI委譲がインストールされるコンポーネント
    
    関連項目:
    
    uninstallUI(javax.swing.JComponent), JComponent.setUI(javax.swing.plaf.ComponentUI), JComponent.updateUI()
  - uninstallUI
```
public void uninstallUI(JComponent c)
```
    installUI時に、指定されたコンポーネントに対して行われた構成を取り消します。このメソッドは、このUIComponentインスタンスが、指定されたコンポーネントのUI委譲として削除されているときに呼び出されます。このメソッドは、installUIによって実行された構成を元に戻すべきです。この場合、JComponentインスタンスをクリーンな状態(余分なリスナーや、Look & Feel固有のプロパティ・オブジェクトが残らないように)にするよう十分注意してください。手順には次のものが含まれるべきです。
    1. UIとして設定されたすべてのボーダーを、コンポーネントから削除する。
    2. UIとして設定されたすべてのレイアウト・マネージャを、コンポーネントから削除する。
    3. UIとして追加されたすべてのサブコンポーネントを、コンポーネントから削除する。
    4. UIとして追加されたすべてのイベント/プロパティ・リスナーを、コンポーネントから削除する。
    5. UIとしてインストールされたすべてのキーボードUIを、コンポーネントから削除する。
    6. GCの対象になるように、割り当てられたすべてのインスタンス・データ・オブジェクトをnullに設定する。
    パラメータ:
    
    c - このUI委譲が削除されるコンポーネント。この引数は通常無視されるが、UIオブジェクトがステートレスで、複数のコンポーネントで共有されている場合は使用されることがある
    
    関連項目:
    
    installUI(javax.swing.JComponent), JComponent.updateUI()
  - paint
```
public void paint(Graphics g,
                  JComponent c)
```
    指定されたコンポーネントをLook & Feelに合わせてペイントします。このメソッドは、指定されたコンポーネントがペイントされるときにComponentUI.updateメソッドから呼び出されます。サブクラスは、このメソッドをオーバーライドして、指定されたGraphicsオブジェクトを使ってコンポーネントの内容を描画するべきです。
    
    パラメータ:
    
    g - ペイント対象のGraphicsコンテキスト
    
    c - ペイントされるコンポーネント。この引数は通常無視されるが、UIオブジェクトがステートレスで、複数のコンポーネントで共有されている場合は使用されることがある
    
    関連項目:
    
    update(java.awt.Graphics, javax.swing.JComponent)
  - update
```
public void update(Graphics g,
                   JComponent c)
```
    指定されたコンポーネントをペイントする時間になったことを、このUI委譲に通知します。このメソッドは、指定されたコンポーネントがペイントされるときにJComponentによって呼び出されます。
    デフォルトでは、このメソッドは、指定されたコンポーネントのopaqueプロパティがtrueの場合に、コンポーネントをそのバックグラウンド・カラーで塗りつぶし、すぐにpaintを呼び出します。一般的に、このメソッドはサブクラスによってオーバーライドする必要はありません。すべてのLook & Feel描画コードはpaintメソッド内に存在する必要があります。
    
    パラメータ:
    
    g - ペイント対象のGraphicsコンテキスト
    
    c - ペイントされるコンポーネント。この引数は通常無視されるが、UIオブジェクトがステートレスで、複数のコンポーネントで共有されている場合は使用されることがある
    
    関連項目:
    
    paint(java.awt.Graphics, javax.swing.JComponent), JComponent.paintComponent(java.awt.Graphics)
  - getPreferredSize
```
public Dimension getPreferredSize(JComponent c)
```
    指定されたコンポーネントの、Look & Feelに適した推奨サイズを返します。nullが返された場合、適切なサイズは代わりにコンポーネントのレイアウト・マネージャによって計算されます(これは、特定のレイアウト・マネージャをインストールしてあるコンポーネントの場合に推奨する方法です)。このメソッドのデフォルト実装はnullを返します。
    
    パラメータ:
    
    c - 推奨サイズが照会されるコンポーネント。この引数は通常無視されるが、UIオブジェクトがステートレスで、複数のコンポーネントで共有されている場合は使用されることがある
    
    関連項目:
    
    JComponent.getPreferredSize(), LayoutManager.preferredLayoutSize(java.awt.Container)
  - getMinimumSize
```
public Dimension getMinimumSize(JComponent c)
```
    指定されたコンポーネントの、Look & Feelに適した最小サイズを返します。nullが返された場合、最小サイズは代わりにコンポーネントのレイアウト・マネージャによって計算されます(これは、特定のレイアウト・マネージャをインストールしてあるコンポーネントの場合に推奨する方法です)。このメソッドのデフォルト実装はgetPreferredSizeを呼び出して、その値を返します。
    
    パラメータ:
    
    c - 最小サイズが照会されるコンポーネント。この引数は通常無視されるが、UIオブジェクトがステートレスで、複数のコンポーネントで共有されている場合は使用されることがある
    
    戻り値:
    
    Dimensionオブジェクトまたはnull
    
    関連項目:
    
    JComponent.getMinimumSize(), LayoutManager.minimumLayoutSize(java.awt.Container), getPreferredSize(javax.swing.JComponent)
  - getMaximumSize
```
public Dimension getMaximumSize(JComponent c)
```
    指定されたコンポーネントの、Look & Feelに適した最大サイズを返します。nullが返された場合、最大サイズは代わりにコンポーネントのレイアウト・マネージャによって計算されます(これは、特定のレイアウト・マネージャをインストールしてあるコンポーネントの場合に推奨する方法です)。このメソッドのデフォルト実装はgetPreferredSizeを呼び出して、その値を返します。
    
    パラメータ:
    
    c - 最大サイズが照会されるコンポーネント。この引数は通常無視されるが、UIオブジェクトがステートレスで、複数のコンポーネントで共有されている場合は使用されることがある
    
    戻り値:
    
    Dimensionオブジェクトまたはnull
    
    関連項目:
    
    JComponent.getMaximumSize(), LayoutManager2.maximumLayoutSize(java.awt.Container)
  - contains
```
public boolean contains(JComponent c,
                        int x,
                        int y)
```
    指定されたx,yの位置が、指定されたコンポーネントのLook & Feel定義の形状内にある場合は、trueを返します。xとyは、指定されたコンポーネントの座標体系を基準に定義されます。コンポーネントのboundsは矩形に制限されますが、このメソッドはヒットの検出のためにこれらの境界内で矩形以外の形状を定義する方法を提供します。
    
    パラメータ:
    
    c - x,yの位置が照会されるコンポーネント。この引数は通常無視されるが、UIオブジェクトがステートレスで、複数のコンポーネントに共有されている場合は使用されることがある
    
    x - 点のx座標
    
    y - 点のy座標
    
    関連項目:
    
    JComponent.contains(int, int), Component.contains(int, int)
  - createUI
```
public static ComponentUI createUI(JComponent c)
```
    指定されたコンポーネントのUI委譲のインスタンスを返します。各サブクラスは、それ自体のstatic createUIメソッドを提供して、そのUI委譲のサブクラスのインスタンスを返す必要があります。UI委譲のサブクラスがステートレスの場合、複数のコンポーネントに共有されるインスタンスを返します。UI委譲がステートフルの場合、コンポーネントごとに新しいインスタンスを返す必要があります。このメソッドは呼び出してはいけないため、そのデフォルト実装はエラーをスローします。
  - getBaseline
```
public int getBaseline(JComponent c,
                       int width,
                       int height)
```
    ベースラインを返します。ベースラインは、コンポーネントの上端から測定されます。このメソッドは、主にLayoutManagerがそのベースラインに沿ってコンポーネントを配置するために使用します。戻り値が0より小さい場合、このコンポーネントのベースラインは適切ではありません。LayoutManagerは、そのベースライン上にこのコンポーネントを配置しないでください。
    このメソッドは -1を返します。意味のあるベースラインを持つサブクラスで適切にオーバーライドするべきです。
    
    パラメータ:
    
    c - ベースラインが要求されるJComponent
    
    width - ベースラインを取得する幅
    
    height - ベースラインを取得する高さ
    
    戻り値:
    
    ベースラインまたは0より小さい値(適切なベースラインがないことを示す)
    
    例外:
    
    NullPointerException - cがnullである場合
    
    IllegalArgumentException - 幅または高さが0より小さい場合
    
    導入されたバージョン:
    
    1.6
    
    関連項目:
    
    JComponent.getBaseline(int,int)
  - getBaselineResizeBehavior
```
public Component.BaselineResizeBehavior getBaselineResizeBehavior(JComponent c)
```
    サイズの変化に合わせてコンポーネントのベースラインがどのように変化するかを示す列挙を返します。このメソッドは、主にレイアウト・マネージャとGUIビルダーで使用されます。
    このメソッドはBaselineResizeBehavior.OTHERを返します。ベースラインをサポートするサブクラスで、適切にオーバーライドするべきです。
    
    パラメータ:
    
    c - ベースラインのサイズ変更の動作を返すJComponent
    
    戻り値:
    
    コンポーネント・サイズの変化に合わせてベースラインがどのように変化するかを示す列挙
    
    例外:
    
    NullPointerException - cがnullである場合
    
    導入されたバージョン:
    
    1.6
    
    関連項目:
    
    JComponent.getBaseline(int, int)
  - getAccessibleChildrenCount
```
public int getAccessibleChildrenCount(JComponent c)
```
    オブジェクト内のアクセシビリティ対応の子の数を返します。このオブジェクトのすべての子がAccessibleインタフェースを実装している場合、このメソッドはこのオブジェクトの子の数を返すべきです。UIが、画面上にコンポーネントとして表示される領域は提供するが、実際のコンポーネントがこの領域を提供するために使用されない場合、UIにおいて必要に応じてこのメソッドをオーバーライドできます。注: バージョン1.3以降は、このメソッドの代わりにComponent.AccessibleAWTComponent.getAccessibleChildrenCount()を呼び出すことをお勧めします。
    
    戻り値:
    
    オブジェクト内のアクセシビリティ対応の子の数
    
    関連項目:
    
    getAccessibleChild(javax.swing.JComponent, int)
  - getAccessibleChild
```
public Accessible getAccessibleChild(JComponent c,
                                     int i)
```
    オブジェクトのi番目のAccessibleの子を返します。UIが、画面上にコンポーネントとして表示される領域は提供するが、この領域を提供するのに実際のコンポーネントを使用しない場合、UIは必要に応じてこのメソッドをオーバーライドします。
    注: バージョン1.3以降は、このメソッドの代わりにComponent.AccessibleAWTComponent.getAccessibleChild()を呼び出すことをお勧めします。
    
    パラメータ:
    
    i - 子のゼロから始まるインデックス
    
    戻り値:
    
    オブジェクトのi番目のAccessibleの子
    
    関連項目:
    
    getAccessibleChildrenCount(javax.swing.JComponent)

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright© 1993, 2014, Oracle and/or its affiliates. All rights reserved.

クラスComponentUI

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

メソッドのサマリー

クラス java.lang.Objectから継承されたメソッド

コンストラクタの詳細

ComponentUI

メソッドの詳細

installUI

uninstallUI

paint

update

getPreferredSize

getMinimumSize

getMaximumSize

contains

createUI

getBaseline

getBaselineResizeBehavior

getAccessibleChildrenCount

getAccessibleChild