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.awt.im.spi
Interface InputMethodContext

All Superinterfaces:

InputMethodRequests

public interface InputMethodContext
extends InputMethodRequests

Provê métodos que possar ser usados pelos métodos de entrada para comunicar-se com seus componentes clientes ou para requisitar outros serviços. Essa interface é implementada pelo framework de método de entrada, e o método de entrada chama este método na instância que eles recebem através de InputMethod.setInputMethodContext(java.awt.im.spi.InputMethodContext). Não deve haver outras implementações ou invocadores.

Since:

1.3

Method Summary

JFrame	createInputMethodJFrame(String title, boolean attachToInputContext) Cria um JFrame Swing de nível de topo para ser usado pelo método de entrada.
Window	createInputMethodWindow(String title, boolean attachToInputContext) Cria uma janela de nivel de topo para ser usada do método de entrada.
void	dispatchInputMethodEvent(int id, AttributedCharacterIterator text, int committedCharacterCount, TextHitInfo caret, TextHitInfo visiblePosition) Cria um evento do método de entrada através dos argumentos dados e o envia para o componente cliente.
void	enableClientWindowNotification(InputMethod inputMethod, boolean enable) Habilita ou desabilita a notificação da localização e estado da atual janela do cliente para o método de entrada especificado.

Methods inherited from interface java.awt.im.InputMethodRequests

cancelLatestCommittedText, getCommittedText, getCommittedTextLength, getInsertPositionOffset, getLocationOffset, getSelectedText, getTextLocation

Method Detail

dispatchInputMethodEvent

void dispatchInputMethodEvent(int id,
                              AttributedCharacterIterator text,
                              int committedCharacterCount,
                              TextHitInfo caret,
                              TextHitInfo visiblePosition)

Cria um evento do método de entrada através dos argumentos dados e o envia para o componente cliente. Para os argumentos, veja see InputMethodEvent.InputMethodEvent(java.awt.Component, int, java.awt.font.TextHitInfo, java.awt.font.TextHitInfo).

createInputMethodWindow

Window createInputMethodWindow(String title,
                               boolean attachToInputContext)

Cria uma janela de nivel de topo para ser usada do método de entrada. O comportamento esperado para esta janela é:

• Ela flutua sobre todas as janelas de documentos e diálogos
• Ela e todos os componentes que ela contém não recebem o foco
• Ela tem decorações leves, como região de arraste reduzida sem título

No entando, o real comportamento em respeito destes três itens é dependente de plataforma.

O título pode ou não ser exibido, dependendo do tipo real da janela criada.

Se attachToInputContext é true, a nova janela irá compartilhar o contexto de entrada que corresponde a este contexto de método de entrada, assim os eventos para os componentes na janela são automaticamente despachados para o método de entrada. Além do mais, quando a janela é aberta usando setVisible(true), o contexto de entrada irá prevenir chamadas de desativação e ativação para o método de entrada que porventura possa acontecer.

Métodos de entrada devem chamar Window.dispose na janela de método de entrada retornada quando ela não for mais necessária.

Parameters:

title - o título a ser exibido na barra de título da janela, se existir uma barra de título. Um valor null é tratado como uma string vazia, "".

attachToInputContext - indica se essa janela deve compartilhar o contexto de entrada que corresponde a este contexto de método de entrada.

Returns:

uma janela com características especiais para ser usada pelos métodos de entrada

Throws:

HeadlessException - se GraphicsEnvironment.isHeadless retorna true

createInputMethodJFrame

JFrame createInputMethodJFrame(String title,
                               boolean attachToInputContext)

Cria um JFrame Swing de nível de topo para ser usado pelo método de entrada. O comportamento esperado para esta janela é:

• Ela flutua sobre todas as janelas de documentos e diálogos
• Ela e todos os componentes que ela contém não recebem o foco
• Ela tem decorações leves, como região de arraste reduzida sem título

No entando, o real comportamento em respeito destes três itens é dependente de plataforma.

O título pode ou não ser exibido, dependendo do tipo real da janela criada.

Se attachToInputContext é true, a nova janela irá compartilhar o contexto de entrada que corresponde a este contexto de método de entrada, assim os eventos para os componentes na janela são automaticamente despachados para o método de entrada. Além do mais, quando a janela é aberta usando setVisible(true), o contexto de entrada irá prevenir chamadas de desativação e ativação para o método de entrada que porventura possa acontecer.

Métodos de entrada devem chamar Window.dispose na janela de método de entrada retornada quando ela não for mais necessária.

Parameters:

title - o título a ser exibido na barra de título da janela, se existir uma barra de título. Um valor null é tratado como uma string vazia, "".

attachToInputContext - indica se essa janela deve compartilhar o contexto de entrada que corresponde a este contexto de método de entrada.

Returns:

uma JFrame com características especiais para ser usada pelos métodos de entrada

Throws:

HeadlessException - se GraphicsEnvironment.isHeadless retorna true

Since:

1.4

enableClientWindowNotification

void enableClientWindowNotification(InputMethod inputMethod,
                                    boolean enable)

Habilita ou desabilita a notificação da localização e estado da atual janela do cliente para o método de entrada especificado. Quando a notificação é habilitada, o método notifyClientWindowChange do método de entrada é chamado como descrito na especificação daquele método. A notificação é automaticamente desabilitada quando o método de entrada é descartado.

Parameters:

inputMethod - o método de entrada para o qual as notificações serão habilitadas ou desabilitadas

enable - true para habilitar, false para desabilitar