- 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つのチェックボックス・メニュー・アイテムをクリックしてもメニューを閉じることはできません。 このような動作は、クライアント
JComponent.putClientProperty(java.lang.Object, java.lang.Object)
またはLook&FeelUIManager.put(java.lang.Object, java.lang.Object)
プロパティ"CheckBoxMenuItem.doNotCloseOnMouseClick"
のいずれかによって制御できます。 デフォルト値はfalse
です。 プロパティをtrue
に設定すると、マウスでクリックしたときにメニューが閉じなくなります。 clientプロパティが設定されている場合、その値は常に使用されます。それ以外の場合は、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, 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, setModel, 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, 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, hide, 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
-
-
-
-
コンストラクタの詳細
-
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
- チェックボックス・メニュー項目の選択状態
-
-
メソッドの詳細
-
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
-
-