/////////////////////////////////////////////////////////////////////////////
// apps/graphics/twm4nx/include/twm4nx_widgetevents.hxx
// Twm4Nx Widget Event Handling
//
//   Copyright (C) 2019 Gregory Nutt. All rights reserved.
//   Author: Gregory Nutt <gnutt@nuttx.org>
//
// Redistribution and use in source and binary forms, with or without
// modification, are permitted provided that the following conditions
// are met:
//
// 1. Redistributions of source code must retain the above copyright
//    notice, this list of conditions and the following disclaimer.
// 2. Redistributions in binary form must reproduce the above copyright
//    notice, this list of conditions and the following disclaimer in
//    the documentation and/or other materials provided with the
//    distribution.
// 3. Neither the name NuttX nor the names of its contributors may be
//    used to endorse or promote products derived from this software
//    without specific prior written permission.
//
// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
// FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
// COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
// INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
// BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
// OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
// AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
// LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
// ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
// POSSIBILITY OF SUCH DAMAGE.
//
/////////////////////////////////////////////////////////////////////////////

#ifndef __APPS_INCLUDE_GRAPHICS_TWM4NX_TWM4NX_WIDGETEVENTS_HXX
#define __APPS_INCLUDE_GRAPHICS_TWM4NX_TWM4NX_WIDGETEVENTS_HXX

/////////////////////////////////////////////////////////////////////////////
// Included Files
/////////////////////////////////////////////////////////////////////////////

#include <nuttx/config.h>

#include <cstdint>
#include <cstdbool>

#include <nuttx/nx/nxglib.h>
#include "graphics/nxwidgets/cwindoweventhandler.hxx"

/////////////////////////////////////////////////////////////////////////////
// Preprocessor Definitions
/////////////////////////////////////////////////////////////////////////////

#define MAX_EVENT_PAYLOAD (64 - sizeof(uint16_t))

/////////////////////////////////////////////////////////////////////////////
// WidgetEvent
/////////////////////////////////////////////////////////////////////////////

namespace NXWidgets
{
  class CNxTkWindow;  // Forward reference
}

namespace Twm4Nx
{
  class CWindow;      // Forward reference
  class CWindowEvent; // Forward reference
  class CTwm4NxEvent;  // Forward reference
  class CTwm4Nx;      // Forward reference

  ///////////////////////////////////////////////////////////////////////////
  // Public Types
  ///////////////////////////////////////////////////////////////////////////

  /**
   * This enumeration identifies the recipient of the event
   */

  enum EEventRecipient
  {
    EVENT_RECIPIENT_MSG        = 0x0000,  /**< Twm4Nx messenging event */
    EVENT_RECIPIENT_SYSTEM     = 0x1000,  /**< Twm4Nx system event */
    EVENT_RECIPIENT_ICONWIDGET = 0x2000,  /**< Icon Widget event */
    EVENT_RECIPIENT_ICONMGR    = 0x3000,  /**< Icon Manager event */
    EVENT_RECIPIENT_MENU       = 0x4000,  /**< Menu related event */
    EVENT_RECIPIENT_WINDOW     = 0x5000,  /**< Window related event */
    EVENT_RECIPIENT_TOOLBAR    = 0x6000,  /**< Toolbar related event */
    EVENT_RECIPIENT_BORDER     = 0x7000,  /**< Window border related event */
    EVENT_RECIPIENT_RESIZE     = 0x8000,  /**< Window resize event */
    EVENT_RECIPIENT_APP        = 0x9000,  /**< App received event via CTwn4NxEvent */
    EVENT_RECIPIENT_MASK       = 0xf000,  /**< Used to isolate recipient */
  };

 /**
  * Specific events include the recipient as part of the event ID encoding.
  */

  enum EEventID
  {
    // Recipient == MSG

    EVENT_MSG_POLL             = 0x0000,  /**< Poll widgets for events */

    // Recipient == SYSTEM

    EVENT_SYSTEM_NOP           = 0x1000,  /**< Null event */
    EVENT_SYSTEM_ERROR         = 0x1001,  /**< Report system error */
    EVENT_SYSTEM_EXIT          = 0x1002,  /**< Terminate the Twm4Nx session */

    // Recipient == ICONWIDGET

    EVENT_ICONWIDGET_GRAB      = 0x2000,  /**< Click on toolbar title */
    EVENT_ICONWIDGET_DRAG      = 0x2001,  /**< Drag window */
    EVENT_ICONWIDGET_UNGRAB    = 0x2002,  /**< Release click on toolbar */

    // Recipient == ICONMGR

    // Recipient == MENU

