javax.swing.plaf.basic
クラス BasicMenuItemUI

java.lang.Object
  |
  +--javax.swing.plaf.ComponentUI
        |
        +--javax.swing.plaf.ButtonUI
              |
              +--javax.swing.plaf.MenuItemUI
                    |
                    +--javax.swing.plaf.basic.BasicMenuItemUI

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

BasicCheckBoxMenuItemUI, BasicMenuUI, BasicRadioButtonMenuItemUI

public class BasicMenuItemUI

extends MenuItemUI

BasicMenuItem の実装です。

入れ子クラスの概要

protected class

BasicMenuItemUI.MouseInputHandler

フィールドの概要

protected Font	acceleratorFont
protected Color	acceleratorForeground
protected Color	acceleratorSelectionForeground
protected Icon	arrowIcon
protected Icon	checkIcon
protected int	defaultTextIconGap
protected Color	disabledForeground
protected MenuDragMouseListener	menuDragMouseListener
protected JMenuItem	menuItem
protected MenuKeyListener	menuKeyListener
protected MouseInputListener	mouseInputListener
protected boolean	oldBorderPainted
protected Color	selectionBackground
protected Color	selectionForeground

コンストラクタの概要

BasicMenuItemUI()

メソッドの概要

protected MenuDragMouseListener	createMenuDragMouseListener(JComponent c)
protected MenuKeyListener	createMenuKeyListener(JComponent c)
protected MouseInputListener	createMouseInputListener(JComponent c)
static ComponentUI	createUI(JComponent c) 指定されたコンポーネントの UI 委譲のインスタンスを返します。
protected void	doClick(MenuSelectionManager msm) メニュー項目の起動時に、このメソッドを呼び出します。
Dimension	getMaximumSize(JComponent c) Look & Feel に適した、指定されたコンポーネントの最大サイズを返します。
Dimension	getMinimumSize(JComponent c) Look & Feel に適した、指定されたコンポーネントの最小サイズを返します。
MenuElement[]	getPath()
protected Dimension	getPreferredMenuItemSize(JComponent c, Icon checkIcon, Icon arrowIcon, int defaultTextIconGap)
Dimension	getPreferredSize(JComponent c) Look & Feel に適した、指定されたコンポーネントの適切なサイズを返します。
protected String	getPropertyPrefix()
protected void	installComponents(JMenuItem menuItem)
protected void	installDefaults()
protected void	installKeyboardActions()
protected void	installListeners()
void	installUI(JComponent c) Look & Feel に適した、指定されたコンポーネントを構成します。
void	paint(Graphics g, JComponent c) Look &Feel に適した、指定されたコンポーネントをペイントします。
protected void	paintBackground(Graphics g, JMenuItem menuItem, Color bgColor) メニュー項目のバックグラウンドを描画します。
protected void	paintMenuItem(Graphics g, JComponent c, Icon checkIcon, Icon arrowIcon, Color background, Color foreground, int defaultTextIconGap)
protected void	paintText(Graphics g, JMenuItem menuItem, Rectangle textRect, String text) 現在のメニュー項目のテキストを描画します。
protected void	uninstallComponents(JMenuItem menuItem)
protected void	uninstallDefaults()
protected void	uninstallKeyboardActions()
protected void	uninstallListeners()
void	uninstallUI(JComponent c) installUI 時に、指定されたコンポーネントで実行した構成を取り消します。
void	update(Graphics g, JComponent c) paintMenuItem() でバックグラウンドを描画します。

クラス javax.swing.plaf.ComponentUI から継承したメソッド

contains, getAccessibleChild, getAccessibleChildrenCount

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

フィールドの詳細

menuItem

protected JMenuItem menuItem

selectionBackground

protected Color selectionBackground

selectionForeground

protected Color selectionForeground

disabledForeground

protected Color disabledForeground

acceleratorForeground

protected Color acceleratorForeground

acceleratorSelectionForeground

protected Color acceleratorSelectionForeground

defaultTextIconGap

protected int defaultTextIconGap

acceleratorFont

protected Font acceleratorFont

mouseInputListener

protected MouseInputListener mouseInputListener

menuDragMouseListener

protected MenuDragMouseListener menuDragMouseListener

menuKeyListener

protected MenuKeyListener menuKeyListener

arrowIcon

protected Icon arrowIcon

checkIcon

protected Icon checkIcon

oldBorderPainted

protected boolean oldBorderPainted

コンストラクタの詳細

BasicMenuItemUI

public BasicMenuItemUI()

メソッドの詳細

createUI

public static ComponentUI createUI(JComponent c)

クラス ComponentUI の記述:

指定されたコンポーネントの UI 委譲のインスタンスを返します。各サブクラスは、それ自体の静的な createUI メソッドを提供して、その UI 委譲のサブクラスのインスタンスを返す必要があります。UI 委譲のサブクラスが状態なしの場合、複数のコンポーネントに共有されるインスタンスを返します。UI 委譲が状態ありの場合、コンポーネントごとに新しいインスタンスを返す必要があります。このメソッドは呼び出してはいけないため、そのデフォルト実装はエラーをスローします。

