www.pudn.com > MicroWindows-Source-200606.zip > view.h

// 
// Micro Windows Implementation 
// view.h: the view class 
// 
// 這裡我們完成了 GUI 裡的重要元件 -- 視界 (views). 一個 view 
// 是一塊矩形區域, 可在上面作繪圖動作. 
// 
// 這個 View class 功能很簡單, 除了有派送訊息的 messageDispatcher 
// 外, 另外有關閉或改變視窗狀態的 minimize, maximize, close, 
// move, resize 等. 
// 
// 一個 view 下面也有可有多個 view , 並且管理它們. 另外, 一個 
// view 可以和一個 Model class 的 instance 「連結」起來, 詳細 
// 的動作請看書內對 MVC 架構的說明. 
// 
// View class 主要被兩個衍生類別繼承, 一是像 Button, Scrollbar 
// 這一類的 Control class (不要和 Controller class 搞混了), 另 
// 外是一種叫 "MultiView" 的 class. 後者其實就是具有重疊視窗介 
// 面的 view. 透過 C++ 的繼承機制, 我們只要修改幾個 member 
// function, 便能將這個演算法移值進去. 
// 
// $Revision: 1.2 $ 
// $Source: P:/MWINDOWS/INCLUDE/rcs/view.h $ 
// $Date: 1993/10/03 15:21:28 $ 
// 
 
#ifndef __view_h 
#define __view_h 
 
#ifndef __viewport_h 
#   include "viewport.h" 
#endif 
 
class ViewList; 
class Message; 
class Model; 
 
typedef BYTE ResizePlace; 
const ResizePlace MVRP_Top        = 1, MVRP_Bottom     = 2, 
                  MVRP_Left       = 4, MVRP_Right      = 8, 
                  MVRP_LeftTop    = 5, MVRP_LeftBottom = 6, 
                  MVRP_RightTop   = 9, MVRP_RightBottm = 10; 
 
class View : public Object 
{ 
public: 
    View (Rect *prect, View *pparent, Model *client, BOOL attach = FALSE, 
          BOOL killModel = FALSE); 
    ~View(); 
 
 
    // PART 1: 訊息遞送的 method 
    // -------------------------- 
    virtual void    messageDispatcher (Message *msg); 
    virtual void    dispatchMouse (Message *msg); 
 
 
    // PART 2: 關於資料的存取; 為了避免讓其他物件任意更動 viewRect 
    //         等的內部資料, 因此 getViewRect 要接收一個參數, 把 
    //         viewRect 拷貝到這參數裡 
    // ------------------------------------------------------------ 
    virtual Rect   *getViewRect (Rect *receiver); 
    virtual Rect   *getClientRect (Rect *receiver); 
    virtual Port   *getClientPort (); 
    virtual Port   *getViewPort (); 
    virtual Port   *getAttachPort (); 
 
 
    // PART 3: 和 view 有關的操作, 如縮小 (minimize, 在沒 icon 
    //         前是沒用的), 放大 (maximize), 關閉 (close), 
    //         重繪 (draw), 搬移 (move), 伸縮 (resize) 等. 
    // ------------------------------------------------------- 
    virtual void    minimize (); 
    virtual void    maximize (); 
    virtual BOOL    close (BOOL immediate = FALSE); 
    virtual void    draw (FreeArea *area); 
    virtual void    draw (Rect *area = NULL); 
    virtual void    move (Point *offset, View *pparent = NULL); 
    virtual void    resize (int width, int height, View *pparent = NULL); 
 
 
    // PART 4: 只供 view 的親代 (parent) 使用的 method, 
    //         包括隱藏／暴露某一塊區域 (hide/show), 啟動／不啟動 
    //         (activate, deactivate) 等. hide 和 show 不能供其他 
    //         物件使用, 因此接收一個 View *pparent 參數做為核對 
    // ---------------------------------------------------------- 
    virtual void    hide (View *pparent, Rect *area = NULL); 
    virtual void    show (View *pparent, Rect *area = NULL); 
    virtual void    activate (); 
    virtual void    deactivate (); 
 
 
    // PART 5: view 和 subview 之間的關係, 在 View class 裡 
    //         只有 attachSubview 和 removeSubview 能正常工作. 
    //         重疊式視窗介面 (overlapped windows) 要到 MultiView 
    //         class 才算完備 
    // ------------------------------------------------------------ 
    virtual void    attachSubview (View *subview); 
    virtual void    removeSubview (View *subview); 
 
    // PART 6: 以下為供 MultiView class 使用的 method 
    // ------------------------------------------------- 
    virtual void    moveSubview (View *subview, Point *offset); 
    virtual void    resizeSubview (View *subview, int width, int height); 
    virtual void    moveResizeSubview (View *subview, Point *offset, 
                                       int width, int height); 
    virtual void    beginMove (View *subview); 
    virtual void    beginResize (View *subview, ResizePlace rp); 
    virtual void    bringTop (View *subview); 
 
 
    // PART 7: 雜項 method, 包括要求一塊矩形以供 subview attach 等 
    // ------------------------------------------------------------ 
    virtual Point  *getRandomAttachPoint (Point *receiver); 
    virtual Rect   *getRandomAttachRect (Rect *receiver); 
 
protected: 
 
    // PART 8: 和 messageDispatcher 有關的 protected member 
    // ---------------------------------------------------- 
    virtual void    selfDraw (Port *port, Rect *area); 
    virtual void    selfMouse (Message *msg); 
    virtual void    clientDraw (Rect *area); 
 
    Rect viewRect, clientRect; 
    ViewPort *viewPort, *clientPort; 
    View *parent; 
    Model *clientModel; 
    ViewList *subviewList; 
    BOOL clientKillable; 
}; 
 
#endif