IContainer  - AS3 Flex

Especifica o modo de botão desta entidade gráfica. Se true, essa entidade gráfica se comportará como um botão, o que significa que ela aciona a exibição do cursor de mão quando o mouse passa sobre a entidade gráfica e poderá receber um evento click se as teclas Enter ou barra de espaço forem pressionadas quando o foco estiver na entidade gráfica. É possível suprimir a exibição do cursor de mão definindo a propriedade useHandCursor como false, em cujo caso o ponto é exibido.

Embora seja melhor usar a classe SimpleButton para criar botões, você pode usar a propriedade buttonMode para fornecer a uma entidade gráfica uma funcionalidade de botão. Para incluir uma entidade gráfica na ordem de tabulação, defina a propriedade tabEnabled (herdada da classe InteractiveObject e false por padrão) como true. Além disso, considere se você deseja que os filhos da entidade gráfica sejam ativados pelo usuário. A maioria dos botões não permitem a interatividade do usuário para seus objetos-filho, já que isso confunde o fluxo de eventos. Para desativar a interatividade para todos os objetos-filho, é necessário definir a propriedade mouseChildren (herdada da classe DisplayObjectContainer) como false.

Se você usar a propriedade buttonMode com a classe MovieClip (que é uma subclasse da classe Sprite), o botão poderá ter uma certa funcionalidade adicionada. Se você incluir quadros com os rótulos _up, _over e _down, o Flash Player fornecerá alterações automáticas de estado (funcionalidade semelhante à fornecida nas versões anteriores do ActionScript para clipes de filme usados como botões). Essas alterações automáticas de estado não estão disponíveis para entidades gráficas, que não têm linha do tempo e, portanto, não têm quadros a serem rotulados.

Containers use an internal content pane to control scrolling. The creatingContentPane is true while the container is creating the content pane so that some events can be ignored or blocked.

The Button control designated as the default button for the container. When controls in the container have focus, pressing the Enter key is the same as clicking this Button control.

Especifica se o objeto recebe eventos doubleClick. O valor padrão é false, o que significa que, por padrão, qualquer ocorrência de InteractiveObject não recebe eventos doubleClick. Se a propriedade doubleClickEnabled estiver definida como true, a ocorrência receberá eventos doubleClick dentro de seus limites. A propriedade mouseEnabled da ocorrência de InteractiveObject também deve ser definida como true para que o objeto receba eventos doubleClick.

Nenhum evento é despachado com o uso dessa propriedade. Você deve usar o método addEventListener() para adicionar um ouvinte de evento para o evento doubleClick.

Especifica o objeto de exibição sobre o qual a entidade gráfica está sendo arrastada ou no qual a entidade gráfica foi solta.

Gets the FocusManager that controls focus for this component and its peers. Each popup has its own focus loop and therefore its own instance of a FocusManager. To make sure you're talking to the right one, use this method.

Especifica se este objeto exibe um retângulo de foco. Pode ser um dos três valores: true, false ou null. Os valores de true e false funcionam como esperado, especificando se o retângulo de foco aparece ou não. Um valor null indica que esse objeto obedece à propriedade stageFocusRect no Palco.

Especifica o objeto Graphics pertencente a esta entidade gráfica em que comandos de desenho de vetor podem ocorrer.

Designa outra entidade gráfica para atuar como área de ocorrência para uma entidade gráfica. Se a propriedade hitArea não existir ou o valor for null ou undefined, a própria entidade gráfica será usada como área de ocorrência. O valor da propriedade hitArea pode ser uma referência a um objeto Sprite.

A propriedade hitArea pode ser alterada a qualquer momento; a entidade gráfica modificada usa imediatamente o novo comportamento da área de ocorrência. A entidade gráfica designada como área de ocorrência não precisa estar visível; sua forma gráfica, embora invisível, ainda é detectada como a área de ocorrência.

Observação: é necessário definir como false a propriedade mouseEnabled da entidade gráfica designada como área de ocorrência. Caso contrário, o botão de entidade gráfica não funcionará porque a entidade gráfica designada como área de acerto receberá os eventos da entrada de usuário no lugar desse botão de entidade gráfica.

The current position of the horizontal scroll bar. This is equal to the distance in pixels between the left edge of the scrollable surface and the leftmost piece of the surface that is currently visible.

Determina se os filhos do objeto são ou não ativados pelo mouse, ou dispositivo de entrada do usuário. Se um objeto estiver ativado,um usuário pode interagir com ele usando um mouse ou dispositivo de entrada do usuário. O padrão é true.

