开通博客赚积分
发布资源赚积分
分类

源码开发语言/平台
当前位置：首页 > 源码/资料 > 数值算法/人工智能 > 生物技术 > 查看源码
sequence_viewer_widget.hpp
资源名称：ncbi_cxx_win--Jul_08_2004.zip　[点击查看]
上传用户：yhdzpy8989
上传日期：2007-06-13
资源大小：13604k
文件大小：8k
源码类别：

生物技术

开发平台：

C/C++

sequence_viewer_widget.hpp：源码内容
  1. /*
  2.  * ===========================================================================
  3.  * PRODUCTION $Log: sequence_viewer_widget.hpp,v $
  4.  * PRODUCTION Revision 1000.0  2003/10/29 18:38:55  gouriano
  5.  * PRODUCTION PRODUCTION: IMPORTED [ORIGINAL] Dev-tree R1.20
  6.  * PRODUCTION
  7.  * ===========================================================================
  8.  */
  10. /*  $Id: sequence_viewer_widget.hpp,v 1000.0 2003/10/29 18:38:55 gouriano Exp $
  11. * ===========================================================================
  12. *
  13. *                            PUBLIC DOMAIN NOTICE
  14. *               National Center for Biotechnology Information
  15. *
  16. *  This software/database is a "United States Government Work" under the
  17. *  terms of the United States Copyright Act.  It was written as part of
  18. *  the author's official duties as a United States Government employee and
  19. *  thus cannot be copyrighted.  This software/database is freely available
  20. *  to the public for use. The National Library of Medicine and the U.S.
  21. *  Government have not placed any restriction on its use or reproduction.
  22. *
  23. *  Although all reasonable efforts have been taken to ensure the accuracy
  24. *  and reliability of the software and data, the NLM and the U.S.
  25. *  Government do not and cannot warrant the performance or results that
  26. *  may be obtained by using this software or data. The NLM and the U.S.
  27. *  Government disclaim all warranties, express or implied, including
  28. *  warranties of performance, merchantability or fitness for any particular
  29. *  purpose.
  30. *
  31. *  Please cite the author in any work or product based on this material.
  32. *
  33. * ===========================================================================
  34. *
  35. * Authors:  Paul Thiessen
  36. *
  37. * File Description:
  38. *      Classes to display sequences and alignments with wxWindows front end
  39. *
  40. * ===========================================================================
  41. */
  43. #ifndef WX_SEQUENCE_VIEWER_WIDGET__HPP
  44. #define WX_SEQUENCE_VIEWER_WIDGET__HPP
  46. #ifdef __WXMSW__
  47. #include <windows.h>
  48. #include <wx/msw/winundef.h>
  49. #endif
  50. #include <wx/wx.h>
  51. #include <wx/splitter.h>
  53. class ViewableAlignment;
  55. // This is the GUI class itself. It is a wxSplitterWindow - a viewing area where
  56. // characters are drawn, with right and bottom scrollbars that will automatically
  57. // be added if necessary. Note that it is *not* a complete top-level window!
  58. // Thus, it can be embedded in other windows, and more than one can exist in a window.
  59. // If you want a separate top-level sequence viewing window, then simply put this
  60. // object into a wxFrame (with whatever menus you want to attach to it).
  62. // A note on memory and processor efficiency: the SequenceViewerWidget does *not*
  63. // keep an entire array of characters in memory, nor does it keep a canvas of the
  64. // entire pixel image of the alignment in memory, thus it should be able to display
  65. // large alignments without incurring NxN memory usage. However, this means that
  66. // the display must be created dynamically, by calls to the ViewableAlignment's
  67. // member functions, as appropriate. It only calls these functions on the
  68. // minimum number of positions needed to fill out the display, including on
  69. // scrolling operations: if you scroll the view one column to the right, only
  70. // the rightmost column is redrawn, and thus the number of calls to GetCharacterAt()
  71. // is equal only to the number of rows in the visible region. Hopefully this will
  72. // provide a reasonable compromise between memory and CPU efficiency.
  74. class SequenceViewerWidget_SequenceArea;
  75. class SequenceViewerWidget_TitleArea;
  77. class SequenceViewerWidget : public wxSplitterWindow
  78. {
  79. public:
  80.     // constructor
  81.     SequenceViewerWidget(
  82.         wxWindow* parent,
  83.         wxWindowID id = -1,
  84.         const wxPoint& pos = wxDefaultPosition,
  85.         const wxSize& size = wxDefaultSize
  86.     );
  88.     // destructor
  89.     ~SequenceViewerWidget(void);
  91.     // to provide a ViewableAlignment to show. It is passed as a pointer, but
  92.     // is not "owned" by the SequenceViewerWidget, and will not be deconstructed
  93.     // even if the SequenceViewerWidget is destroyed. Returns false on error.
  94.     bool AttachAlignment(ViewableAlignment *newAlignment, int initX = 0, int initY = 0);
  96.     // sets mouse mode. If eSelect, dragging the mouse with the left button
  97.     // down will cause a rubberband to be drawn around a block of characters,
  98.     // and the ViewableAlignment's SelectedRectangle() callback will be called
  99.     // upon button-up. If eDrag, two individual cells are rubberbanded: one where
  100.     // the mouse was upon button-down, and one where the mouse is while
  101.     // being dragged; DraggedCell() will be called upon button-up. In any case,
  102.     // selection is limited to coordinates given by ViewableAlignment's GetSize(),
  103.     // even if the window is larger.
  104.     enum eMouseMode {
  105.         eSelectRectangle,   // select rectangle of cells
  106.         eSelectColumns,     // select whole columns
  107.         eSelectRows,        // select whole rows
  108.         eDrag,              // move one cell
  109.         eDragHorizontal,    // move one cell only horizontally
  110.         eDragVertical       // move one cell only vertically
  111.     };
  112.     void SetMouseMode(eMouseMode mode);
  113.     eMouseMode GetMouseMode(void) const;
  115.     // sets the background color for the window after refresh
  116.     void SetBackgroundColor(const wxColor& backgroundColor);
  118.     // set the font for the characters; refreshes automatically. This font
  119.     // object will be owned and destroyed by the SequenceViewerWidget
  120.     void SetCharacterFont(wxFont *font);
  122.     // set the rubber band color after refresh
  123.     void SetRubberbandColor(const wxColor& rubberbandColor);
  125.     // scroll sequence area to specific column or row; if either is -1, will
  126.     // not scroll in that direction
  127.     void ScrollTo(int column, int row);
  129.     // get current uppermost row & leftmost column
  130.     void GetScroll(int *vsX, int *vsY) const;
  132.     // make character visible (in sequence area) if it's not already; if either coordinate
  133.     // is < 0, will not scroll in that direction
  134.     void MakeCharacterVisible(int column, int row) const;
  136.     // turn on/off the title area
  137.     void TitleAreaOn(void);
  138.     void TitleAreaOff(void);
  139.     void TitleAreaToggle(void);
  141.     void Refresh(bool eraseBackground = TRUE, const wxRect *rect = NULL);
  143. private:
  144.     SequenceViewerWidget_SequenceArea *sequenceArea;
  145.     SequenceViewerWidget_TitleArea *titleArea;
  147.     void OnDoubleClickSash(int x, int y);
  148. };
  150. #endif // WX_SEQUENCE_VIEWER_WIDGET__HPP
  152. /*
  153. * ---------------------------------------------------------------------------
  154. * $Log: sequence_viewer_widget.hpp,v $
  155. * Revision 1000.0  2003/10/29 18:38:55  gouriano
  156. * PRODUCTION: IMPORTED [ORIGINAL] Dev-tree R1.20
  157. *
  158. * Revision 1.20  2003/02/03 19:20:06  thiessen
  159. * format changes: move CVS Log to bottom of file, remove std:: from .cpp files, and use new diagnostic macros
  160. *
  161. * Revision 1.19  2002/10/07 13:29:32  thiessen
  162. * add double-click -> show row to taxonomy tree
  163. *
  164. * Revision 1.18  2002/08/15 22:13:16  thiessen
  165. * update for wx2.3.2+ only; add structure pick dialog; fix MultitextDialog bug
  166. *
  167. * Revision 1.17  2002/02/05 18:53:25  thiessen
  168. * scroll to residue in sequence windows when selected in structure window
  169. *
  170. * Revision 1.16  2001/05/22 19:09:10  thiessen
  171. * many minor fixes to compile/run on Solaris/GTK
  172. *
  173. * Revision 1.15  2001/05/03 14:38:32  thiessen
  174. * put ViewableAlignment in its own (non-wx) header
  175. *
  176. * Revision 1.14  2001/03/17 14:06:52  thiessen
  177. * more workarounds for namespace/#define conflicts
  178. *
  179. * Revision 1.13  2000/11/02 16:48:23  thiessen
  180. * working editor undo; dynamic slave transforms
  181. *
  182. * Revision 1.12  2000/10/16 20:02:17  thiessen
  183. * working block creation
  184. *
  185. * Revision 1.11  2000/10/12 16:39:31  thiessen
  186. * fix MouseDown return value
  187. *
  188. * Revision 1.10  2000/10/12 16:22:37  thiessen
  189. * working block split
  190. *
  191. * Revision 1.9  2000/10/05 18:34:35  thiessen
  192. * first working editing operation
  193. *
  194. * Revision 1.8  2000/10/04 17:40:47  thiessen
  195. * rearrange STL #includes
  196. *
  197. * Revision 1.7  2000/10/03 18:59:55  thiessen
  198. * added row/column selection
  199. *
  200. * Revision 1.6  2000/10/02 23:25:08  thiessen
  201. * working sequence identifier window in sequence viewer
  202. *
  203. * Revision 1.5  2000/09/14 14:55:26  thiessen
  204. * add row reordering; misc fixes
  205. *
  206. * Revision 1.4  2000/09/11 22:57:55  thiessen
  207. * working highlighting
  208. *
  209. * Revision 1.3  2000/09/09 14:35:35  thiessen
  210. * fix wxWin problem with large alignments
  211. *
  212. * Revision 1.2  2000/09/07 17:37:42  thiessen
  213. * minor fixes
  214. *
  215. * Revision 1.1  2000/09/03 18:45:57  thiessen
  216. * working generalized sequence viewer
  217. *
  218. * Revision 1.2  2000/08/30 23:45:36  thiessen
  219. * working alignment display
  220. *
  221. * Revision 1.1  2000/08/30 19:49:05  thiessen
  222. * working sequence window
  223. *
  224. */