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

クラスJWindow

  • すべての実装されたインタフェース:
    ImageObserver, MenuContainer, Serializable, Accessible, RootPaneContainer
    @JavaBean(defaultProperty="accessibleContext",
          description="A toplevel window which has no system border or controls.")
public class JWindow
extends Window
implements Accessible, RootPaneContainer
    JWindowは、ユーザーのデスクトップ上のどこにでも表示できるコンテナです。 タイトル・バー、ウィンドウ管理ボタン、またはJFrameに関連したほかの装飾を持ちませんが、それでもユーザーのデスクトップの「最上級のメンバー」であり、そのどこにでも表示できます。

    JWindowコンポーネントには、唯一の子としてJRootPaneが格納されます。 contentPaneは、JWindowのすべての子の親になります。 便宜上、このクラスのadd、removeおよびsetLayoutメソッドは、ContentPaneの対応するメソッドに呼出しを委譲するようにオーバーライドされます。 たとえば、次のようにしてウィンドウに子コンポーネントを追加できます。 

           window.add(child);
    子はcontentPaneに追加されます。 contentPaneは常にnull以外の値になります。 nullに設定しようとするとJWindowは例外をスローします。 デフォルトのcontentPaneには、BorderLayoutマネージャが設定されます。 JWindowのLayoutManagerの追加、削除、および設定の詳細については、RootPaneContainerを参照してください。

    contentPane、glassPane、およびlayeredPaneコンポーネントの詳細については、JRootPaneの説明を参照してください。

    マルチスクリーン環境の場合には、別のスクリーン・デバイス上にJWindowを生成できます。 詳細は、Windowを参照してください。

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

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

    導入されたバージョン:
    1.2
    関連項目:
    JRootPane, 「直列化されたフォーム」

    • コンストラクタの詳細

      • JWindow

        public JWindow()
        オーナーの指定されていないウィンドウを作成します。 このウィンドウには、フォーカスが設定されません。

        このコンストラクタはコンポーネントのローカル・プロパティをJComponent.getDefaultLocaleによって返された値に設定します。

        例外:
        HeadlessException - GraphicsEnvironment.isHeadless()がtrueを返した場合。
        関連項目:
        GraphicsEnvironment.isHeadless(), Window.isFocusableWindow(), JComponent.getDefaultLocale()

      • JWindow

        public JWindow​(GraphicsConfiguration gc)
        画面デバイスの指定されたGraphicsConfigurationでウィンドウを作成します。 このウィンドウには、フォーカスが設定されません。

        このコンストラクタはコンポーネントのローカル・プロパティをJComponent.getDefaultLocaleによって返された値に設定します。

        パラメータ:
        gc - 新しいウィンドウの構築に使用するGraphicsConfiguration。gcがnullの場合、システムのデフォルトのGraphicsConfigurationが使用される
        例外:
        HeadlessException - GraphicsEnvironment.isHeadless()がtrueを返した場合。
        IllegalArgumentException - gcが画面デバイスのものでない場合。
        導入されたバージョン:
        1.3
        関連項目:
        GraphicsEnvironment.isHeadless(), Window.isFocusableWindow(), JComponent.getDefaultLocale()

      • JWindow

        public JWindow​(Frame owner)
        指定された所有者フレームで、ウィンドウを作成します。 ownerがnullの場合は、共有所有者が使用され、このウィンドウにはフォーカスが設定されません。 また、所有者が画面に表示されないかぎり、このウィンドウにはフォーカスが設定されません。

        このコンストラクタはコンポーネントのローカル・プロパティをJComponent.getDefaultLocaleによって返された値に設定します。

        パラメータ:
        owner - ウィンドウを表示するフレーム
        例外:
        HeadlessException - GraphicsEnvironment.isHeadless()がtrueを返した場合。
        関連項目:
        GraphicsEnvironment.isHeadless(), Window.isFocusableWindow(), JComponent.getDefaultLocale()

      • JWindow

        public JWindow​(Window owner)
        オーナー・ウィンドウを指定してウィンドウを作成します。 所有者が画面に表示されないかぎり、このウィンドウにはフォーカスが設定されません。 ownerがnullの場合は、共有所有者が使用され、このウィンドウにはフォーカスが設定されません。

        このコンストラクタはコンポーネントのローカル・プロパティをJComponent.getDefaultLocaleによって返された値に設定します。

        パラメータ:
        owner - ウィンドウを表示するウィンドウ
        例外:
        HeadlessException - GraphicsEnvironment.isHeadless()がtrueを返した場合。
        関連項目:
        GraphicsEnvironment.isHeadless(), Window.isFocusableWindow(), JComponent.getDefaultLocale()

      • JWindow

        public JWindow​(Window owner,
               GraphicsConfiguration gc)
        指定された所有者ウィンドウと画面デバイスのGraphicsConfigurationでウィンドウを作成します。 ownerがnullの場合は、共有所有者が使用され、このウィンドウにはフォーカスが設定されません。

        このコンストラクタはコンポーネントのローカル・プロパティをJComponent.getDefaultLocaleによって返された値に設定します。

        パラメータ:
        owner - ウィンドウを表示するウィンドウ
        gc - 新しいウィンドウの構築に使用するGraphicsConfiguration。gcがnullの場合、システム・デフォルトのGraphicsConfigurationが使われる。ただし、ownerもnullの場合は、共有所有者フレームのGraphicsConfigurationが使われる。
        例外:
        HeadlessException - GraphicsEnvironment.isHeadless()がtrueを返した場合。
        IllegalArgumentException - gcが画面デバイスのものでない場合。
        導入されたバージョン:
        1.3
        関連項目:
        GraphicsEnvironment.isHeadless(), Window.isFocusableWindow(), JComponent.getDefaultLocale()

    • メソッドの詳細

      • windowInit

        protected void windowInit()
        JWindowを適切に初期化するためにコンストラクタによって呼び出されます。

      • createRootPane

        protected JRootPane createRootPane()
        デフォルトのrootPaneを作成するために、コンストラクタ・メソッドから呼び出されます。
        戻り値:
        新しいJRootPane。

      • setTransferHandler

        @BeanProperty(hidden=true,
              description="Mechanism for transfer of data into the component")
