Escolha de uma subclasse de DisplayObject

Flash Player 9 e posterior, Adobe AIR 1.0 e posterior

Com tantas opções disponíveis, ao trabalhar com objetos de exibição, uma das decisões importantes é definir qual objeto será usado para cada finalidade. Veja algumas diretrizes que podem ajudá-lo a tomar essa decisão. Essas mesmas sugestões podem ser usadas quando você precisa de uma ocorrência de uma classe ou está escolhendo uma base para criar uma classe:

  • Se você não precisar de um objeto que possa ser contêiner de outros objetos de exibição (isto é, precisar de apenas um que sirva como um elemento de tela autônomo), escolha uma dessas subclasses de DisplayObject ou InteractiveObject, dependendo do uso pretendido:

    • Bitmap para exibir uma imagem de bitmap.

    • TextField para adicionar texto.

    • Video para exibir vídeo.

    • Shape para uma “tela de desenho” para desenhar o conteúdo na tela. Especificamente, se desejar criar uma ocorrência para desenhar formas na tela que não será contêiner de outros objetos de exibição, use Shape em vez de Sprite ou MovieClip para melhorar o desempenho significativamente.

    • MorphShape, StaticText ou SimpleButton para itens criados com a ferramenta de autoria do Flash. Não é possível criar ocorrências dessas classes de modo programático, mas você pode criar variáveis com esses tipos de dados para fazer referência aos itens criados com a ferramenta da autoria do Flash.

  • Se precisar de uma variável para fazer referência ao palco principal, use a classe Stage como tipo de dados.

  • Se precisar de um contêiner para carregar um arquivo SWF ou de imagem externo, use uma ocorrência de Loader. O conteúdo carregado será adicionado à lista de exibição como filho da ocorrência de Loader. O tipo de dados depende da natureza do conteúdo carregado, do seguinte modo:

    • Uma imagem carregada será uma ocorrência do Bitmap.

    • Um arquivo SWF carregado gravado no ActionScript 3.0 será uma ocorrência de Sprite ou MovieClip (ou uma ocorrência de uma subclasse dessas classes, conforme especificado pelo criador do conteúdo).

    • Um arquivo SWF carregado gravado no ActionScript 1.0 ou no ActionScript 2.0 será uma ocorrência de AVM1Movie.

  • Se precisar de um objeto para servir como contêiner de outros objetos de exibição (esteja você desenhando ou não no objeto de exibição com o ActionScript), escolha uma das subclasses de DisplayObjectContainer:

    • Sprite se o objeto for criado apenas com o ActionScript ou como a classe base de um objeto de exibição personalizado que será criado e manipulado somente com o ActionScript.

    • MovieClip se estiver criando uma variável para fazer referência a um símbolo de clipe de filme criado na ferramenta de criação do Flash.

  • Se estiver criando uma classe que será associada a um símbolo de clipe de filme na biblioteca do Flash, escolha uma destas subclasses de DisplayObjectContainer como sua classe base:

    • MovieClip se o símbolo de clipe de filme associado tiver conteúdo em mais de um quadro

    • Sprite se o símbolo de clipe de filme associado tiver conteúdo somente no primeiro quadro