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
Interface AppletContext

public interface AppletContext

Esta interface corresponde a um ambiente de applet: o documento que contém o applet e outros applets no mesmo documento.

Os métodos nesta interface podem ser usados por um applet para obter informações sobre seu ambiente.

Since:

JDK1.0

Method Summary

Applet	getApplet(String name) Encontra e retorna o applet no documento representado por este contexto de applet com o nome fornecido.
Enumeration<Applet>	getApplets() Encontra todos os applets no documento representado por este contexto de applet.
AudioClip	getAudioClip(URL url) Cria um clipe de áudio.
Image	getImage(URL url) Retorna um objeto Image que pode então ser pintado na tela.
InputStream	getStream(String key) Retorna a stream a qual a chave especificada está associada dentre deste contexto de applet.
Iterator<String>	getStreamKeys() Encontra todas as chaves de streams neste contexto de applet.
void	setStream(String key, InputStream stream) Associa a stream especificada com a chave especificada em key neste contexto de applet.
void	showDocument(URL url) Substitui a página Web atualmente sendo visualizada pela URL fornecida.
void	showDocument(URL url, String target) Solicita que o browser ou visualizador de applet mostre a páginda Web indicada pelo parâmetro url.
void	showStatus(String status) Solicita que o parâmetro string seja mostrado na "janela de estado".

Method Detail

getAudioClip

AudioClip getAudioClip(URL url)

Cria um clipe de áudio.

Parameters:

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

Returns:

o clipe de áudio na URL especificada.

getImage

Image getImage(URL url)

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

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

Parameters:

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

Returns:

a imagem na URL especificada.

See Also:

Image

getApplet

Applet getApplet(String name)

Encontra e retorna o applet no documento representado por este contexto de applet com o nome fornecido. O nome pode ser atribuido na tag HTML atribuindo-o ao atributo name.

Parameters:

name - um nome de applet.

Returns:

o applet com o nome fornecido, ou null se não encontrado.

getApplets

Enumeration<Applet> getApplets()

Encontra todos os applets no documento representado por este contexto de applet.

Returns:

um Enumeration de todos os applets no documente representado por este contexto de applet.

showDocument

void showDocument(URL url)

Substitui a página Web atualmente sendo visualizada pela URL fornecida. Este método pode ser ignorado pelos contextos de applet que não são browsers.

Parameters:

url - uma URL absoluta fornecendo a localização do documento.

showDocument

void showDocument(URL url,
                  String target)

Solicita que o browser ou visualizador de applet mostre a páginda Web indicada pelo parâmetro url. O parâmetro target indica em qual frame HTML o documento será mostrado. O parâmetro target é interpretado da seguinte forma:

Parâmetro Target	Descrição
"_self"	Mostra na janela e frame que contém o applet.
"_parent"	Mostra no frame pai do applet. Se o frame do applet não tiver um frame pai, atua da mesma maneira que "_self".
"_top"	Mostra no frame superior da janela do applet. Se o frame do applet estiver no frame superio, atua da mesma maneira que "_self".
"_blank"	Mostra em uma janela nova e sem nome.
name	Mostra no frame ou janela chamada name. Se um target chamado name ainda não existir, uma nova janela com o nome especificado é criada, e o documento é mostrado nela.

Um visualizador de applet ou browser é livre para ignorar showDocument.

Parameters:

url - uma URL absoluta fornecendo a localização do documento.

target - uma String indicando onde mostrar a página.

showStatus

void showStatus(String status)

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

Parameters:

status - uma string para mostrar na janela de estado.

setStream

void setStream(String key,
               InputStream stream)
               throws IOException

Associa a stream especificada com a chave especificada em key neste contexto de applet. Se o contexto de applet previamente continha um mapeamento para esta chave, o valor antido é substituído.

Por razões de segurança, o mapeamento de streams e chaves existe para cada base de código. Em outras palavra, applet de uma base de código não pode acessar as streams criadas por um applet de uma base de código different.

Parameters:

key - chave com a qual o valor especificado será associado.

stream - stream a ser associadato com a chave especificada. Se este parametro for null, a chave especificada é removida neste contexto de applet.

Throws:

IOException - se o tamanho da stream exceder um certo limite de tamanho. Limite de tamanho é decidido pelo implementador desta interface.

IOException

Since:

JDK1.4

getStream

InputStream getStream(String key)

Retorna a stream a qual a chave especificada está associada dentre deste contexto de applet. Retorna null se o contexto de applet não contém nenhuma stream para esta chave.

Por razões de segurança, o mapeamento de streams e chaves existe para cada base de código. Em outras palavra, applet de uma base de código não pode acessar as streams criadas por um applet de uma base de código different.

Parameters:

key - chave pela qual a stream associada será retornada.

Returns:

a stream a qual este contexto de applet mapea pela chave

Since:

JDK1.4

getStreamKeys

Iterator<String> getStreamKeys()

Encontra todas as chaves de streams neste contexto de applet.

Por razões de segurança, o mapeamento de streams e chaves existe para cada base de código. Em outras palavra, applet de uma base de código não pode acessar as streams criadas por um applet de uma base de código different.

Returns:

um Iterator de todos os nomes de streams neste contexto de applet.

Since:

JDK1.4