IFlexDisplayObject  - AS3 Flex

As opções de acessibilidade atuais para este objeto de exibição. Se você modificar a propriedade accessibilityProperties ou qualquer um dos campos em accessibilityProperties, deverá chamar o método Accessibility.updateProperties() para que as alterações sejam efetivadas.

Observação: Para um objeto criado no ambiente de autoria do Flash, o valor de accessibilityProperties é pré-preenchido com todas as informações inseridas no painel Acessibilidade desse objeto.

Indica o valor de transparência alfa do objeto especificado. Os valores válidos são de 0 (totalmente transparente) a 1 (totalmente opaco). O valor padrão é 1. Objetos de exibição com a propriedade alpha definida como 0 são ativos, mesmo estando invisíveis.

Um valor a partir da classe BlendMode que especifica o modo de mesclagem a ser usado. Um bitmap pode ser desenhado internamente de duas maneiras. Se você tiver um modo de mesclagem ativado ou uma máscara de corte externa, o bitmap será desenhado adicionando-se uma forma de quadrado com preenchimento de bitmap ao renderizador de vetor. Se você tentar definir essa propriedade como um valor inválido, tempo de execução do Flash definirá o valor como BlendMode.NORMAL.

A propriedade modoMesclagem afeta cada pixel do objeto de exibição. Cada pixel é formado por três cores constituintes (vermelho, verde e azul) e cada uma dessas cores tem um valor entre 0x00 e 0xFF. O Flash Player ou o Adobe AIR compara cada cor constituinte de um pixel no clipe de filme com a cor correspondente do pixel no plano de fundo. Por exemplo, se a propriedade modoMesclagem estiver definida como BlendMode.LIGHTEN, o Flash Player ou o Adobe AIR irá comparar o valor de vermelho do objeto de exibição com o valor de vermelho do plano de fundo e usará o mais claro como o valor para o componente vermelho da cor exibida.

A tabela a seguir descreve as configurações de modoMesclagem. A classe BlendMode define valores de string que você pode usar. As ilustrações na tabela mostra valores de modoMesclagem aplicados a um objeto de exibição circular (2) superimposto em outro objeto de exibição (1).

