モジュール java.desktop
パッケージ javax.swing

クラスJCheckBox

java.lang.Object
java.awt.Component
java.awt.Container
javax.swing.JComponent
javax.swing.AbstractButton
javax.swing.JToggleButton
javax.swing.JCheckBox
すべての実装されたインタフェース:
ImageObserver, ItemSelectable, MenuContainer, Serializable, Accessible, SwingConstants
@JavaBean(description="A component which can be selected or deselected.") public class JCheckBox extends JToggleButton implements Accessible
チェックボックス(選択または選択解除が可能で、その状態をユーザーに表示する項目)の実装です。 規則にしたがって、グループから任意の数のチェックボックスを選択できます。 チェックボックスの使用方法の詳細と例については、『The Java Tutorial』の「How to Use Buttons, Check Boxes, and Radio Buttons」を参照してください。

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

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

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

導入されたバージョン:
1.2
関連項目:

  • フィールド詳細

    • BORDER_PAINTED_FLAT_CHANGED_PROPERTY

      public static final String BORDER_PAINTED_FLAT_CHANGED_PROPERTY
      flatプロパティに対する変更を識別します。
      関連項目:

  • コンストラクタの詳細

    • JCheckBox

      public JCheckBox()
      初期状態で選択されていない、テキストおよびアイコンなしのチェックボックス・ボタンを生成します。

    • JCheckBox

      public JCheckBox(Icon icon)
      初期状態で選択されていない、アイコン付きのチェックボックスを生成します。
      パラメータ:
      icon - 表示するIconイメージ

    • JCheckBox

      public JCheckBox(Icon icon, boolean selected)
      アイコン付きのチェックボックスを生成し、それが初期状態で選択されるかどうかを指定します。
      パラメータ:
      icon - 表示するIconイメージ
      selected - 初期選択状態を示すboolean値。 trueの場合、チェックボックスが選択される

    • JCheckBox

      public JCheckBox(String text)
      初期状態で選択されていない、テキスト付きのチェックボックスを生成します。
      パラメータ:
      text - チェックボックスのテキスト。

    • JCheckBox

      public JCheckBox(Action a)
      指定されたActionからプロパティを取得するチェックボックスを生成します。
      パラメータ:
      a - 新しいチェックボックスを指定するために使用されるAction
      導入されたバージョン:
      1.3

    • JCheckBox

      public JCheckBox(String text, boolean selected)
      テキスト付きのチェックボックスを生成し、それが初期状態で選択されるかどうかを指定します。
      パラメータ:
      text - チェックボックスのテキスト。
      selected - 初期選択状態を示すboolean値。 trueの場合、チェックボックスが選択される

    • JCheckBox

      public JCheckBox(String text, Icon icon)
      初期状態で選択されていない、指定されたテキストおよびアイコン付きのチェックボックスを生成します。
      パラメータ:
      text - チェックボックスのテキスト。
      icon - 表示するIconイメージ

    • JCheckBox

      public JCheckBox(String text, Icon icon, boolean selected)
      テキストおよびアイコン付きのチェックボックスを生成し、それが初期状態で選択されるかどうかを指定します。
      パラメータ:
      text - チェックボックスのテキスト。
      icon - 表示するIconイメージ
      selected - 初期選択状態を示すboolean値。 trueの場合、チェックボックスが選択される

  • メソッドの詳細

    • setBorderPaintedFlat

      @BeanProperty(visualUpdate=true, description="Whether the border is painted flat.") public void setBorderPaintedFlat(boolean b)
      チェックボックス・ボーダーの外見についてのヒントをルック・アンド・フィールに与えるborderPaintedFlatプロパティを設定します。 JCheckBoxインスタンスがJTableやJTreeなどのコンポーネントでレンダリングとして使われている場合、このプロパティは通常trueに設定されます。 borderPaintedFlatプロパティのデフォルト値はfalseです。 このメソッドはプロパティ変更イベントをトリガーします。 均一なボーダーを実装しないルック・アンド・フィールではこのプロパティは無視されます。
      パラメータ:
      b - trueの場合はボーダーの均一なペイントが要求され、falseの場合は通常のボーダー・ペイントが要求される
      導入されたバージョン:
      1.3
      関連項目:

    • isBorderPaintedFlat

      public boolean isBorderPaintedFlat()
      borderPaintedFlatプロパティの値を取得します。
      戻り値:
      borderPaintedFlatプロパティの値
      導入されたバージョン:
      1.3
      関連項目:

    • updateUI

      public void updateUI()
      現在のルック・アンド・フィールからの値にUIプロパティをリセットします。
      オーバーライド:
      updateUI、クラスJToggleButton
      関連項目:

    • getUIClassID

      @BeanProperty(bound=false, expert=true, description="A string that specifies the name of the L&F class") public String getUIClassID()
      このコンポーネントをレンダリングするL&Fクラスの名前を指定する文字列を返します。
      オーバーライド:
      getUIClassID、クラスJToggleButton
      戻り値:
      CheckBoxUIの文字列
      関連項目:

    • paramString

      protected String paramString()
      このJCheckBoxの文字列表現を返します。 このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なる可能性があります。 返される文字列は空でもかまいませんが、nullにはできません。これは、JFCコンポーネントに固有な新しい面です。
      オーバーライド:
      paramString、クラスJToggleButton
      戻り値:
      このJCheckBoxの文字列表現

    • getAccessibleContext

      @BeanProperty(bound=false, expert=true, description="The AccessibleContext associated with this CheckBox.") public AccessibleContext getAccessibleContext()
      このJCheckBoxに関連付けられたAccessibleContextを取得します。 JCheckBoxの場合、AccessibleContextはAccessibleJCheckBoxの形式を取ります。 必要に応じて新規のAccessibleJCheckBoxインスタンスが生成されます。
      定義:
      getAccessibleContext、インタフェースAccessible
      オーバーライド:
      getAccessibleContext、クラスJToggleButton
      戻り値:
      このJCheckBoxのAccessibleContextとして機能するAccessibleJCheckBox