Flex : How to Display Hand Cursor on Components

Tagged Under :

If you want to display a hand cursor over a Flex component (any Flex Component I would say ?), there are two properties that come handy. useHandCursor and buttonMode. In some cases, a third property called mouseChildren might be required as well.

Here is a little extract from the Flex livedocs , on what buttonMode and mouseChildren means :-

buttonMode property

Specifies the button mode of this sprite. If true, this sprite behaves as a button, which means that it triggers the display of the hand cursor when the mouse passes over the sprite and can receive a click event if the enter or space keys are pressed when the sprite has focus. You can suppress the display of the hand cursor by setting the useHandCursor property to false, in which case the pointer is displayed.

mouseChildren property

Determines whether or not the children of the object are mouse enabled. If an object is mouse enabled, a user can interact with it by using a mouse. The default is true.

If you look at the code below, there are 4 different controls (Label, Image, Button and Text), all 4 of them will display a handCursor but if you notice, for Label and Text, I had to use mouseChildren = false to achieve this and for Image and Button, simply doing buttonMode = true did the trick.

I understand what mouseChildren means, if we set it to false, it basically stops all the mouse activities on that control and we need to do custom events for mouse actions but why I had to set it to false for Label and Text, I am not sure yet! Maybe someone can explain ?

My overall conclusion is, if you want to get a hand cursor, use all 3 properties, sounds like the safest bet to me, atleast we know its going to work!

useHandCursor = true
buttonMode = true
mouseChildren = false

Comments:

7 Responses to “Flex : How to Display Hand Cursor on Components”


  1. So, how do you do this in actionscript, say on a shape component?


  2. s.buttonMode = true;
    s.useHandCursor = true;

    something like that, given that s is your Shape object.


  3. cool actually it turns out the shape object doesn’t support those properties so i had to use a sprite instead. thanks!


  4. its perfectly fine thing whatever you have mentioned, but problem with this is it disables the click events of text and label :(
    do have any solution for this?


  5. @kanu, how did you try the click events , did you add an event listener for the click events? My understanding is it should work.


  6. The best you can for the ComboBox is to set buttonMode=”true” but do not set mouseChildren or else it will disable the ability to use the drop down. Setting buttonMode=”true” allows you to have a hand cursor over the down triangle but not on the option labels.


  7. This also works for when you import fl.controls.button in an Actionscript only project.
    see http://joshblog.net/2008/02/10/how-to-use-the-flash-cs3-component-set-in-a-flex-builder-actionscript-project/
    and
    http://de-co-de.blogspot.com/2008/03/wheres-my-skin.html

Leave a Reply