Constante de BlendMode	Ilustração	Descrição
BlendMode.NORMAL		O objeto de exibição aparece na frente do plano de fundo. Os valores de pixel do objeto de exibição substituem os do plano de fundo. Nos pontos em que o objeto de exibição for transparente, o plano de fundo será visível.
BlendMode.LAYER		Força a criação de um grupo de transparências para o objeto de exibição. Isso significa que o objeto de exibição é pré-composto em um buffer temporário antes de continuar a ser processado. Isso será feito automaticamente se o objeto de exibição for pré-armazenado em cache usando o cache de bitmap ou se o objeto de exibição for um contêiner de objetos de exibição com pelo menos um objeto filho com uma configuração de blendMode diferente de BlendMode.NORMAL. Sem suporte na renderização pela GPU.
BlendMode.MULTIPLY		Multiplica os valores das cores constituintes do objeto de exibição pelas cores da cor do plano de fundo e normaliza dividindo por 0xFF, o que resulta em cores mais escuras. Essa configuração costuma ser usada para sombras e efeitos de profundidade. Por exemplo, se uma cor constituinte (como vermelho) de um pixel no objeto de exibição e a cor correspondente do pixel no plano de fundo tiverem ambas o valor 0x88, o resultado multiplicado será 0x4840. A divisão por 0xFF gera um valor de 0x48 para essa cor constituinte, que é uma sombra mais escura do que a cor do objeto de exibição ou a cor do plano de fundo.
BlendMode.SCREEN		Multiplica o complemento (inverso) da cor do objeto de exibição pelo complemento da cor de plano de fundo, resultando em um efeito de branqueamento. Essa configuração costuma ser usada para realces ou para remover áreas pretas do objeto de exibição.
BlendMode.LIGHTEN		Seleciona a mais clara das cores constituintes do objeto de exibição e a cor do plano de fundo (as cores com os maiores valores). Essa configuração costuma ser usada para o tipo de superimposição. Por exemplo, se o objeto de exibição tiver um pixel com valor RGB 0xFFCC33 e o pixel do plano de fundo tiver o valor RGB 0xDDF800, o valor RGB resultante para o pixel exibido será 0xFFF833 (porque 0xFF > 0xDD, 0xCC < 0xF8 e 0x33 > 0x00 = 33). Sem suporte na renderização pela GPU.
BlendMode.DARKEN		Seleciona a mais escura das cores constituintes do objeto de exibição e as cores do plano de fundo (as cores com os menores valores). Essa configuração costuma ser usada para o tipo de superimposição. Por exemplo, se o objeto de exibição tiver um pixel com valor RGB 0xFFCC33 e o pixel do plano de fundo tiver o valor RGB 0xDDF800, o valor RGB resultante para o pixel exibido será 0xDDCC00 (porque 0xFF > 0xDD, 0xCC < 0xF8 e 0x33 > 0x00 = 33). Sem suporte na renderização pela GPU.
BlendMode.DIFFERENCE		Compara as cores constituintes do objeto de exibição com as cores do seu plano de fundo e subtrai o mais escuro dos valores das duas cores constituintes do valor mais claro. Essa configuração costuma ser usada para cores mais vibrantes. Por exemplo, se o objeto de exibição tiver um pixel com um valor RGB de 0xFFCC33 e o pixel do plano de fundo tiver um valor RGB de 0xDDF800, o valor RGB resultante para o pixel exibido será 0x222C33 (porque 0xFF - 0xDD = 0x22, 0xF8 - 0xCC = 0x2C e 0x33 - 0x00 = 0x33).
BlendMode.ADD		Adiciona os valores das cores constituintes do objeto de exibição às cores do seu plano de fundo, aplicando um limite superior de 0xFF. Essa configuração costuma ser usada para animar uma desincorporação de clareamento entre dois objetos. Por exemplo, se o objeto de exibição tiver um pixel com um valor RGB de 0xAAA633 e o pixel do plano de fundo tiver um valor RGB de 0xDD2200, o valor RGB resultante para o pixel exibido será 0xFFC833 (porque 0xAA + 0xDD > 0xFF, 0xA6 + 0x22 = 0xC8 e 0x33 + 0x00 = 0x33).
BlendMode.SUBTRACT		Subtrai os valores das cores constituintes no objeto de exibição dos valores da cor do plano de fundo, aplicando um limite inferior de 0. Essa configuração costuma ser usada para animar uma desincorporação de escurecimento entre dois objetos. Por exemplo, se o objeto de exibição tiver um pixel com um valor RGB de 0xAA2233 e o pixel do plano de fundo tiver um valor RGB de 0xDDA600, o valor RGB resultante para o pixel exibido será 0x338400 (porque 0xDD - 0xAA = 0x33, 0xA6 - 0x22 = 0x84 e 0x00 - 0x33 < 0x00).
BlendMode.INVERT		Inverte o plano de fundo.
BlendMode.ALPHA		Aplica o valor alfa de cada pixel do objeto de exibição ao plano de fundo. Isso requer que a configuração de modoMesclagem do objeto de exibição-pai seja definida como BlendMode.LAYER. Por exemplo, na ilustração, o objeto de exibição pai, que é um plano de fundo branco, tem blendMode = BlendMode.LAYER. Sem suporte na renderização pela GPU.
BlendMode.ERASE		Apaga o plano de fundo com base no valor alfa do objeto de exibição. Isso requer que a configuração de modoMesclagem do objeto de exibição-pai seja definida como BlendMode.LAYER. Por exemplo, na ilustração, o objeto de exibição pai, que é um plano de fundo branco, tem blendMode = BlendMode.LAYER. Sem suporte na renderização pela GPU.
BlendMode.OVERLAY		Ajusta a cor de cada pixel com base na escuridão do plano de fundo. Se o plano de fundo for mais claro do que 50% cinza, as cores do objeto de exibição e do plano de fundo serão filtradas, resultando em uma cor mais clara. Se o plano de fundo for mais escuro do que 50% cinza, as cores serão multiplicadas, resultando em uma cor mais escura. Essa configuração costuma ser usada para efeitos de sombreamento. Sem suporte na renderização pela GPU.
BlendMode.HARDLIGHT		Ajusta a cor de cada pixel com base na escuridão do objeto de exibição. Se o objeto de exibição for mais claro do que 50% cinza, as cores do objeto de exibição e do plano de fundo serão filtradas, resultando em uma cor mais clara. Se o objeto de exibição for mais escuro do que 50% cinza, as cores serão multiplicadas, resultando em uma cor mais escura. Essa configuração costuma ser usada para efeitos de sombreamento. Sem suporte na renderização pela GPU.
BlendMode.SHADER	N/D	Ajusta a cor usando uma rotina de shader personalizada. O shader usado é especificado como sendo a ocorrência de Shader atribuída à propriedade blendShader. A definição da propriedade blendShader como de um objeto de exibição como uma ocorrência de Shader define automaticamente a propriedade blendMode como BlendMode.SHADER. Caso a propriedade blendMode seja definida como BlendMode.SHADER sem que a propriedade blendShader seja definido antes disso, a propriedade blendMode será definida como BlendMode.NORMAL. Sem suporte na renderização pela GPU.

Se definido como true, tempo de execução do Flash, armazenará em cachê uma representação interna em bitmap do objeto de exibição. Esse cachê pode aumentar o desempenho para objetos de exibição que têm conteúdo de vetor complexo.

Todos os dados de vetor para um objeto de exibição que possui bitmap em cache são desenhados no bitmap e não na exibição principal. Se cacheAsBitmapMatrix for nulo ou não suportado, o bitmap então será copiado para a exposição principal como não esticado; os pixéis não girados ajustam-se aos limites de pixel mais próximos. Os pixels são mapeados 1 a 1 com o objeto-pai. Se os limites do bitmap forem alterados, o bitmap será recriado em vez de ser esticado.

Se cacheAsBitmapMatrix for não nula e suportada, o objeto será desenhado para o bitmap fora da tela usando a matriz, e os resultados esticados e/ou girados desta renderização serão usado para desenhar o objeto para a exibição principal.

Nenhum bitmap inteiro será criado, a não ser que a propriedade cacheAsBitmap seja definida como true.

Depois de definir a propriedade cacheAsBitmap como true, a renderização não será alterada, mas o objeto de exibição realizará o encaixe de pixels automaticamente. A velocidade de animação pode aumentar significativamente dependendo da complexidade do conteúdo de vetor.

A propriedade cacheAsBitmap é automaticamente definida como true sempre que você aplica um filtro a um objeto de exibição (quando sua matriz filter não está vazia) e, se um objeto de exibição tiver um filtro aplicado, cacheAsBitmap será relatado como true para esse objeto de exibição, mesmo que você defina a propriedade como false. Se você limpar todos os filtros para um objeto de exibição, a configuração de cacheAsBitmap será alterada para o estado anterior mais recente.

Um objeto de exibição não usará um bitmap mesmo que a propriedade cacheAsBitmap seja definida como true e, em vez disso, renderizará a partir de dados de vetor nos seguintes casos:

• O bitmap é muito grande. No AIR 1.5 e no Flash Player 10, o tamanho máximo de uma imagem bitmap é de 8.191 pixels de largura ou de altura, e o número total de pixels não pode exceder 16.777.215 pixels. (Dessa forma, caso uma imagem bitmap tenha 8.191 pixels de largura, ela só pode ter 2.048 pixels de altura.) No Flash Player 9 e anteriores, a limitação é de 2.880 pixels de altura e 2.880 pixels de largura.
• O bitmap não consegue ser alocado (erro de falta de memória).

A propriedade cacheAsBitmap é melhor utilizada com clipes de filme que têm conteúdo estático predominantemente e que não são dimensionados e girados com frequência. Com esses clipes de filme, cacheAsBitmap pode resultar em aumentos de desempenho quando o clipe de filme é convertido (quando suas posições x e y são alteradas).

Uma matriz indexada que contém cada objeto de filtro atualmente associado ao objeto de exibição. O pacote flash.filters contém várias classes que definem filtros específicos que você pode usar.

Os filtros podem ser aplicados na ferramenta de autoria do Flash Professional durante o design ou a execução usando o código ActionScript. Para aplicar um filtro usando ActionScript, é necessário fazer uma cópia temporária da matriz de filters inteira, modificar a matriz temporária e então atribuir o valor da matriz temporária de volta para a matriz filters. Não é possível adicionar diretamente um novo objeto de filtro à matriz de filters.

Para adicionar um filtro usando o ActionScript, realize as etapas a seguir (suponha que o nome do objeto de exibição seja myDisplayObject):

1. Crie um novo objeto de filtro usando o método de construtor da sua classe de filtro escolhida.
2. Atribua o valor da matriz myDisplayObject.filters a uma matriz temporária, como myFilters.
3. Adicione o novo objeto de filtro à matriz temporária myFilters.
4. Atribua o valor da matriz temporária à matriz myDisplayObject.filters.

Se a matriz de filters for indefinida, não será necessário usar uma matriz temporária. Em vez disso, é possível atribuir diretamente um literal de matriz que contenha um ou mais objetos de filtro que você criar. O primeiro exemplo na seção Exemplos adiciona um filtro de sombra projetada usando um código que lida com matrizes de filters definidas e indefinidas.

