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メソッドの方をお薦めします。これらは、すべてのメニューとボタンで機能します。getStateおよびsetStateメソッドは、他のコンポーネント・セットとの互換性のために用意されています。

メニュー項目は構成可能であり、Actionを使用してある程度制御できます。メニュー項目でActionを使用することは、メニュー項目を直接構成するのと比べて多くの利点があります。詳細は「ActionをサポートするSwingコンポーネント」を参照してください。さらに、Java チュートリアルの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から継承されたフィールド

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

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