Essa propriedade é útil quando você cria um botão com uma ocorrência da classe Sprite (em vez de usar a classe SimpleButton). Ao usar uma ocorrência de Sprite para criar um botão, você pode optar por decorar esse botão usando o método addChild() para incluir ocorrências adicionais de Sprite. Esse processo pode causar um comportamento inesperado com eventos de mouse, já que as ocorrências de Sprite adicionadas como filhos podem se tornar o objeto de destino de um evento de mouse, quando você espera que a ocorrência-pai seja o objeto de destino. Para garantir que a ocorrência-pai atue como o objeto de destino para eventos de mouse, defina a propriedade mouseChildren dessa ocorrência como false.

Nenhum evento é despachado com o uso dessa propriedade. É necessário usar o método addEventListener() para criar uma funcionalidade interativa.

Especifica se este objeto recebe mensagens de mouse, ou de outras entradas de usuários. O valor padrão é true, o que significa que, por padrão, qualquer instância de InteractiveObject na lista de exibição receberá eventos do mouse. Se mouseEnabled for definido como false, a instância não recebe nenhum evento de mouse (ou outros eventos de entrada de usuário como eventos do teclado). Nenhum filho dessa ocorrência na lista de exibição será afetado. Para alterar o comportamento de mouseEnabled para todos os filhos de um objeto na lista de objetos, use flash.display.DisplayObjectContainer.mouseChildren.

Nenhum evento é despachado com o uso dessa propriedade. É necessário usar o método addEventListener() para criar uma funcionalidade interativa.

Retorna o número de filhos deste objeto.

Controla o som nesta entidade gráfica.

Observação: Esta propriedade não afeta o conteúdo de HTML em um objeto HTMLControl (no Adobe AIR).

Determines whether the children of the object are tab enabled.

Note: Do not use this property with Flex. Instead, use the UIComponent.hasFocusableChildren property.

Elementos da API relacionados

Especifica se este objeto está na ordem de tabulação. Se o objeto estiver na ordem de tabulação, o valor será true; caso contrário, o valor será false. Por padrão, o valor é false, exceto pelo seguinte:

• Para um objeto SimpleButton, o valor é true.
• Para um objeto TextField com type = "input", o valor é true.
• Para um objeto Sprite ou MovieClip com buttonMode = true, o valor é true.

Especifica a ordem de tabulação de objetos em um arquivo SWF. A propriedade tabIndex é -1 por padrão, significando que nenhum índice de tabulação é definido para o objeto.

Se qualquer objeto atualmente exibido no arquivo SWF contiver uma propriedade tabIndex, a ordenação de tabulação automática será desativada e essa ordenação será calculada a partir das propriedades tabIndex de objetos no arquivo SWF. A ordenação de tabulação personalizada inclui apenas objetos que possuem propriedades tabIndex.

A propriedade tabIndex pode ser um inteiro não negativo. Os objetos são ordenados de acordo com suas propriedades tabIndex, em ordem crescente. Um objeto com um valor tabIndex de 1 precede um objeto com um valor tabIndex de 2. Não use o mesmo valor tabIndex para vários objetos.

A ordenação de guia personalizada definida pela propriedade tabIndex é flat. Isso significa que nenhuma atenção é dada aos relacionamentos hierárquicos de objetos no arquivo SWF. Todos os objetos no arquivo SWF com propriedades tabIndex são inseridos na ordem de tabulação, que é determinada pela ordem dos valores tabIndex.

Nota: para definir a ordem de tabulação das instâncias TLFTextField, envie o filho do objeto de exibição de TLFTextField como um InteractiveObject e, em seguida, defina a propriedade tabIndex. Por exemplo:

	 InteractiveObject(tlfInstance.getChildAt(1)).tabIndex = 3;
	 

	 InteractiveObject(tlfInstance1.getChildAt(1)).tabIndex = 3;
	 InteractiveObject(tlfInstance2.getChildAt(1)).tabIndex = 2;
	 InteractiveObject(tlfInstance3.getChildAt(1)).tabIndex = 1;
	 

Retorna um objeto TextSnapshot para essa ocorrência de DisplayObjectContainer.

Um valor booliano que indica se a mão que aponta (cursor de mão) aparece quando o mouse passa sobre uma entidade gráfica em que a propriedade buttonModeesteja definida como true. O valor padrão da propriedade useHandCursor é true. Se useHandCursor está definida como true, a mão que aponta usada para botões aparecerá quando o mouse rolar sobre uma entidade gráfica de botão. Se useHandCursor for false, o ponteiro de seta será usado.

A propriedade useHandCursor pode ser alterada a qualquer momento; a entidade gráfica modificada usa imediatamente a nova aparência do cursor.

