636e3e2278
apps/graphics/twm4nx: Revise logic to detect clicks on the background image. The original implementation had some side effects.
apps/graphics/twm4nx: Remove some remaining, unused stuff from TWM that was never used. Menus need to close after the 'terminal' selection is made. Otherwise, the menu can become buried under a newly open menu and not easily recovered.
apps/graphics/twm4ndx: Add a 'critical' bit to the eventID. While resizing, all events will be ignore except those marked critical.
apps/graphics/twm4nx: CBackground now brings up the main menu if the background image is click. This makes the behavior the same across all of the background except when an icon is clicked.
299 lines
11 KiB
C++
299 lines
11 KiB
C++
/////////////////////////////////////////////////////////////////////////////
|
|
// apps/include/graphics/twm4nx/cresize.hxx
|
|
// Resize function externs
|
|
//
|
|
// Copyright (C) 2019 Gregory Nutt. All rights reserved.
|
|
// Author: Gregory Nutt <gnutt@nuttx.org>
|
|
//
|
|
// Largely an original work but derives from TWM 1.0.10 in many ways:
|
|
//
|
|
// Copyright 1989,1998 The Open Group
|
|
// Copyright 1988 by Evans & Sutherland Computer Corporation,
|
|
//
|
|
// Please refer to apps/twm4nx/COPYING for detailed copyright information.
|
|
// Although not listed as a copyright holder, thanks and recognition need
|
|
// to go to Tom LaStrange, the original author of TWM.
|
|
//
|
|
// 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_CRESIZE_HXX
|
|
#define __APPS_INCLUDE_GRAPHICS_TWM4NX_CRESIZE_HXX
|
|
|
|
/////////////////////////////////////////////////////////////////////////////
|
|
// Included Files
|
|
/////////////////////////////////////////////////////////////////////////////
|
|
|
|
#include <nuttx/config.h>
|
|
|
|
#include <nuttx/nx/nxglib.h>
|
|
|
|
#include "graphics/twm4nx/ctwm4nxevent.hxx"
|
|
#include "graphics/twm4nx/cwindowevent.hxx"
|
|
|
|
/////////////////////////////////////////////////////////////////////////////
|
|
// Implementation Classes
|
|
/////////////////////////////////////////////////////////////////////////////
|
|
|
|
namespace NXWidgets
|
|
{
|
|
class CNxTkWindow; // Forward reference
|
|
class CLabel; // Forward reference
|
|
}
|
|
|
|
namespace Twm4Nx
|
|
{
|
|
class CWindow; // Forward reference
|
|
struct SEventMsg; // Forward reference
|
|
|
|
// The CResize class is, logically, a part of CWindow. It is brought out
|
|
// separately only to minimize the complexity of CWindows (and because it
|
|
// matches the original partitioning of TWM). The downside is that (1) CWindow
|
|
// instances have to be passed un-necessarily, and (2) the precludes the
|
|
// possibility of resizing two window simultaneous. That latter is not
|
|
// currently supported anyway.
|
|
|
|
class CResize : protected NXWidgets::CWidgetEventHandler,
|
|
protected IEventTap,
|
|
public CTwm4NxEvent
|
|
{
|
|
private:
|
|
|
|
CTwm4Nx *m_twm4nx; /**< Cached Twm4Nx session */
|
|
mqd_t m_eventq; /**< NxWidget event message queue */
|
|
FAR NXWidgets::CNxTkWindow *m_sizeWindow; /**< The resize dimensions window */
|
|
FAR NXWidgets::CLabel *m_sizeLabel; /**< Resize dimension label */
|
|
FAR CWindow *m_resizeWindow; /**< The window being resized */
|
|
FAR IEventTap *m_savedTap; /**< Saved IEventTap */
|
|
uintptr_t m_savedTapArg; /**< Saved IEventTap argument */
|
|
struct nxgl_point_s m_lastPos; /**< Last window position */
|
|
struct nxgl_size_s m_lastSize; /**< Last window size */
|
|
struct nxgl_point_s m_mousePos; /**< Last mouse position */
|
|
bool m_resizing; /**< Resize in progress */
|
|
bool m_resized; /**< The size has changed */
|
|
bool m_mouseValid; /**< True: m_mousePos is valid */
|
|
volatile bool m_paused; /**< The window was un-clicked */
|
|
|
|
/**
|
|
* Create the size window
|
|
*/
|
|
|
|
bool createSizeWindow(void);
|
|
|
|
/**
|
|
* Create the size label widget
|
|
*/
|
|
|
|
bool createSizeLabel(void);
|
|
|
|
/**
|
|
* Set the Window Size
|
|
*/
|
|
|
|
bool setWindowSize(FAR struct nxgl_size_s *size);
|
|
|
|
/**
|
|
* Update the size show in the size dimension label.
|
|
*
|
|
* @param size The size of the rubber band
|
|
*/
|
|
|
|
void updateSizeLabel(FAR struct nxgl_size_s &size);
|
|
|
|
/**
|
|
* This function handles the EVENT_RESIZE_BUTTON event. It will start a
|
|
* new resize sequence. This occurs the first time that the toolbar
|
|
* resize icon is clicked.
|
|
*
|
|
* @param msg. The received NxWidget RESIZE event message.
|
|
* @return True if the message was properly handled. false is
|
|
* return on any failure.
|
|
*/
|
|
|
|
bool startResize(FAR struct SEventMsg *eventmsg);
|
|
|
|
/**
|
|
* This function handles the EVENT_RESIZE_MOVE event. It will update
|
|
* the resize information based on the new mouse position.
|
|
*
|
|
* @param msg. The received NxWidget RESIZE event message.
|
|
* @return True if the message was properly handled. false is
|
|
* return on any failure.
|
|
*/
|
|
|
|
bool updateSize(FAR struct SEventMsg *eventmsg);
|
|
|
|
/**
|
|
* This function handles the EVENT_RESIZE_PAUSE event. This occurs
|
|
* when the window is un-clicked. Another click in the window
|
|
* will resume the resize operation.
|
|
*
|
|
* @param msg. The received NxWidget RESIZE event message.
|
|
* @return True if the message was properly handled. false is
|
|
* return on any failure.
|
|
*/
|
|
|
|
bool pauseResize(FAR struct SEventMsg *eventmsg);
|
|
|
|
/**
|
|
* This function handles the EVENT_RESIZE_RESUME event. This occurs
|
|
* when the window is clicked while paused.
|
|
*
|
|
* @param msg. The received NxWidget RESIZE event message.
|
|
* @return True if the message was properly handled. false is
|
|
* return on any failure.
|
|
*/
|
|
|
|
bool resumeResize(FAR struct SEventMsg *eventmsg);
|
|
|
|
/**
|
|
* This function handles the EVENT_RESIZE_STOP event. It will
|
|
* terminate a resize sequence. This occurs when the resize button
|
|
* is pressed a second time.
|
|
*
|
|
* @param msg. The received NxWidget RESIZE event message.
|
|
* @return True if the message was properly handled. false is
|
|
* return on any failure.
|
|
*/
|
|
|
|
bool endResize(FAR struct SEventMsg *eventmsg);
|
|
|
|
/**
|
|
* This function is called when there is any movement of the mouse or
|
|
* touch position that would indicate that the object is being moved.
|
|
*
|
|
* This function overrides the virtual IEventTap::moveEvent method.
|
|
*
|
|
* @param pos The current mouse/touch X/Y position.
|
|
* @param arg The user-argument provided that accompanies the callback
|
|
* @return True: if the movement event was processed; false it was
|
|
* ignored. The event should be ignored if there is not actually
|
|
* a movement event in progress
|
|
*/
|
|
|
|
bool moveEvent(FAR const struct nxgl_point_s &pos,
|
|
uintptr_t arg);
|
|
|
|
/**
|
|
* This function is called if the mouse left button is released or
|
|
* if the touchscrreen touch is lost. This indicates that the
|
|
* resize sequence is complete.
|
|
*
|
|
* This function overrides the virtual IEventTap::dropEvent method.
|
|
*
|
|
* @param pos The last mouse/touch X/Y position.
|
|
* @param arg The user-argument provided that accompanies the callback
|
|
* @return True: if the drop event was processed; false it was
|
|
* ignored. The event should be ignored if there is not actually
|
|
* a resize event in progress
|
|
*/
|
|
|
|
bool dropEvent(FAR const struct nxgl_point_s &pos,
|
|
uintptr_t arg);
|
|
|
|
/**
|
|
* Is the tap enabled?
|
|
*
|
|
* @param arg The user-argument provided that accompanies the callback
|
|
* @return True: If the the tap is enabled.
|
|
*/
|
|
|
|
inline bool isActive(uintptr_t arg)
|
|
{
|
|
return (!m_paused && m_resizing);
|
|
}
|
|
|
|
/**
|
|
* Enable/disable the resizing. The disable event will cause resizing
|
|
* to be paused.
|
|
*
|
|
* True is provided when (1) isActive() returns false, but (2) a mouse
|
|
* report with a left-click is received.
|
|
* False is provided when (1) isActive() returns true, but (2) a mouse
|
|
* report without a left-click is received.
|
|
*
|
|
* In the latter is redundant since dropEvent() will be called immediately
|
|
* afterward.
|
|
*
|
|
* @param pos. The mouse position at the time of the click or release
|
|
* @param enable. True: Enable movement
|
|
* @param arg The user-argument provided that accompanies the callback
|
|
*/
|
|
|
|
void enableMovement(FAR const struct nxgl_point_s &pos,
|
|
bool enable, uintptr_t arg);
|
|
|
|
public:
|
|
|
|
/**
|
|
* CResize Constructor
|
|
*
|
|
* @param twm4nx The Twm4Nx session
|
|
*/
|
|
|
|
CResize(CTwm4Nx *twm4nx);
|
|
|
|
/**
|
|
* CResize Destructor
|
|
*/
|
|
|
|
~CResize(void);
|
|
|
|
/**
|
|
* @return True if resize is in-progress
|
|
*/
|
|
|
|
inline bool resizing(void)
|
|
{
|
|
return m_resizing;
|
|
}
|
|
|
|
/**
|
|
* CResize Initializer. Performs the parts of the CResize construction
|
|
* that may fail.
|
|
*
|
|
* @result True is returned on success
|
|
*/
|
|
|
|
bool initialize(void);
|
|
|
|
/**
|
|
* Handle RESIZE events.
|
|
*
|
|
* @param msg. The received NxWidget RESIZE event message.
|
|
* @return True if the message was properly handled. false is
|
|
* return on any failure.
|
|
*/
|
|
|
|
bool event(FAR struct SEventMsg *msg);
|
|
};
|
|
}
|
|
|
|
#endif // __APPS_INCLUDE_GRAPHICS_TWM4NX_CRESIZE_HXX
|