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

public class JCheckBoxMenuItem
extends JMenuItem
implements SwingConstants, Accessible

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

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

メニュー項目は構成可能で、Action を使ってある程度まで制御できます。メニュー項目に対して Action を使用すると、直接メニュー項目を構成する場合よりも多くの利点があります。詳細は、「Action をサポートする Swing コンポーネント」を参照してください。また、『The Java Tutorial』の「How to Use Actions」も参照してください。

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

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

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

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

ネストされたクラス

修飾子と型	クラスと説明
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 から継承されたフィールド

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

クラス java.awt.Component から継承されたフィールド

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

インタフェース 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

インタフェース java.awt.image.ImageObserver から継承されたフィールド

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

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

コンストラクタ

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

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
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, 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, 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, getPeer, 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, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, 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 - CheckBoxMenuItem のアイコン。

JCheckBoxMenuItem

public JCheckBoxMenuItem(String text)

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

パラメータ:

text - CheckBoxMenuItem のテキスト

JCheckBoxMenuItem

public JCheckBoxMenuItem(Action a)

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

導入されたバージョン:

1.3

JCheckBoxMenuItem

public JCheckBoxMenuItem(String text,
                 Icon icon)

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

パラメータ:

text - CheckBoxMenuItem のテキスト

icon - CheckBoxMenuItem のアイコン

JCheckBoxMenuItem

public JCheckBoxMenuItem(String text,
                 boolean b)

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

パラメータ:

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

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

JCheckBoxMenuItem

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

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

パラメータ:

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

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

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

メソッドの詳細

getUIClassID

public String getUIClassID()

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

オーバーライド:

getUIClassID 、クラス: JMenuItem

戻り値:

CheckBoxMenuItemUI

関連項目:

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

getState

public boolean getState()

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

戻り値:

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

setState

public void setState(boolean b)

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

パラメータ:

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

getSelectedObjects

public Object[] getSelectedObjects()

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

定義:

getSelectedObjects 、インタフェース: ItemSelectable

オーバーライド:

getSelectedObjects 、クラス: AbstractButton

戻り値:

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

paramString

protected String paramString()

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

オーバーライド:

paramString 、クラス: JMenuItem

戻り値:

この JCheckBoxMenuItem の文字列表現。

getAccessibleContext

public AccessibleContext getAccessibleContext()

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

定義:

getAccessibleContext 、インタフェース: Accessible

オーバーライド:

getAccessibleContext 、クラス: JMenuItem

戻り値:

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