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

クラスJWindow

java.lang.Object
java.awt.Component
java.awt.Container
java.awt.Window
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。

    • isRootPaneCheckingEnabled

      protected boolean isRootPaneCheckingEnabled()
      addおよびsetLayoutの呼出しがcontentPaneに転送されるかどうかを返します。
      戻り値:
      addおよびsetLayoutが転送される場合はtrue、それ以外の場合はfalse
      関連項目:
      addImpl(java.awt.Component, java.lang.Object, int), setLayout(java.awt.LayoutManager), setRootPaneCheckingEnabled(boolean), RootPaneContainer

    • 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)

    • getTransferHandler

      public TransferHandler getTransferHandler()
      transferHandlerプロパティを取得します。
      戻り値:
      transferHandlerプロパティの値
      導入されたバージョン:
      1.6
      関連項目:
      TransferHandler, setTransferHandler(javax.swing.TransferHandler)

    • update

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

    • setRootPaneCheckingEnabled

      @BeanProperty(hidden=true, description="Whether the add and setLayout methods are forwarded")protected void setRootPaneCheckingEnabled​(boolean enabled)
      addおよびsetLayoutの呼出しがcontentPaneに転送されるかどうかを設定します。
      パラメータ:
      enabled - addおよびsetLayoutが転送される場合はtrue、JWindowで直接実行する必要がある場合はfalse。
      関連項目:
      addImpl(java.awt.Component, java.lang.Object, int), setLayout(java.awt.LayoutManager), isRootPaneCheckingEnabled(), RootPaneContainer

    • 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

    • setLayout

      public void setLayout​(LayoutManager manager)
      LayoutManagerを設定します。 オーバーライドすると、呼出しが条件付きでcontentPaneに転送されます。 詳細は、RootPaneContainerを参照してください。
      オーバーライド:
      setLayout、クラス: Container
      パラメータ:
      manager - LayoutManager
      関連項目:
      setRootPaneCheckingEnabled(boolean), RootPaneContainer

    • getRootPane

      @BeanProperty(bound=false, hidden=true, description="the RootPane object for this window.") public JRootPane getRootPane()
      このウィンドウのrootPaneオブジェクトを返します。
      定義:
      getRootPane、インタフェース: RootPaneContainer
      戻り値:
      このウィンドウのrootPaneプロパティ
      関連項目:
      setRootPane(javax.swing.JRootPane), RootPaneContainer.getRootPane()

    • setRootPane

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

    • getContentPane

      public Container getContentPane()
      このウィンドウのcontentPaneであるContainerを返します。
      定義:
      getContentPane、インタフェース: RootPaneContainer
      戻り値:
      contentPaneプロパティ
      関連項目:
      setContentPane(java.awt.Container), RootPaneContainer.getContentPane()

    • setContentPane

      @BeanProperty(bound=false, hidden=true, description="The client area of the window where child components are normally inserted.")public void setContentPane​(Container contentPane)
      このウィンドウのcontentPaneプロパティを設定します。 このメソッドはコンストラクタによって呼び出されます。
      定義:
      setContentPane、インタフェース: RootPaneContainer
      パラメータ:
      contentPane - 新しいcontentPane
      例外:
      IllegalComponentStateException - (実行時例外)コンテンツ・ペイン・パラメータが次の場合: null
      関連項目:
      getContentPane(), RootPaneContainer.setContentPane(java.awt.Container)

    • getLayeredPane

      public JLayeredPane getLayeredPane()
      このウィンドウのlayeredPaneオブジェクトを返します。
      定義:
      getLayeredPane、インタフェース: RootPaneContainer
      戻り値:
      layeredPaneプロパティ
      関連項目:
      setLayeredPane(javax.swing.JLayeredPane), RootPaneContainer.getLayeredPane()

    • setLayeredPane

      @BeanProperty(bound=false, hidden=true, description="The pane which holds the various window layers.")public void setLayeredPane​(JLayeredPane layeredPane)
      layeredPaneプロパティを設定します。 このメソッドはコンストラクタによって呼び出されます。
      定義:
      setLayeredPane、インタフェース: RootPaneContainer
      パラメータ:
      layeredPane - 新しいlayeredPaneオブジェクト
      例外:
      IllegalComponentStateException - (実行時例外)コンテンツ・ペイン・パラメータが次の場合: null
      関連項目:
      getLayeredPane(), RootPaneContainer.setLayeredPane(javax.swing.JLayeredPane)

    • getGlassPane

      public Component getGlassPane()
      このウィンドウのglassPane Componentを返します。
      定義:
      getGlassPane、インタフェース: RootPaneContainer
      戻り値:
      glassPaneプロパティ
      関連項目:
      setGlassPane(java.awt.Component), RootPaneContainer.getGlassPane()

    • setGlassPane

      @BeanProperty(bound=false, hidden=true, description="A transparent pane used for menu rendering.")public void setGlassPane​(Component glassPane)
      glassPaneプロパティを設定します。 このメソッドはコンストラクタによって呼び出されます。
      定義:
      setGlassPane、インタフェース: RootPaneContainer
      パラメータ:
      glassPane - このウィンドウのglassPaneオブジェクト
      関連項目:
      getGlassPane(), RootPaneContainer.setGlassPane(java.awt.Component)

    • 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