You may return to the Cvo Object Documenation Index from this document. This document contains the following sections describing the Cvo_Iwin object:

Class

Cvo_Iwin

Base

Cvo_Window

Syntax

#include <Cvo/Iwin.h++>

new Cvo_Iwin ( char *resource_name,
{ Cvo_Object *parent | Display *display } )

Overview

A Cvo_Iwin object provides a canvas on which to display icons. Once the icons have been placed, they may be selected as well as dragged. When dragged, they may either be dropped on the Cvo_Iwin window, in which case they will be moved there, or they may be dropped outside the window, in which case the application should generate a drop event for that location.

Member Functions

This object defines the following member functions in addition to those defined by its parent and ancestor objects.

A Cvo_Iwin can generate the following events: CvoIwinPrimaryEvent CvoIwinSecondaryEvent By default, these events are generated by double clicking on an icon. Buttons 1 and 2 are registered as generating a CvoIwinPrimaryEvent and Button 3 generates a CvoIwinSecondaryEvent. The following elements are provided: Cvo_IwinItem *item; The icon which was selected. void *client_data; The client data associated with the icon at AddIcon time. Cvo_IwinDropEvent This event is generated when icons are dragged and dropped outside of the icon window. The following elements are provided: short count; The number of icons being dropped. Cvo_IwinItem **selections; The array of icons being dropped. int refx; int refy; The <x,y> location of the originating button press within the icon. int offx; int offy; The <x,y> location of the button release on the root window. Time time; The time of button release.

See the legend for information about the conventions used in this documentation.