This command reference lists the commands you can use to to drag a coolTip around on your web page. The original reason this plugin was introduced was to permit moving the coolTip away from obscurring FORM elements on a web page. However, with newer browsers this problem has largely gone away so this plugin isn't needed as often.

Remember that commands are always in uppercase (case-sensitive) and can have none or up to two parameter values.

To include this support module just include the following statements in the HEAD section of your document:

<SCRIPT TYPE="text/javascript" SRC="cCore.js"></SCRIPT>
<SCRIPT TYPE="text/javascript" SRC="cDraggable.js"></SCRIPT>

You only have to make sure that the cDraggable.js module is loaded after the core module.

Download this module as a zip file.

DRAGCAP example (see the next command's example)

This command only applies to a STICKY popup and when used on the command line, it switches the state of the associated default variable to its opposite state. The "grab" region is the CAPTION region of the popup, including the region occupied by the "Close" link, and the extra key(s) required by the DRAGGABLE command (i.e., ALT and/or CTRL) is not required; dragging is initiated by pressing and holding the left mouse button. While being dragged, the cursor changes to the 'move' cursor. Its default value is off (0). When this command is used, it is not necessary to also include the DRAGGABLE command because DRAGCAP automatically sets the draggable parameter on. Note, for this command to work, the Anchor plugin must also be loaded.

DRAGGABLE example

This command only applies to a STICKY popup and when used on the command line, it switches the state of the associated default variable to its opposite state. It indicates that this coolTip can be dragged and while it is being dragged, the cursor becomes the 'move' cursor except in the Netscape 4.x browser which doesn't allow the cursor to be changed. (There are also some problems in the final release of the Opera v7+ browser in displaying the 'move' cursor.) Default value is not to enable dragging (0). This command can not be applied to a CROSS FRAME STICKY. If it is, then this option will be disabled. A STICKY coolTip can only be dragged if it is in the same frame or window which contains the coolTip code. Dragging is initiated in IE by holding the ALT key (Windows), or the CMND-OPTION key (on Macintosh) and the left mouse button simultaneously. For the Opera browser, dragging is initiated by holding the CTRL key and the left mouse button.
Variable: cd_draggable

ALTCUT toggle DRAG key action

The normal way to drag a popup on the page is to press the ALT key (OPTION on a Mac) and hold down the left mouse button. This key combination enables one to select text within the popup for cutting and pasting in the normal way. However, this can be reversed by using the ALTCUT command on the command line, which will switch the current state of the associated default variable to its opposite state. Default value is off (0). Apparently there was a bug in the Opera v7 browser, since corrected in v8+, such that the event.altKey, which should indicate whether this key is being pressed during the event, always returns a false whether it is pressed or not. (This new capability has not yet been incorporated into the code). To compensate for this, the activating key has been changed to the CTRL key in this browser which is working correctly. However, in the final release, the cursor is not changing consistently to the 'move' cursor, although the popup can still be dragged.
Variable: cd_altcut

DRAGIMG name  example two

Allows the image whose name is given by this command's parameter value to be the drag point for moving the coolTip around on the screen. This command assigns the parameter value to the CAPICON image's name and id attributes. Default value is the null string (''). For this parameter to work, the Anchor plugin must also be loaded. If it isn't, then dragging works normally. There is no warning of this. Once dragging has been engaged, the user may release the activating key (ALT or CTRL) and continue dragging by just holding down the left mouse button (on a PC). Although this feature is working reasonably well, it should be considered experimental and subject to change. Note: the image doesn't have to be in the caption region of the popup. It can also be in the main body text, as demonstrated by example two, but here you are responsible for making sure that the name is the same as that specified by DRAGIMG as well as any other formatting that you want to provide. If that is the case, then that body image takes priority over the CAPICON image as the drag point in moving the coolTip around on the screen. If you want to use the CAPICON image for dragging then just eliminate the name attribute on the body text images. WARNING: Dragging a coolTip by an image doesn't work very reliably in Opera 7+. To get it to start moving, one must select a point on the image that is in the lower-right quadrant of the image, and the cursor must be moved very slowly.
Variable: cd_dragimg

HIDECONTENT example (similar to the first example with this command included)

This command will cause the body content of a coolTip to be hidden while dragging is underway. It is a toggle-like command which switches the state of the associated default variable to its opposite state. The default value is off (i.e., body content remains visible while dragging is underway). This command is meant to be used with coolTips that contain complicated body HTML markup so that dragging may be done faster.
Variable: cd_hidecontent