home *** CD-ROM | disk | FTP | other *** search
/ PC Press 1997 July / Sezamfile97_2.iso / windows / program / activex / axtsamp.exe / TSBRANCH.EXE / STOCLIEN / GUIPAPER.H < prev    next >
C/C++ Source or Header  |  1996-12-29  |  6KB  |  161 lines
  1. /*+==========================================================================
  2.   File:      GUIPAPER.H
  3.  
  4.   Summary:   Include file for the CGuiPaper C++ class. A GuiPaper is a C++
  5.              object that displays and stores mouse movements as free-form
  6.              line drawing or "scribbling" in the client area of a
  7.              designated window. GuiPaper is anchored to the Windows GUI
  8.              (Graphical User Interface) environment. This GuiPaper object
  9.              relies on a virtual Paper object that is instantiated as a
  10.              COM object (a COPaper) in a separate In-process server,
  11.              STOSERVE, to store the "ink" data that is drawn.
  12.  
  13.              For a comprehensive tutorial code tour of GUIPAPER's contents
  14.              and offerings see the tutorial STOCLIEN.HTM file. For
  15.              more specific technical details on the internal workings see
  16.              the comments dispersed throughout the GUIPAPER source code.
  17.  
  18.   Classes:   CGuiPaper.
  19.  
  20.   Origin:    6-10-96: atrent - Editor inheritance from GUIBALL.H in the
  21.              CONCLIEN source.
  22. ----------------------------------------------------------------------------
  23.   This file is part of the Microsoft ActiveX Tutorial Code Samples.
  24.  
  25.   Copyright (C) Microsoft Corporation, 1997.  All rights reserved.
  26.  
  27.   This source code is intended only as a supplement to Microsoft
  28.   Development Tools and/or on-line documentation.  See these other
  29.   materials for detailed information regarding Microsoft code samples.
  30.  
  31.   THIS CODE AND INFORMATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY
  32.   KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
  33.   IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A
  34.   PARTICULAR PURPOSE.
  35. ==========================================================================+*/
  36.  
  37. #if !defined(GUIPAPER_H)
  38. #define GUIPAPER_H
  39.  
  40. #if defined(__cplusplus)
  41.  
  42.  
  43. #define PAP_EXT "PAP"
  44. #define PAP_FILE_EXT ".PAP"
  45.  
  46.  
  47. /*C+C+++C+++C+++C+++C+++C+++C+++C+++C+++C+++C+++C+++C+++C+++C+++C+++C+++C+++C
  48.   Class:    CGuiPaper
  49.  
  50.   Summary:  Class to encapsulate the displayable Graphical User Interface
  51.             GUI Paper object.
  52.  
  53.   Methods:  CGuiPaper
  54.               Constructor.
  55.             ~CGuiPaper
  56.               Destructor.
  57.             BOOL Init(HINSTANCE hInst, HWND hWnd, TCHAR* pszCmdLineFile);
  58.               Initialize the GuiPaper.
  59.             HRESULT DrawOn(void);
  60.               Lock paper for drawing.
  61.             HRESULT DrawOff(void);
  62.               Unlock paper for drawing.
  63.             HRESULT ClearWin(void);
  64.               Clear display window but retain ink data.
  65.             HRESULT PaintWin(void);
  66.               Clear window and Repaint the window with ink data.
  67.             HRESULT Erase(void);
  68.               Erase current drawn content and clear display window.
  69.             HRESULT Resize(WORD wWidth, WORD wHeight);
  70.               Resize the display window.
  71.             HRESULT InkSaving(BOOL bInkSaving);
  72.               Turn Ink data saving in COPaper on and off.
  73.             HRESULT InkWidth(SHORT nInkWidth);
  74.               Set current ink color for drawing.
  75.             HRESULT InkColor(COLORREF crInkColor);
  76.               Set current ink color for drawing.
  77.             HRESULT InkStart(SHORT nX, SHORT nY);
  78.               Start ink drawing sequence.
  79.             HRESULT InkDraw(SHORT nX, SHORT nY);
  80.               Draw ink sequence data.
  81.             HRESULT InkStop(SHORT nX, SHORT nY);
  82.               Stop ink drawing sequence.
  83.             HRESULT ConnectPaperSink(void);
  84.               Connect the PaperSink to the server COPaper source.
  85.             HRESULT DisconnectPaperSink(void);
  86.               Disconnect the PaperSink from the server COPaper source.
  87.             IConnectionPoint* GetConnectionPoint(REFIID riid);
  88.               Private method to obtain a connection point interface.
  89.             HRESULT Load(void);
  90.               Load Ink Data from current compound file.
  91.             HRESULT Save(void);
  92.               Save existing Ink Data to current compound file.
  93.             HRESULT AskSave(void);
  94.               Check if new ink data, ask user, save if user says to.
  95.             HRESULT Open(void);
  96.               Common dialog. Open existing Ink Data compound file.
  97.             HRESULT SaveAs(void);
  98.               Common dialog. Save current Ink Data file in renamed file.
  99.             COLORREF PickColor(void);
  100.               Common dialog. Ask user to choose new pen color.
  101. C---C---C---C---C---C---C---C---C---C---C---C---C---C---C---C---C---C---C-C*/
  102. class CGuiPaper
  103. {
  104.   public:
  105.     CGuiPaper(void);
  106.     ~CGuiPaper(void);
  107.     BOOL Init(HINSTANCE hInst, HWND hWnd, TCHAR* pszCmdLineFile);
  108.     HRESULT DrawOn(void);
  109.     HRESULT DrawOff(void);
  110.     HRESULT ClearWin(void);
  111.     HRESULT PaintWin(void);
  112.     HRESULT Erase(void);
  113.     HRESULT Resize(WORD wWidth, WORD wHeight);
  114.     HRESULT InkSaving(BOOL bInkSaving);
  115.     HRESULT InkWidth(SHORT nInkWidth);
  116.     HRESULT InkColor(COLORREF crInkColor);
  117.     HRESULT InkStart(SHORT nX, SHORT nY);
  118.     HRESULT InkDraw(SHORT nX, SHORT nY);
  119.     HRESULT InkStop(SHORT nX, SHORT nY);
  120.     HRESULT ConnectPaperSink(void);
  121.     HRESULT DisconnectPaperSink(void);
  122.     HRESULT Load(void);
  123.     HRESULT Save(void);
  124.     int     AskSave(void);
  125.     HRESULT Open(void);
  126.     HRESULT SaveAs(void);
  127.     COLORREF PickColor(void);
  128.  
  129.   private:
  130.     HINSTANCE  m_hInst;
  131.     HWND       m_hWnd;
  132.     HDC        m_hDC;
  133.     RECT       m_WinRect;
  134.     IPaper*    m_pIPaper;
  135.     SHORT      m_nLockKey;
  136.     HPEN       m_hPen;
  137.     SHORT      m_nInkWidth;
  138.     COLORREF   m_crInkColor;
  139.     BOOL       m_bInkSaving;
  140.     BOOL       m_bInking;
  141.     BOOL       m_bPainting;
  142.     POINT      m_OldPos;
  143.     IUnknown*  m_pCOPaperSink;
  144.     DWORD      m_dwPaperSink;
  145.     BOOL       m_bDirty;
  146.     CPapFile*    m_pPapFile;
  147.     OPENFILENAME m_ofnFile;
  148.     TCHAR        m_szFileFilter[MAX_PATH];
  149.     TCHAR        m_szFileName[MAX_PATH];
  150.     TCHAR        m_szFileTitle[MAX_PATH];
  151.     CHOOSECOLOR  m_ChooseColor;
  152.     COLORREF     m_acrCustColors[16];
  153.  
  154.     IConnectionPoint* GetConnectionPoint(REFIID riid);
  155. };
  156.  
  157.  
  158. #endif // __cplusplus
  159.  
  160. #endif
  161.