Observação: No Flex ou no Flash Builder, se o seu fantasma tiver fantasmas filhos, talvez convenha definir a propriedade mouseChildren como false. Por exemplo, se desejar que o cursor de mão seja exibido sobre um controle Flex<mx:Label>, defina as propriedades useHandCursor e buttonMode como true, e a propriedade mouseChildren como false.

The current position of the vertical scroll bar. This is equal to the distance in pixels between the top edge of the scrollable surface and the topmost piece of the surface that is currently visible.

Returns an object that has four properties: left, top, right, and bottom. The value of each property equals the thickness of the chrome (visual elements) around the edge of the container.

The chrome includes the border thickness. If the horizontalScrollPolicy or verticalScrollPolicy property value is ScrollPolicy.ON, the chrome also includes the thickness of the corresponding scroll bar. If a scroll policy is ScrollPolicy.AUTO, the chrome measurement does not include the scroll bar thickness, even if a scroll bar is displayed.

Subclasses of Container should override this method, so that they include other chrome to be taken into account when positioning the Container's children. For example, the viewMetrics property for the Panel class should return an object whose top property includes the thickness of the Panel container's title bar.

Adiciona uma ocorrência-filho de DisplayObject a essa ocorrência de DisplayObjectContainer. O filho é adicionado à frente (acima) de todos os outros filhos nessa ocorrência de DisplayObjectContainer. (Para adicionar um filho em uma posição de índice específica, use o método addChildAt().)

Se você adicionar um objeto-filho que já tenha um contêiner de objetos de exibição diferente como pai, o objeto será removido da lista de filhos do outro contêiner de objetos de exibição.

Observação: O comando stage.addChild() pode causar problemas com um arquivo SWF publicado, inclusive problemas de segurança e conflitos com outros arquivos SWF carregados. Há só um Palco dentro de uma instância de tempo de execução de Flash, não importa quantos arquivos SWF você carrega no tempo de execução. Portanto, geralmente, os objetos não devem ser adicionados ao Palco, diretamente. O único objeto que o Palco deve conter é o objeto-raiz. Crie um DisplayObjectContainer para conter todos os itens na lista de exibição. Então, se necessário, adicione essa instância DisplayObjectContainer ao Palco.

Parâmetros

Adiciona uma ocorrência-filho de DisplayObject a essa ocorrência de DisplayObjectContainer. O filho é adicionado na posição de índice especificada. Um índice de 0 representa o final (parte inferior) da lista de exibição para esse objeto DisplayObjectContainer.

Por exemplo, o exemplo a seguir mostra três objetos de exibição, com os rótulos a, b e c, nas posições de índice 0, 2 e 1, respectivamente:

Se você adicionar um objeto-filho que já tenha um contêiner de objetos de exibição diferente como pai, o objeto será removido da lista de filhos do outro contêiner de objetos de exibição.

Parâmetros

Indica se restrições de segurança fariam com que qualquer objeto de exibição fosse omitido da lista retornada com a chamada do método DisplayObjectContainer.getObjectsUnderPoint() junto com o ponto especificado. Por padrão, o conteúdo de um domínio não pode acessar objetos de outro domínio, a não ser isso seja permitido com uma chamada ao método Security.allowDomain(). Para obter mais informações relacionadas à segurança, consulte o tópico do Centro do desenvolvedor do Flash Player: Security.

O parâmetro ponto está no espaço de coordenadas do Palco, que pode ser diferente do espaço de coordenadas do contêiner de objetos de exibição (a menos que o contêiner de objetos de exibição seja o Palco). Você pode usar os métodos globalToLocal() e localToGlobal() para converter pontos entre esses espaços de coordenadas.

Parâmetros

Determina se o objeto de exibição especificado é um filho da ocorrência de DisplayObjectContainer ou se é a própria ocorrência. A pesquisa inclui a lista de exibição inteira, incluindo essa ocorrência de DisplayObjectContainer. Netos, bisnetos e assim por diante retornam true cada.

Parâmetros

Retorna a ocorrência do objeto de exibição-filho que existe no índice especificado.

Parâmetros

Retorna o objeto de exibição-filho que existe com o nome especificado. Se mais de um objeto de exibição-filho tiver o nome especificado, o método retornará o primeiro objeto na lista de filhos.

O método getChildAt() é mais rápido do que o método getChildByName(). O método getChildAt() acessa um filho a partir de uma matriz em cache, enquanto o método getChildByName() precisa atravessar a lista vinculada para acessar um filho.

Parâmetros

Retorna a posição de índice de uma ocorrência-filho de DisplayObject.

