Por favor, lembre-se que esta tradução da especificação é resultado de um projeto da comunidade java.net( https://jdk5-api-pt-br.dev.java.net/). A versão oficial da especificação é a versão na língua inglesa que pode ser encontrada em http://java.sun.com/j2se/1.5.0/docs/api/. Em caso de divergências, a versão predominante da especificação é a original em inglês.

Please note that this translation of the specification is the result of a java.net community project ( https://jdk5-api-pt-br.dev.java.net/ ). The official version of the specification is the US English language version which can be found at http://java.sun.com/j2se/1.5.0/docs/api/. In case of disputes, the authoritative version of the specification is the original, English document.

java.applet
Class Applet

java.lang.Object
  java.awt.Component
      java.awt.Container
          java.awt.Panel
              java.applet.Applet

All Implemented Interfaces:

ImageObserver, MenuContainer, Serializable, Accessible

Direct Known Subclasses:

JApplet

public class Applet
extends Panel

Um applet é um pequeno programa que não tem o propósito de ser executado por si só, mas sim ser embutido dentro de uma outra aplicação.

A classe Applet deve ser a superclasse de qualquer applet que seja embutido em uma página Web ou visualizado pelo Java Applet Viewer. A classe Applet fornece uma interface padrão entre os applets e seus ambientes.

Since:

JDK1.0

See Also:

Serialized Form

Nested Class Summary

protected class

Applet.AccessibleApplet Esta classe implementa suporte de acessibilidade para a classe Applet.

Nested classes/interfaces inherited from class java.awt.Panel

Panel.AccessibleAWTPanel

Nested classes/interfaces inherited from class java.awt.Container

Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class java.awt.Component

Component.AccessibleAWTComponent, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary

Fields inherited from class java.awt.Component

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

Applet()
Cria um novo objeto Applet

Method Summary

void	destroy() Chamado pelo browser ou visualizador de applet para informar este applet que ele está sendo regenerado e deveria destruir qualquer recurso que ele tenha alocado.
AccessibleContext	getAccessibleContext() Obtém o AccessibleContext associado com este Applet.
AppletContext	getAppletContext() Determina o contexto do applet, o qual permite o applet a obter informação e interagir com o ambiente no qual ele está sendo executado.
String	getAppletInfo() Retorna informações sobre este applet.
AudioClip	getAudioClip(URL url) Retorna o objeto AudioClip especificado pelo parâmetro URL.
AudioClip	getAudioClip(URL url, String name) Retorna o objeto AudioClip especificado pelos parâmetros URL e name.
URL	getCodeBase() Obtém a URL base.
URL	getDocumentBase() Obtém a URL do documento no qual este applet está embutido.
Image	getImage(URL url) Retorna um objeto Image que pode então ser pintado na tela.
Image	getImage(URL url, String name) Retorna um objeto Image que pode então ser pintado na tela.
Locale	getLocale() Obtém o Locale (localidade) para o applet, se foi atribuído.
String	getParameter(String name) Retorna o valor do parâmetro nomeado na tag HTML.
String[][]	getParameterInfo() Retorna informações sobre os parâmetros que são compreendidos por este applet.
void	init() Chamado pelo browser ou visualizador de applet para informar este applet que ele foi carregado no sistema.
boolean	isActive() Determina se este applet está ativo.
static AudioClip	newAudioClip(URL url) Obtém clipe de áudio da URL fornecida.
void	play(URL url) Toca o clipe de áudio na URL absoluta.
void	play(URL url, String name) Toca o clipe de áudio dado uma URL e um especificador que relativo a URL.
void	resize(Dimension d) Solicita que este applet seja redimensionado.
void	resize(int width, int height) Solicita que este applet seja redimensionado.
void	setStub(AppletStub stub) Atribue este stub ao applet.
void	showStatus(String msg) Solicita que a mensagem no parâmetro seja apresentada na "janela de estado".
void	start() Chamado pelo browser ou visualizador de applet para informar este applet que ele deveria iniciar sua execução.
void	stop() Chamada pelo browser ou visualizador de applet para informar este applet que ele deveria parar sua execução.

Methods inherited from class java.awt.Panel

addNotify

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getInsets, getLayout, getListeners, getMaximumSize, getMinimumSize, getMousePosition, getPreferredSize, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paint, paintComponents, paramString, preferredSize, print, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, removeNotify, setComponentZOrder, setFocusCycleRoot, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, setLayout, transferFocusBackward, transferFocusDownCycle, update, validate, validateTree

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, reshape, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setName, setPreferredSize, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusUpCycle

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

Applet

public Applet()
       throws HeadlessException

Cria um novo objeto Applet

Throws:

HeadlessException - se GraphicsEnvironment.isHeadless() retornar true.

Since:

1.4

See Also:

GraphicsEnvironment.isHeadless()

Method Detail

setStub

public final void setStub(AppletStub stub)

Atribue este stub ao applet. Isto é feito automaticamente pelo sistema.

Se existir um gerenciador de segurança, seu método checkPermission é chamado com a permissão AWTPermission("setAppletStub") se um stub já foi atribuído.

Parameters:

stub - o novo stub.

Throws:

SecurityException - se chamador não puder atribuir o stub

isActive

public boolean isActive()

Determina se este applet está ativo. Um applet é marcado como ativo imediatamente antes que seu método start seja chamado. Ele se torna inativo imediatamente antes que seu método stop seja chamado.

Returns:

true se o applet está ativo; false caso contrário.

See Also:

start(), stop()

getDocumentBase

public URL getDocumentBase()

Obtém a URL do documento no qual este applet está embutido. Por exemplo, suponha que um applet está contido dentro do documento:

    http://java.sun.com/products/jdk/1.2/index.html
 

A base do documento é:

    http://java.sun.com/products/jdk/1.2/index.html
 

Returns:

o URL do documento que contém este applet.

See Also:

getCodeBase()

getCodeBase

public URL getCodeBase()

Obtém a URL base. Isto é, a URL do diretório que contém este applet.

Returns:

a URL base do diretório que contém este applet.

See Also:

getDocumentBase()

getParameter

public String getParameter(String name)

Retorna o valor do parâmetro nomeado na tag HTML. Por exemplo, se este applet é especificado como

 <applet code="Clock" width=50 height=50>
 <param name=Color value="blue">
 </applet>
 

então uma chamada a getParameter("Color") retorna o valor "blue".

O argumento name é caso insensitivo.

Parameters:

name - um nome de parâmetro.

Returns:

o valor do parâmetro nomeado, ou null se não atribuído.

getAppletContext

public AppletContext getAppletContext()

Determina o contexto do applet, o qual permite o applet a obter informação e interagir com o ambiente no qual ele está sendo executado.

Este ambiente de um applet representa o documento que contém o applet.

Returns:

o contexto do applet.

resize

public void resize(int width,
                   int height)

Solicita que este applet seja redimensionado.

Overrides:

resize in class Component

Parameters:

width - a nova largura solicitada para o applet.

height - a nova altura solicitada para o applet.

resize

public void resize(Dimension d)

Solicita que este applet seja redimensionado.

Overrides:

resize in class Component

Parameters:

d - um objeto com a nova altura e largura.

showStatus

public void showStatus(String msg)

Solicita que a mensagem no parâmetro seja apresentada na "janela de estado". Muitos browsers e visualizadores de applet fornecem tal janela, onde uma aplicação pode informar aos usuários seu estado atual.

Parameters:

msg - uma mensagem para apresentar na janela de estado.

getImage

public Image getImage(URL url)

Retorna um objeto Image que pode então ser pintado na tela. A url que é passada como parâmetro deve especificar uma URL absoluta.

Este método sempre retorna imediatamente, se a imagem existe ou não. Quando este applet tenta desenhar a imagem na tela, os dados serão recarregados. As primitivas gráficas que desenham a imagem serão incrementalmente pintadas na tela.

Parameters:

url - uma URL absoluta fornecendo a localização da imagem.

Returns:

a image na URL especificada.

See Also:

Image

getImage

public Image getImage(URL url,
                      String name)

Retorna um objeto Image que pode então ser pintado na tela. O parâmetro url deve especificar uma URL absoluta. O parâmetro name é um especificador que é relativo ao parâmetro url.

Este método sempre retorna imediatamente, se a imagem existe ou não. Quando este applet tenta desenhar a imagem na tela, os dados serão recarregados. As primitivas gráficas que desenham a imagem serão incrementalmente pintadas na tela.

Parameters:

url - uma URL absoluta fornecendo a localização da imagem.

name - a localização da imagem, relativa ao parâmetro url.

Returns:

a imagem na URL especificada.

See Also:

Image

newAudioClip

public static final AudioClip newAudioClip(URL url)

Obtém clipe de áudio da URL fornecida.

Parameters:

url - aponta para o clipe de áudio

Returns:

o clipe de áudio na URL especificada.

Since:

1.2

getAudioClip

public AudioClip getAudioClip(URL url)

Retorna o objeto AudioClip especificado pelo parâmetro URL.

Este método sempre retorna imediatamente, se o clipe de áudio existe ou não. Quando este applet tenta tocar o clipe de áudio, os dados serão recarregado.

Parameters:

url - uma URL absoluta fornecendo a localização do clipe de áudio.

Returns:

o clipe de áudio na URL especificada.

See Also:

AudioClip

getAudioClip

public AudioClip getAudioClip(URL url,
                              String name)

Retorna o objeto AudioClip especificado pelos parâmetros URL e name.

Este método sempre retorna imediatamente, se o clipe de áudio existe ou não. Quando este applet tenta tocar o clipe de áudio, os dados serão recarregado.

Parameters:

url - uma URL absoluta fornecendo a localização base do clipe de áudio.

name - a localização do clipe de áudio, relativa ao parâmetro url.

Returns:

o clipe de áudio na URL especificada.

See Also:

AudioClip

getAppletInfo

public String getAppletInfo()

Retorna informações sobre este applet. Um applet deveria sobrepor este método para retornar uma String contendo informações sobre o autor, versão, e direitos autorais do applet.

A implementação deste método fornecido pela classe Applet retorna null.

Returns:

uma string contendo informações sobre o autor, versão, e direitos autorais do applet.

getLocale

public Locale getLocale()

Obtém o Locale (localidade) para o applet, se foi atribuído. Se nenhum Locale foi atribuído, então o Locale padrão é retornado.

Overrides:

getLocale in class Component

Returns:

o Locale para o applet

Since:

JDK1.1

See Also:

Component.setLocale(java.util.Locale)

getParameterInfo

public String[][] getParameterInfo()

Retorna informações sobre os parâmetros que são compreendidos por este applet. Um applet deveria sobrepor este método para retornar um array de Strings descrevendo estes parâmetros.

Cada elemento do array deveria ser um conjunto de três Strings contendo o nome, o tipo, e uma descrição. Por exemplo:

 String pinfo[][] = {
         {"fps",    "1-10",    "frames por segundo"},
         {"repita", "boolean", "repete o loop de imagem"},
         {"imgs",   "url",     "diretório de imagens"}
 };
 

A implementação deste método fornecida pela classe Applet retorna null.

Returns:

um array descrevendo os parâmetros que este applet espera receber.

play

public void play(URL url)

Toca o clipe de áudio na URL absoluta. Nada acontece se o clipe de áudio não puder ser encontrado.

Parameters:

url - uma URL absoluta fornecendo a localização do clipe de aúdio.

play

public void play(URL url,
                 String name)

Toca o clipe de áudio dado uma URL e um especificador que relativo a URL. Nada acontece se o clipe de áudio não puder ser encontrado.

Parameters:

url - uma URL absoluta fornecendo a localização base do clipe de áudio.

name - a localização do clipe de áudio, relativo ao parâmetro url.

init

public void init()

Chamado pelo browser ou visualizador de applet para informar este applet que ele foi carregado no sistema. Ele é sempre chamado antes da primeira vez que o método start é chamado.

Uma subclasse de Applet deveria sobrepor este método se ela tiver inicialização a fazer. Po exemplo, uma applet com threads usaria o método init para criar threads e o método destroy para encerrá-las.

A implementação deste método fornecida pela classe Applet não faz nada.

See Also:

destroy(), start(), stop()

start

public void start()

Chamado pelo browser ou visualizador de applet para informar este applet que ele deveria iniciar sua execução. Ele é chamado após o método init e cada vez que o applet é revisitado na página Web.

Uma subclasse de Applet deveria sobrepor este método se ela tem qualquer operação que queira fazer toda vez que a página Web que contém o applet seja visitada. Por exemplo, um applet com animação poderia querer usar o método start para iniciar a animação, e o método stop para suspender a animação.

Nota: algums métodos, tal como getLocationOnScreen, podem apenas fornecer resultados significativos se o applet for mostrado. Porque isShowing retorna false quando o start do applet for chamado primeiro, método solicitando que isShowing retorne true deveriam ser chamados de um ComponentListener.

A implementação deste método fornecida pela classe Applet não faz nada.

See Also:

destroy(), init(), stop(), Component.isShowing(), ComponentListener.componentShown(java.awt.event.ComponentEvent)

stop

public void stop()

Chamada pelo browser ou visualizador de applet para informar este applet que ele deveria parar sua execução. Ele é chamado quando a página Web que contém este applet trocada por uma outra página, e também imediatamente antes que o applet seja destruído.

Uma subclasse de Applet deveria sobrepor este método se ela tiver qualquer operação que queira fazer toda vez que a página Web contendo o applet não estiver mais visível. Por example, um applet com animação poderia querer usar o método start para iniciar a animação, e o método stop para suspender a animação.

A implementação deste método fornecida pela classe Applet não faz nada.

See Also:

destroy(), init()

destroy

public void destroy()

Chamado pelo browser ou visualizador de applet para informar este applet que ele está sendo regenerado e deveria destruir qualquer recurso que ele tenha alocado. O método stop sempre será chamado imediatamente antes de destroy.

Uma subclasse de Applet deveira sobrepor este método se ela tiver qualquer operação que queira fazer antes que ela seja destruída. Por exemplo, um applet com threads usaria o método init para criar as threads e o método destroy para encerrá-las.

A implementação deste método fornecida pela classe Applet não faz nada.

See Also:

init(), start(), stop()

getAccessibleContext

public AccessibleContext getAccessibleContext()

Obtém o AccessibleContext associado com este Applet. Para applets, o AccessibleContext toma a forma de um AccessibleApplet. Uma nova instância de AccessibleApplet é criada se necessário.

Specified by:

getAccessibleContext in interface Accessible

Overrides:

getAccessibleContext in class Panel

Returns:

um AccessibleApplet que serve como o AccessibleContext deste Applet