Component.h

Go to the documentation of this file.

#pragma once
 
#include "Common.h"
#include "UICommon.h"
#include "EventListeners.h"
#include "Graphics.h"
 
class ProcParams
{
public:
    WinHandle hwnd;
    WPARAM wParam;
    LPARAM lParam;
};

class Component
{
    static long NextId;

    long _id;
 
    Component* _parent;

    BOOL _doNotSubclass;

    long _nCommand;

    DataChangeListener* _dataChangeListener;

    SelectionChangeListener* _selectionChangeListener;

    ActionListener* _actionListener;

    RowDoubleClickListener* _rowDoubleClickListener;

    int _mouseWheelDelta;

    BOOL _isPaintQueued;

    BOOL _isCustomFont;

    HFONT _customFont;

    long _fontSize;

    wstring _fontName;

    BOOL _fontIsBold;
    BOOL _fontIsItalic;
    BOOL _fontIsUnderlined;
 
    long _lastResizeX, _lastResizeY, _lastResizeWidth, _lastResizeHeight;
 
    vector<NumberCollection> _scheduledTimers;

    void interceptStandardControlEvents(WinHandle hWndControl);

    BOOL createNativeWindow(Component *parent, Bounds rect, const wstring& title, UINT windowStyles,
                            const wstring& wndClassName = L"", BOOL isCustomWndProc = FALSE,
                            long nCmdId = -1, BOOL isVisible = TRUE);
 
protected:
    WinHandle _hWnd;

    wstring _componentType;
 
    BOOL _showBorder;

    virtual BOOL getCreateWindowOptions(wstring& title, UINT& widownStyles, wstring& wndClassName, BOOL& isCustomWndProc) = 0;

    virtual void windowCreated() = 0;

    long getActionId();

    void doNotSubclass();

    void startTimer(unsigned int timerId, unsigned int milliseconds);

    void stopTimer(unsigned int timerId);
 
public:
    Component();

    virtual ~Component();

    long getId();
 
    void setParent(Component* parent);
    Component* getParent();
    Component* getTopLevelParent();
 
    void bringWindowToTop();

    wstring getComponentType();

    BOOL isWindowCreated();

    WinHandle getWindowHandle();

    int createComponent(Component* parent, Bounds rect, long nCmd = -1, BOOL isVisible = TRUE);
 
    void setFocus();

    void setFont(long fontSize, BOOL isBold = FALSE, BOOL isItalic = FALSE, BOOL isUnderlined = FALSE, const wstring& fontName = L"Arial");
 
    BOOL getCustomFont(long& fontSize, BOOL& isBold, BOOL& isItalic, BOOL& isUnderlined, wstring& fontName);
 
    void showBorder(BOOL bShow = TRUE);

    void setEnabled(BOOL bEnable = TRUE);

    void setVisible(BOOL bShow = TRUE);
 
    void GetClientRect(Bounds& rect);
    void GetWindowRect(Bounds& rect);

    void moveWindow(long x, long y, long width, long height, BOOL bRedraw = TRUE);

    void reconfigureScrollBar();

    void setMouseWheelDelta(int delta);

    int getMouseWheelDelta();

    virtual int getMinimumHeight();

    virtual int getPreferredHeight();

    void repaint(Component* comp = NULL, BOOL repaintImmediately = FALSE); // Must be defaulted to FALSE

    void clearQueuedPaintRequest();
 
    virtual BOOL getChildren(vector<Component*>& children) { return FALSE; };
 
public: // Overridable event handlers

    virtual void onPaint(Graphics *g) {}

    virtual void onWindowResized() {}

    virtual void onWindowMoved() {}

    virtual void onAction(WinHandle hTarget, long actionId, const ProcParams& procParams) {}

    virtual void onSelectionChanged(WinHandle hTarget, int itemIndex, const wstring& itemText, BOOL itemChecked, const ProcParams& procParams) {}

    virtual void onDataChanged(WinHandle hTarget, const wstring& newValue, const ProcParams& procParams) {}
 
//    virtual BOOL onDrawMeasureItem(LPMEASUREITEMSTRUCT dis, const ProcParams& procParams) { return FALSE; }
//    virtual BOOL onDrawItem(LPDRAWITEMSTRUCT dis, const ProcParams& procParams) { return FALSE; }

    virtual void onMousePressed(WinHandle hWnd, int x, int y, int clickCount, BOOL shiftPressed, BOOL ctrlPressed) {}

