Flex : How to Display Hand Cursor on Components

On March 27, 2008, in Flex, by Anuj Gakhar

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.


<mx:Label buttonMode="true" text="testing here" useHandCursor="true" mouseChildren="false" />
<mx:Image source="someimage.gif" buttonMode="true"/>
<mx:Button label="Button" buttonMode="true" />
<mx:Text text="testing again" buttonMode="true" useHandCursor="true" mouseChildren="false" />

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

Tagged with:  

21 Responses to Flex : How to Display Hand Cursor on Components

  1. frank says:

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

  2. Anuj Gakhar says:

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

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

  3. frank says:

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

  4. kanu kukreja says:

    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. Anuj Gakhar says:

    @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. Dylan says:

    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. I looked at the API for this and my impression (though I have not tested this) is that the mouseChildren requirement comes from Label’s internal textField UIComponent that it uses to actually render the text. Since textField is itself a UIComponent, it would by default capture the mouse, and any mouse related parameters would have to be set on it (Label.TextField) instead. By setting mouseChildren = false, the mouse focus is not allowed to drop down to the Text Field. Anyone know? :)

  8. Ansury says:

    “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 ?”

    A component like “Text” isn’t a container and can’t have children, so I’m thinking that has something to do with it, but I’ve never looked into it myself.

  9. dan says:

    set mouseChildren on components that contain children if you want mouse events to apply to the whole component and not separately for each of its children (be careful though, it will disabled their own unique events).

  10. Ed says:

    Thanks Dude help me so much!

  11. Andy says:

    This was really helpful!

  12. jeeva says:

    Mac os doesn’t support hand cursor. How to do it?

  13. Mr.Kwon says:

    This is very helpful tip.

  14. Derek says:

    This helped me out! Thanks!

  15. Puneet says:

    Thank you very much. It works as expected. You saved my Day….

  16. Thom Haynes says:

    Just what I needed, thks!

  17. Tahir Alvi says:

    If i want to show hand cursor on Buttonbar in Flex 4.
    What can i do?

  18. sonali says:

    thanks a lot … !! :)

  19. Thanks :)

    mouseChildren=”false” made buttonMode works perfectly on mx:Text

    ^^

Leave a Reply

© 2011 Anuj Gakhar
%d bloggers like this: