GUIPAPER.H
上传用户:bangxh
上传日期:2007-01-31
资源大小:42235k
文件大小:6k
源码类别:

Windows编程

开发平台:

Visual C++

  1. /*+==========================================================================
  2.   File:      GUIPAPER.H
  3.   Summary:   Include file for the CGuiPaper C++ class. A GuiPaper is a C++
  4.              object that displays and stores mouse movements as free-form
  5.              line drawing or "scribbling" in the client area of a
  6.              designated window. GuiPaper is anchored to the Windows GUI
  7.              (Graphical User Interface) environment. This GuiPaper object
  8.              relies on a virtual Paper object that is instantiated as a
  9.              COM object (a COPaper) in a separate out-of-process server,
  10.              DCDSERVE, to store the "ink" data that is drawn.
  11.              For a comprehensive tutorial code tour of GUIPAPER's contents
  12.              and offerings see the tutorial DCOMDRAW.HTM file. For
  13.              more specific technical details on the internal workings see
  14.              the comments dispersed throughout the GUIPAPER source code.
  15.   Classes:   CGuiPaper.
  16.   Origin:    8-23-97: atrent - Editor inheritance from GUIBALL.H in the
  17.              CONCLIEN source. [Revised]
  18. ----------------------------------------------------------------------------
  19.   This file is part of the Microsoft COM Tutorial Code Samples.
  20.   Copyright (C) Microsoft Corporation, 1997.  All rights reserved.
  21.   This source code is intended only as a supplement to Microsoft
  22.   Development Tools and/or on-line documentation.  See these other
  23.   materials for detailed information regarding Microsoft code samples.
  24.   THIS CODE AND INFORMATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY
  25.   KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
  26.   IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A
  27.   PARTICULAR PURPOSE.
  28. ==========================================================================+*/
  29. #if !defined(GUIPAPER_H)
  30. #define GUIPAPER_H
  31. #if defined(__cplusplus)
  32. /*C+C+++C+++C+++C+++C+++C+++C+++C+++C+++C+++C+++C+++C+++C+++C+++C+++C+++C+++C
  33.   Class:    CGuiPaper
  34.   Summary:  Class to encapsulate the displayable Graphical User Interface
  35.             GUI Paper object.
  36.   Methods:  CGuiPaper
  37.               Constructor.
  38.             ~CGuiPaper
  39.               Destructor.
  40.             BOOL Init(HINSTANCE hInst, HWND hWnd);
  41.               Initialize the GuiPaper.
  42.             HRESULT SetPenCur(USHORT usPenCurNew);
  43.               Set the pen width and pen On/Off.
  44.             HRESULT Lock(BOOL bLock);
  45.               Lock or unlock paper for drawing. Master client has lock.
  46.             BOOL    Master(void);
  47.               Return TRUE if this client is the owning master client.
  48.             HRESULT ResizeWin(LONG lWidth, LONG lHeight);
  49.               Resize the display window.
  50.             HRESULT ClearWin(void);
  51.               Clear display window but retain ink data.
  52.             HRESULT PaintWin(void);
  53.               Clear window and Repaint the window with ink data.
  54.             HRESULT Erase(void);
  55.               Erase current drawn content and clear display window.
  56.             HRESULT Resize(LONG lWidth, LONG lHeight);
  57.               Resize the display rectangle of the drawing.
  58.             HRESULT InkWidth(SHORT nInkWidth);
  59.               Set current ink line width for drawing.
  60.             HRESULT InkColor(COLORREF crInkColor);
  61.               Set current ink color for drawing.
  62.             HRESULT InkStart(SHORT nX, SHORT nY);
  63.               Start ink drawing sequence.
  64.             HRESULT InkDraw(SHORT nX, SHORT nY);
  65.               Draw ink sequence data.
  66.             HRESULT InkStop(SHORT nX, SHORT nY);
  67.               Stop ink drawing sequence.
  68.             HRESULT ConnectPaperSink(void);
  69.               Connect the PaperSink to the server COPaper source.
  70.             HRESULT DisconnectPaperSink(void);
  71.               Disconnect the PaperSink from the server COPaper source.
  72.             HRESULT Load(void);
  73.               Load ink data from current compound file (local or remote).
  74.             HRESULT LoadLocal(void);
  75.               Unload current drawing and Load drawing from local
  76.               DCDSERVE server.
  77.             HRESULT LoadRemote(void);
  78.               Unload current drawing paper and reload from a DCDSERVE
  79.               located on a remote machine. User gives remote machine
  80.               name in a dialog.
  81.             HRESULT Save(void);
  82.               Save existing Ink Data to current compound file.
  83.             INT AskSave(void);
  84.               Check if new ink data, ask user, save if user says to.
  85.             COLORREF PickColor(void);
  86.               Common dialog. Ask user to choose new pen color.
  87. C---C---C---C---C---C---C---C---C---C---C---C---C---C---C---C---C---C---C-C*/
  88. class CGuiPaper
  89. {
  90.   public:
  91.     CGuiPaper(void);
  92.     ~CGuiPaper(void);
  93.     BOOL Init(HINSTANCE hInst, HWND hWnd);
  94.     HRESULT SetPenCur(USHORT usPenCurNew);
  95.     HRESULT Lock(BOOL bLock);
  96.     BOOL    Master(void);
  97.     HRESULT ResizeWin(LONG lWidth, LONG lHeight);
  98.     HRESULT ClearWin(void);
  99.     HRESULT PaintWin(void);
  100.     HRESULT Erase(void);
  101.     HRESULT Resize(LONG lWidth, LONG lHeight);
  102.     HRESULT InkWidth(SHORT nInkWidth);
  103.     HRESULT InkColor(COLORREF crInkColor);
  104.     HRESULT InkStart(SHORT nX, SHORT nY);
  105.     HRESULT InkDraw(SHORT nX, SHORT nY);
  106.     HRESULT InkStop(SHORT nX, SHORT nY);
  107.     HRESULT ConnectPaperSink(void);
  108.     HRESULT DisconnectPaperSink(void);
  109.     HRESULT Load(void);
  110.     HRESULT LoadLocal(void);
  111.     HRESULT LoadRemote(void);
  112.     HRESULT Save(void);
  113.     INT     AskSave(void);
  114.     COLORREF PickColor(void);
  115.   private:
  116.     HINSTANCE    m_hInst;
  117.     HWND         m_hWnd;
  118.     HDC          m_hDC;
  119.     RECT         m_WinRect;
  120.     ISharePaper* m_pISharePaper;
  121.     HPEN         m_hPen;
  122.     USHORT       m_PenCur;
  123.     HCURSOR      m_hPenCurN;
  124.     HCURSOR      m_hPenCurT;
  125.     HCURSOR      m_hPenCurM;
  126.     HCURSOR      m_hPenCurF;
  127.     SHORT        m_nInkWidth;
  128.     COLORREF     m_crInkColor;
  129.     BOOL         m_bLocked;
  130.     BOOL         m_bInkSaving;
  131.     BOOL         m_bInking;
  132.     BOOL         m_bPainting;
  133.     POINT        m_OldPos;
  134.     IUnknown*    m_pCOPaperSink;
  135.     DWORD        m_dwPaperSink;
  136.     BOOL         m_bDirty;
  137.     CHOOSECOLOR  m_ChooseColor;
  138.     COLORREF     m_acrCustColors[16];
  139.     IConnectionPoint* GetConnectionPoint(REFIID riid);
  140. };
  141. #endif // __cplusplus
  142. #endif