Para modificar um objeto de filtro existente, use a técnica de modificar uma cópia da matriz de filters:

1. Atribua o valor da matriz de filters a uma matriz temporária, como myFilters.
2. Modifique a propriedade usando a matriz temporária, myFilters. Por exemplo, para definir a propriedade "quality" do primeiro filtro da matriz, é possível usar o código a seguir: myFilters[0].quality = 1;
3. Atribua o valor da matriz temporária à matriz de filters.

Em tempo de carregamento, se um objeto de exibição tiver um filtro associado, ele será marcado para se armazenar em cache como bitmap transparente. Deste ponto em diante, desde que o objeto de exibição tenha uma lista de filtros válida, o player armazenará em cache o objeto de exibição como um bitmap. Esse bitmap de origem é usado como imagem de origem para os efeitos de filtro. Cada objeto de exibição geralmente tem dois bitmaps: um com o objeto original de exibição de origem e outro para a imagem final, após a filtragem. A imagem final é usada no momento da renderização. Desde que o objeto de exibição não seja alterado, a imagem final não precisa de atualização.

O pacote flash.filters inclui classes para filtros. Por exemplo, para criar um filtro de sombra projetada, grave o seguinte:

     import flash.filters.DropShadowFilter
     var myFilter:DropShadowFilter = new DropShadowFilter (distance, angle, color, alpha, blurX, blurY, quality, inner, knockout)
     

O operador is pode ser usado para determinar o tipo de filtro atribuído a cada posição de índice na matriz de filters. Por exemplo, o código a seguir mostra como determinar a posição do primeiro filtro na matriz de filters que é DropShadowFilter:

     import flash.text.TextField;
     import flash.filters.*;
     var tf:TextField = new TextField();
     var filter1:DropShadowFilter = new DropShadowFilter();
     var filter2:GradientGlowFilter = new GradientGlowFilter();
     tf.filters = [filter1, filter2];
     
     tf.text = "DropShadow index: " + filterPosition(tf, DropShadowFilter).toString(); // 0
     addChild(tf)
     
     function filterPosition(displayObject:DisplayObject, filterClass:Class):int {
         for (var i:uint = 0; i < displayObject.filters.length; i++) {
             if (displayObject.filters[i] is filterClass) {
                 return i;
             }
         }
         return -1;
     }
     

Observação:Como não é possível adicionar diretamente um novo objeto de filtro à matriz DisplayObject.filters, o código a seguir não tem efeito sobre o objeto de exibição de destino, denominado myDisplayObject:

     myDisplayObject.filters.push(myDropShadow);
     

Indica a altura do objeto de exibição, em pixels. A altura é calculada com base nos limites do conteúdo do objeto de exibição. Quando você define a propriedade height, a propriedade scaleY é ajustada de acordo, como mostra o código a seguir:

    var rect:Shape = new Shape();
    rect.graphics.beginFill(0xFF0000);
    rect.graphics.drawRect(0, 0, 100, 100);
    trace(rect.scaleY) // 1;
    rect.height = 200;
    trace(rect.scaleY) // 2;

Exceto para objetos TextField e Video, um objeto de exibição sem conteúdo (como uma entidade gráfica vazia) tem uma altura de 0, mesmo que você tente definir height como um valor diferente.

Retorna um objeto LoaderInfo contendo informações sobre o carregamento do arquivo ao qual esse objeto de exibição pertence. A propriedade loaderInfo é definida apenas para o objeto de exibição raiz de um arquivo SWF ou para um Bitmap carregado (e não para um Bitmap desenhado com ActionScript). Para descobrir o objeto loaderInfo associado ao arquivo SWF que contém um objeto de exibição denominado myDisplayObject, use myDisplayObject.root.loaderInfo.

Um arquivo SWF grande pode monitorar seu download chamando this.root.loaderInfo.addEventListener(Event.COMPLETE, func).

O objeto de exibição de chamada é mascarado pelo objeto mask especificado. Para garantir que o mascaramento funcione quando o Palco for dimensionado, o objeto de exibição mask precisa estar em uma parte ativa da lista de exibição. O objeto mask propriamente dito não é desenhado. Defina mask como null para remover a máscara.

Para poder dimensionar um objeto de máscara, ele deve estar na lista de exibição. Para poder arrastar um objeto Sprite "mask" (chamando seu método startDrag()), ele deve estar na lista de exibição. Para chamar o método startDrag() para uma entidade gráfica de máscara em um evento mouseDown que está sendo despachado pela entidade gráfica, defina a propriedade buttonMode dessa entidade como true.

