// XTPCustomizeSheet.h : interface for the CXTPCustomizeSheet class.
//
// This file is a part of the XTREME COMMANDBARS MFC class library.
// (c)1998-2012 Codejock Software, All Rights Reserved.
//
// THIS SOURCE FILE IS THE PROPERTY OF CODEJOCK SOFTWARE AND IS NOT TO BE
// RE-DISTRIBUTED BY ANY MEANS WHATSOEVER WITHOUT THE EXPRESSED WRITTEN
// CONSENT OF CODEJOCK SOFTWARE.
//
// THIS SOURCE CODE CAN ONLY BE USED UNDER THE TERMS AND CONDITIONS OUTLINED
// IN THE XTREME TOOLKIT PRO LICENSE AGREEMENT. CODEJOCK SOFTWARE GRANTS TO
// YOU (ONE SOFTWARE DEVELOPER) THE LIMITED RIGHT TO USE THIS SOFTWARE ON A
// SINGLE COMPUTER.
//
// CONTACT INFORMATION:
// support@codejock.com
// http://www.codejock.com
//
/////////////////////////////////////////////////////////////////////////////
//{{AFX_CODEJOCK_PRIVATE
#if !defined(__XTPCUSTOMIZESHEET_H__)
#define __XTPCUSTOMIZESHEET_H__
//}}AFX_CODEJOCK_PRIVATE
#if _MSC_VER > 1000
#pragma once
#endif // _MSC_VER > 1000
class CXTPCommandBars;
class CXTPCustomizeToolbarsPage;
class CXTPCustomizeCommandsPage;
class CXTPImageManager;
class CXTPPropertyPage;
class CXTPPopupBar;
class CXTPControl;
//===========================================================================
// Summary:
// CXTPCustomizeSheet is a CPropertySheet derived class. It represents
// the Customize dialog.
//===========================================================================
class _XTP_EXT_CLASS CXTPCustomizeSheet : public CXTPPropertySheet
{
public:
//-----------------------------------------------------------------------
// Summary:
// Constructs a CXTPCustomizeSheet object
// Parameters:
// pCommandBars - Points to a CXTPCommandBars object
// iSelectPage - Page initially selected.
//-----------------------------------------------------------------------
CXTPCustomizeSheet(CXTPCommandBars* pCommandBars, UINT iSelectPage = 0);
//-----------------------------------------------------------------------
// Summary:
// Destroys a CXTPCustomizeSheet object, handles cleanup and deallocation.
//-----------------------------------------------------------------------
virtual ~CXTPCustomizeSheet();
public:
//-----------------------------------------------------------------------
// Summary:
// Call this member to get a pointer to the context menu that
// is displayed in customization mode when a user right-clicks
// on a control.
// Returns:
// Retrieves the context menu.
//-----------------------------------------------------------------------
CXTPPopupBar* GetContextMenu() const;
//-----------------------------------------------------------------------
// Summary:
// Retrieves collection of custom icons that can be selected for
// a control during customization mode. Custom icons are displayed
// in the "Change Button Image" popup of the context menu that is
// displayed when a user right-clicks on a control.
// Remarks:
// Icons must be numbered from 1. When adding icons, the numbering
// must start with 1 and increment by 1 for each icon added. So the
// numbering would look like this: 1, 2, 3, 4, ...N.
//
// The toolkit provide 42 "built-in" icons that you can choose from
// and they are automatically displayed in the "Change Button Icon"
// popup menu if you do not remove them. If you do not remove the
// "built-in" icons that are provided with the toolkit then you should
// start your numbering at 43. If you start at 1 and you did not
// remove the "bulilt-in" icons, then you will overwrite some of
// the "built-in" icons. So you would number your icons
// 43, 44, 45, ...N. So you could even keep some of the "built-in"
// icons and overwrite the ones you don't need with your own
// custom icons.
//-----------------------------------------------------------------------
CXTPImageManager* GetCustomIcons() const;
//-----------------------------------------------------------------------
// Input: lpszText - Text in message box.
// nType - Specifies the contents and behavior of the dialog box.
// Summary: Displays a message box.
// Returns: If the function succeeds, the return value specified the
// button that was selected.
//-----------------------------------------------------------------------
int MessageBox(LPCTSTR lpszText, UINT nType = MB_OK);
//-----------------------------------------------------------------------
// Summary:
// Call this member to retrieve the current customized control.
// Returns:
// A pointer to a CXTPControl object.
//-----------------------------------------------------------------------
CXTPControl* GetDragControl() const;
public:
//-----------------------------------------------------------------------
// Summary:
// Returns the Commands PropertyPage
// Returns:
// A pointer to a CXTPCustomizeCommandsPage object
//-----------------------------------------------------------------------
CXTPCustomizeCommandsPage* GetCommandsPage() const;
//-----------------------------------------------------------------------
// Summary:
// Returns the Toolbars PropertyPage
// Returns:
// A pointer to a CXTPCustomizeCommandsPage object
//-----------------------------------------------------------------------
CXTPCustomizeToolbarsPage* GetToolbarsPage() const;
//-----------------------------------------------------------------------
// Summary:
// Returns the parent Command Bars class
// Returns:
// A pointer to a CXTPCommandBars object
//-----------------------------------------------------------------------
CXTPCommandBars* GetCommandBars() const;
//-----------------------------------------------------------------------
// Summary:
// Call this method to show customize dialog.
//-----------------------------------------------------------------------
INT_PTR DoModal();
//-----------------------------------------------------------------------
// Summary:
// This method shows the context menu for toolbars
// Parameters:
// point - Position of the menu to show
//-----------------------------------------------------------------------
void ContextMenu(CPoint point);
//-----------------------------------------------------------------------
// Summary:
// Adds the supplied page with the rightmost tab in the property sheet.
// Parameters:
// pPage - Points to the page to be added to the property sheet. Cannot be NULL.
//-----------------------------------------------------------------------
void AddPage(CXTPPropertyPage* pPage, int nIndex = -1);
protected:
//{{AFX_CODEJOCK_PRIVATE
DECLARE_MESSAGE_MAP()
//{{AFX_VIRTUAL(CXTPCustomizeSheet)
BOOL OnInitDialog();
BOOL PreTranslateMessage(MSG* pMsg);
BOOL OnCmdMsg(UINT nID, int nCode, void* pExtra, AFX_CMDHANDLERINFO* pHandlerInfo);
//}}AFX_VIRTUAL
//{{AFX_MSG(CXTPCustomizeSheet)
afx_msg void OnCustomizeDefaultStyle();
afx_msg void OnCustomizeImageAndText();
afx_msg void OnCustomizeTextOnly();
afx_msg void OnCustomizeBeginGroup();
afx_msg void OnCustomizeDelete();
afx_msg void OnCustomizeCopyImage();
afx_msg void OnCustomizePasteImage();
afx_msg void OnCustomizeResetImage();
afx_msg void OnCustomizeEditImage();
afx_msg void OnCustomizeReset();
afx_msg LRESULT OnCustomizeName(WPARAM wParam, LPARAM lParam);
afx_msg void OnUpdateCustomizeDefaultStyle(CCmdUI* pCmdUI);
afx_msg void OnUpdateCustomizeImageAndText(CCmdUI* pCmdUI);
afx_msg void OnUpdateCustomizeTextOnly(CCmdUI* pCmdUI);
afx_msg void OnUpdateCustomizeBeginGroup(CCmdUI* pCmdUI);
afx_msg void OnUpdateCustomizeName(CCmdUI* pCmdUI);
afx_msg void OnUpdateCustomizeCopyImage(CCmdUI* pCmdUI);
afx_msg void OnUpdateCustomizePasteImage(CCmdUI* pCmdUI);
afx_msg void OnUpdateCustomizeResetImage(CCmdUI* pCmdUI);
afx_msg void OnUpdateCustomizeReset(CCmdUI* pCmdUI);
afx_msg void OnUpdateCustomizeEditImage(CCmdUI* pCmdUI);
afx_msg void OnSysKeyDown(UINT nChar, UINT nRepCnt, UINT nFlags);
afx_msg void OnInitCommandsPopup(CXTPPopupBar* pPopupBar);
afx_msg void OnGrabFocus();
//}}AFX_MSG
//}}AFX_CODEJOCK_PRIVATE
private:
BOOL FilterMouse(WPARAM wParam, LPARAM lParam);
BOOL FilterKey(WPARAM wParam, LPARAM lParam);
BOOL FilterMessage(WPARAM wParam, LPARAM lParam);
void CreateContextMenu();
BOOL IsAllowChangeStyle(CXTPControl* pControl) const;
virtual BOOL CreateClient();
public:
BOOL m_bHookMainFrame;
protected:
CXTPCustomizeToolbarsPage* m_pPageToolBars; // Toolbar page.
CXTPCustomizeCommandsPage* m_pPageCommands; // Commands page.
CWnd* m_pWndParent; // Parent window.
CXTPCommandBars* m_pCommandBars; // Customized comamndBars.
CXTPPopupBar* m_pContextMenu; // Context menu that is displayed in customization mode when a
// user right-clicks on a control.
CXTPImageManager* m_pCustomIcons; // Icons displayed in the "Change Button Image" popup of the
// context menu that is displayed when a user right-clicks on a control.
private:
DECLARE_DYNAMIC(CXTPCustomizeSheet)
class CCustomizeButton;
class CCustomizeEdit;
};
/////////////////////////////////////////////////////////////////////////////
AFX_INLINE CXTPCustomizeCommandsPage* CXTPCustomizeSheet::GetCommandsPage() const {
return m_pPageCommands;
}
AFX_INLINE CXTPCustomizeToolbarsPage* CXTPCustomizeSheet::GetToolbarsPage() const {
return m_pPageToolBars;
}
AFX_INLINE CXTPCommandBars* CXTPCustomizeSheet::GetCommandBars() const {
return m_pCommandBars;
}
AFX_INLINE CXTPPopupBar* CXTPCustomizeSheet::GetContextMenu() const {
return m_pContextMenu;
}
AFX_INLINE CXTPImageManager* CXTPCustomizeSheet::GetCustomIcons() const {
return m_pCustomIcons;
}
#endif // #if !defined(__XTPCUSTOMIZESHEET_H__)