query
PW_LOOSE_STATUS
Get the current status of the loose item. The status can be either PW_STATUS_AVAILABLE, PW_STATUS_UNAVAILABLE or PW_STATUS_SELECTED.
PW_LOOSE_TEXT
Get a pointer to the text which is displayed inside the loose item. This text is read only !
change
PW_LOOSE_STATUS
Set the current status of the loose item. The parameter can be either PW_STATUS_AVAILABLE, PW_STATUS_UNAVAILABLE or PW_STATUS_SELECTED. If the new status if different from the old, then the item will be redrawn when control is handed back to ProWesS. By default, an item is PW_STATUS_AVAILABLE.
PW_LOOSE_TEXT
Set the text which should be displayed inside the loose item. The parameter is of type "char *". The pointer is copied by the object, so the memory which contains the text should be retained ! When autosize is true, then the size of the loose item will be redetermined when control is handed back to ProWesS.
PW_LOOSE_TEXT_COPY
Set the text which should be displayed inside the loose item. The parameter is of type "char *". The text is copied into a piece of memory which is allocated (and released) by the loose items itself. When autosize is true, then the size of the loose item will be redetermined when control is handed back to ProWesS.
PW_LOOSE_CHANGE_STATUS
The parameter is either TRUE or FALSE. By default, the value is TRUE. The status of the loose item is only changed when change status is TRUE. In this case a PW_EVENT_HIT will switch between PW_STATUS_AVAILABLE and PW_STATUS_SELECTED. In the case of a PW_EVENT_DO, the status will change to PW_STATUS_SELECTED. When the loose item is PW_STATUS_UNAVAILABLE, the status is not changed automatically (actually, not even a border will be drawn around the item).
PW_LOOSE_WINDOW_DO
The parameter is either TRUE or FALSE. By default it is FALSE. When the window do status is TRUE, then the keypress is also handled by the system (thus a keypress object can react to it).
PW_LOOSE_CENTER_ITEM
The parameter is either TRUE or FALSE. By default, the value is TRUE. If the value is TRUE, then the text will be draw at the centre of the loose item, else it is draw at the top left corner.
PW_LOOSE_AUTOSIZE
The parameter is either TRUE or FALSE. By default, the value is TRUE. When autosize is TRUE, then the size of the loose item will automatically be redetermined when the text inside the item is changed. If autosize is FALSE and no size is set explicitly, then the size of the text at the time when the window is first activated is used.
PW_LOOSE_ACTION_HIT
Set the routine which should be called when the loose item reacts to a PW_EVENT_HIT. The parameter should be of type "Error (*)(PWObject object)".
PW_LOOSE_ACTION_DO
Set the routine which should be called when the loose item reacts to a PW_EVENT_HIT. The parameter should be of type "Error (*)(PWObject object)". If no do action exists for the loose item (or it is NULL), the hit action will be called.
PW_LOOSE_ACTION_DRAW
Set a draw action for the loose item, the parameter is of type "Error (*)(PWObject object, Gstate gstate, pt xsiz, pt ysiz)". As usual the SubWindow is set to cover the hit area of the loose item. The text will already be drawn. This makes it possible (in combination with the tags to set the size) to draw icons in loose items.
PW_LOOSE_SIZE
Set the minimum width and height of the loose item. The tag needs two parameters, the x and y size, both in PROforma coordinates (pt). Setting the size automatically also sets autosize to FALSE.
PW_LOOSE_XSIZE
Set the minimum width of the loose item. The tag needs a PROforma point as parameter. Setting the size automatically also sets autosize to FALSE.
PW_LOOSE_YSIZE
Set the minimum height of the loose item. The tag needs a PROforma point as parameter. Setting the size automatically also sets autosize to FALSE.
PW_LOOSE_KEYPRESS
Attach a keypress with the loose-item. The pressing of the key will be equivalent with a PW_EVENT_HIT on the item. The parameter is the primary keypress, which is of type "char". When a keypress is assigned to a loose item, than that character will be underlined in the text. When possible, the character with the same case is underlined, or otherwise a character with differing case.
PW_LOOSE_AUTOREPEAT
When tag tah has been passed to the object, then autorepeat will be activated on the HIT and DO as well. This tag does not have a parameter.
PW_LOOSE_OFFSET
This tag allows you to define an offset for the display of the text in the loose item. It is only valid when the text is not centered. The default is to leave one pixel at the left. This tag requires two parameters, the offset from the left, and the offset from the top. The parameters are in PROforma points (device independent).
PW_LOOSE_OFFSET_PIX
This tag allows you to define an offset for the display of the text in the loose item. It is only valid when the text is not centered. The default is to leave one pixel at the left. This tag requires two parameters, the offset from the left, and the offset from the top. The parameters are in pixels (integer).

PROGS, Professional & Graphical Software
last edited May 7, 1997