    virtual void onMouseReleased(WinHandle hWnd, int x, int y, BOOL shiftPressed, BOOL ctrlPressed) {}

    virtual void onMouseRightClicked(WinHandle hWnd, int x, int y, BOOL shiftPressed, BOOL ctrlPressed) {}

    virtual void onMouseMoved(WinHandle hWnd, int x, int y, BOOL shiftPressed, BOOL ctrlPressed) {}

    virtual BOOL onMouseWheel(WinHandle hWnd, int x, int y, int delta) { return FALSE; }
 
    // Keyboard key event handlers (shiftPressed and ctrlPressed indicate modifier key state)
    virtual void onArrowLeft(BOOL shiftPressed, BOOL ctrlPressed) {}
    virtual void onArrowRight(BOOL shiftPressed, BOOL ctrlPressed) {}
    virtual void onArrowUp(BOOL shiftPressed, BOOL ctrlPressed) {}
    virtual void onArrowDown(BOOL shiftPressed, BOOL ctrlPressed) {}
    virtual void onPageUp(BOOL shiftPressed, BOOL ctrlPressed) {}
    virtual void onPageDown(BOOL shiftPressed, BOOL ctrlPressed) {}
    virtual void onKeyHome(BOOL shiftPressed, BOOL ctrlPressed) {}
    virtual void onKeyEnd(BOOL shiftPressed, BOOL ctrlPressed) {}
    virtual void onKeyInsert(BOOL shiftPressed, BOOL ctrlPressed) {}
    virtual void onKeyDelete(BOOL shiftPressed, BOOL ctrlPressed) {}
    virtual void onKeyBackSpace(BOOL shiftPressed, BOOL ctrlPressed) {}
    virtual void onKeyTyped(wchar_t ch, BOOL shiftPressed, BOOL ctrlPressed) {}
    virtual void onKeyTab(BOOL shiftPressed, BOOL ctrlPressed) {}
    virtual void onKeyEnter(BOOL shiftPressed, BOOL ctrlPressed) {}
    virtual void onKeyF1(BOOL shiftPressed, BOOL ctrlPressed) {}
    virtual void onKeyF2(BOOL shiftPressed, BOOL ctrlPressed) {}
    virtual void onKeyF3(BOOL shiftPressed, BOOL ctrlPressed) {}
    virtual void onKeyF4(BOOL shiftPressed, BOOL ctrlPressed) {}
    virtual void onKeyF5(BOOL shiftPressed, BOOL ctrlPressed) {}
    virtual void onKeyF6(BOOL shiftPressed, BOOL ctrlPressed) {}
    virtual void onKeyF7(BOOL shiftPressed, BOOL ctrlPressed) {}
    virtual void onKeyF8(BOOL shiftPressed, BOOL ctrlPressed) {}
    virtual void onKeyF9(BOOL shiftPressed, BOOL ctrlPressed) {}
    virtual void onKeyF10(BOOL shiftPressed, BOOL ctrlPressed) {}
    virtual void onKeyF11(BOOL shiftPressed, BOOL ctrlPressed) {}
    virtual void onKeyF12(BOOL shiftPressed, BOOL ctrlPressed) {}

    virtual void onFocusGained() {}

    virtual void onFocusLost() {}

    virtual void onTimer(unsigned int timerId) {}
 
    // Scrollbar functionality

    virtual BOOL getScrollingInfo(__int64& scrollMin, __int64& scrollMax, __int64& pageSize) { return FALSE; }

    virtual void setScrollbarTopOffset(__int64 firstVisibleRow) {}

    void updateScrollbarTopOffset(__int64 firstVisibleRow);
 
protected: // Listener management

    void protectedAddDataChangedListener(DataChangeListener* l);

    void protectedAddSelectionChangedListener(SelectionChangeListener* l);

    void protectedAddActionListener(ActionListener* l);

    void protectedAddItemDoubleClickedListener(RowDoubleClickListener* l);

    void protectedFireDataChangedEvent(const wstring& oldValue, const wstring& newValue);

    void protectedFireSelectionChangedEvent(long selectionIndex = -1, const wstring& selectionValue = L"", BOOL checked = FALSE);

    void protectedFireActionEvent(long actionId = -1, const wstring& actionName = L"");

    void protectedFireItemDoubleClickedEvent(__int64 rowIndex);
};