| Pacote | flash.ui |
| Classe | public final class MouseCursorData |
| Herança | MouseCursorData Object |
| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10.2, AIR 2.6 |
Para exibir o cursor, use o Mouse.registerCursor() função. Para retornar o controle da imagem de cursor ao sistema operacional, chamar Mouse.unregisterCursor(). Chamar Mouse.supportsNativeCursor testar se os cursores nativos são apoiados no computador atual.
O tamanho de cursor máximo é 32x32 pixels. A transparência é apoiada na maior parte de sistemas operacionais.
Um cursor do mouse nativo é implementado diretamente pelo mecanismo de cursor de sistema operacional e é um meio mais eficiente para exibir uma imagem de cursor personalizada do que a utilização de um objeto de exposição. Você pode animar o cursor fornecendo a mais de uma imagem no data propriedade e configuração da taxa de quadros.
O cursor só é exibido dentro dos limites do palco. Do lado de fora do palco, o controle da imagem de cursor retorna ao sistema operacional
Saiba mais
Elementos da API relacionados
| Propriedade | Definido por | ||
|---|---|---|---|
![]() | constructor : Object
Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto. | Object | |
| data : Vector.<BitmapData>
Um vetor dos objetos BitmapData que contém a image ou imagens do cursor. | MouseCursorData | ||
| frameRate : Number
A taxa de quadros da animação do cursor. | MouseCursorData | ||
| hotSpot : Point
O ponto de posicionamento do cursor em pixels. | MouseCursorData | ||
| Método | Definido por | ||
|---|---|---|---|
Cria um objeto MouseCursorData. | MouseCursorData | ||
![]() |
Indica se um objeto tem uma propriedade especificada definida. | Object | |
![]() |
Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro. | Object | |
![]() |
Indica se a propriedade especificada existe e é enumerável. | Object | |
![]() |
Define a disponibilidade de uma propriedade dinâmica para operações de repetição. | Object | |
![]() |
Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade. | Object | |
![]() |
Retorna a representação de string do objeto especificado. | Object | |
![]() |
Retorna o valor primitivo do objeto especificado. | Object | |
data | propriedade |
data:Vector.<BitmapData>| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10.2, AIR 2.6 |
Um vetor dos objetos BitmapData que contém a image ou imagens do cursor.
Forneça a mais de uma imagem e estabeleça o framerate propriedade para animar o cursor.
O tamanho de cursor máximo é 32x32 pixels.
Implementação
public function get data():Vector.<BitmapData> public function set data(value:Vector.<BitmapData>):voidframeRate | propriedade |
frameRate:Number| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10.2, AIR 2.6 |
A taxa de quadros da animação do cursor.
Suppy mais de uma imagem no data propriedade e jogo a taxa de quadros a um valor maior do que 0 para animar o cursor. Esta taxa de quadros do cursor pode ser diferente da taxa de quadros do SWF atual.
Implementação
public function get frameRate():Number public function set frameRate(value:Number):voidhotSpot | propriedade |
hotSpot:Point| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10.2, AIR 2.6 |
O ponto de posicionamento do cursor em pixels.
O ponto ativo é o ponto no cursor abaixo do qual os cliques de mouse são registrados. À revelia, a região de conflito é o canto superior esquerdo (0,0).
Implementação
public function get hotSpot():Point public function set hotSpot(value:Point):voidMouseCursorData | () | Construtor |
public function MouseCursorData()| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10.2, AIR 2.6 |
Cria um objeto MouseCursorData.
Para exibir o cursor, chame o Mouse.registerCursor() função.
Elementos da API relacionados
O exemplo usa os comandos de desenho disponíveis pela classe de Gráficos para criar oito, imagens giradas de uma seta. Estas imagens são empurradas em um vetor e atribuidas ao data propriedade do objeto de MouseCursorData. (Observe que você também pode usar imagens bitmap prerenderizadas dos seus cursores.)
package {
import flash.display.Sprite;
import flash.display.Shape;
import flash.display.BitmapData;
import flash.display.GraphicsPath;
import flash.ui.MouseCursorData;
import flash.ui.Mouse;
import flash.geom.Matrix;
public class MouseCursorDataExample extends Sprite {
//Graphics path data for an arrow
private var cursorPoints:Vector.<Number> = new <Number>[0,8, 16,8, 16,0, 24,12, 16,24, 16,16, 0,16, 0,8];
private var cursorDrawCommands:Vector.<int> = new <int>[1,2,2,2,2,2,2,2];
public function MouseCursorDataExample() {
var mouseCursorData:MouseCursorData = new MouseCursorData();
mouseCursorData.data = makeCursorImages();
mouseCursorData.frameRate = 1;
Mouse.registerCursor( "spinningArrow", mouseCursorData );
Mouse.cursor = "spinningArrow";
}
//Returns a Vector containing 8 cursor images
private function makeCursorImages():Vector.<BitmapData>
{
var cursorData:Vector.<BitmapData> = new Vector.<BitmapData>();
var cursorShape:Shape = new Shape();
cursorShape.graphics.beginFill( 0xff5555, .75 );
cursorShape.graphics.lineStyle( 1 );
cursorShape.graphics.drawPath( cursorDrawCommands, cursorPoints );
cursorShape.graphics.endFill();
var transformer:Matrix = new Matrix();
//Rotate and draw the arrow shape to a BitmapData object for each of 8 frames
for( var i:int = 0; i < 8; i++ )
{
var cursorFrame:BitmapData = new BitmapData( 32, 32, true, 0 );
cursorFrame.draw( cursorShape, transformer );
cursorData.push( cursorFrame );
transformer.translate(-15,-15);
transformer.rotate( 0.785398163 );
transformer.translate(15,15);
}
return cursorData;
}
}
}
Wed Jun 13 2018, 11:10 AM Z
Ocultar propriedades públicas herdadas
Mostrar propriedades públicas herdadas