installUI

public void installUI(JComponent c)

クラス ComponentUI の記述:

Look & Feel に適した、指定されたコンポーネントを構成します。このメソッドは、ComponentUI インスタンスが、指定されたコンポーネントの UI 委譲としてインストールされているときに呼び出されます。このメソッドは、以下を含む Look & Feel 用のコンポーネントを完全に構成する必要があります。

1. カラー、フォント、ボーダ、アイコン、不透明さなどすべてのデフォルトプロパティの値をコンポーネントにインストールする。可能な場合は、クライアントプログラムによって初期化されたプロパティの値をオーバーライドしてはならない
2. 必要に応じて、コンポーネントに LayoutManager をインストールする
3. 必要なサブコンポーネントを、コンポーネントに作成または追加する
4. イベントリスナーを、コンポーネントに作成またはインストールする
5. コンポーネントのプロパティの変更を適切に検出し、応答するために、PropertyChangeListener をコンポーネントに作成またはインストールする
6. キーボード UI (ニーモニック、トラバーサルなど) を、コンポーネントにインストールする
7. 適切なインスタンスのデータを初期化する

オーバーライド:

クラス ComponentUI 内の installUI

パラメータ:

c - UI 委譲がインストールされているコンポーネント

関連項目:

ComponentUI.uninstallUI(javax.swing.JComponent), JComponent.setUI(javax.swing.plaf.ComponentUI), JComponent.updateUI()

installDefaults

protected void installDefaults()

installComponents

protected void installComponents(JMenuItem menuItem)

導入されたバージョン:

1.3

getPropertyPrefix

protected String getPropertyPrefix()

installListeners

protected void installListeners()

installKeyboardActions

protected void installKeyboardActions()

uninstallUI

public void uninstallUI(JComponent c)

クラス ComponentUI の記述:

installUI 時に、指定されたコンポーネントで実行した構成を取り消します。このメソッドは、指定されたコンポーネントの UI 委譲としての UIComponent インスタンスが削除されているときに呼び出されます。このメソッドは、installUI によって実行された構成を元に戻す必要があります。この場合、JComponent インスタンスをクリーンな状態 (余分なリスナーや、Look & Feel 固有のプロパティオブジェクトが残らないように) にするよう十分注意してください。手順には次のものがあります。

1. UI として設定されたすべてのボーダを、コンポーネントから削除する
2. UI として設定されたすべてのレイアウトマネージャを、コンポーネントから削除する
3. UI として追加されたすべてのサブコンポーネントを、コンポーネントから削除する
4. UI として追加されたすべてのイベント/リスナーを、コンポーネントから削除する
5. UI としてインストールされたすべてのキーボード UI を、コンポーネントから削除する
6. GC 用に割り当てられたすべてのインスタンスのデータオブジェクトを無効にする

オーバーライド:

クラス ComponentUI 内の uninstallUI

パラメータ:

c - この UI 委譲が削除されるコンポーネント。この引数はしばしば無視されるが、UI オブジェクトが状態なしで複数のコンポーネントに共有される場合に使用されることがある

関連項目:

ComponentUI.installUI(javax.swing.JComponent), JComponent.updateUI()

uninstallDefaults

protected void uninstallDefaults()

uninstallComponents

protected void uninstallComponents(JMenuItem menuItem)

導入されたバージョン:

1.3

uninstallListeners

protected void uninstallListeners()

uninstallKeyboardActions

protected void uninstallKeyboardActions()

createMouseInputListener

protected MouseInputListener createMouseInputListener(JComponent c)

createMenuDragMouseListener

protected MenuDragMouseListener createMenuDragMouseListener(JComponent c)

createMenuKeyListener

protected MenuKeyListener createMenuKeyListener(JComponent c)

getMinimumSize

public Dimension getMinimumSize(JComponent c)

クラス ComponentUI の記述:

Look & Feel に適した、指定されたコンポーネントの最小サイズを返します。null が返される場合、最小サイズは代わりにコンポーネントのレイアウトマネージャによって計算されます (これは、特定のレイアウトマネージャをインストールしてあるコンポーネントの場合に推奨する方法です)。このメソッドのデフォルト実装は getPreferredSize を呼び出して、その値を返します。

オーバーライド:

クラス ComponentUI 内の getMinimumSize

パラメータ:

c - 最小サイズが照会されるコンポーネント。この引数はしばしば無視されるが、UI オブジェクトが状態なしで複数のコンポーネントに共有される場合に使用されることがある

戻り値:

Dimension オブジェクト、または null

関連項目:

JComponent.getMinimumSize(), LayoutManager.minimumLayoutSize(java.awt.Container), ComponentUI.getPreferredSize(javax.swing.JComponent)

getPreferredSize

public Dimension getPreferredSize(JComponent c)

クラス ComponentUI の記述:

