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

源码开发语言/平台
当前位置：首页 > 源码/资料 > Windows编程 > 界面编程 > 对话框与窗口 > 查看源码
XTPControlGallery.h
资源名称：Xtreme.ToolkitPro.v12.0.0.rar　[点击查看]
上传用户：szled88
上传日期：2015-04-09
资源大小：43957k
文件大小：39k
源码类别：

对话框与窗口

开发平台：

Visual C++

XTPControlGallery.h：源码内容
  1. // XTPControlGallery.h
  2. //
  3. // This file is a part of the XTREME COMMANDBARS MFC class library.
  4. // (c)1998-2008 Codejock Software, All Rights Reserved.
  5. //
  6. // THIS SOURCE FILE IS THE PROPERTY OF CODEJOCK SOFTWARE AND IS NOT TO BE
  7. // RE-DISTRIBUTED BY ANY MEANS WHATSOEVER WITHOUT THE EXPRESSED WRITTEN
  8. // CONSENT OF CODEJOCK SOFTWARE.
  9. //
  10. // THIS SOURCE CODE CAN ONLY BE USED UNDER THE TERMS AND CONDITIONS OUTLINED
  11. // IN THE XTREME TOOLKIT PRO LICENSE AGREEMENT. CODEJOCK SOFTWARE GRANTS TO
  12. // YOU (ONE SOFTWARE DEVELOPER) THE LIMITED RIGHT TO USE THIS SOFTWARE ON A
  13. // SINGLE COMPUTER.
  14. //
  15. // CONTACT INFORMATION:
  16. // support@codejock.com
  17. // http://www.codejock.com
  18. //
  19. /////////////////////////////////////////////////////////////////////////////
  21. //{{AFX_CODEJOCK_PRIVATE
  22. #if !defined(__XTPCONTROLGALLERY_H__)
  23. #define __XTPCONTROLGALLERY_H__
  24. //}}AFX_CODEJOCK_PRIVATE
  26. #if _MSC_VER >= 1000
  27. #pragma once
  28. #endif // _MSC_VER >= 1000
  31. #include "XTPCommandBarsDefines.h"
  32. #include "XTPControlPopup.h"
  33. #include "XTPControlComboBox.h"
  34. #include "XTPScrollBar.h"
  36. class CXTPControlGalleryItems;
  37. class CXTPControlGallery;
  38. class CXTPControlGalleryPaintManager;
  40. const UINT XTP_GN_PREVIEWSTART      = 0x1010;
  41. const UINT XTP_GN_PREVIEWCANCEL     = 0x1011;
  42. const UINT XTP_GN_PREVIEWAPPLY      = 0x1012;
  43. const UINT XTP_GN_PREVIEWCHANGE     = 0x1013;
  44. const UINT XTP_GN_STARTDRAG         = 0x1014;
  45. const UINT XTP_GN_SELCHANGE         = 0x1015;
  47. //===========================================================================
  48. // Summary:
  49. //     CXTPControlGalleryItem is a CCmdTarget derived class. It represents single item of
  50. //     gallery object.
  51. //===========================================================================
  52. class _XTP_EXT_CLASS CXTPControlGalleryItem : public CXTPCmdTarget
  53. {
  54. public:
  55. //-----------------------------------------------------------------------
  56. // Summary:
  57. //     Constructs a CXTPControlGalleryItem object
  58. //-----------------------------------------------------------------------
  59. CXTPControlGalleryItem();
  61. public:
  62. //-----------------------------------------------------------------------
  63. // Summary:
  64. //     This method is called to get size of the item.
  65. // Returns:
  66. //     Size of the item
  67. // See Also: SetSize, CXTPControlGalleryItems::SetItemSize
  68. //-----------------------------------------------------------------------
  69. virtual CSize GetSize();
  71. //-----------------------------------------------------------------------
  72. // Summary:
  73. //     Call this method to set size of the individual item. You can call
  74. //     CXTPControlGalleryItems::SetItemSize to set default size for items
  75. // Parameters:
  76. //     szItem - Size of the item to be set
  77. //-----------------------------------------------------------------------
  78. void SetSize(CSize szItem);
  80. //-----------------------------------------------------------------------
  81. // Summary:
  82. //     This method is called to draw the item
  83. // Parameters:
  84. //     pDC      - Pointer to valid device context
  85. //     pGallery - Parent gallery of the item
  86. //     rcItem   - Bounding rectangle of the item
  87. //     bEnabled - TRUE to draw item enabled; FALSE - disabled
  88. //     bSelected - TRUE to draw item selected
  89. //     bPressed - TRUE to draw item pressed
  90. //     bChecked - TRUE to draw item checked
  91. //-----------------------------------------------------------------------
  92. virtual void Draw(CDC* pDC, CXTPControlGallery* pGallery, CRect rcItem, BOOL bEnabled, BOOL bSelected, BOOL bPressed, BOOL bChecked);
  94. //-----------------------------------------------------------------------
  95. // Summary:
  96. //     This method is called to get image for item
  97. //-----------------------------------------------------------------------
  98. CXTPImageManagerIcon* GetImage();
  100. //-----------------------------------------------------------------------
  101. // Summary:
  102. //     Call this method to determine if the item is label
  103. //-----------------------------------------------------------------------
  104. BOOL IsLabel() const;
  106. //-----------------------------------------------------------------------
  107. // Summary:
  108. //     Call this method to set caption of the item
  109. // Parameters:
  110. //     lpszCaption - Caption of the item to be set
  111. // See Also: GetCaption, SetToolTip, GetToolTip
  112. //-----------------------------------------------------------------------
  113. void SetCaption(LPCTSTR lpszCaption);
  115. //-----------------------------------------------------------------------
  116. // Summary:
  117. //     Call this method to set tooltip  of the item
  118. // Parameters:
  119. //     lpszToolTip - Tooltip of the item to be set
  120. // See Also: GetToolTip, SetCaption, GetCaption
  121. //-----------------------------------------------------------------------
  122. void SetToolTip(LPCTSTR lpszToolTip);
  124. //-----------------------------------------------------------------------
  125. // Summary:
  126. //     Retrieves tooltip of the item
  127. // See Also: SetToolTip, SetCaption, GetCaption
  128. //-----------------------------------------------------------------------
  129. CString GetToolTip() const;
  131. //-----------------------------------------------------------------------
  132. // Summary:
  133. //     Retrieves caption of the item
  134. // See Also: SetCaption, SetToolTip, GetToolTip
  135. //-----------------------------------------------------------------------
  136. CString GetCaption() const;
  138. //-----------------------------------------------------------------------
  139. // Summary:
  140. //     Retrieves index of the item
  141. //-----------------------------------------------------------------------
  142. int GetIndex() const;
  144. //-----------------------------------------------------------------------
  145. // Summary:
  146. //     Call this member to set the identifier of the item.
  147. // Parameters:
  148. //     nId - Identifier to be set.
  149. //-----------------------------------------------------------------------
  150. void SetID(int nId);
  152. //-----------------------------------------------------------------------
  153. // Summary:
  154. //     Call this member to get the item's identifier.
  155. // Returns:
  156. //     The identifier of the item.
  157. //-----------------------------------------------------------------------
  158. int GetID() const;
  160. //-----------------------------------------------------------------------
  161. // Summary:
  162. //     This method sets the 32-bit value associated with the item.
  163. // Parameters:
  164. //     dwData - Contains the new value to associate with the item.
  165. //-----------------------------------------------------------------------
  166. void SetData(DWORD_PTR dwData);
  168. //-----------------------------------------------------------------------
  169. // Summary:
  170. //     This method retrieves the application-supplied 32-bit value
  171. //     associated with the item.
  172. // Returns:
  173. //     The 32-bit value associated with the item.
  174. //-----------------------------------------------------------------------
  175. DWORD_PTR GetData() const;
  177. //-----------------------------------------------------------------------
  178. // Summary:
  179. //     Call this member to set the description of the item.
  180. // Parameters:
  181. //     lpszDescription - Description to be set.
  182. // See Also: SetCaption, SetTooltip
  183. //-----------------------------------------------------------------------
  184. void SetDescription(LPCTSTR lpszDescription);
  186. //-----------------------------------------------------------------------
  187. // Summary:
  188. //     Call this member to get the item's description.
  189. // Returns:
  190. //     The description of the control.
  191. //-----------------------------------------------------------------------
  192. CString GetDescription() const;
  195. protected:
  196. int m_nId;              // Identifier
  197. int m_nIndex;           // Index of the item
  198. int m_nImage;           // Image index
  199. CString m_strCaption;   // Caption of the item
  200. CString m_strToolTip;   // Tooltip of the item
  201. CString m_strDescriptionText; // Description of the item
  202. CXTPControlGalleryItems* m_pItems;  // Parent items collection
  203. DWORD_PTR m_dwData;     // 32-bit data
  204. CSize m_szItem;         // Size of the item; CSize(0, 0) - to use default value
  205. BOOL m_bLabel;          // TRUE if item is label
  208. friend class CXTPControlGalleryItems;
  209. friend class CXTPControlGallery;
  210. };
  212. //===========================================================================
  213. // Summary:
  214. //     CXTPControlGalleryItems is a CCmdTarget derived class. It represents a collection
  215. //     of the items for gallery control.
  216. //===========================================================================
  217. class _XTP_EXT_CLASS CXTPControlGalleryItems : public CXTPCmdTarget
  218. {
  219. DECLARE_DYNAMIC(CXTPControlGalleryItems)
  221. protected:
  222. //-----------------------------------------------------------------------
  223. // Summary:
  224. //     Constructs a CXTPControlGalleryItems object.
  225. // Parameters:
  226. //     pAction - Action for gallery control to link with.
  227. // Remarks:
  228. //     Protected constructor, use CreateItems to create items for gallery
  229. //-----------------------------------------------------------------------
  230. CXTPControlGalleryItems(CXTPControlAction* pAction);
  232. //-----------------------------------------------------------------------
  233. // Summary:
  234. //     Destroys a CXTPControlGalleryItems object, handles cleanup and deallocation
  235. //-----------------------------------------------------------------------
  236. ~CXTPControlGalleryItems();
  238. public:
  239. //-----------------------------------------------------------------------
  240. // Summary:
  241. //     Creates new items collection for gallery control
  242. // Parameters:
  243. //     pCommandBars - Parent Commandbars.
  244. //     nId - Identifier of the items
  245. //-----------------------------------------------------------------------
  246. static CXTPControlGalleryItems* AFX_CDECL CreateItems(CXTPCommandBars* pCommandBars, int nId);
  249. public:
  250. //-----------------------------------------------------------------------
  251. // Summary:
  252. //     Call this method to remove all items in collection
  253. //-----------------------------------------------------------------------
  254. void RemoveAll();
  256. //-----------------------------------------------------------------------
  257. // Summary:
  258. //     Call this member to remove item.
  259. // Parameters:
  260. //     nIndex - Index of the item to be removed.
  261. //-----------------------------------------------------------------------
  262. void Remove(int nIndex);
  264. //-----------------------------------------------------------------------
  265. // Summary:
  266. //     Call this member to add a new item.
  267. // Parameters:
  268. //     pItem - Item to be added
  269. //     nId   - Identifier of the item
  270. //     nImage - Image of the item
  271. //     lpszCaption - Caption of the item to be added
  272. // Returns:
  273. //     A pointer to the added item.
  274. //-----------------------------------------------------------------------
  275. CXTPControlGalleryItem* AddItem(int nId, int nImage);
  276. CXTPControlGalleryItem* AddItem(LPCTSTR lpszCaption, int nId, int nImage);
  277. CXTPControlGalleryItem* AddItem(CXTPControlGalleryItem* pItem, int nId = -1, int nImage = -1); //<combine CXTPControlGalleryItems::AddItem@int@int>
  278. CXTPControlGalleryItem* AddItem(LPCTSTR lpszCaption, int nImage = -1); //<combine CXTPControlGalleryItems::AddItem@int@int>
  280. //-----------------------------------------------------------------------
  281. // Summary:
  282. //     Call this member to insert a new item.
  283. // Parameters:
  284. //     nIndex - Index to insert new item
  285. //     pItem - Item to be added
  286. //     nId   - Identifier of the item
  287. //     nImage - Image of the item
  288. // Returns:
  289. //     A pointer to the added item.
  290. //-----------------------------------------------------------------------
  291. CXTPControlGalleryItem* InsertItem(int nIndex, CXTPControlGalleryItem* pItem, int nId = -1, int nImage = -1);
  293. //-----------------------------------------------------------------------
  294. // Summary:
  295. //     Call this member to add a new label item.
  296. // Parameters:
  297. //     nId   - Identifier of the item
  298. //     lpszCaption - Caption of the item to be added
  299. // Returns:
  300. //     A pointer to the added item.
  301. //-----------------------------------------------------------------------
  302. CXTPControlGalleryItem* AddLabel(int nId);
  303. CXTPControlGalleryItem* AddLabel(LPCTSTR lpszCaption); //<combine CXTPControlGalleryItems::AddLabel@int>
  305. //-----------------------------------------------------------------------
  306. // Summary:
  307. //     Call this method to set image manager for items
  308. // Parameters:
  309. //     pImageManager - new image manager to be set
  310. //-----------------------------------------------------------------------
  311. void SetImageManager(CXTPImageManager* pImageManager);
  313. //-----------------------------------------------------------------------
  314. // Summary:
  315. //     Retrieves image manager of the items
  316. //-----------------------------------------------------------------------
  317. CXTPImageManager* GetImageManager() const;
  319. //-----------------------------------------------------------------------
  320. // Summary:
  321. //     Determines default size of the items
  322. // See Also: SetItemSize
  323. //-----------------------------------------------------------------------
  324. CSize GetItemSize() const;
  326. //-----------------------------------------------------------------------
  327. // Summary:
  328. //     Call this method to set size of the item
  329. // Parameters:
  330. //     szItem - New size to be set
  331. // See Also: GetItemSize
  332. //-----------------------------------------------------------------------
  333. void SetItemSize(CSize szItem);
  335. //-----------------------------------------------------------------------
  336. // Summary:
  337. //     Call this member to get the count of the items
  338. // Returns:
  339. //     The count of the items in collection.
  340. //-----------------------------------------------------------------------
  341. int GetItemCount() const;
  343. //-----------------------------------------------------------------------
  344. // Summary:
  345. //     Call this member to return the item at the specified index.
  346. // Parameters:
  347. //     nIndex - An integer index.
  348. // Returns:
  349. //     The CXTPControlGalleryItem pointer currently at this index.
  350. //-----------------------------------------------------------------------
  351. CXTPControlGalleryItem* GetItem(int nIndex) const;
  353. //-----------------------------------------------------------------------
  354. // Summary:
  355. //     Call this member to enable/disable clipping items if selection was changed
  356. // Parameters:
  357. //     bClipItems - TRUE to enable clipping; FALSE to disable
  358. // Remarks:
  359. //     By default clipping is enabled
  360. //-----------------------------------------------------------------------
  361. void ClipItems(BOOL bClipItems);
  363. //-----------------------------------------------------------------------
  364. // Summary:
  365. //     This method is called if items was added or removed in collection
  366. //-----------------------------------------------------------------------
  367. void OnItemsChanged();
  369. //-----------------------------------------------------------------------
  370. // Summary:
  371. //     This method is called to draw the item
  372. // Parameters:
  373. //     pDC      - Pointer to valid device context
  374. //     pGallery - Parent gallery of the item
  375. //     pItem    - Item to be drawn
  376. //     rcItem   - Bounding rectangle of the item
  377. //     bEnabled - TRUE to draw item enabled; FALSE - disabled
  378. //     bSelected - TRUE to draw item selected
  379. //     bPressed - TRUE to draw item pressed
  380. //     bChecked - TRUE to draw item checked
  381. //-----------------------------------------------------------------------
  382. virtual BOOL PreDrawItem(CDC* pDC, CXTPControlGallery* pGallery, CXTPControlGalleryItem* pItem, CRect rcItem,
  383. BOOL bEnabled, BOOL bSelected, BOOL bPressed, BOOL bChecked);
  385. private:
  386. void UpdateIndexes(int nStart /*= 0*/);
  388. protected:
  389. CSize m_szItem;                         // Size of the items
  390. CXTPImageManager* m_pImageManager;      // Image manager of items
  391. BOOL m_bClipItems;                      // TRUE to clip items
  392. CXTPControlAction* m_pAction;           // Action of the items
  393. CArray<CXTPControlGalleryItem*, CXTPControlGalleryItem*> m_arrItems;    // Array of items
  395. private:
  396. friend class CXTPControlGalleryItem;
  397. friend class CXTPControlGallery;
  398. friend class CXTPControlGalleryAction;
  401. };
  403. //===========================================================================
  404. // Summary:
  405. //     CXTPControlGallery is a CXTPControlPopup derived class. It represents gallery control of toolbar.
  406. //===========================================================================
  407. class _XTP_EXT_CLASS CXTPControlGallery : public CXTPControlPopup, public CXTPScrollBase
  408. {
  409. DECLARE_XTP_CONTROL(CXTPControlGallery)
  411. public:
  413. //-------------------------------------------------------------------------
  414. // Summary:
  415. //     Structure contains item position description
  416. //-------------------------------------------------------------------------
  417. struct GALLERYITEM_POSITION
  418. {
  419. RECT rcItem;                    // Bounding rectangle of the item
  420. CXTPControlGalleryItem* pItem;  // Item pointer
  421. BOOL bBeginRow;                 // TRUE it item starts new row
  422. };
  425. public:
  426. //-----------------------------------------------------------------------
  427. // Summary:
  428. //     Constructs a CXTPControlGallery object
  429. //-----------------------------------------------------------------------
  430. CXTPControlGallery();
  432. //-----------------------------------------------------------------------
  433. // Summary:
  434. //     Destroys a CXTPControlGallery object, handles cleanup and deallocation
  435. //-----------------------------------------------------------------------
  436. ~CXTPControlGallery();
  438. public:
  439. //-----------------------------------------------------------------------
  440. // Summary:
  441. //     Call this method to set items for gallery
  442. // Parameters:
  443. //     pItems - Pointer to items to be set
  444. //-----------------------------------------------------------------------
  445. void SetItems(CXTPControlGalleryItems* pItems);
  447. //-----------------------------------------------------------------------
  448. // Summary:
  449. //     Call this method to set margins around items
  450. // Parameters:
  451. //     nLeft   - Left margin to be set
  452. //     nTop    - Top margin to be set
  453. //     nRight  - nRight margin to be set
  454. //     nBottom - Bottom margin to be set
  455. //-----------------------------------------------------------------------
  456. void SetItemsMargin(int nLeft, int nTop, int nRight, int nBottom);
  458. //-----------------------------------------------------------------------
  459. // Summary:
  460. //     Call this method to set size of the control
  461. // Parameters:
  462. //     szControl - New control size to be set
  463. //-----------------------------------------------------------------------
  464. void SetControlSize(CSize szControl);
  466. public:
  467. //-----------------------------------------------------------------------
  468. // Summary:
  469. //     Call this method to get count of items in gallery
  470. // Returns:
  471. //     Count of items in the gallery
  472. // See Also: SetItems, GetItem
  473. //-----------------------------------------------------------------------
  474. int GetItemCount() const;
  476. //-----------------------------------------------------------------------
  477. // Summary:
  478. //     Call this method to retrieve item by its index
  479. // Parameters:
  480. //     nIndex - Index of the item to be retrieved
  481. // Returns:
  482. //     Item in specified index; NULL if failed
  483. // See Also: SetItems, GetItemCount
  484. //-----------------------------------------------------------------------
  485. CXTPControlGalleryItem* GetItem(int nIndex) const;
  487. //-----------------------------------------------------------------------
  488. // Summary:
  489. //     Call this method to get items associated with the gallery
  490. // See Also: SetItems
  491. //-----------------------------------------------------------------------
  492. CXTPControlGalleryItems* GetItems() const;
  494. //-----------------------------------------------------------------------
  495. // Summary:
  496. //     Call this method to set selected item in the gallery
  497. // Parameters:
  498. //     nSelected - Item to select
  499. // See Also: GetSelectedItem
  500. //-----------------------------------------------------------------------
  501. void SetSelectedItem(int nSelected);
  503. //-----------------------------------------------------------------------
  504. // Summary:
  505. //     Call this method to get selected item in the gallery
  506. // See Also: SetSelectedItem
  507. //-----------------------------------------------------------------------
  508. int GetSelectedItem() const;
  510. //-----------------------------------------------------------------------
  511. // Summary:
  512. //     Call this method to set checked item identifier for the gallery
  513. // Parameters:
  514. //     nId - Item id
  515. // See Also: GetCheckedItem
  516. //-----------------------------------------------------------------------
  517. void SetCheckedItem(int nId);
  519. //-----------------------------------------------------------------------
  520. // Summary:
  521. //     Call this method to get checked item identifier
  522. // See Also: SetCheckedItem
  523. //-----------------------------------------------------------------------
  524. int GetCheckedItem() const;
  526. //-----------------------------------------------------------------------
  527. // Summary:
  528. //     Determines if there is selection in gallery
  529. // See Also: GetSelectedItem
  530. //-----------------------------------------------------------------------
  531. BOOL IsItemSelected() const;
  533. public:
  534. //-----------------------------------------------------------------------
  535. // Summary:
  536. //     Call this method to draw borders around gallery
  537. // Parameters:
  538. //     bShowBorders - TRUE to show borders around gallery
  539. // See Also: IsShowBorders
  540. //-----------------------------------------------------------------------
  541. void ShowBorders(BOOL bShowBorders);
  543. //-----------------------------------------------------------------------
  544. // Summary:
  545. //     Call this method to determine if borders are visible
  546. // See Also: ShowBorders
  547. //-----------------------------------------------------------------------
  548. BOOL IsShowBorders() const;
  550. //-----------------------------------------------------------------------
  551. // Summary:
  552. //     Call this method to show/hide labels of the gallery
  553. // Parameters:
  554. //     bShowLabels - TRUE to show labels
  555. //-----------------------------------------------------------------------
  556. void ShowLabels(BOOL bShowLabels);
  558. //-----------------------------------------------------------------------
  559. // Summary:
  560. //     Call this method to show/hide scrollbar of the gallery
  561. // Parameters:
  562. //     bShowScrollBar - TRUE to show scrollbar
  563. //-----------------------------------------------------------------------
  564. void ShowScrollBar(BOOL bShowScrollBar);
  566. public:
  567. //-----------------------------------------------------------------------
  568. // Summary:
  569. //     Determines total borders width for gallery
  570. //-----------------------------------------------------------------------
  571. virtual CRect GetBorders() const;
  573. //-----------------------------------------------------------------------
  574. // Summary:
  575. //     Determines bounding rectangle of the item
  576. // Parameters:
  577. //     nIndex - Item index.
  578. //-----------------------------------------------------------------------
  579. CRect GetItemDrawRect(int nIndex);
  581. //-----------------------------------------------------------------------
  582. // Summary:
  583. //     This method determines where a point lies in a specified item.
  584. // Parameters:
  585. //     point - Specifies the point to be tested.
  586. //     lpRect - Retrieves rectangle where item is located. Can be NULL
  587. // Returns:
  588. //     An index of CXTPControlGalleryItem that occupies the specified
  589. //     point or NULL if no control occupies the point.
  590. //-----------------------------------------------------------------------
  591. int HitTestItem(CPoint point, LPRECT lpRect = NULL) const;
  593. //-----------------------------------------------------------------------
  594. // Summary:
  595. //     Determines bounding rectangle of the items
  596. //-----------------------------------------------------------------------
  597. CRect GetItemsRect() const;
  599. //-----------------------------------------------------------------------
  600. // Summary:
  601. //     Redraw items
  602. // Parameters:
  603. //     lpRect - Rectangle to redraw
  604. //     bAnimate - TURE to animate changes
  605. //-----------------------------------------------------------------------
  606. void InvalidateItems(LPCRECT lpRect = NULL, BOOL bAnimate = TRUE);
  608. //-----------------------------------------------------------------------
  609. // Summary:
  610. //     Retrieves CXTPControlGalleryPaintManager pointer to draw gallery
  611. //-----------------------------------------------------------------------
  612. CXTPControlGalleryPaintManager* GetGalleryPaintManager() const;
  614. CXTPScrollBarPaintManager* GetScrollBarPaintManager() const;
  616. //-----------------------------------------------------------------------
  617. // Summary:
  618. //     Call this member to make sure that an item is visible in the gallery.
  619. //     This will scroll the gallery until the item is visible.
  620. // Parameters:
  621. //     nIndex - Item index that should be visible.
  622. //-----------------------------------------------------------------------
  623. void EnsureVisible(int nIndex);
  625. //-----------------------------------------------------------------------
  626. // Summary:
  627. //     Call this method to set scroll position of gallery
  628. // Parameters:
  629. //     nScrollPos - New scrollbar position to be set
  630. // See Also: GetScrollPos
  631. //-----------------------------------------------------------------------
  632. void SetScrollPos(int nScrollPos);
  634. //-----------------------------------------------------------------------
  635. // Summary:
  636. //     Determines position of scroll bar of gallery control
  637. // See Also: SetScrollPos
  638. //-----------------------------------------------------------------------
  639. int GetScrollPos() const;
  641. //-----------------------------------------------------------------------
  642. // Summary:
  643. //     Call this method to scroll gallery for specified top item
  644. // Parameters:
  645. //     nIndex - Item to be scrolled to.
  646. // See Also: SetScrollPos
  647. //-----------------------------------------------------------------------
  648. int SetTopIndex(int nIndex);
  650. //-----------------------------------------------------------------------
  651. // Summary:
  652. //     Call this method to allow user resize gallery
  653. // Parameters:
  654. //     bResizeWidth - Allow change width
  655. //     bResizeHeight - Allow change height
  656. // See Also: IsResizable
  657. //-----------------------------------------------------------------------
  658. void SetResizable(BOOL bResizeWidth = TRUE, BOOL bResizeHeight = TRUE);
  660. //-----------------------------------------------------------------------
  661. // Summary:
  662. //     Determines if control can be resized by user
  663. // See Also: SetResizable
  664. //-----------------------------------------------------------------------
  665. BOOL IsResizable() const;
  667. //-----------------------------------------------------------------------
  668. // Summary:
  669. //     This method is called when selection was changed by user
  670. //-----------------------------------------------------------------------
  671. virtual void OnSelectedItemChanged();
  673. public:
  674. //{{AFX_CODEJOCK_PRIVATE
  675. BOOL HasBottomSeparator() const;
  676. long GetNext(long nIndex, int nDirection) const;
  677. long GetNextInRow(long nIndex, int nDirection) const;
  678. long GetNextInColumn(long nIndex, int nDirection) const;
  679. long GetNextInPage(long nIndex, int nDirection) const;
  680. int FindItem(int nStartAfter, LPCTSTR lpszItem, BOOL bExact) const;
  681. CString GetItemCaption(int nIndex);
  682. BOOL IsScrollButtonEnabled(int ht);
  683. BOOL IsScrollBarEnabled() const;
  684. BOOL IsShowAsButton() const;
  685. void HideSelection();
  687. //}}AFX_CODEJOCK_PRIVATE
  689. protected:
  691. //-------------------------------------------------------------------------
  692. // Summary:
  693. //     This method is called to set position of all items
  694. //-------------------------------------------------------------------------
  695. void Reposition();
  697. //-----------------------------------------------------------------------
  698. // Summary:
  699. //      This method is called to draw all items
  700. // Parameters:
  701. //      pDC - Pointer to device context to draw
  702. //-----------------------------------------------------------------------
  703. void DrawItems(CDC* pDC);
  705. protected:
  707. //-----------------------------------------------------------------------
  708. // Summary:
  709. //     This method is called to copy the control.
  710. // Parameters:
  711. //     pControl - Points to a source CXTPControl object
  712. //     bRecursive - TRUE to copy recursively.
  713. //-----------------------------------------------------------------------
  714. void Copy(CXTPControl* pControl, BOOL bRecursive = FALSE);
  716. //-----------------------------------------------------------------------
  717. // Summary:
  718. //     Reads or writes this object from or to an archive.
  719. // Parameters:
  720. //     pPX - A CXTPPropExchange object to serialize to or from.
  721. //----------------------------------------------------------------------
  722. void DoPropExchange(CXTPPropExchange* pPX);
  724. protected:
  725. //{{AFX_CODEJOCK_PRIVATE
  726. virtual CSize GetSize(CDC* pDC);
  727. virtual void Draw(CDC* pDC);
  729. virtual void OnMouseMove(CPoint point);
  731. virtual void OnClick(BOOL bKeyboard = FALSE, CPoint pt = CPoint(0, 0));
  732. virtual void OnLButtonUp(CPoint point);
  733. virtual BOOL OnSetSelected(int bSelected);
  734. virtual void SetRect(CRect rcControl);
  735. void DoScroll(int cmd, int pos);
  736. void GetScrollInfo(SCROLLINFO* pSI);
  737. void PerformMouseMove(CPoint point);
  738. void PerformMouseDown(CPoint point);
  739. void PerformMouseUp(CPoint point);
  740. void FillControl(CDC* pDC, CRect rcControl);
  741. virtual void SetAction(CXTPControlAction* pAction);
  742. virtual int GetCustomizeMinWidth() const;
  743. virtual int GetCustomizeMinHeight() const;
  744. virtual BOOL IsCustomizeResizeAllow() const;
  746. protected:
  747. void DrawScrollBar(CDC* pDC);
  748. CRect GetScrollBarRect();
  749. void CalcScrollBarInfo(LPRECT lprc, SCROLLBARPOSINFO* pSBInfo, SCROLLINFO* pSI);
  751. BOOL OnHookMouseWheel(UINT nFlags, short zDelta, CPoint pt);
  752. BOOL IsFocused() const;
  753. BOOL OnHookKeyDown(UINT nChar, LPARAM lParam);
  754. virtual void OnScrollChanged();
  755. virtual INT_PTR OnToolHitTest(CPoint point, TOOLINFO* pTI) const;
  756. void OnExecute();
  757. BOOL OnSetPopup(BOOL bPopup);
  758. void OnMouseHover();
  760. protected:
  761. CWnd* GetParentWindow() const;
  762. virtual void AdjustExcludeRect(CRect& rc, BOOL /*bVertical*/);
  763. virtual void RedrawScrollBar();
  764. void DoAnimate();
  765. void StartAnimation(int nScrollPos);
  768. //}}AFX_CODEJOCK_PRIVATE
  770. protected:
  771. //{{AFX_CODEJOCK_PRIVATE
  772. virtual HRESULT GetAccessibleChildCount(long* pcountChildren);
  773. virtual HRESULT GetAccessibleChild(VARIANT varChild, IDispatch** ppdispChild);
  774. virtual HRESULT GetAccessibleName(VARIANT varChild, BSTR* pszName);
  775. virtual HRESULT GetAccessibleRole(VARIANT varChild, VARIANT* pvarRole);
  776. virtual HRESULT AccessibleLocation(long *pxLeft, long *pyTop, long *pcxWidth, long* pcyHeight, VARIANT varChild);
  777. virtual HRESULT AccessibleHitTest(long xLeft, long yTop, VARIANT* pvarChild);
  778. virtual HRESULT GetAccessibleState(VARIANT varChild, VARIANT* pvarState);
  779. virtual HRESULT GetAccessibleDefaultAction(VARIANT varChild, BSTR* pszDefaultAction);
  780. virtual HRESULT AccessibleDoDefaultAction(VARIANT varChild);
  781. virtual HRESULT AccessibleSelect(long flagsSelect, VARIANT varChild);
  782. //}}AFX_CODEJOCK_PRIVATE
  785. protected:
  787. int m_nChecked;             // Checked id
  788. int m_nSelected;            // Index of Selected item
  789. BOOL m_bHideSelection;      // TRUE to hide selection
  790. BOOL m_bPressed;            // TRUE if item is pressed
  791. CPoint m_ptPressed;         // Position of pressed item
  792. int m_nScrollPos;           // Scroll position
  793. int m_nScrollPosTarget;     // Scroll position
  794. double m_dAnimationStep;
  796. BOOL m_bKeyboardSelected;   // TRUE if item was selected using keyboard
  798. int m_nTotalHeight;         // Total height of items
  800. BOOL m_bShowLabels;         // TRUE to show labels
  802. BOOL m_bShowScrollBar;      // TRUE to show scrollbars
  803. BOOL m_bShowBorders;        // TRUE to show borders
  804. CRect m_rcMargin;           // Margins of gallery items
  805. BOOL m_bPreview;            // TRUE if control in preview mode
  806. int m_nResizable;
  808. CArray<GALLERYITEM_POSITION, GALLERYITEM_POSITION&> m_arrRects; // bounding rectangles
  810. friend class CXTPControlGalleryItems;
  811. };
  814. //===========================================================================
  815. // Summary:
  816. //     CXTPControlGalleryPaintManager is standalone class used to draw CXTPControlGallery object
  817. //===========================================================================
  818. class _XTP_EXT_CLASS CXTPControlGalleryPaintManager : public CXTPScrollBarPaintManager
  819. {
  820. public:
  821. //-----------------------------------------------------------------------
  822. // Summary:
  823. //     Constructs a CXTPControlGalleryPaintManager object
  824. // Parameters:
  825. //     pPaintManager - PaintManager of commandbars
  826. //-----------------------------------------------------------------------
  827. CXTPControlGalleryPaintManager(CXTPPaintManager* pPaintManager);
  829. public:
  831. //-----------------------------------------------------------------------
  832. // Summary:
  833. //     This method is called to draw label control
  834. // Parameters:
  835. //     pDC - Pointer to device context
  836. //     pLabel - Label item
  837. //     rc - Bounding rectangle of the label
  838. //-----------------------------------------------------------------------
  839. virtual void DrawLabel(CDC* pDC, CXTPControlGalleryItem* pLabel, CRect rc);
  841. //-----------------------------------------------------------------------
  842. // Summary:
  843. //     This method is called to draw background of the gallery
  844. // Parameters:
  845. //      pDC - Pointer to device context
  846. //      pGallery - CXTPControlGallery object to draw
  847. //      rc - Bounding rectangle of gallery object
  848. //-----------------------------------------------------------------------
  849. virtual void FillControl(CDC* pDC, CXTPControlGallery* pGallery, CRect rc);
  851. //-----------------------------------------------------------------------
  852. // Summary:
  853. //     This method is called to draw scrollbar of the gallery
  854. // Parameters:
  855. //     pDC - Pointer to device context
  856. //     pScrollBar - ScrollBar to draw
  857. //-----------------------------------------------------------------------
  858. virtual void DrawScrollBar(CDC* pDC, CXTPScrollBase* pScrollBar);
  860. //-----------------------------------------------------------------------
  861. // Summary:
  862. //     This method called to draw scrollbar of inplace gallery
  863. // Parameters:
  864. //     pDC - Pointer to device context
  865. //     pGallery - CXTPControlGallery object to draw
  866. // See Also: DrawScrollBar
  867. //-----------------------------------------------------------------------
  868. virtual void DrawPopupScrollBar(CDC* pDC, CXTPControlGallery* pGallery);
  870. //-------------------------------------------------------------------------
  871. // Summary:
  872. //     Recalculates gallery metrics
  873. //-------------------------------------------------------------------------
  874. virtual void RefreshMetrics();
  876. public:
  877. int m_cyPopupUp;            // Height of Up arrow of in place scrollbar
  878. int m_cyPopupDown;          // Height of Down arrow of in place scrollbar
  879. int m_cxPopup;              // Width of arrows of in place scrollbar
  880. };
  882. class _XTP_EXT_CLASS CXTPControlComboBoxGalleryPopupBar : public CXTPControlComboBoxPopupBar
  883. {
  884. DECLARE_XTP_COMMANDBAR(CXTPControlComboBoxGalleryPopupBar)
  886. protected:
  887. CXTPControlComboBoxGalleryPopupBar();
  889. public:
  890. //-----------------------------------------------------------------------
  891. // Summary:
  892. //     Creates a popup bar object.
  893. // Parameters:
  894. //     pCommandBars - Points to a CXTPCommandBars object
  895. // Returns:
  896. //     A pointer to a CXTPControlComboBoxGalleryPopupBar object
  897. //-----------------------------------------------------------------------
  898. static CXTPControlComboBoxGalleryPopupBar* AFX_CDECL CreateComboBoxGalleryPopupBar(CXTPCommandBars* pCommandBars);
  900. protected:
  901. //{{AFX_CODEJOCK_PRIVATE
  902. DECLARE_MESSAGE_MAP()
  904. BOOL SetTrackingMode(int bMode, BOOL bSelectFirst, BOOL bKeyboard);
  905. BOOL OnHookKeyDown(UINT nChar, LPARAM lParam);
  907. CXTPControlGallery* GetGalleryItem() const;
  909. //{{AFX_VIRUAL(CXTPControlComboBoxList)
  910. virtual int GetCurSel() const {
  911. return GetGalleryItem()->GetSelectedItem();
  912. }
  913. virtual int FindString(int nStartAfter, LPCTSTR lpszItem) const {
  914. return GetGalleryItem()->FindItem(nStartAfter, lpszItem, FALSE);
  915. }
  916. virtual int FindStringExact(int nIndexStart, LPCTSTR lpsz) const {
  917. return GetGalleryItem()->FindItem(nIndexStart, lpsz, TRUE);
  918. }
  919. virtual int SetTopIndex(int nIndex) {
  920. return GetGalleryItem()->SetTopIndex(nIndex);
  921. }
  922. virtual void SetCurSel(int nIndex) {
  923. GetGalleryItem()->SetSelectedItem(nIndex);
  924. }
  925. virtual void GetText(int nIndex, CString& rString) const {
  926. rString = GetGalleryItem()->GetItemCaption(nIndex);
  927. }
  928. //}}AFX_VIRUAL
  930. //{{AFX_MSG(CXTPControlComboBoxList)
  931. void OnLButtonUp(UINT nFlags, CPoint point);
  932. //}}AFX_MSG
  933. //}}AFX_CODEJOCK_PRIVATE
  934. };
  938. AFX_INLINE BOOL CXTPControlGalleryItem::IsLabel() const {
  939. return m_bLabel;
  940. }
  941. AFX_INLINE void CXTPControlGalleryItem::SetCaption(LPCTSTR lpszCaption) {
  942. m_strCaption = lpszCaption;
  943. }
  944. AFX_INLINE void CXTPControlGalleryItem::SetToolTip(LPCTSTR lpszToolTip) {
  945. m_strToolTip = lpszToolTip;
  946. }
  947. AFX_INLINE CString CXTPControlGalleryItem::GetToolTip() const {
  948. return m_strToolTip;
  949. }
  950. AFX_INLINE CString CXTPControlGalleryItem::GetCaption() const {
  951. return m_strCaption;
  952. }
  953. AFX_INLINE void CXTPControlGalleryItem::SetDescription(LPCTSTR lpszDescription) {
  954. m_strDescriptionText = lpszDescription;
  955. }
  956. AFX_INLINE CString CXTPControlGalleryItem::GetDescription() const {
  957. return m_strDescriptionText;
  958. }
  959. AFX_INLINE void CXTPControlGalleryItem::SetID(int nId) {
  960. m_nId = nId;
  961. }
  962. AFX_INLINE int CXTPControlGalleryItem::GetID() const {
  963. return m_nId;
  964. }
  965. AFX_INLINE CXTPImageManager* CXTPControlGalleryItems::GetImageManager() const {
  966. return m_pImageManager;
  967. }
  968. AFX_INLINE CSize CXTPControlGalleryItems::GetItemSize() const {
  969. return m_szItem;
  970. }
  971. AFX_INLINE void CXTPControlGalleryItems::SetItemSize(CSize szItem) {
  972. m_szItem = szItem;
  973. }
  974. AFX_INLINE void CXTPControlGalleryItems::ClipItems(BOOL bClipItems) {
  975. m_bClipItems = bClipItems;
  976. }
  978. AFX_INLINE void CXTPControlGalleryItem::SetData(DWORD_PTR dwData) {
  979. m_dwData = dwData;
  980. }
  981. AFX_INLINE DWORD_PTR CXTPControlGalleryItem::GetData() const {
  982. return m_dwData;
  983. }
  985. AFX_INLINE void CXTPControlGallery::SetControlSize(CSize szControl) {
  986. m_nWidth = szControl.cx;
  987. m_nHeight = szControl.cy;
  988. }
  989. AFX_INLINE BOOL CXTPControlGallery::IsShowBorders() const {
  990. return m_bShowBorders;
  991. }
  992. AFX_INLINE void CXTPControlGallery::ShowLabels(BOOL bShowLabels) {
  993. m_bShowLabels = bShowLabels;
  994. }
  995. AFX_INLINE void CXTPControlGallery::ShowScrollBar(BOOL bShowScrollBar) {
  996. m_bShowScrollBar = bShowScrollBar;
  997. }
  998. AFX_INLINE void CXTPControlGallery::ShowBorders(BOOL bShowBorders) {
  999. m_bShowBorders = bShowBorders;
  1000. }
  1001. AFX_INLINE BOOL CXTPControlGallery::IsItemSelected() const {
  1002. return !m_bHideSelection && GetSelectedItem() != -1;
  1003. }
  1004. AFX_INLINE BOOL CXTPControlGallery::IsResizable() const {
  1005. return !IsShowAsButton() && GetItems() ? m_nResizable : FALSE;
  1006. }
  1007. AFX_INLINE BOOL CXTPControlGallery::IsCustomizeResizeAllow() const {
  1008. return IsResizable();
  1009. }
  1011. #endif // #if !defined(__XTPCONTROLGALLERY_H__)