Name

---

      CATCONTROLPANEL

Purpose

---

      The purpose of this routine is to implement a control panel as an object. It
      automatically deals with whether the CP is embedded or standalone and adds
      OK, APPLY and CANCEL buttons if required. Control panels are most often
      represented by propertysheet widgets, but don't have to be. Our original
      notion was that every object in the Catalyst system could have its own control
      panel to allow the user to manipulate the properties of that object. See the
      ControlPanel method of the IMGAXES object as an example of how to create control
      panels for objects.
      Objects can (and should) customise the control panel by adding other widget
      objects. Note that the events for these will be passed to the caller object
      event handler.

Authors

---

        FANNING SOFTWARE CONSULTING BURRIDGE COMPUTING
        1645 Sheely Drive 18 The Green South
        Fort Collins Warborough, Oxon
        CO 80526 USA OX10 7DN, ENGLAND
        Phone: 970-221-0438 Phone: +44 (0)1865 858279
        E-mail: davidf@dfanning.com E-mail: davidb@burridgecomputing.co.uk

Category

---

      Object widgets.

Syntax

---

      aCatControlPanel = Obj_New("CatControlPanel", callerObject)

Superclasses

---

      WIDGETATOM
      CATATOM
      IDL_CONTAINER

Class Structure

---

  class = { CatControlPanel, $
            _caller : OBJ_NEW (), $ ; The object that calls the Control Panel.
            _tlb : OBJ_NEW (), $ ; The pseudo-TLB of the Control Panel widgets.
            _event_destination: OBJ_NEW(), $ ; The object that will receive events.
            INHERITS BaseWidget $
            }

Modification History

---

      Written by: David Burridge, 19th August 2002.