sbIClickablePropertyInfo Interface Reference

The property information specific to clickable properties. More...

import"sbIClickablePropertyInfo.idl";

Inheritance diagram for sbIClickablePropertyInfo:
[legend]
Collaboration diagram for sbIClickablePropertyInfo:
[legend]

Public Member Functions

boolean isDisabled (in AString aCurrentValue)
 Whether the tree cell widget representing this property should be disabled given a value (for this property) More...
 
boolean hitTest (in AString aCurrentValue, in AString aPart, in unsigned long aBoxWidth, in unsigned long aBoxHeight, in unsigned long aMouseX, in unsigned long aMouseY)
 Hit testing for a cell. More...
 
boolean onClick (in sbIMediaItem aItem, [optional] in nsISupports aEvent, [optional] in nsISupports aContext)
 Callback for a click event for special handling. More...
 
AString getValueForClick (in AString aCurrentValue, in unsigned long aBoxWidth, in unsigned long aBoxHeight, in unsigned long aMouseX, in unsigned long aMouseY)
 Convert a mouse click to a value for this property. More...
 

Public Attributes

attribute boolean suppressSelect
 

Detailed Description

The property information specific to clickable properties.

A property that implements this interface indicates that it can convert a mouse click into a value for the property.

See Also
sbIPropertyInfo

Definition at line 49 of file sbIClickablePropertyInfo.idl.

Member Function Documentation

AString sbIClickablePropertyInfo::getValueForClick ( in AString  aCurrentValue,
in unsigned long  aBoxWidth,
in unsigned long  aBoxHeight,
in unsigned long  aMouseX,
in unsigned long  aMouseY 
)

Convert a mouse click to a value for this property.

Parameters
aCurrentValueThe current value of this property
aBoxWidthWidth of the clickable area
aBoxHeightHeight of the clickable area
aMouseXThe X coordinate of the click location
aMouseYThe Y coordinate of the click location
Returns
The value that should be given to this property for the click
boolean sbIClickablePropertyInfo::hitTest ( in AString  aCurrentValue,
in AString  aPart,
in unsigned long  aBoxWidth,
in unsigned long  aBoxHeight,
in unsigned long  aMouseX,
in unsigned long  aMouseY 
)

Hit testing for a cell.

Parameters
aCurrentValuethe property value of the item (row) clicked on
aPartthe pseudoelement being hit
aBoxWidththe total box object width of the cell
aBoxHeightthe total box object height of the cell
aMouseXthe X coordinate of the mouse, relative to the left edge of the box object
aMouseYthe Y coordinate of the mouse, relative to the top edge of the box object
Returns
true if the click should be registered
See Also
nsITreeBoxObject::getCellAt() for pseudoelement part names
boolean sbIClickablePropertyInfo::isDisabled ( in AString  aCurrentValue)

Whether the tree cell widget representing this property should be disabled given a value (for this property)

Parameters
aCurrentValuethe property value of an item
Returns
true if the cell should be disabled
boolean sbIClickablePropertyInfo::onClick ( in sbIMediaItem  aItem,
[optional] in nsISupports  aEvent,
[optional] in nsISupports  aContext 
)

Callback for a click event for special handling.

Parameters
aItemthe media item being clicked on
aEventthe DOM click event
aContexta context for the click; most likely a playlist widget
Returns
True if the event has been handled and should be suppressed

Member Data Documentation

attribute boolean sbIClickablePropertyInfo::suppressSelect

Whether tree row selection should be suppressed for clicks on tree cells representing this property

Definition at line 55 of file sbIClickablePropertyInfo.idl.


The documentation for this interface was generated from the following file: