モジュール java.desktop

パッケージ javax.swing

クラスJCheckBoxMenuItem

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.AbstractButton

javax.swing.JMenuItem

javax.swing.JCheckBoxMenuItem

すべての実装されたインタフェース:

ImageObserver, ItemSelectable, MenuContainer, Serializable, Accessible, MenuElement, SwingConstants

@JavaBean(description="A menu item which can be selected or deselected.") public class JCheckBoxMenuItem extends JMenuItem implements SwingConstants, Accessible

選択または選択解除できるメニュー項目です。 選択されている場合、通常はメニュー項目の横にチェック・マークが表示されます。 選択されていないか、あるいは選択が解除された場合、メニュー項目はチェック・マークなしで表示されます。 通常のメニュー項目と同じように、チェックボックス・メニュー項目は、関連付けられたテキストまたはグラフィック・アイコン、またはこの両方を持つことができます。

isSelectedとsetSelected、またはgetStateとsetStateを使用して、メニュー項目の選択状態を判定または指定できます。 isSelectedおよびsetSelectedメソッドの方をお薦めします。これらは、すべてのメニューとボタンで機能します。 getStateおよびsetStateメソッドは、他のコンポーネント・セットとの互換性のために用意されています。

メニュー項目は構成可能であり、Actionを使用してある程度制御できます。 メニュー項目でActionを使用することは、メニュー項目を直接構成するのと比べて多くの利点があります。 詳細は「ActionをサポートするSwingコンポーネント」を参照してください。さらに、Java チュートリアルのActionsの使用方法のセクションに詳細が説明されています。

1つのメニューから複数のチェック・ボックス・メニュー項目を選択する必要がある場合があります。 この場合、1つのチェック・ボックス・メニュー項目をクリックしてもメニューは閉じないと便利です。 このような動作は、クライアントJComponent.putClientProperty(java.lang.Object, java.lang.Object)またはLook&Feel UIManager.put(java.lang.Object, java.lang.Object)プロパティ"CheckBoxMenuItem.doNotCloseOnMouseClick"のいずれかによって制御できます。 デフォルト値はfalseです。 プロパティをtrueに設定すると、マウスでメニューをクリックしたときにメニューが閉じなくなります。 クライアント・プロパティが設定されている場合、その値は常に使用されます。それ以外の場合は、L&Fプロパティを問い合せます。 ノート: L&Fによっては、このプロパティが無視される場合があります。 すべての組込みL&Fは、この動作を継承します。

チェックボックス・メニュー項目の使用方法の詳細と例については、『The Java Tutorial』の「How to Use Menus」を参照してください。

警告: Swingはスレッドに対して安全ではありません。 詳細は、「Swing's Threading Policy」を参照してください。

警告: このクラスの直列化されたオブジェクトは、今後のSwingリリースと互換ではなくなる予定です。 現在の直列化のサポートは、短期間の格納や、同じバージョンのSwingを実行するアプリケーション間のRMIに適しています。 1.4では、すべてのJavaBeansの長期ストレージのサポートがjava.beansパッケージに追加されました。 XMLEncoderを参照してください。

導入されたバージョン:

1.2

ネストされたクラスのサマリー

ネストされたクラス

修飾子と型	クラス	説明
protected class	JCheckBoxMenuItem.AccessibleJCheckBoxMenuItem	このクラスはJCheckBoxMenuItemクラスのアクセシビリティ・サポートを実装しています。

クラスjavax.swing.JMenuItemで宣言されたネストされたクラス/インタフェース

JMenuItem.AccessibleJMenuItem

クラスjavax.swing.AbstractButtonで宣言されたネストされたクラス/インタフェース

AbstractButton.AccessibleAbstractButton, AbstractButton.ButtonChangeListener

クラスjavax.swing.JComponentで宣言されたネストされたクラス/インタフェース

JComponent.AccessibleJComponent

クラスjava.awt.Containerで宣言されたネストされたクラス/インタフェース

Container.AccessibleAWTContainer

クラスjava.awt.Componentで宣言されたネストされたクラス/インタフェース

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

フィールドのサマリー

クラスjavax.swing.AbstractButtonで宣言されたフィールド

actionListener, BORDER_PAINTED_CHANGED_PROPERTY, changeEvent, changeListener, CONTENT_AREA_FILLED_CHANGED_PROPERTY, DISABLED_ICON_CHANGED_PROPERTY, DISABLED_SELECTED_ICON_CHANGED_PROPERTY, FOCUS_PAINTED_CHANGED_PROPERTY, HORIZONTAL_ALIGNMENT_CHANGED_PROPERTY, HORIZONTAL_TEXT_POSITION_CHANGED_PROPERTY, ICON_CHANGED_PROPERTY, itemListener, MARGIN_CHANGED_PROPERTY, MNEMONIC_CHANGED_PROPERTY, model, MODEL_CHANGED_PROPERTY, PRESSED_ICON_CHANGED_PROPERTY, ROLLOVER_ENABLED_CHANGED_PROPERTY, ROLLOVER_ICON_CHANGED_PROPERTY, ROLLOVER_SELECTED_ICON_CHANGED_PROPERTY, SELECTED_ICON_CHANGED_PROPERTY, TEXT_CHANGED_PROPERTY, VERTICAL_ALIGNMENT_CHANGED_PROPERTY, VERTICAL_TEXT_POSITION_CHANGED_PROPERTY

クラスjavax.swing.JComponentで宣言されたフィールド

listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

クラスjava.awt.Componentで宣言されたフィールド

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

インタフェースjava.awt.image.ImageObserverで宣言されているフィールド

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

インタフェースjavax.swing.SwingConstantsで宣言されているフィールド

BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST

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

コンストラクタ

コンストラクタ	説明
JCheckBoxMenuItem()	初期状態で選択されていない、テキストおよびアイコンなしのチェックボックス・メニュー項目を生成します。
JCheckBoxMenuItem(String text)	初期状態で選択されていない、テキスト付きのチェックボックス・メニュー項目を生成します。
JCheckBoxMenuItem(String text, boolean b)	指定されたテキストおよび選択状態を持つチェックボックス・メニュー項目を生成します。
JCheckBoxMenuItem(String text, Icon icon)	初期状態で選択されていない、指定されたテキストおよびアイコン付きのチェックボックス・メニュー項目を生成します。
JCheckBoxMenuItem(String text, Icon icon, boolean b)	指定されたテキスト、アイコン、および選択状態を持つチェックボックス・メニュー項目を生成します。
JCheckBoxMenuItem(Action a)	指定されたActionからプロパティを取得するメニュー項目を生成します。
JCheckBoxMenuItem(Icon icon)	初期状態で選択されていない、アイコン付きのチェックボックス・メニュー項目を生成します。

メソッドのサマリー

修飾子と型	メソッド	説明
AccessibleContext	getAccessibleContext()	このJCheckBoxMenuItemに関連付けられたAccessibleContextを取得します。
Object[]	getSelectedObjects()	チェックボックス・メニュー項目のラベルを格納する配列(長さ1)を返します。チェックボックスが選択されていない場合はnullを返します。
boolean	getState()	項目の選択状態を返します。
String	getUIClassID()	このコンポーネントをレンダリングするL&Fクラスの名前を返します。
protected String	paramString()	このJCheckBoxMenuItemの文字列表現を返します。
void	setState(boolean b)	項目の選択状態を設定します。

クラスjavax.swing.JMenuItemで宣言されたメソッド

actionPropertyChanged, addMenuDragMouseListener, addMenuKeyListener, configurePropertiesFromAction, fireMenuDragMouseDragged, fireMenuDragMouseEntered, fireMenuDragMouseExited, fireMenuDragMouseReleased, fireMenuKeyPressed, fireMenuKeyReleased, fireMenuKeyTyped, getAccelerator, getComponent, getMenuDragMouseListeners, getMenuKeyListeners, getSubElements, init, isArmed, menuSelectionChanged, processKeyEvent, processMenuDragMouseEvent, processMenuKeyEvent, processMouseEvent, removeMenuDragMouseListener, removeMenuKeyListener, setAccelerator, setArmed, setEnabled, setModel, setUI, updateUI

クラスjavax.swing.AbstractButtonで宣言されたメソッド

addActionListener, addChangeListener, addImpl, addItemListener, checkHorizontalKey, checkVerticalKey, createActionListener, createActionPropertyChangeListener, createChangeListener, createItemListener, doClick, doClick, fireActionPerformed, fireItemStateChanged, fireStateChanged, getAction, getActionCommand, getActionListeners, getChangeListeners, getDisabledIcon, getDisabledSelectedIcon, getDisplayedMnemonicIndex, getHideActionText, getHorizontalAlignment, getHorizontalTextPosition, getIcon, getIconTextGap, getItemListeners, getLabel, getMargin, getMnemonic, getModel, getMultiClickThreshhold, getPressedIcon, getRolloverIcon, getRolloverSelectedIcon, getSelectedIcon, getText, getUI, getVerticalAlignment, getVerticalTextPosition, imageUpdate, isBorderPainted, isContentAreaFilled, isFocusPainted, isRolloverEnabled, isSelected, paintBorder, removeActionListener, removeChangeListener, removeItemListener, removeNotify, setAction, setActionCommand, setBorderPainted, setContentAreaFilled, setDisabledIcon, setDisabledSelectedIcon, setDisplayedMnemonicIndex, setFocusPainted, setHideActionText, setHorizontalAlignment, setHorizontalTextPosition, setIcon, setIconTextGap, setLabel, setLayout, setMargin, setMnemonic, setMnemonic, setMultiClickThreshhold, setPressedIcon, setRolloverEnabled, setRolloverIcon, setRolloverSelectedIcon, setSelected, setSelectedIcon, setText, setUI, setVerticalAlignment, setVerticalTextPosition

