对话框与窗口

开发平台：
Visual C++

XTPTaskPanelItems.h：源码内容
							// XTPTaskPanelItems.h interface for the CXTPTaskPanelItems class.
//
// This file is a part of the XTREME TASKPANEL MFC class library.
// (c)1998-2008 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(__XTPTASKPANELITEMS_H__)
#define __XTPTASKPANELITEMS_H__
//}}AFX_CODEJOCK_PRIVATE
#if _MSC_VER > 1000
#pragma once
#endif // _MSC_VER > 1000
class CXTPTaskPanelGroup;
class CXTPTaskPanelItem;
class CXTPTaskPanel;
class CXTPPropExchange;
//===========================================================================
// Summary:
//     CXTPTaskPanelItems is a CCmdTarget derived class. It is used as collection of
//     CXTPTaskPanelItem classes.
//===========================================================================
class _XTP_EXT_CLASS CXTPTaskPanelItems : public CXTPCmdTarget
{
	DECLARE_DYNCREATE(CXTPTaskPanelItems)
public:
	//-----------------------------------------------------------------------
	// Summary:
	//     Constructs a CXTPTaskPanelItems object.
	// Parameters:
	//     pPanel - Pointer to the task panel to add the items to.
	//-----------------------------------------------------------------------
	CXTPTaskPanelItems(CXTPTaskPanel* pPanel = NULL);
	//-----------------------------------------------------------------------
	// Summary:
	//     Destroys a CXTPTaskPanelItems object, handles cleanup and deallocation.
	//-----------------------------------------------------------------------
	virtual ~CXTPTaskPanelItems();
public:
	//-----------------------------------------------------------------------
	// Summary:
	//     Call this member to add a new item to the collection.
	// Parameters:
	//     pItem - Points to a CXTPTaskPanelItem to be added.
	//     nID - Identifier of the item.
	// Returns:
	//     A pointer to a CXTPTaskPanelItem object added.
	//-----------------------------------------------------------------------
	CXTPTaskPanelItem* Add(CXTPTaskPanelItem* pItem, UINT nID);
	//-----------------------------------------------------------------------
	// Summary:
	//     Call this member to insert an item at a specific position
	//     within the collection of items.
	// Parameters:
	//     nIndex - Position in collectionarray to insert the new item.
	//     pItem  - Pointer to a valid task panel itemgroup.
	// Remarks:
	//     To move an item, use the MOVE function.
	// Returns:
	//     A pointer to the newly inserted item.
	//-----------------------------------------------------------------------
	CXTPTaskPanelItem* InsertAt(int nIndex, CXTPTaskPanelItem* pItem);
	//-----------------------------------------------------------------------
	// Summary:
	//     Call this member to return the item at the specified index
	// Parameters:
	//     nIndex - Specifies the zero-based index of the item to retrieve.
	// Returns:
	//     A pointer to a CXTPTaskPanelItem object.
	//-----------------------------------------------------------------------
	CXTPTaskPanelItem* GetAt(int nIndex) const;
	//-----------------------------------------------------------------------
	// Summary:
	//     Call this method to remove all items in the collection.
	// Parameters:
	//     bReposition - TRUE to reposition items after remove.
	// See Also: CXTPTaskPanel::Reposition
	//-----------------------------------------------------------------------
	void Clear(BOOL bReposition = TRUE);
	//-----------------------------------------------------------------------
	// Summary:
	//     Call this member function to find an item by its ID
	// Parameters:
	//     nID - Identifier of item to be found.
	// Returns:
	//     A pointer to item if successful; otherwise returns NULL.
	//-----------------------------------------------------------------------
	CXTPTaskPanelItem* Find(UINT nID) const;
	//-----------------------------------------------------------------------
	// Summary:
	//     Call this method to remove the specified item.
	// Parameters:
	//     pItem - Item to be removed.
	//-----------------------------------------------------------------------
	void Remove(CXTPTaskPanelItem* pItem);
	//-----------------------------------------------------------------------
	// Summary:
	//     Call this method to remove the specified item by its index.
	// Parameters:
	//     nIndex - Specifies the zero-based index of the item to remove.
	//-----------------------------------------------------------------------
	void RemoveAt(int nIndex);
	//-----------------------------------------------------------------------
	// Summary:
	//     Call this member to get index of item in the collection of items.
	// Parameters:
	//     pItem - Item to be tested
	// Returns:
	//     Index of item in collection.
	//-----------------------------------------------------------------------
	int GetIndex(const CXTPTaskPanelItem* pItem) const;
	//-----------------------------------------------------------------------
	// Summary:
	//     Call this member to get count of items
	// Returns:
	//     Number of items.
	//-----------------------------------------------------------------------
	int GetCount() const;
	//-----------------------------------------------------------------------
	// Summary:
	//     Call this member function to get a pointer to the owner
	// Returns:
	//     A pointer to a CCmdTarget object owned by this collection
	//-----------------------------------------------------------------------
	CCmdTarget* GetOwner() const;
	//-----------------------------------------------------------------------
	// Summary:
	//     Call this member to move a GroupItem to the specified location
	//     within the collection of items.
	// Parameters:
	//     pItem  - GroupItem to be moved.
	//     nIndex - New position of the item within the collection of items.
	// Remarks:
	//     A GroupItem will be displayed in the order that they are added
	//     to the collection of items.  They are stored in a zero based array
	//     of items.  The items position within the array can be changed by
	//     specifying an index to move the item to.
	//-----------------------------------------------------------------------
	void Move(CXTPTaskPanelItem* pItem, int nIndex);
	//-----------------------------------------------------------------------
	// Summary:
	//     Reads or writes this object from or to an archive.
	// Parameters:
	//     pPX - A CXTPPropExchange object to serialize to or from.
	//-----------------------------------------------------------------------
	void DoPropExchange(CXTPPropExchange* pPX);
	//-----------------------------------------------------------------------
	// Summary:
	//     Retrieves default runtime class of items in collection.
	//-----------------------------------------------------------------------
	virtual CRuntimeClass* GetDefaultItemClass() const;
	//-----------------------------------------------------------------------
	// Summary:
	//     This method finds next visible item index in specified direction.
	// Parameters:
	//     nIndex - Index of the item to begin the searching with.
	//     nDirection - Direction to find (1 to forward, -1 to backward)
	// Returns:
	//     The index of the next visible item if successful, or -1 otherwise.
	// See Also: GetFirstVisibleItem, GetLastVisibleItem
	//-----------------------------------------------------------------------
	int GetNextVisibleIndex(int nIndex, int nDirection) const;
	//-----------------------------------------------------------------------
	// Summary:
	//     Retrieves first visible item.
	// Returns:
	//     Pointer to first visible item in collection
	// See Also: GetLastVisibleItem, GetNextVisibleIndex
	//-----------------------------------------------------------------------
	CXTPTaskPanelItem* GetFirstVisibleItem() const;
	//-----------------------------------------------------------------------
	// Summary:
	//     Retrieves last visible item.
	// Returns:
	//     Pointer to last visible item in collection
	// See Also: GetFirstVisibleItem, GetNextVisibleIndex
	//-----------------------------------------------------------------------
	CXTPTaskPanelItem* GetLastVisibleItem() const;
protected:
	CXTPTaskPanel* m_pPanel;                                    // Parent TaskPanel control.
	CArray<CXTPTaskPanelItem*, CXTPTaskPanelItem*> m_arrItems;  // Array of items.
	CCmdTarget* m_pOwner;                                       // Owner of items. Can be TaskPanel or Group.
	friend class CXTPTaskPanel;
	friend class CXTPTaskPanelGroup;
};
//===========================================================================
// Summary:
//     CXTPTaskPanelGroupItems is a CXTPTaskPanelItems derived class.
//     It is used as collection of items in the group.
//===========================================================================
class _XTP_EXT_CLASS CXTPTaskPanelGroupItems : public CXTPTaskPanelItems
{
public:
	//-----------------------------------------------------------------------
	// Summary:
	//     Constructs CXTPTaskPanelGroupItems object
	// Parameters:
	//     pPanel - Points to a CXTPTaskPanel object
	//-----------------------------------------------------------------------
	CXTPTaskPanelGroupItems(CXTPTaskPanel* pPanel);
	//-----------------------------------------------------------------------
	// Summary:
	//     Retrieves default runtime class of items in collection.
	//-----------------------------------------------------------------------
	virtual CRuntimeClass* GetDefaultItemClass() const;
};
//===========================================================================
// Summary:
//     CXTPTaskPanelGroups is a CXTPTaskPanelItems derived class.
//     It is used as a collection of groups in the control.
//===========================================================================
class _XTP_EXT_CLASS CXTPTaskPanelGroups : public CXTPTaskPanelItems
{
public:
	//-----------------------------------------------------------------------
	// Summary:
	//     Constructs a CXTPTaskPanelGroups object
	// Parameters:
	//     pPanel - Points to a CXTPTaskPanel object
	//-----------------------------------------------------------------------
	CXTPTaskPanelGroups(CXTPTaskPanel* pPanel);
	//-----------------------------------------------------------------------
	// Summary:
	//     Retrieves default runtime class of items in collection.
	//-----------------------------------------------------------------------
	virtual CRuntimeClass* GetDefaultItemClass() const;
};
AFX_INLINE int CXTPTaskPanelItems::GetCount() const
{
	return (int)m_arrItems.GetSize();
}
AFX_INLINE CXTPTaskPanelItem* CXTPTaskPanelItems::GetAt(int nIndex) const
{
	return nIndex >= 0 && nIndex < m_arrItems.GetSize() ? m_arrItems.GetAt(nIndex) : NULL;
}
AFX_INLINE CCmdTarget* CXTPTaskPanelItems::GetOwner() const
{
	return m_pOwner;
}
#endif // !defined(__XTPTASKPANELITEMS_H__)

						