Quando os objetos de exibição são armazenados em cache por meio da definição da propriedade cacheAsBitmap como true e a propriedade cacheAsBitmapMatrix como um objeto Matrix, tanto a máscara quanto o objeto de exibição que está sendo mascarado devem fazer parte do mesmo bitmap armazenado em cache. Assim, se o objeto de exibição estiver armazenado em cache, a máscara deverá ser filha do objeto de exibição. Se um ancestral do objeto de exibição na lista de exibição estiver armazenado em cache, a máscara deverá ser filha desse ancestral ou de um dos seus descendentes. Se mais de um ancestral do objeto mascarado estiver armazenado em cache, a máscara deverá ser descendente do contêiner armazenado em cache mais próximo do objeto mascarado na lista de exibição.

Observação: não é possível usar um objeto mask único para mascarar mais de um objeto de exibição de chamada. Quando se atribui mask a um segundo objeto de exibição, ele é removido como máscara do primeiro objeto, e a propriedade mask do objeto, torna-se null.

The measured height of this object.

This is typically hard-coded for graphical skins because this number is simply the number of pixels in the graphic. For code skins, it can also be hard-coded if you expect to be drawn at a certain size. If your size can change based on properties, you may want to also be an ILayoutManagerClient so a measure() method will be called at an appropriate time, giving you an opportunity to compute a measuredHeight.

The measured width of this object.

This is typically hard-coded for graphical skins because this number is simply the number of pixels in the graphic. For code skins, it can also be hard-coded if you expect to be drawn at a certain size. If your size can change based on properties, you may want to also be an ILayoutManagerClient so a measure() method will be called at an appropriate time, giving you an opportunity to compute a measuredHeight.

Indica a coordenada x da posição do dispositivo do mouse ou de entrada do usuário, em pixels.

Observação: Para um DisplayObject que foi girado, a coordenada x retornada refletirá o objeto não girado.

Indica a coordenada y da posição do dispositivo do mouse ou de entrada do usuário, em pixels.

Observação: Para um DisplayObject que foi girado, a coordenada y retornada refletirá o objeto não girado.

Indica o nome da ocorrência de DisplayObject. O objeto pode ser identificado na lista de filhos do seu contêiner de objetos de exibição-pai, chamando o método getChildByName() desse contêiner.

Especifica se o objeto de exibição é opaco com uma certa cor de plano de fundo. Um bitmap transparente contém dados de canal alfa e é desenhado transparentemente. Um bitmap opaco não tem canal alfa (e é renderizado mais rapidamente que um bitmap transparente). Se o bitmap for opaco, você poderá especificar sua própria cor de plano de fundo a ser usada.

Se definida como um valor numérico, a superfície será opaca (não transparente), com a cor de plano de fundo RGB especificada pelo número. Se definido como null (o valor padrão), o objeto de exibição terá um plano de fundo transparente.

A propriedade opaqueBackground serve principalmente para uso com a propriedade cacheAsBitmap, para otimização da renderização. Para objetos de exibição nos quais a propriedade cacheAsBitmap está definida como "true", a definição de opaqueBackground pode melhorar o desempenho de renderização.

A região de plano de fundo opaca não é correspondida ao chamar o método hitTestPoint() com o parâmetro sinalizadorForma definido como true.

A região de plano de fundo opaca não responde a eventos do mouse.

Indica o objeto DisplayObjectContainer que contém esse objeto de exibição. Use a propriedade parent de modo a especificar um caminho relativo para objetos de exibição que estão acima do objeto de exibição atual na hierarquia da lista de exibição.

Você pode usar parent para mover-se vários níveis acima na lista de exibição, como a seguir:

     this.parent.parent.alpha = 20;
     

Para um objeto de exibição em um arquivo SWF carregado, a propriedade root é o objeto de exibição na extremidade superior, na parte da estrutura em árvore da lista de exibição representada por esse arquivo SWF. Para um objeto Bitmap representando um arquivo de imagem carregado, a propriedade root é o próprio objeto. Para a ocorrência da classe principal do primeiro arquivo SWF carregado, a propriedade root é o próprio objeto de exibição. A propriedade root do objeto Stage é o próprio objeto Stage. A propriedade root é definida como null para qualquer objeto de exibição que não tenha sido adicionado à lista de exibição, a não ser que tenha sido adicionado a um contêiner de objetos de exibição que esteja fora da lista de exibição, mas que seja filho do objeto de exibição em posição superior em um arquivo SWF carregado.