クラスjavax.swing.JComponentで宣言されたメソッド

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

クラスjava.awt.Containerで宣言されたメソッド

add, add, add, add, add, addContainerListener, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, transferFocusDownCycle, validate, validateTree

クラスjava.awt.Componentで宣言されたメソッド

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

クラスjava.lang.Objectで宣言されたメソッド

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

コンストラクタの詳細

JCheckBoxMenuItem

public JCheckBoxMenuItem()

初期状態で選択されていない、テキストおよびアイコンなしのチェックボックス・メニュー項目を生成します。

JCheckBoxMenuItem

public JCheckBoxMenuItem(Icon icon)

初期状態で選択されていない、アイコン付きのチェックボックス・メニュー項目を生成します。

パラメータ:

icon - JCheckBoxMenuItemのアイコン。

JCheckBoxMenuItem

public JCheckBoxMenuItem(String text)

初期状態で選択されていない、テキスト付きのチェックボックス・メニュー項目を生成します。

パラメータ:

text - JCheckBoxMenuItemのテキスト

JCheckBoxMenuItem

public JCheckBoxMenuItem(Action a)

指定されたActionからプロパティを取得するメニュー項目を生成します。

パラメータ:

a - JCheckBoxMenuItemの動作

導入されたバージョン:

1.3

JCheckBoxMenuItem

public JCheckBoxMenuItem(String text, Icon icon)

初期状態で選択されていない、指定されたテキストおよびアイコン付きのチェックボックス・メニュー項目を生成します。

パラメータ:

text - JCheckBoxMenuItemのテキスト

icon - JCheckBoxMenuItemのアイコン

JCheckBoxMenuItem

public JCheckBoxMenuItem(String text, boolean b)

指定されたテキストおよび選択状態を持つチェックボックス・メニュー項目を生成します。

パラメータ:

text - チェックボックス・メニュー項目のテキスト。

b - チェックボックス・メニュー項目の選択状態

JCheckBoxMenuItem

public JCheckBoxMenuItem(String text, Icon icon, boolean b)

指定されたテキスト、アイコン、および選択状態を持つチェックボックス・メニュー項目を生成します。

パラメータ:

text - チェックボックス・メニュー項目のテキスト

icon - チェックボックス・メニュー項目のアイコン

b - チェックボックス・メニュー項目の選択状態

メソッドの詳細

getUIClassID

@BeanProperty(bound=false) public String getUIClassID()

このコンポーネントをレンダリングするL&Fクラスの名前を返します。

オーバーライド:

getUIClassID、クラスJMenuItem

戻り値:

文字列"CheckBoxMenuItemUI"

関連項目:

• JComponent.getUIClassID()
• UIDefaults.getUI(javax.swing.JComponent)

getState

public boolean getState()

項目の選択状態を返します。 このメソッドは、AWTの互換性のためだけに用意されています。 新しいコードでは、代わりにisSelected()を使用します。

戻り値:

項目が選択されている場合はtrue

setState

@BeanProperty(bound=false, hidden=true, description="The selection state of the check box menu item") public void setState(boolean b)

項目の選択状態を設定します。 このメソッドは、AWTの互換性のためだけに用意されています。 新しいコードでは、代わりにsetSelected()を使用します。

パラメータ:

b - 項目の選択状態を示すboolean値。項目が選択されている場合はtrue

getSelectedObjects

@BeanProperty(bound=false) public Object[] getSelectedObjects()

チェックボックス・メニュー項目のラベルを格納する配列(長さ1)を返します。チェックボックスが選択されていない場合はnullを返します。

定義:

getSelectedObjects、インタフェースItemSelectable

オーバーライド:

getSelectedObjects、クラスAbstractButton

戻り値:

項目が選択されている場合は、メニュー項目のテキストである1個のオブジェクトを含む配列。そうでない場合はnull

paramString

protected String paramString()

このJCheckBoxMenuItemの文字列表現を返します。 このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なる可能性があります。 返される文字列は空でもかまいませんが、nullにはできません。

オーバーライド:

paramString、クラスJMenuItem

戻り値:

このJCheckBoxMenuItemの文字列表現。

getAccessibleContext

@BeanProperty(bound=false) public AccessibleContext getAccessibleContext()

このJCheckBoxMenuItemに関連付けられたAccessibleContextを取得します。 JCheckBoxMenuItemの場合、AccessibleContextはAccessibleJCheckBoxMenuItemの形式を取ります。 必要に応じて新規のAccessibleJCheckBoxMenuItemインスタンスが生成されます。

定義:

getAccessibleContext、インタフェースAccessible

オーバーライド:

getAccessibleContext、クラスJMenuItem

戻り値:

このAccessibleJCheckBoxMenuItemのAccessibleContextとして機能するAccessibleJCheckBoxMenuItem