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 In-process server,
  10.              STOSERVE, 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 STOCLIEN.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:    6-10-96: atrent - Editor inheritance from GUIBALL.H in the
  17.              CONCLIEN source.
  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. #define PAP_EXT "PAP"
  33. #define PAP_FILE_EXT ".PAP"
  34. /*C+C+++C+++C+++C+++C+++C+++C+++C+++C+++C+++C+++C+++C+++C+++C+++C+++C+++C+++C
  35.   Class:    CGuiPaper
  36.   Summary:  Class to encapsulate the displayable Graphical User Interface
  37.             GUI Paper object.
  38.   Methods:  CGuiPaper
  39.               Constructor.
  40.             ~CGuiPaper
  41.               Destructor.
  42.             BOOL Init(HINSTANCE hInst, HWND hWnd, TCHAR* pszCmdLineFile);
  43.               Initialize the GuiPaper.
  44.             HRESULT DrawOn(void);
  45.               Lock paper for drawing.
  46.             HRESULT DrawOff(void);
  47.               Unlock paper for drawing.
  48.             HRESULT ClearWin(void);
  49.               Clear display window but retain ink data.
  50.             HRESULT PaintWin(void);
  51.               Clear window and Repaint the window with ink data.
  52.             HRESULT Erase(void);
  53.               Erase current drawn content and clear display window.
  54.             HRESULT Resize(WORD wWidth, WORD wHeight);
  55.               Resize the display window.
  56.             HRESULT InkSaving(BOOL bInkSaving);
  57.               Turn Ink data saving in COPaper on and off.
  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.             IConnectionPoint* GetConnectionPoint(REFIID riid);
  73.               Private method to obtain a connection point interface.
  74.             HRESULT Load(void);
  75.               Load Ink Data from current compound file.
  76.             HRESULT Save(void);
  77.               Save existing Ink Data to current compound file.
  78.             INT AskSave(void);
  79.               Check if new ink data, ask user, save if user says to.
  80.             HRESULT Open(void);
  81.               Common dialog. Open existing Ink Data compound file.
  82.             HRESULT SaveAs(void);
  83.               Common dialog. Save current Ink Data file in renamed file.
  84.             COLORREF PickColor(void);
  85.               Common dialog. Ask user to choose new pen color.
  86. C---C---C---C---C---C---C---C---C---C---C---C---C---C---C---C---C---C---C-C*/
  87. class CGuiPaper
  88. {
  89.   public:
  90.     CGuiPaper(void);
  91.     ~CGuiPaper(void);
  92.     BOOL Init(HINSTANCE hInst, HWND hWnd, TCHAR* pszCmdLineFile);
  93.     HRESULT DrawOn(void);
  94.     HRESULT DrawOff(void);
  95.     HRESULT ClearWin(void);
  96.     HRESULT PaintWin(void);
  97.     HRESULT Erase(void);
  98.     HRESULT Resize(WORD wWidth, WORD wHeight);
  99.     HRESULT InkSaving(BOOL bInkSaving);
  100.     HRESULT InkWidth(SHORT nInkWidth);
  101.     HRESULT InkColor(COLORREF crInkColor);
  102.     HRESULT InkStart(SHORT nX, SHORT nY);
  103.     HRESULT InkDraw(SHORT nX, SHORT nY);
  104.     HRESULT InkStop(SHORT nX, SHORT nY);
  105.     HRESULT ConnectPaperSink(void);
  106.     HRESULT DisconnectPaperSink(void);
  107.     HRESULT Load(void);
  108.     HRESULT Save(void);
  109.     INT     AskSave(void);
  110.     HRESULT Open(void);
  111.     HRESULT SaveAs(void);
  112.     COLORREF PickColor(void);
  113.   private:
  114.     HINSTANCE  m_hInst;
  115.     HWND       m_hWnd;
  116.     HDC        m_hDC;
  117.     RECT       m_WinRect;
  118.     IPaper*    m_pIPaper;
  119.     SHORT      m_nLockKey;
  120.     HPEN       m_hPen;
  121.     SHORT      m_nInkWidth;
  122.     COLORREF   m_crInkColor;
  123.     BOOL       m_bInkSaving;
  124.     BOOL       m_bInking;
  125.     BOOL       m_bPainting;
  126.     POINT      m_OldPos;
  127.     IUnknown*  m_pCOPaperSink;
  128.     DWORD      m_dwPaperSink;
  129.     BOOL       m_bDirty;
  130.     CPapFile*    m_pPapFile;
  131.     OPENFILENAME m_ofnFile;
  132.     TCHAR        m_szFileFilter[MAX_PATH];
  133.     TCHAR        m_szFileName[MAX_PATH];
  134.     TCHAR        m_szFileTitle[MAX_PATH];
  135.     CHOOSECOLOR  m_ChooseColor;
  136.     COLORREF     m_acrCustColors[16];
  137.     IConnectionPoint* GetConnectionPoint(REFIID riid);
  138. };
  139. #endif // __cplusplus
  140. #endif