public void setTransferHandler​(TransferHandler newHandler)
        このコンポーネントへのデータ転送をサポートするメカニズムである、transferHandlerプロパティを設定します。 コンポーネントがデータ転送操作をサポートしない場合、nullを使用します。

        システム・プロパティsuppressSwingDropSupportがfalse (デフォルト)であり、このコンポーネント上の現在のドロップ・ターゲットがnullであるか、ユーザー設定のドロップ・ターゲットでない場合、このメソッドはドロップ・ターゲットを次のように変更します。newHandlerがnullの場合は、ドロップ・ターゲットをクリアします。 nullでない場合は、新しいDropTargetをインストールします。

        ノート: JWindowと組み合わせて使用した場合、TransferHandlerはデータのインポート機能しか提供しません。これは、データのエクスポート関連のメソッドが現在JComponent型になっているためです。

        詳細は、『The Java Tutorial』の「How to Use Drag and Drop and Data Transfer」を参照してください。

        パラメータ:
        newHandler - 新しいTransferHandler
        導入されたバージョン:
        1.6
        関連項目:
        TransferHandler, getTransferHandler(), Component.setDropTarget(java.awt.dnd.DropTarget)

      • update

        public void update​(Graphics g)
        paint(g)を呼び出します。 このメソッドは、バックグラウンドをクリアする不必要な呼出しが行われないようにするためにオーバーライドされました。
        オーバーライド:
        update、クラスContainer
        パラメータ:
        g - ペイント対象のGraphicsコンテキスト
        関連項目:
        Component.update(Graphics)

      • addImpl

        protected void addImpl​(Component comp,
                       Object constraints,
                       int index)
        指定された子Componentを追加します。 このメソッドをオーバーライドすると、呼出しが条件付きでcontentPaneに転送されます。 デフォルトでは、子はフレームではなくcontentPaneに追加されます。詳細は、RootPaneContainerを参照してください。
        オーバーライド:
        addImpl、クラスContainer
        パラメータ:
        comp - 拡張されるコンポーネント
        constraints - 遵守されるべき制約
        index - インデックス
        例外:
        IllegalArgumentException - indexが無効である場合
        IllegalArgumentException - コンテナの親をそのコンテナ自体に追加しようとしている場合
        IllegalArgumentException - ウィンドウをコンテナに追加しようとしている場合
        関連項目:
        setRootPaneCheckingEnabled(boolean), RootPaneContainer

      • remove

        public void remove​(Component comp)
        指定されたコンポーネントをコンテナから削除します。 compがrootPaneでない場合は、呼出しがcontentPaneに転送されます。 compがJWindowまたはcontentPaneの子でない場合は、何も行われません。
        オーバーライド:
        remove、クラスContainer
        パラメータ:
        comp - 削除されるコンポーネント
        例外:
        NullPointerException - compがnullである場合
        関連項目:
        Container.add(java.awt.Component), RootPaneContainer

      • setRootPane

        protected void setRootPane​(JRootPane root)
        このウィンドウの新しいrootPaneオブジェクトを設定します。 このメソッドはコンストラクタによって呼び出されます。
        パラメータ:
        root - 新しいrootPaneプロパティ
        関連項目:
        getRootPane()

      • getGraphics

        @BeanProperty(bound=false)
public Graphics getGraphics()
        このコンポーネントのグラフィックス・コンテキストを作成します。 このメソッドは、コンポーネントが現在表示可能でない場合、nullを返します。
        オーバーライド:
        getGraphics、クラスComponent
        戻り値:
        このコンポーネントのグラフィックス・コンテキスト。ない場合はnull
        導入されたバージョン:
        1.6
        関連項目:
        Component.paint(java.awt.Graphics)

      • repaint

        public void repaint​(long time,
                    int x,
                    int y,
                    int width,
                    int height)
        このコンポーネントの指定された矩形をtimeミリ秒以内に再ペイントします。 再ペイントの方法の詳細は、RepaintManagerを参照してください。
        オーバーライド:
        repaint、クラスComponent
        パラメータ:
        time - 更新までの最大時間(ミリ秒単位)
        x - x座標
        y - y座標
        width - 幅
        height - 高さ
        導入されたバージョン:
        1.6
        関連項目:
        RepaintManager

      • paramString

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

      • getAccessibleContext

        public AccessibleContext getAccessibleContext()
        このJWindowに関連付けられたAccessibleContextを取得します。 JWindowの場合、AccessibleContextはAccessibleJWindowの形式を取ります。 必要に応じて新規のAccessibleJWindowインスタンスが作成されます。
        定義:
        getAccessibleContext、インタフェースAccessible
        オーバーライド:
        getAccessibleContext、クラスWindow
        戻り値:
        このJWindowのAccessibleContextとして機能するAccessibleJWindow