Por exemplo, se você criar um novo objeto Sprite chamando o método do construtor Sprite(), sua propriedade root será null até você adicioná-lo à lista de exibição (ou a um contêiner de objetos de exibição que esteja fora da lista de exibição, mas que seja filho do objeto de exibição em posição superior em um arquivo SWF).

Para um arquivo SWF carregado, mesmo que o objeto Loader usado para carregar o arquivo possa não estar na lista de exibição, o objeto de exibição em posição superior nesse arquivo SWF tem sua propriedade root definida como si mesma. O objeto Loader não terá sua propriedade root definida até que seja adicionado como filho de um objeto de exibição para o qual a propriedade root esteja definida.

Indica o giro da ocorrência de DisplayObject, em graus, a partir da sua orientação original. Os valores de 0 a 180 representam o giro em sentido horário, enquanto os valores de 0 a -180 representam o giro em sentido anti-horário. Os valores fora dessa faixa são adicionados a ou subtraídos de 360 para obter um valor dentro da faixa. Por exemplo, a instrução my_video.rotation = 450 equivale a my_video.rotation = 90.

A grade de dimensionamento atual que está em vigor. Se definida como null, o objeto de exibição inteiro será dimensionado normalmente quando qualquer transformação de escala for aplicada.

Quando você define a propriedade scale9Grid, o objeto de exibição é dividido em uma grade com nove regiões com base no retângulo de scale9Grid, que define a região central da grade. As oito outras regiões da grade são as seguintes áreas:

• O canto superior esquerdo fora do retângulo
• A área acima do retângulo
• O canto superior direito fora do retângulo
• A área à esquerda do retângulo
• A área à direita do retângulo
• O canto inferior esquerdo fora do retângulo
• A área abaixo do retângulo
• O canto inferior direito fora do retângulo

Imagine as oito regiões fora do centro (definidas pelo retângulo) como sendo uma moldura de imagem que possui regras especiais aplicadas ao ser dimensionada.

Quando a propriedade scale9Grid está definida e um objeto de exibição é dimensionado, todos os gradientes e textos são dimensionados normalmente. Entretanto, para os outros tipos de objetos, as seguintes regras se aplicam:

• O conteúdo na região central é dimensionado normalmente.
• O conteúdo nos cantos não é dimensionado.
• O conteúdo nas regiões superior e inferior é dimensionado apenas horizontalmente. O conteúdo nas regiões esquerda e direita são dimensionados apenas verticalmente.
• Todos os preenchimentos (incluindo bitmaps, vídeo e gradientes) são esticados para encaixar suas formas.

Se um objeto de exibição for girado, todo o dimensionamento subsequente será normal (e a propriedade scale9Grid será ignorada).

Por exemplo, considere o objeto de exibição a seguir e um retângulo aplicado como scale9Grid do objeto de exibição:

O objeto de exibição.

O retângulo vermelho mostra scale9Grid.

Quando o objeto de exibição é dimensionado ou esticado, os objetos dentro do retângulo são dimensionados normalmente, mas os objetos fora dele são dimensionados de acordo com as regras de scale9Grid:

Dimensionado em 75%:
Dimensionado em 50%:
Dimensionado em 25%:
Esticado horizontalmente 150%:

Um uso comum para a definição scale9Grid é configurar um objeto de exibição a ser usado como componente, no qual as regiões da borda mantêm a mesma largura quando o componente é dimensionado.

Indica a escala horizontal (porcentagem) do objeto aplicada a partir do ponto de registro. O ponto de registro padrão é (0,0). 1.0 equivale a uma escala de 100%.

O dimensionamento do sistema de coordenadas local altera os valores das propriedades x e y, que são definidas em pixels inteiros.

Indica a escala vertical (porcentagem) de um objeto aplicada a partir do ponto de registro desse objeto. O ponto de registro padrão é (0,0). 1.0 equivale a uma escala de 100%.

O dimensionamento do sistema de coordenadas local altera os valores das propriedades x e y, que são definidas em pixels inteiros.

Os limites do retângulo de rolagem do objeto de exibição. O objeto de exibição é cortado com base no tamanho definido pelo retângulo e rola dentro do retângulo quando você altera as propriedades x e y do objeto scrollRect.

