Ａｐｐｌｅｔ クラス

[内容]

　　アプレットを生成するためのクラスです．Panelのサブクラスであり，Panel とほとんど同じメソッドを使用できます．デフォルトレイアウトは，FlowLayout です．

[主なメソッド]

• public Component add(Component comp)　　（ Container から継承）
  コンポーネントを付加する

• public Component add(Component comp, int index)　　（ Container から継承）
  コンポーネントを指定した位置に付加する．index が -1 の場合は最後に付加される．

• public void add(Component comp, Object constraints)　　（ Container から継承）
  レイアウトマネージャの制約に従って，コンポーネントを付加する

• public void add(Component comp, Object constraints, int index)　　（ Container から継承）
  レイアウトマネージャの制約に従って，指定された位置にコンポーネントを付加する

• public void add(PopupMenu popup)　　（ Component から継承）
  ポップアップメニューを付加する

• public void addComponentListener(ComponentListener l)　　（ Component から継承）
  ComponentListener を付加する

• public void addFocusListener(FocusListener l)　　（ Component から継承）
  FocusListener を付加する

• public void addKeyListener(KeyListener l)　　（ Component から継承）
  KeyListener を付加する

• public void addMouseListener(MouseListener l)　　（ Component から継承）
  MouseListener を付加する

• public void addMouseMotionListener(MouseMotionListener l)　　（ Component から継承）
  MouseMotionListener を付加する

• public boolean contains(Point p)　　（ Component から継承）
• public boolean contains(int x, int y)　　（ Component から継承）
  コンポーネントが指定された点を含んでいるか否かを返す（参照： Point クラス）

• public void destroy()
  ブラウザが正常終了したときに自動的に呼び出される．アプレットがアクティブであるときは，destroy メソッドを呼び出す前に stop メソッドを呼び出す．アプレットパネル以外に解放すべきリソースがない場合は特に使用する必要はない．

• public AppletContext getAppletContext()
  アプレットのコンテキストを取得する．アプレットは，コンテキストを使用してアプレットの実行環境に関する情報を得たり，実行環境を制御したりすることができる．

• public AudioClip getAudioClip(URL url)
• public AudioClip getAudioClip(URL url, String name)
  指定した URL から AudioClip オブジェクトを読み込む．

• public URL getCodeBase()
  アプレットのコードがある URL を返す

• public URL getDocumentBase()
  アプレットが埋め込まれている HTML ファイルがある URL を返す

• public Image getImage(URL url)
• public Image getImage(URL url, String name)
  指定した URL からイメージを読み込む

• public String getParameter(String name)
  HTML から渡されたパラメータ name の値を返す

• public void init()
  アプレットが開始されるときにブラウザから呼び出され，アプレットの初期化を行う．コンストラクタの機能と非常に似ている．init メソッドの後には，必ず，atart メソッドが呼び出される．

• public boolean isFocusable()　　（ Component から継承）
  フォーカスが設定可能かどうかを返す

• public static final AudioClip newAudioClip(URL url)
  指定した URL から AudioClip オブジェクトを取得する．

• public void paint(Graphics g)　　（ Container から継承）
  描画

• public void play(URL url)
• public void play(URL url, String name)
  指定した URL にある AudioClip オブジェクトを実行する

• public void remove(MenuComponent m)　　（ Component から継承）
  指定されたメニューバーを削除する

• public void remove(Component comp)　　（ Container から継承）
  指定されたコンポーネントを取り除く

• public void remove(int index)　　（ Container から継承）
  index で指定されたコンポーネントを取り除く

• public void removeAll()　　（ Container から継承）
  すべてのコンポーネントを取り除く

• public void removeComponentListener(ComponentListener l)　　（ Component から継承）
  ComponentListener を取り除く

• public void removeFocusListener(FocusListener l)　　（ Component から継承）
  FocusListener を取り除く

• public void removeKeyListener(KeyListener l)　　（ Component から継承）
  KeyListener を取り除く

• public void removeMouseListener(MouseListener l)　　（ Component から継承）
  MouseListener を取り除く

• public void removeMouseMotionListener(MouseMotionListener l)　　（ Component から継承）
  MouseMotionListener を取り除く

• public void repaint()　　（ Component から継承）
• public void repaint(int x, int y, int width, int height)　　（ Component から継承）
• public void repaint(long tm)　　（ Component から継承）
• public void repaint(long tm, int x, int y, int width, int height)　　（ Component から継承）
  指定された矩形領域を，tm ミリ秒以内に再描画する