Look & Feel に適した、指定されたコンポーネントの適切なサイズを返します。null が返される場合、適切なサイズは代わりにコンポーネントのレイアウトマネージャによって計算されます (これは、特定のレイアウトマネージャをインストールしてあるコンポーネントの場合に推奨する方法です)。このメソッドのデフォルト実装は null を返します。

オーバーライド:

クラス ComponentUI 内の getPreferredSize

パラメータ:

c - 適切なサイズが照会されるコンポーネント。この引数はしばしば無視されるが、UI オブジェクトが状態なしで複数のコンポーネントに共有される場合に使用されることがある

関連項目:

JComponent.getPreferredSize(), LayoutManager.preferredLayoutSize(java.awt.Container)

getMaximumSize

public Dimension getMaximumSize(JComponent c)

クラス ComponentUI の記述:

Look & Feel に適した、指定されたコンポーネントの最大サイズを返します。null が返される場合、最大サイズは代わりにコンポーネントのレイアウトマネージャによって計算されます (これは、特定のレイアウトマネージャをインストールしてあるコンポーネントの場合に推奨する方法です)。このメソッドのデフォルト実装は getPreferredSize を呼び出して、その値を返します。

オーバーライド:

クラス ComponentUI 内の getMaximumSize

パラメータ:

c - 最大サイズが照会されるコンポーネント。この引数はしばしば無視されるが、UI オブジェクトが状態なしで複数のコンポーネントに共有される場合に使用されることがある

戻り値:

Dimension オブジェクト、または null

関連項目:

JComponent.getMaximumSize(), LayoutManager2.maximumLayoutSize(java.awt.Container)

getPreferredMenuItemSize

protected Dimension getPreferredMenuItemSize(JComponent c,
                                             Icon checkIcon,
                                             Icon arrowIcon,
                                             int defaultTextIconGap)

update

public void update(Graphics g,
                   JComponent c)

paintMenuItem() でバックグラウンドを描画します。そのために、デフォルトで不透明なコンポーネントのバックグラウンドを塗りつぶす update をオーバーライドして、paint() を呼び出すだけにします。

オーバーライド:

クラス ComponentUI 内の update

パラメータ:

g - ペイント先となる Graphics コンテキスト

c - ペイントされるコンポーネント。この引数はしばしば無視されるが、UI オブジェクトが状態なしで複数のコンポーネントに共有される場合に使用されることがある

関連項目:

ComponentUI.paint(java.awt.Graphics, javax.swing.JComponent), JComponent.paintComponent(java.awt.Graphics)

paint

public void paint(Graphics g,
                  JComponent c)

クラス ComponentUI の記述:

Look &Feel に適した、指定されたコンポーネントをペイントします。このメソッドは ComponentUI.update メソッドから、指定されたコンポーネントがペイントされるときに呼び出されます。サブクラスは、このメソッドをオーバーライドして、指定された Graphics オブジェクトを使ってコンポーネントの内容を描画する必要があります。

オーバーライド:

クラス ComponentUI 内の paint

パラメータ:

g - ペイント先となる Graphics コンテキスト

c - ペイントされるコンポーネント。この引数はしばしば無視されるが、UI オブジェクトが状態なしで複数のコンポーネントに共有される場合に使用されることがある

関連項目:

ComponentUI.update(java.awt.Graphics, javax.swing.JComponent)

paintMenuItem

protected void paintMenuItem(Graphics g,
                             JComponent c,
                             Icon checkIcon,
                             Icon arrowIcon,
                             Color background,
                             Color foreground,
                             int defaultTextIconGap)

paintBackground

protected void paintBackground(Graphics g,
                               JMenuItem menuItem,
                               Color bgColor)

メニュー項目のバックグラウンドを描画します。

パラメータ:

g - ペイントのグラフィックス

menuItem - ペイントされるメニュー項目

bgColor - 選択バックグラウンドカラー

導入されたバージョン:

1.4

paintText

protected void paintText(Graphics g,
                         JMenuItem menuItem,
                         Rectangle textRect,
                         String text)

現在のメニュー項目のテキストを描画します。

パラメータ:

g - グラフィックスコンテキスト

menuItem - 描画するメニュー項目

textRect - テキストを描画する境界の矩形

text - 描画する文字列

導入されたバージョン:

1.4

getPath

public MenuElement[] getPath()

doClick

protected void doClick(MenuSelectionManager msm)

メニュー項目の起動時に、このメソッドを呼び出します。このメソッドは、選択したパスを消去したり、JMenuItem の doClick() メソッドをメッセージとして送るなど、メニュー項目起動の詳細の一部を処理します。

パラメータ:

msm - MenuSelectionManager。画像フィードバックと内部簿記作業は、この MenuSelectionManager に委譲されます。引数として null が渡された場合、MenuSelectionManager.defaultManager が使用されます。

導入されたバージョン:

1.4

関連項目:

MenuSelectionManager, AbstractButton.doClick(int)