As propriedades do objeto Rectangle scrollRect usam o espaço de coordenadas do objeto de exibição e são dimensionadas como o objeto de exibição geral. Os limites de cantos da janela cortada no objeto de exibição de rolagem são a origem do objeto de exibição (0,0) e o ponto definido pela altura e largura do retângulo. Eles não são centralizados ao redor da origem, mas usam essa origem para definir o canto superior esquerdo da área. Um objeto de exibição rolado sempre rola em incrementos de pixels inteiros.

Você pode rolar um objeto para a esquerda e para a direita definindo a propriedade x do objeto Rectangle scrollRect. Você pode rolar um objeto para cima e para baixo definindo a propriedade y do objeto Rectangle scrollRect. Se o objeto de exibição for girado em 90° e for rolado para a esquerda e a direita, ele irá rolar na verdade para cima e para baixo.

Observe que as modificações à propriedade scrollRect só são processadas quando o objeto é renderizado. Assim, os métodos como localToGlobal podem não produzir o resultado esperado se chamados imediatamente depois de modificarscrollRect.

Observe: ao Iniciar o Flash Player 11.4/AIR 3.4, os valores negativos da largura ou da altura do retângulo alteram-se para 0.

O Palco do objeto de exibição. Um aplicativo de tempo de execução do Flash tem apenas um objeto Stage. Por exemplo, você pode criar e carregar vários objetos de exibição na lista de exibição, e a propriedade stage de cada objeto de exibição faz referência ao mesmo objeto Stage (mesmo que o objeto de exibição pertença a um arquivo SWF carregado).

Se um objeto de exibição não for adicionado à lista de exibição, sua propriedade stage será definida como null.

Um objeto com propriedades relacionadas aos limites de pixels, matriz e transformação de cores de um objeto de exibição. As propriedades específicas — matrix, colorTransform e três propriedades somente leitura (concatenatedMatrix, concatenatedColorTransform e pixelBounds) — são descritas na entrada da classe Transform.

Cada uma das propriedades do objeto "transform" é por si só um objeto. Esse conceito é importante uma vez que a única maneira de definir novos valores para objetos matrix ou colorTransform é criar um novo objeto e copiá-lo na propriedade transform.matrix ou transform.colorTransform.

Por exemplo, para aumentar o valor tx da matriz de uma objeto de exibição, é preciso fazer uma cópia do objeto "matrix" inteiro e então copiar o novo objeto na propriedade "matrix" do objeto "transform":

    var myMatrix:Matrix = myDisplayObject.transform.matrix;  
    myMatrix.tx += 10; 
    myDisplayObject.transform.matrix = myMatrix;  
    

Não é possível definir a propriedade tx diretamente. O código a seguir não tem efeito em myDisplayObject:

    myDisplayObject.transform.matrix.tx += 10;
    

Também é possível copiar um objeto "transform" inteiro e atribuí-lo à propriedade "transform" de outro objeto de exibição. Por exemplo, o código a seguir copia o objeto de transformação inteiro de myOldDisplayObj em myNewDisplayObj:

O objeto de exibição resultante, myNewDisplayObj, tem agora os mesmos valores para os seus limites de pixel, transformação de cores e matriz que o objeto de exibição antigo, myOldDisplayObj.

Observe que os dispositivos AIR for TV usam a aceleração por hardware, se disponível, para transformações de cores.

Se o objeto de exibição está ou não visível. Os objetos de exibição que não estiverem visíveis serão desativados. Por exemplo, se visible=false para uma ocorrência de InteractiveObject, não será possível clicar nessa ocorrência.

Indica a largura do objeto de exibição, em pixels. A largura é calculada com base nos limites do conteúdo do objeto de exibição. Quando você define a propriedade width, a propriedade scaleX é ajustada de acordo, como mostra o código a seguir:

    var rect:Shape = new Shape();
    rect.graphics.beginFill(0xFF0000);
    rect.graphics.drawRect(0, 0, 100, 100);
    trace(rect.scaleX) // 1;
    rect.width = 200;
    trace(rect.scaleX) // 2;

Exceto para objetos TextField e Video, um objeto de exibição sem conteúdo (como uma entidade gráfica vazia) tem uma largura de 0, mesmo que você tente definir width como um valor diferente.

Indica a coordenada x da ocorrência de DisplayObject com relação às coordenadas locais do DisplayObjectContainer-pai. Se o objeto estiver dentro de um DisplayObjectContainer que possui transformações, ele estará no sistema de coordenadas local do DisplayObjectContainer delimitador. Portanto, no caso de um DisplayObjectContainer com giro de 90° em sentido anti-horário, os filhos de DisplayObjectContainer herdam um sistema de coordenadas que é girado 90° em sentido anti-horário. As coordenadas do objeto fazem referência à posição do ponto de registro.