• public void setBackground(Color c)　　（ Component から継承）
  バックグラウンドカラーを設定する

• public void setBounds(int x, int y, int width, int height)　　（ Component から継承）
• public void setBounds(Rectangle r)　　（ Component から継承）
  コンポーネントを動かし，大きさを変える（参照： Rectangle クラス）

• public void setEnabled(boolean b)　　（ Component から継承）
  コンポーネントを enable，または，disable にする．disable にするとイベントを受け付けなくなる．

• public void setFont(Font f)　　（ Container から継承）
  コンテナのフォントを設定する

• public void setForeground(Color c)　　（ Component から継承）
  フォアグラウンドカラーを設定する

• public void setLayout(LayoutManager mgr)　　（ Container から継承）
  コンテナのレイアウトマネージャを設定する

• public void setLocation(int x, int y)　　（ Component から継承）
• public void setLocation(Point p)　　（ Component から継承）
  コンポーネントの位置を設定する（参照： Point クラス）

• public void setName(String name)　　（ Component から継承）
  コンポーネントの名前を設定する

• public void setSize(int width, int height)　　（ Component から継承）
• public void setSize(Dimension d)　　（ Component から継承）
  コンポーネントの大きさを width （ d.width ），height （ d.height ）に設定する（ Dimension については，プログラム例を参照）

• public void setVisible(boolean b)　　（ Component から継承）
  コンポーネントを表示，非表示にする

• public void start()
  ブラウザが init メソッドを呼び出したとき，または，他のページからアプレットのあるページへ戻ったときに自動的に呼び出される．init メソッドとは異なり，何回も呼ばれる可能性がある．

• public void stop()
  他のページへ移動するとき自動的に呼び出される．statr メソッドと同様，何回も呼び出される可能性がある．スレッドを使用してアニメーションを実行しているような場合，他のページへ移っている間そのアニメーションを停止させておくような処理のために使用される．

[使用例]

1. 基本的な Applet 生成例です．HTML ファイルからパ ラメータを受け取り，小さな子 Window を生成しています．init，start の各メソッドの使用例ともなっています．ここをクリックして表示してみてください（プログラム）．なお，Web ページに貼り付けるには，以下に示してあるように，OBJECT 要素を使用します．

   <object type="application/x-java-applet" width="600" height="400">
   	<param name="code" value="Ball.class">
   	<param name="codebase" value="applet/" >
   </object>
   				

   　　一般に，プログラムが大きくなると多くのクラスファイルが生成されます．そのため，プログラムをダウンロードするのに時間がかかるようになります．そこで，Java では，jar コマンドを使用して，複数のファイルを圧縮しながら 1 つのファイルにまとめることができます．jar コマンドの一般形式は以下に示す通りであり，クラスファイルだけでなく，画像等のファイルを含めることも可能です．

   jar [オプション] JARファイル [マニフェストファイル] [圧縮するファイル ･･･]

   例えば，

   jar cvf Ball.jar *.class

   のようにして作成された jar ファイルをアプレットで利用する場合は，以下のようになります．

   <object type="application/x-java-applet" width="600" height="400">
   	<param name="codebase" value="applet/" >
   	<param name="archive" value="Ball.jar" >
   	<param name="code" value="Ball" >
   </object>
   				

2. プログラム例は，イメージファイルを表示した Window をスクリーン中央に表示し，バックグラウンドミュージックを流した例です．なお，Applet の場合は，イメージファイルの読み込みに対し，Toolkit を使用せず，getDocumenyBase または getCodeBase メソッドによって可能です．ここをクリックするとアプレット版が表示されます（プログラム）．

   

3. プログラム例は，簡単な描画の例です．Window を GridLayout により，上下 2 つに分け，下の領域に描画しています．ここをクリックするとアプレット版が表示されます（プログラム）．

   

4. プログラム例は，文字が回転しながら移動する非常に単純なアニメーションです．上の例と同様，外部から画像を読み込んでいますが，異なる画像を順に表示しています．ここをクリックして，表示してみてください．

5. プログラムは，キーイベント処理の例です．下に示した青い四角形は，「 z 」および「 x 」キーによって左右に動かすことができます．また，Shift キーを押すと，光線が発射され，円に命中すると円が消滅します．

[参照]

Panel,　Toolkit,　JApplet