    EVENT_MENU_IDENTIFY        = 0x4001,  /**< Describe the window */
    EVENT_MENU_VERSION         = 0x4002,  /**< Show the Twm4Nx version */
    EVENT_MENU_ICONIFY         = 0x4003,  /**< Tool bar minimize button pressed */
    EVENT_MENU_DEICONIFY       = 0x4004,  /**< Window icon pressed */
    EVENT_MENU_FUNCTION        = 0x4005,  /**< Perform function on unknown menu */
    EVENT_MENU_TITLE           = 0x4006,  /**< REVISIT: Really an action not an event */
    EVENT_MENU_ROOT            = 0x4007,  /**< REVISIT: Popup root menu */

    // Recipient == WINDOW

    EVENT_WINDOW_FOCUS         = 0x5000,  /**< Enter modal state */
    EVENT_WINDOW_UNFOCUS       = 0x5001,  /**< Exit modal state */
    EVENT_WINDOW_RAISE         = 0x5002,  /**< Raise window to the top of the heirarchy */
    EVENT_WINDOW_LOWER         = 0x5003,  /**< Lower window to the bottom of the heirarchy */
    EVENT_WINDOW_DEICONIFY     = 0x5004,  /**< De-iconify and raise window  */
    EVENT_WINDOW_DRAG          = 0x5005,  /**< Drag window */
    EVENT_WINDOW_DELETE        = 0x5006,  /**< Delete window */

    // Recipient == TOOLBAR

    EVENT_TOOLBAR_GRAB         = 0x6000,  /**< Click on title widget */
    EVENT_TOOLBAR_UNGRAB       = 0x6001,  /**< Release click on title widget */
    EVENT_TOOLBAR_MENU         = 0x6002,  /**< Toolbar menu button released */
    EVENT_TOOLBAR_MINIMIZE     = 0x6003,  /**< Toolbar minimize button released */
    EVENT_TOOLBAR_RESIZE       = 0x6004,  /**< Toolbar resize button released */
    EVENT_TOOLBAR_TERMINATE    = 0x6005,  /**< Toolbar delete button released */

    // Recipient == BORDER

    // Recipient == RESIZE

    EVENT_RESIZE_START         = 0x8000,  /**< Start window resize */
    EVENT_RESIZE_VERTZOOM      = 0x8001,  /**< Zoom vertically only */
    EVENT_RESIZE_HORIZOOM      = 0x8002,  /**< Zoom horizontally only */
    EVENT_RESIZE_FULLZOOM      = 0x8003,  /**< Zoom both vertically and horizontally */
    EVENT_RESIZE_LEFTZOOM      = 0x8004,  /**< Zoom left only */
    EVENT_RESIZE_RIGHTZOOM     = 0x8005,  /**< Zoom right only */
    EVENT_RESIZE_TOPZOOM       = 0x8006,  /**< Zoom top only */
    EVENT_RESIZE_BOTTOMZOOM    = 0x8007,  /**< Zoom bottom only */

    // Recipient == APP
    // All application defined events must (1) use recepient == EVENT_RECIPIENT_APP,
    // and (2) provide an instance of CTwm4NxEvent in the SEventMsg structure.

  };

  // Contexts for button press events

  enum EButtonContext
  {
    EVENT_CONTEXT_WINDOW = 0,
    EVENT_CONTEXT_TOOLBAR,
    EVENT_CONTEXT_ICON,
    EVENT_CONTEXT_FRAME,
    EVENT_CONTEXT_ICONMGR,
    EVENT_CONTEXT_NAME,
    EVENT_CONTEXT_IDENTIFY,
    NUM_CONTEXTS
  };

  /**
   * This type represents a generic message containing all possible,
   * message-specific options (wasteful, but a lot easier).
   */

  struct SEventMsg
  {
    uint16_t eventID;                   /**< Encoded event ID */
    struct nxgl_point_s pos;            /**< X/Y position */
    struct nxgl_point_s delta;          /**< X/Y change (for dragging only) */
    uint8_t context;                    /**< Button press context */
    FAR CTwm4NxEvent *handler;          /**< App event handler (APP recipient only) */
    FAR void *obj;                      /**< Window object (CWindow or CIconWidget) */
  };

  /**
   * This is the alternative form of the message used on in
   * CWindowEvent::event()
   */

  struct SNxEventMsg
  {
    uint16_t eventID;                  /**< Encoded event ID */
    FAR CWindowEvent *instance;        /**< X/Y position */
    FAR struct SWindow *win;           /**< Twm4NX window reference */
  };
}

#endif // __APPS_INCLUDE_GRAPHICS_TWM4NX_TWM4NX_WIDGETEVENTS_HXX