Parâmetros

Retorna uma matriz de objetos que estão dispostos no ponto especificado e são filhos (ou netos e assim por diante) desta ocorrência de DisplayObjectContainer. Os objetos-filho que não puderem ser acessados por questões de segurança serão omitidos da matriz retornada. Para determinar se essa restrição de segurança afeta a matriz retornada, chame o método areInaccessibleObjectsUnderPoint().

O parâmetro ponto está no espaço de coordenadas do Palco, que pode ser diferente do espaço de coordenadas do contêiner de objetos de exibição (a menos que o contêiner de objetos de exibição seja o Palco). Você pode usar os métodos globalToLocal() e localToGlobal() para converter pontos entre esses espaços de coordenadas.

Parâmetros

Remove uma ocorrência-filho de DisplayObject especificada da lista de filhos da ocorrência de DisplayObjectContainer. A propriedade parent do filho removido é definida como null e o objeto será coletado como lixo se não houver outras referências ao filho. As posições de índice de qualquer objeto de exibição acima do filho em DisplayObjectContainer são diminuídas em 1.

O coletor de lixo realoca o espaço de memória não utilizado. Quando uma variável ou objeto deixa de ser ativamente referenciado ou é armazenado em outro local, o coletor de lixo faz uma varredura e limpa o espaço de memória que essa variável ou objeto costumava ocupar, se nenhuma outra referência existir.

Parâmetros

Remove um DisplayObject filho da posição de index especificada na lista de filhos de DisplayObjectContainer. A propriedade parent do filho removido é definida como null e o objeto será coletado como lixo se não houver outras referências ao filho. As posições de índice de qualquer objeto de exibição acima do filho em DisplayObjectContainer são diminuídas em 1.

O coletor de lixo realoca o espaço de memória não utilizado. Quando uma variável ou objeto deixa de ser ativamente referenciado ou é armazenado em outro local, o coletor de lixo faz uma varredura e limpa o espaço de memória que essa variável ou objeto costumava ocupar, se nenhuma outra referência existir.

Parâmetros

Altera a posição de um filho existente no contêiner de objetos de exibição. Isso afeta a disposição de objetos-filho em camadas. Por exemplo, o exemplo a seguir mostra três objetos de exibição, com os rótulos a, b e c, nas posições de índice 0, 1 e 2, respectivamente:

Quando você usa o método setChildIndex() e especifica uma posição de índice que já está ocupada, as únicas posições alteradas são aquelas entre a posição nova e a anterior do objeto de exibição. Todos as demais permanecem da mesma maneira. Se um filho for movido para um índice INFERIOR ao índice atual respectivo, todos os filhos entre eles AUMENTARÃO em 1 na respectiva referência de índice. Se um filho for movido para um índice SUPERIOR ao índice atual respectivo, todos os filhos entre eles DIMINUIRÃO em 1 na respectiva referência de índice. Por exemplo, se o contêiner de objetos de exibição no exemplo anterior se chamar container, você poderá alternar a posição dos objetos de exibição com os rótulos a e b, chamando o seguinte código:

container.setChildIndex(container.getChildAt(1), 0);

Esse código resulta na seguinte disposição de objetos:

Parâmetros

Permite ao usuário arrastar a entidade gráfica especificada. A entidade gráfica permanece arrastável até ser explicitamente interrompida por meio de uma chamada ao método Sprite.stopDrag() ou até que outra entidade gráfica se torne arrastável. Apenas uma entidade gráfica por vez pode ser arrastável.

Os objetos de exibição tridimensional seguem o mouse e Sprite.startDrag() move o objeto dentro do plano tridimensional definido pelo objeto de exibição. Ou, se o objeto de exibição for um objeto bidimensional e filho de um objeto tridimensional, esse objeto bidimensional se moverá dentro do plano tridimensional definido pelo objeto pai tridimensional.

Parâmetros

Finaliza o método startDrag(). Uma entidade gráfica que se tornou arrastável com o método startDrag() permanecerá nesse estado até que um método stopDrag() seja adicionado ou até que outra entidade gráfica se torne arrastável. Apenas uma entidade gráfica por vez pode ser arrastável.

Alterna a ordem z (ordem da frente para trás) dos dois objetos filhos especificados. Todos os outros objetos-filho no contêiner de objetos de exibição permanecem nas mesmas posições de índice.

Parâmetros

Alterna a ordem z (ordem da frente para trás) dos objetos-filho nas duas posições de índice especificadas na lista de filhos. Todos os outros objetos-filho no contêiner de objetos de exibição permanecem nas mesmas posições de índice.

Parâmetros