/**************************************************************************** * apps/include/graphics/nxwm/chexcalculator.hxx * * Licensed to the Apache Software Foundation (ASF) under one or more * contributor license agreements. See the NOTICE file distributed with * this work for additional information regarding copyright ownership. The * ASF licenses this file to you under the Apache License, Version 2.0 (the * "License"); you may not use this file except in compliance with the * License. You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the * License for the specific language governing permissions and limitations * under the License. * ****************************************************************************/ #ifndef __APPS_INCLUDE_GRAPHICS_NXWM_CHEXCALCULATOR_HXX #define __APPS_INCLUDE_GRAPHICS_NXWM_CHEXCALCULATOR_HXX /**************************************************************************** * Included Files ****************************************************************************/ #include #include #include #include "graphics/nxwidgets/cbuttonarray.hxx" #include "graphics/nxwidgets/clabel.hxx" #include "graphics/nxwidgets/cnxfont.hxx" #include "graphics/nxwm/iapplication.hxx" #include "graphics/nxwm/capplicationwindow.hxx" #include "graphics/nxwm/ctaskbar.hxx" /**************************************************************************** * Pre-Processor Definitions ****************************************************************************/ #define NXWM_HEXCALCULATOR_NROWS 6 #define NXWM_HEXCALCULATOR_NCOLUMNS 6 /**************************************************************************** * Implementation Classes ****************************************************************************/ #if defined(__cplusplus) namespace NxWM { /** * This class implements the Hex calculator application. */ class CHexCalculator : public IApplication, private IApplicationCallback, private NXWidgets::CWidgetEventHandler { private: /** * The structure defines a pending operation. */ struct SPendingOperation { int64_t value; /**< Accumulated value */ uint8_t operation; /**< Identifies the operations */ }; /** * Calculator state data. */ /** * Cached constructor parameters. */ CTaskbar *m_taskbar; /**< Reference to the "parent" taskbar */ CApplicationWindow *m_window; /**< Reference to the application window */ /** * Widgets */ NXWidgets::CButtonArray *m_keypad; /**< The calculator keyboard */ NXWidgets::CLabel *m_text; /**< The accumulator text display */ NXWidgets::CNxFont *m_font; /**< The font used in the calculator */ /** * Calculator geometry. This stuff does not really have to be retained * in memory. If you are pinched for memory, get rid of these. */ struct nxgl_size_s m_windowSize; /**< The size of the calculator window */ struct nxgl_size_s m_keypadSize; /**< The size the calculator keypad */ struct nxgl_size_s m_buttonSize; /**< The size of one calculator button */ struct nxgl_size_s m_textSize; /**< The size of the calculator textbox */ struct nxgl_point_s m_keypadPos; /**< The position the calculator keypad */ struct nxgl_point_s m_textPos; /**< The position of the calculator textbox */ /** * Calculator computational data. Note: Since we do not support * parentheses and support only two levels of operator precedence, it is * not necessary to maintain a stack of operations. Within there * limitations, there can be at most only one pending low prececence * operation and one pending high precedence operation. If you want * to support parentheses or more levels of precedence, they you will * have to extend the design. */ int64_t m_accum; /**< The current accumulated value */ int64_t m_memory; /**< The current value saved in memory */ struct SPendingOperation m_low; /**< Low precedence pending operation */ struct SPendingOperation m_high; /**< High precedence pending operation */ bool m_hexMode; /**< True if in hex mode */ bool m_result ; /**< True if the accumulator holds a previoius result */ /** * Select the geometry of the calculator given the current window size. * Only called as part of construction. */ inline void setGeometry(void); /** * Create the calculator keypad. Only start as part of the application * start method. */ inline bool createCalculator(void); /** * Applies labels to the keys. */ void labelKeypad(void); /** * Evaluate a binary operation. * * @param value1. The first value * @param value2. The second value * * @return The result of the operation */ int64_t evaluateBinaryOperation(uint8_t operation, int64_t value1, int64_t value2); /** * Show the current value of the accumulator. */ void updateText(void); /** * Called when the window minimize button is pressed. */ void minimize(void); /** * Called when the window minimize close is pressed. */ void close(void); /** * Handle a widget action event. For CImage, this is a button pre- * release event. * * @param e The event data. */ void handleActionEvent(const NXWidgets::CWidgetEventArgs &e); public: /** * CHexCalculator constructor * * @param window. The application window * * @param taskbar. A pointer to the parent task bar instance * @param window. The window to be used by this application. */ CHexCalculator(CTaskbar *taskbar, CApplicationWindow *window); /** * CHexCalculator destructor */ ~CHexCalculator(void); /** * Each implementation of IApplication must provide a method to recover * the contained CApplicationWindow instance. */ IApplicationWindow *getWindow(void) const; /** * Get the icon associated with the application * * @return An instance if IBitmap that may be used to rend the * application's icon. This is an new IBitmap instance that must * be deleted by the caller when it is no long needed. */ NXWidgets::IBitmap *getIcon(void); /** * Get the name string associated with the application * * @return A copy if CNxString that contains the name of the application. */ NXWidgets::CNxString getName(void); /** * Start the application (perhaps in the minimized state). * * @return True if the application was successfully started. */ bool run(void); /** * Stop the application. */ void stop(void); /** * Destroy the application and free all of its resources. This method * will initiate blocking of messages from the NX server. The server * will flush the window message queue and reply with the blocked * message. When the block message is received by CWindowMessenger, * it will send the destroy message to the start window task which * will, finally, safely delete the application. */ void destroy(void); /** * The application window is hidden (either it is minimized or it is * maximized, but not at the top of the hierarchy */ void hide(void); /** * Redraw the entire window. The application has been maximized or * otherwise moved to the top of the hierarchy. This method is call from * CTaskbar when the application window must be displayed */ void redraw(void); /** * Report of this is a "normal" window or a full screen window. The * primary purpose of this method is so that window manager will know * whether or not it show draw the task bar. * * @return True if this is a full screen window. */ bool isFullScreen(void) const; }; class CHexCalculatorFactory : public IApplicationFactory { private: CTaskbar *m_taskbar; /**< The taskbar */ public: /** * CHexCalculatorFactory Constructor * * @param taskbar. The taskbar instance used to terminate calibration */ CHexCalculatorFactory(CTaskbar *taskbar); /** * CHexCalculatorFactory Destructor */ inline ~CHexCalculatorFactory(void) { } /** * Create a new instance of an CHexCalculator (as IApplication). */ IApplication *create(void); /** * Get the icon associated with the application * * @return An instance if IBitmap that may be used to rend the * application's icon. This is an new IBitmap instance that must * be deleted by the caller when it is no long needed. */ NXWidgets::IBitmap *getIcon(void); }; } #endif // __cplusplus #endif // __APPS_INCLUDE_GRAPHICS_NXWM_CHEXCALCULATOR_HXX