Indica a coordenada y da ocorrência de DisplayObject com relação às coordenadas locais do DisplayObjectContainer-pai. Se o objeto estiver dentro de um DisplayObjectContainer que possui transformações, ele estará no sistema de coordenadas local do DisplayObjectContainer delimitador. Portanto, no caso de um DisplayObjectContainer com giro de 90° em sentido anti-horário, os filhos de DisplayObjectContainer herdam um sistema de coordenadas que é girado 90° em sentido anti-horário. As coordenadas do objeto fazem referência à posição do ponto de registro.

Retorna um retângulo que define a área do objeto de exibição com relação ao sistema de coordenadas do objeto targetCoordinateSpace. Considere o código a seguir, que mostra como o retângulo retornado pode variar dependendo do parâmetro espaçoCoordenadasDestino transmitido ao método:

     var container:Sprite = new Sprite();
     container.x = 100;
     container.y = 100;
     this.addChild(container);
     var contents:Shape = new Shape();
     contents.graphics.drawCircle(0,0,100);
     container.addChild(contents);
     trace(contents.getBounds(container));
      // (x=-100, y=-100, w=200, h=200)
     trace(contents.getBounds(this));
      // (x=0, y=0, w=200, h=200)
     

Observação:Use os métodos localToGlobal() e globalToLocal() para converter as coordenadas locais do objeto de exibição em coordenadas de exibição ou as coordenadas de exibição em coordenadas locais, respectivamente.

O método getBounds() é semelhante ao método getRect(). Entretanto, o retângulo retornado pelo método getBounds() inclui traçados em formas, o que não ocorre com o retângulo retornado pelo método getRect(). Para obter um exemplo, consulte a descrição do método getRect().

Parâmetros

Retorna um retângulo que define o limite do objeto de exibição, com base no sistema de coordenadas definido pelo parâmetro espaçoCoordenadasDestino, excluindo quaisquer traçados em formas. Os valores retornados pelo método getRect() são os mesmos ou menores do que os retornados pelo método getBounds().

Observação:Use os métodos localToGlobal() e globalToLocal() para converter as coordenadas locais do objeto de exibição em coordenadas do Palco ou as coordenadas do Palco em coordenadas locais, respectivamente.

Parâmetros

Converte o objeto de ponto a partir de coordenadas de Palco (globais) em coordenadas do objeto de exibição (locais).

Para usar esse método, crie primeiro uma ocorrência da classe Point. Os valores x e y que você atribuir representam coordenadas globais porque estão relacionados à origem (0,0) da área de exibição principal. Em seguida, transmita a ocorrência de Point como parâmetro para o método globalToLocal(). O método retorna um novo objeto Point com os valores x e y que estão relacionados à origem do objeto de exibição em vez da origem do Palco.

Parâmetros

Avalia a caixa delimitadora do objeto de exibição para ver se ela sobrepõe ou faz interseção com a caixa delimitadora do objeto de exibição obj.

Parâmetros

Avalia o objeto de exibição para ver se ele sobrepõe ou faz interseção com o ponto especificado pelos parâmetros x e y. Os parâmetros x e y especificam um ponto no espaço de coordenadas do Palco e não do contêiner de objetos de exibição que mantém o objeto de exibição (a menos que esse contêiner seja o Palco).

Parâmetros

Converte o objeto de point a partir das coordenadas do objeto de exibição (locais) em coordenadas do Palco (globais).

Esse método permite converter quaisquer coordenadas x e y especificadas de valores relativos à origem (0,0) de um objeto de exibição específico (coordenadas locais) em valores relativos à origem do Palco (coordenadas globais).

Para usar esse método, crie primeiro uma ocorrência da classe Point. Os valores x e y que você atribuir representam coordenadas locais porque estão relacionados à origem do objeto de exibição.

Em seguida, transmita a ocorrência de Point criada como parâmetro para o método localToGlobal(). O método retorna um novo objeto Point com os valores x e y que estão relacionados à origem do Palco em vez da origem do objeto de exibição.

Parâmetros

Moves this object to the specified x and y coordinates.

Parâmetros

Sets the actual size of this object.

This method is mainly for use in implementing the updateDisplayList() method, which is where you compute this object's actual size based on its explicit size, parent-relative (percent) size, and measured size. You then apply this actual size to the object by calling setActualSize().

In other situations, you should be setting properties such as width, height, percentWidth, or percentHeight rather than calling this method.

Parâmetros