XPWidgetPropertyID
Properties are values attached to instances of your widgets. A property is identified by a 32-bit ID and its value is the width of a pointer.
Each widget instance may have a property or not have it. When you set a property on a widget for the first time, the property is added to the widget; it then stays there for the life of the widget.
Some property IDs are predefined by the widget package; you can make up your own property IDs as well.
Name | Value | Description |
---|---|---|
xpProperty_Refcon | "0" | A window's refcon is an opaque value used by client code to find other data based on it. |
xpProperty_Dragging | "1" | These properties are used by the utilities to implement dragging. |
xpProperty_DragXOff | "2" | |
xpProperty_DragYOff | "3" | |
xpProperty_Hilited | "4" | Is the widget highlighted? (For widgets that support this kind of thing.) |
xpProperty_Object | "5" | Is there a C++ object attached to this widget? |
xpProperty_Clip | "6" | If this property is 1, the widget package will use OpenGL to restrict drawing to the Widget's exposed rectangle. |
xpProperty_Enabled | "7" | Is this widget enabled (for those that have a disabled state too)? |
xpProperty_UserStart | "10000" |
NOTE: Property IDs 1 - 999 are reserved for the widgets library.
NOTE: Property IDs 1000 - 9999 are allocated to the standard widget classes provided with the library. Properties 1000 - 1099 are for widget class 0, 1100 - 1199 for widget class 1, etc. |