| Pacote | flash.desktop |
| Classe | public class SystemTrayIcon |
| Herança | SystemTrayIcon  InteractiveIcon Icon EventDispatcher Object |
| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0 |
Suporte a perfil do AIR: este recurso conta com o suporte de sistemas operacionais para desktop, mas não é compatível com dispositivos móveis nem com dispositivos AIR for TV. Consulte Suporte a perfil do AIR para obter mais informações sobre o suporte de API através de múltiplos perfis.
Nem todos os sistemas operacionais para desktop têm ícones de bandeja do sistema. Verifique NativeApplication.supportsSystemTrayIcon para determinar se os ícones da bandeja do sistema são suportados no sistema atual.
Não é possível criar uma ocorrência da classe SystemTrayIcon. Obtenha o objeto que representa o ícone na bandeja do sistema da propriedade icon do objeto "global" NativeApplication.
Quando os ícones da bandeja do sistema forem suportados, o ícone será do tipo SystemTrayIcon. Caso contrário, o tipo de icon será outra subclasse de InteractiveIcon, geralmente DockIcon.
Importante: tentar chamar um método da classe SystemTrayIcon no objeto NativeApplication.icon em um sistema operacional para o qual o AIR não suporta os ícones da bandeja do sistema gerará uma exceção do tempo de execução.
Elementos da API relacionados
flash.desktop.NativeApplication.supportsSystemTrayIcon
flash.desktop.DockIcon
Ocultar propriedades públicas herdadas
Mostrar propriedades públicas herdadas| Propriedade | Definido por | ||
|---|---|---|---|
| bitmaps : Array [substituir]
A imagem do ícone como uma matriz de objetos BitmapData de tamanhos diferentes. | SystemTrayIcon | ||
 | constructor : Object
Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto. | Object | |
| height : int [substituir] [somente leitura]
A altura de exibição atual do ícone, em pixels. | SystemTrayIcon | ||
| menu : NativeMenu
O menu do ícone da bandeja do sistema. | SystemTrayIcon | ||
| tooltip : String
A dica de ferramenta que é exibida para o ícone da bandeja do sistema. | SystemTrayIcon | ||
| width : int [substituir] [somente leitura]
A largura de exibição atual do ícone, em pixels. | SystemTrayIcon | ||
| Evento | Resumo | Definido por | ||
|---|---|---|---|---|
| [transmissão de evento] Despachado quando o Flash Player ou o aplicativo do AIR ganha o foco do sistema operacional e está se tornando inativo. | EventDispatcher | ||
| Despachado por esse objeto SystemTrayIcon mediante um clique do mouse. | SystemTrayIcon | |||
| [transmissão de evento] Despachado quando o Flash Player ou o aplicativo do AIR perde o foco do sistema operacional e está se tornando inativo. | EventDispatcher | ||
| Despachado por esse objeto SystemTrayIcon mediante um movimento para baixo do mouse. | SystemTrayIcon | |||
| Despachado por esse objeto SystemTrayIcon mediante um movimento para cima do mouse. | SystemTrayIcon | |||
| Despachado por esse objeto SystemTrayIcon mediante um clique com o botão direito do mouse. | SystemTrayIcon | |||
| Despachado por esse objeto SystemTrayIcon mediante um movimento para baixo e à direita do mouse. | SystemTrayIcon | |||
| Despachado por esse objeto SystemTrayIcon mediante um movimento para cima e à direita do mouse. | SystemTrayIcon | |||
| Constante | Definido por | ||
|---|---|---|---|
| MAX_TIP_LENGTH : Number = 63 [estático]
O comprimento permitido da dica de ferramenta do ícone da bandeja do sistema. | SystemTrayIcon | ||
bitmaps | propriedade |
bitmaps:Array[substituir] | Versões de runtime: | AIR 1.0 |
A imagem do ícone como uma matriz de objetos BitmapData de tamanhos diferentes.
Quando um ícone é exibido em um determinado contexto do sistema operacional, será usado (e escalado, se necessário) o bitmap na matriz mais próximo do tamanho exibido. Os tamanhos comuns incluem 16x16, 32x32, 48x48 e 128x128. (Ícones de 512x512 pixels podem ser usados para ícones de alguns sistemas operacionais em um futuro próximo.)
Em alguns contextos, o sistema operacional poderá usar um ícone de sistema padrão se nada tiver sido atribuído à propriedade bitmaps. Em outros contextos, não aparece nenhum ícone.
Para definir ou alterar a aparência do ícone, atribua uma matriz dos objetos BitmapData para a propriedade bitmaps:
icon.bitmaps = new Array(icon16x16.bitmapData, icon128x128.bitmapData);
Modificar a matriz bitmaps diretamente não tem efeito algum.
Para limpar a imagem do ícone, atribua uma matriz vazia à propriedade bitmaps.
Observação: ao carregar arquivos de imagem para um ícone, o formato de arquivo PNG geralmente fornece a melhor mesclagem alfa. O formato GIF só suporta ativação ou desativação de transparência (sem mesclagem). O formato JPG não suporta nenhum tipo de transparência.
Implementação
override public function get bitmaps():Array override public function set bitmaps(value:Array):void height | propriedade |
height:int [somente leitura] [substituir] | Versões de runtime: | AIR 1.0 |
A altura de exibição atual do ícone, em pixels.
Alguns contextos de itens suportam tamanhos dinâmicos. A propriedade height indica a altura do ícone escolhida na matriz bitmaps para o contexto atual. A altura de exibição atual poderá ser diferente se o sistema operacional tiver escalado o ícone.
Implementação
override public function get height():int menu | propriedade |
menu:NativeMenu| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0 |
O menu do ícone da bandeja do sistema.
Implementação
public function get menu():NativeMenu public function set menu(value:NativeMenu):void tooltip | propriedade |
tooltip:String| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0 |
A dica de ferramenta que é exibida para o ícone da bandeja do sistema. Se a string for maior do que SystemTrayIcon.MAX_TIP_LENGTH, a dica será truncada.
Implementação
public function get tooltip():String public function set tooltip(value:String):void width | propriedade |
width:int [somente leitura] [substituir] | Versões de runtime: | AIR 1.0 |
A largura de exibição atual do ícone, em pixels.
Alguns contextos de itens suportam tamanhos dinâmicos. A propriedade width indica a largura do ícone escolhida na matriz bitmaps para o contexto atual. A largura de exibição atual poderá ser diferente se o sistema operacional tiver escalado o ícone.
Implementação
override public function get width():int click | Evento |
flash.events.ScreenMouseEventpropriedade ScreenMouseEvent.type =
flash.events.ScreenMouseEvent.CLICK| Versões de runtime: | AIR 1.0 |
Despachado por esse objeto SystemTrayIcon mediante um clique do mouse.
A constanteScreenMouseEvent.CLICK define o valor da propriedade type de um objeto de evento click.
Este evento tem as seguintes propriedades relevantes:
| Propriedade | Valor |
|---|---|
buttonDown | true se o botão principal do mouse estiver pressionado; false se não estiver. |
ctrlKey | true no Windows ou no Linux caso a tecla Ctrl esteja ativa. true no Mac se a tecla Ctrl ou Command estiver ativa. Caso contrário, false. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
shiftKey | true se a tecla Shift estiver ativa; false se estiver inativa. |
commandKey | true no Mac se a tecla Command estiver ativa; false se estiver inativa. Sempre false no Windows. |
controlKey | true se a tecla Ctrl ou Control estiver ativa; false se estiver inativa. |
screenX | A coordenada horizontal na qual o evento ocorreu em coordenadas de tela. |
screenY | A coordenada vertical na qual o evento ocorreu em coordenadas de tela. |
target | A ocorrência SystemTrayIcon sob o dispositivo apontador. |
mouseDown | Evento |
flash.events.ScreenMouseEventpropriedade ScreenMouseEvent.type =
flash.events.ScreenMouseEvent.MOUSE_DOWN| Versões de runtime: | AIR 1.0 |
Despachado por esse objeto SystemTrayIcon mediante um movimento para baixo do mouse.
A constanteScreenMouseEvent.MOUSE_DOWN define o valor da propriedade type de um objeto de evento mouseDown.
Este evento tem as seguintes propriedades relevantes:
| Propriedade | Valor |
|---|---|
buttonDown | true se o botão principal do mouse estiver pressionado; false se não estiver. |
ctrlKey | true no Windows ou no Linux caso a tecla Ctrl esteja ativa. true no Mac se a tecla Ctrl ou Command estiver ativa. Caso contrário, false. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
shiftKey | true se a tecla Shift estiver ativa; false se estiver inativa. |
commandKey | true no Mac se a tecla Command estiver ativa; false se estiver inativa. Sempre false no Windows. |
controlKey | true se a tecla Ctrl ou Control estiver ativa; false se estiver inativa. |
screenX | A coordenada horizontal na qual o evento ocorreu em coordenadas de tela. |
screenY | A coordenada vertical na qual o evento ocorreu em coordenadas de tela. |
target | A ocorrência SystemTrayIcon sob o dispositivo apontador. |
mouseUp | Evento |
flash.events.ScreenMouseEventpropriedade ScreenMouseEvent.type =
flash.events.ScreenMouseEvent.MOUSE_UP| Versões de runtime: | AIR 1.0 |
Despachado por esse objeto SystemTrayIcon mediante um movimento para cima do mouse.
A constanteScreenMouseEvent.MOUSE_UP define o valor da propriedade type de um objeto de evento mouseUp.
Este evento tem as seguintes propriedades relevantes:
| Propriedade | Valor |
|---|---|
buttonDown | true se o botão principal do mouse estiver pressionado; false se não estiver. |
ctrlKey | true no Windows ou no Linux caso a tecla Ctrl esteja ativa. true no Mac se a tecla Ctrl ou Command estiver ativa. Caso contrário, false. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
shiftKey | true se a tecla Shift estiver ativa; false se estiver inativa. |
commandKey | true no Mac se a tecla Command estiver ativa; false se estiver inativa. Sempre false no Windows. |
controlKey | true se a tecla Ctrl ou Control estiver ativa; false se estiver inativa. |
screenX | A coordenada horizontal na qual o evento ocorreu em coordenadas de tela. |
screenY | A coordenada vertical na qual o evento ocorreu em coordenadas de tela. |
target | A ocorrência SystemTrayIcon sob o dispositivo apontador. |
rightClick | Evento |
flash.events.ScreenMouseEventpropriedade ScreenMouseEvent.type =
flash.events.ScreenMouseEvent.RIGHT_CLICK| Versões de runtime: | AIR 1.0 |
Despachado por esse objeto SystemTrayIcon mediante um clique com o botão direito do mouse.
A constanteScreenMouseEvent.RIGHT_CLICK define o valor da propriedade type de um objeto de evento rightClick.
Este evento tem as seguintes propriedades relevantes:
| Propriedade | Valor |
|---|---|
buttonDown | true se o botão principal do mouse estiver pressionado; false se não estiver. |
ctrlKey | true no Windows ou no Linux caso a tecla Ctrl esteja ativa. true no Mac se a tecla Ctrl ou Command estiver ativa. Caso contrário, false. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
shiftKey | true se a tecla Shift estiver ativa; false se estiver inativa. |
commandKey | true no Mac se a tecla Command estiver ativa; false se estiver inativa. Sempre false no Windows. |
controlKey | true se a tecla Ctrl ou Control estiver ativa; false se estiver inativa. |
screenX | A coordenada horizontal na qual o evento ocorreu em coordenadas de tela. |
screenY | A coordenada vertical na qual o evento ocorreu em coordenadas de tela. |
target | A ocorrência SystemTrayIcon sob o dispositivo apontador. |
rightMouseDown | Evento |
flash.events.ScreenMouseEventpropriedade ScreenMouseEvent.type =
flash.events.ScreenMouseEvent.RIGHT_MOUSE_DOWN| Versões de runtime: | AIR 1.0 |
Despachado por esse objeto SystemTrayIcon mediante um movimento para baixo e à direita do mouse.
A constanteScreenMouseEvent.RIGHT_MOUSE_DOWN define o valor da propriedade type de um objeto de evento rightMouseDown.
Este evento tem as seguintes propriedades relevantes:
| Propriedade | Valor |
|---|---|
buttonDown | true se o botão principal do mouse estiver pressionado; false se não estiver. |
ctrlKey | true no Windows ou no Linux caso a tecla Ctrl esteja ativa. true no Mac se a tecla Ctrl ou Command estiver ativa. Caso contrário, false. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
shiftKey | true se a tecla Shift estiver ativa; false se estiver inativa. |
commandKey | true no Mac se a tecla Command estiver ativa; false se estiver inativa. Sempre false no Windows. |
controlKey | true se a tecla Ctrl ou Control estiver ativa; false se estiver inativa. |
screenX | A coordenada horizontal na qual o evento ocorreu em coordenadas de tela. |
screenY | A coordenada vertical na qual o evento ocorreu em coordenadas de tela. |
target | A ocorrência SystemTrayIcon sob o dispositivo apontador. |
rightMouseUp | Evento |
flash.events.ScreenMouseEventpropriedade ScreenMouseEvent.type =
flash.events.ScreenMouseEvent.RIGHT_MOUSE_UP| Versões de runtime: | AIR 1.0 |
Despachado por esse objeto SystemTrayIcon mediante um movimento para cima e à direita do mouse.
A constanteScreenMouseEvent.RIGHT_MOUSE_UP define o valor da propriedade type de um objeto de evento rightMouseUp.
Este evento tem as seguintes propriedades relevantes:
| Propriedade | Valor |
|---|---|
buttonDown | true se o botão principal do mouse estiver pressionado; false se não estiver. |
ctrlKey | true no Windows ou no Linux caso a tecla Ctrl esteja ativa. true no Mac se a tecla Ctrl ou Command estiver ativa. Caso contrário, false. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
shiftKey | true se a tecla Shift estiver ativa; false se estiver inativa. |
commandKey | true no Mac se a tecla Command estiver ativa; false se estiver inativa. Sempre false no Windows. |
controlKey | true se a tecla Ctrl ou Control estiver ativa; false se estiver inativa. |
screenX | A coordenada horizontal na qual o evento ocorreu em coordenadas de tela. |
screenY | A coordenada vertical na qual o evento ocorreu em coordenadas de tela. |
target | A ocorrência SystemTrayIcon sob o dispositivo apontador. |
MAX_TIP_LENGTH | Constante |
public static const MAX_TIP_LENGTH:Number = 63| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0 |
O comprimento permitido da dica de ferramenta do ícone da bandeja do sistema.
Wed Jun 13 2018, 11:10 AM Z