448 lines
12 KiB
C++
448 lines
12 KiB
C++
|
/////////////////////////////////////////////////////////////////////////////
|
||
|
|
//
|
||
|
|
// Copyright (c) 1996-2000 Microsoft Corporation
|
||
|
|
//
|
||
|
|
// Module Name:
|
||
|
|
// LCPrPage.cpp
|
||
|
|
//
|
||
|
|
// Abstract:
|
||
|
|
// Implementation of the CListCtrlPairPage dialog template class.
|
||
|
|
//
|
||
|
|
// Author:
|
||
|
|
// David Potter (davidp) August 12, 1996
|
||
|
|
//
|
||
|
|
// Revision History:
|
||
|
|
//
|
||
|
|
// Notes:
|
||
|
|
//
|
||
|
|
/////////////////////////////////////////////////////////////////////////////
|
||
|
|
|
||
|
|
#include "stdafx.h"
|
||
|
|
#include "LCPrPage.h"
|
||
|
|
#include "OLCPair.h"
|
||
|
|
#include "HelpData.h" // for g_rghelpmap*
|
||
|
|
|
||
|
|
#ifdef _DEBUG
|
||
|
|
#define new DEBUG_NEW
|
||
|
|
#undef THIS_FILE
|
||
|
|
static char THIS_FILE[] = __FILE__;
|
||
|
|
#endif
|
||
|
|
|
||
|
|
/////////////////////////////////////////////////////////////////////////////
|
||
|
|
// CListCtrlPairPage
|
||
|
|
/////////////////////////////////////////////////////////////////////////////
|
||
|
|
|
||
|
|
IMPLEMENT_DYNCREATE(CListCtrlPairPage, CBasePropertyPage)
|
||
|
|
|
||
|
|
/////////////////////////////////////////////////////////////////////////////
|
||
|
|
// Message Maps
|
||
|
|
|
||
|
|
BEGIN_MESSAGE_MAP(CListCtrlPairPage, CBasePropertyPage)
|
||
|
|
//{{AFX_MSG_MAP(CListCtrlPairPage)
|
||
|
|
ON_WM_CONTEXTMENU()
|
||
|
|
//}}AFX_MSG_MAP
|
||
|
|
END_MESSAGE_MAP()
|
||
|
|
|
||
|
|
/////////////////////////////////////////////////////////////////////////////
|
||
|
|
//++
|
||
|
|
//
|
||
|
|
// CListCtrlPairPage::CListCtrlPairPage
|
||
|
|
//
|
||
|
|
// Routine Description:
|
||
|
|
// Constructor.
|
||
|
|
//
|
||
|
|
// Arguments:
|
||
|
|
// None.
|
||
|
|
//
|
||
|
|
// Return Value:
|
||
|
|
// None.
|
||
|
|
//
|
||
|
|
//--
|
||
|
|
/////////////////////////////////////////////////////////////////////////////
|
||
|
|
CListCtrlPairPage::CListCtrlPairPage(void)
|
||
|
|
{
|
||
|
|
CommonConstruct();
|
||
|
|
|
||
|
|
} //*** CListCtrlPairPage::CListCtrlPairPage()
|
||
|
|
|
||
|
|
/////////////////////////////////////////////////////////////////////////////
|
||
|
|
//++
|
||
|
|
//
|
||
|
|
// CListCtrlPairPage::CListCtrlPairPage
|
||
|
|
//
|
||
|
|
// Routine Description:
|
||
|
|
// Constructor.
|
||
|
|
//
|
||
|
|
// Arguments:
|
||
|
|
// idd [IN] Resource ID for the dialog template.
|
||
|
|
// pdwHelpMap [IN] Control-to-Help ID mapping array.
|
||
|
|
// dwStyle [IN] Style:
|
||
|
|
// LCPS_SHOW_IMAGES Show images to left of items.
|
||
|
|
// LCPS_ALLOW_EMPTY Allow right list to be empty.
|
||
|
|
// LCPS_ORDERED Ordered right list.
|
||
|
|
// LCPS_CAN_BE_ORDERED List can be ordered (hides
|
||
|
|
// Up/Down puttons if LCPS_ORDERED not specified).
|
||
|
|
// pfnGetColumn [IN] Function pointer for getting column data.
|
||
|
|
// pfnDisplayProps [IN] Function pointer for displaying properties.
|
||
|
|
//
|
||
|
|
// Return Value:
|
||
|
|
// None.
|
||
|
|
//
|
||
|
|
//--
|
||
|
|
/////////////////////////////////////////////////////////////////////////////
|
||
|
|
CListCtrlPairPage::CListCtrlPairPage(
|
||
|
|
IN UINT idd,
|
||
|
|
IN const DWORD * pdwHelpMap,
|
||
|
|
IN DWORD dwStyle,
|
||
|
|
IN PFNLCPGETCOLUMN pfnGetColumn,
|
||
|
|
IN PFNLCPDISPPROPS pfnDisplayProps
|
||
|
|
)
|
||
|
|
: CBasePropertyPage(idd, pdwHelpMap)
|
||
|
|
{
|
||
|
|
ASSERT(pfnGetColumn != NULL);
|
||
|
|
ASSERT(pfnDisplayProps != NULL);
|
||
|
|
|
||
|
|
CommonConstruct();
|
||
|
|
|
||
|
|
m_dwStyle = dwStyle;
|
||
|
|
m_pfnGetColumn = pfnGetColumn;
|
||
|
|
m_pfnDisplayProps = pfnDisplayProps;
|
||
|
|
|
||
|
|
} //*** CListCtrlPairPage::CListCtrlPairPage()
|
||
|
|
|
||
|
|
/////////////////////////////////////////////////////////////////////////////
|
||
|
|
//++
|
||
|
|
//
|
||
|
|
// CListCtrlPair::CommonConstruct
|
||
|
|
//
|
||
|
|
// Routine Description:
|
||
|
|
// Common construction.
|
||
|
|
//
|
||
|
|
// Arguments:
|
||
|
|
// None.
|
||
|
|
//
|
||
|
|
// Return Value:
|
||
|
|
// None.
|
||
|
|
//
|
||
|
|
//--
|
||
|
|
/////////////////////////////////////////////////////////////////////////////
|
||
|
|
void CListCtrlPairPage::CommonConstruct(void)
|
||
|
|
{
|
||
|
|
m_plpobjRight = NULL;
|
||
|
|
m_plpobjLeft = NULL;
|
||
|
|
m_dwStyle = 0;
|
||
|
|
m_pfnGetColumn = NULL;
|
||
|
|
|
||
|
|
m_plcp = NULL;
|
||
|
|
|
||
|
|
} //*** CListCtrlPairPage::CommonConstruct()
|
||
|
|
|
||
|
|
/////////////////////////////////////////////////////////////////////////////
|
||
|
|
//++
|
||
|
|
//
|
||
|
|
// CListCtrlPairPage::~CListCtrlPairPage
|
||
|
|
//
|
||
|
|
// Routine Description:
|
||
|
|
// Destructor.
|
||
|
|
//
|
||
|
|
// Arguments:
|
||
|
|
// None.
|
||
|
|
//
|
||
|
|
// Return Value:
|
||
|
|
// None.
|
||
|
|
//
|
||
|
|
//--
|
||
|
|
/////////////////////////////////////////////////////////////////////////////
|
||
|
|
CListCtrlPairPage::~CListCtrlPairPage(void)
|
||
|
|
{
|
||
|
|
delete m_plcp;
|
||
|
|
|
||
|
|
} //*** CListCtrlPairPage::~CListCtrlPairPage()
|
||
|
|
|
||
|
|
/////////////////////////////////////////////////////////////////////////////
|
||
|
|
//++
|
||
|
|
//
|
||
|
|
// CListCtrlPair::NAddColumn
|
||
|
|
//
|
||
|
|
// Routine Description:
|
||
|
|
// Add a column to the list of columns displayed in each list control.
|
||
|
|
//
|
||
|
|
// Arguments:
|
||
|
|
// idsText [IN] String resource ID for text to display on column.
|
||
|
|
// nWidth [IN] Initial width of the column.
|
||
|
|
//
|
||
|
|
// Return Value:
|
||
|
|
// icol Index of the column.
|
||
|
|
//
|
||
|
|
// Exceptions Thrown:
|
||
|
|
// Any exceptions thrown by CArray::Add.
|
||
|
|
//--
|
||
|
|
/////////////////////////////////////////////////////////////////////////////
|
||
|
|
int CListCtrlPairPage::NAddColumn(IN IDS idsText, IN int nWidth)
|
||
|
|
{
|
||
|
|
CListCtrlPair::CColumn col;
|
||
|
|
|
||
|
|
ASSERT(idsText != 0);
|
||
|
|
ASSERT(nWidth > 0);
|
||
|
|
ASSERT(Plcp() == NULL);
|
||
|
|
|
||
|
|
col.m_idsText = idsText;
|
||
|
|
col.m_nWidth = nWidth;
|
||
|
|
|
||
|
|
return (int)m_aColumns.Add(col);
|
||
|
|
|
||
|
|
} //*** CListCtrlPair::NAddColumn()
|
||
|
|
|
||
|
|
/////////////////////////////////////////////////////////////////////////////
|
||
|
|
//++
|
||
|
|
//
|
||
|
|
// CListCtrlPairPage::DoDataExchange
|
||
|
|
//
|
||
|
|
// Routine Description:
|
||
|
|
// Do data exchange between the dialog and the class.
|
||
|
|
//
|
||
|
|
// Arguments:
|
||
|
|
// pDX [IN OUT] Data exchange object
|
||
|
|
//
|
||
|
|
// Return Value:
|
||
|
|
// None.
|
||
|
|
//
|
||
|
|
//--
|
||
|
|
/////////////////////////////////////////////////////////////////////////////
|
||
|
|
void CListCtrlPairPage::DoDataExchange(CDataExchange * pDX)
|
||
|
|
{
|
||
|
|
CBasePropertyPage::DoDataExchange(pDX);
|
||
|
|
Plcp()->DoDataExchange(pDX);
|
||
|
|
//{{AFX_DATA_MAP(CListCtrlPairDlg)
|
||
|
|
//}}AFX_DATA_MAP
|
||
|
|
|
||
|
|
} //*** CListCtrlPairPage::DoDataExchange()
|
||
|
|
|
||
|
|
/////////////////////////////////////////////////////////////////////////////
|
||
|
|
//++
|
||
|
|
//
|
||
|
|
// CListCtrlPairPage::OnInitDialog
|
||
|
|
//
|
||
|
|
// Routine Description:
|
||
|
|
// Handler for the WM_INITDIALOG message.
|
||
|
|
//
|
||
|
|
// Arguments:
|
||
|
|
// None.
|
||
|
|
//
|
||
|
|
// Return Value:
|
||
|
|
// TRUE Focus needs to be set.
|
||
|
|
// FALSE Focus already set.
|
||
|
|
//
|
||
|
|
//--
|
||
|
|
/////////////////////////////////////////////////////////////////////////////
|
||
|
|
BOOL CListCtrlPairPage::OnInitDialog( void )
|
||
|
|
{
|
||
|
|
if ( BReadOnly() )
|
||
|
|
{
|
||
|
|
m_dwStyle |= LCPS_READ_ONLY;
|
||
|
|
} // if: page is read only
|
||
|
|
|
||
|
|
// Initialize the ListCtrlPair control.
|
||
|
|
if ( BCanBeOrdered() )
|
||
|
|
{
|
||
|
|
m_plcp = new COrderedListCtrlPair(
|
||
|
|
this,
|
||
|
|
m_plpobjRight,
|
||
|
|
m_plpobjLeft,
|
||
|
|
m_dwStyle,
|
||
|
|
m_pfnGetColumn,
|
||
|
|
m_pfnDisplayProps
|
||
|
|
);
|
||
|
|
} // if: list can be ordered
|
||
|
|
else
|
||
|
|
{
|
||
|
|
m_plcp = new CListCtrlPair(
|
||
|
|
this,
|
||
|
|
m_plpobjRight,
|
||
|
|
m_plpobjLeft,
|
||
|
|
m_dwStyle,
|
||
|
|
m_pfnGetColumn,
|
||
|
|
m_pfnDisplayProps
|
||
|
|
);
|
||
|
|
} // else: list cannot be ordered
|
||
|
|
if ( m_plcp == NULL )
|
||
|
|
{
|
||
|
|
AfxThrowMemoryException();
|
||
|
|
} // if: error allocating memory
|
||
|
|
|
||
|
|
// Add columns if there are any.
|
||
|
|
{
|
||
|
|
int icol;
|
||
|
|
|
||
|
|
for ( icol = 0 ; icol <= m_aColumns.GetUpperBound() ; icol++ )
|
||
|
|
{
|
||
|
|
Plcp()->NAddColumn( m_aColumns[ icol ].m_idsText, m_aColumns[ icol ].m_nWidth );
|
||
|
|
} // for: each column
|
||
|
|
} // Add columns if there are any
|
||
|
|
|
||
|
|
CBasePropertyPage::OnInitDialog();
|
||
|
|
Plcp()->OnInitDialog();
|
||
|
|
|
||
|
|
return TRUE; // return TRUE unless you set the focus to a control
|
||
|
|
// EXCEPTION: OCX Property Pages should return FALSE
|
||
|
|
|
||
|
|
} //*** CListCtrlPairPage::OnInitDialog()
|
||
|
|
|
||
|
|
/////////////////////////////////////////////////////////////////////////////
|
||
|
|
//++
|
||
|
|
//
|
||
|
|
// CListCtrlPairPage::OnSetActive
|
||
|
|
//
|
||
|
|
// Routine Description:
|
||
|
|
// Handler for the PSN_SETACTIVE message.
|
||
|
|
//
|
||
|
|
// Arguments:
|
||
|
|
// None.
|
||
|
|
//
|
||
|
|
// Return Value:
|
||
|
|
// TRUE Page successfully initialized.
|
||
|
|
// FALSE Page not initialized.
|
||
|
|
//
|
||
|
|
//--
|
||
|
|
/////////////////////////////////////////////////////////////////////////////
|
||
|
|
BOOL CListCtrlPairPage::OnSetActive(void)
|
||
|
|
{
|
||
|
|
BOOL bSuccess;
|
||
|
|
|
||
|
|
bSuccess = CBasePropertyPage::OnSetActive();
|
||
|
|
if (bSuccess)
|
||
|
|
bSuccess = Plcp()->OnSetActive();
|
||
|
|
|
||
|
|
return bSuccess;
|
||
|
|
|
||
|
|
} //*** CListCtrlPairPage::OnSetActive()
|
||
|
|
|
||
|
|
/////////////////////////////////////////////////////////////////////////////
|
||
|
|
//++
|
||
|
|
//
|
||
|
|
// CListCtrlPairPage::OnCmdMsg
|
||
|
|
//
|
||
|
|
// Routine Description:
|
||
|
|
// Processes command messages. Attempts to pass them on to a selected
|
||
|
|
// item first.
|
||
|
|
//
|
||
|
|
// Arguments:
|
||
|
|
// nID [IN] Command ID.
|
||
|
|
// nCode [IN] Notification code.
|
||
|
|
// pExtra [IN OUT] Used according to the value of nCode.
|
||
|
|
// pHandlerInfo [OUT] ???
|
||
|
|
//
|
||
|
|
// Return Value:
|
||
|
|
// TRUE Message has been handled.
|
||
|
|
// FALSE Message has NOT been handled.
|
||
|
|
//
|
||
|
|
//--
|
||
|
|
/////////////////////////////////////////////////////////////////////////////
|
||
|
|
BOOL CListCtrlPairPage::OnCmdMsg(
|
||
|
|
UINT nID,
|
||
|
|
int nCode,
|
||
|
|
void * pExtra,
|
||
|
|
AFX_CMDHANDLERINFO * pHandlerInfo
|
||
|
|
)
|
||
|
|
{
|
||
|
|
BOOL bHandled;
|
||
|
|
|
||
|
|
ASSERT(Plcp() != NULL);
|
||
|
|
|
||
|
|
bHandled = Plcp()->OnCmdMsg(nID, nCode, pExtra, pHandlerInfo);
|
||
|
|
if (!bHandled)
|
||
|
|
bHandled = CBasePropertyPage::OnCmdMsg(nID, nCode, pExtra, pHandlerInfo);
|
||
|
|
return bHandled;
|
||
|
|
|
||
|
|
} //*** CListCtrlPairPage::OnCmdMsg()
|
||
|
|
|
||
|
|
/////////////////////////////////////////////////////////////////////////////
|
||
|
|
//++
|
||
|
|
//
|
||
|
|
// CListCtrlPairPage::OnContextMenu
|
||
|
|
//
|
||
|
|
// Routine Description:
|
||
|
|
// Handler for the WM_CONTEXTMENU method.
|
||
|
|
//
|
||
|
|
// Arguments:
|
||
|
|
// pWnd Window in which the user right clicked the mouse.
|
||
|
|
// point Position of the cursor, in screen coordinates.
|
||
|
|
//
|
||
|
|
// Return Value:
|
||
|
|
// None.
|
||
|
|
//
|
||
|
|
//--
|
||
|
|
/////////////////////////////////////////////////////////////////////////////
|
||
|
|
void CListCtrlPairPage::OnContextMenu(CWnd * pWnd, CPoint point)
|
||
|
|
{
|
||
|
|
ASSERT(Plcp() != NULL);
|
||
|
|
|
||
|
|
if (!Plcp()->OnContextMenu(pWnd, point))
|
||
|
|
CBasePropertyPage::OnContextMenu(pWnd, point);
|
||
|
|
|
||
|
|
} //*** CListCtrlPairPage::OnContextMenu()
|
||
|
|
|
||
|
|
/////////////////////////////////////////////////////////////////////////////
|
||
|
|
//++
|
||
|
|
//
|
||
|
|
// CListCtrlPairPage::SetLists
|
||
|
|
//
|
||
|
|
// Routine Description:
|
||
|
|
// Set the lists for the list control pair.
|
||
|
|
//
|
||
|
|
// Arguments:
|
||
|
|
// plpobjRight [IN OUT] List for the right list box.
|
||
|
|
// plpobjLeft [IN] List for the left list box.
|
||
|
|
//
|
||
|
|
// Return Value:
|
||
|
|
// None.
|
||
|
|
//
|
||
|
|
//--
|
||
|
|
/////////////////////////////////////////////////////////////////////////////
|
||
|
|
void CListCtrlPairPage::SetLists(
|
||
|
|
IN OUT CClusterItemList * plpobjRight,
|
||
|
|
IN const CClusterItemList * plpobjLeft
|
||
|
|
)
|
||
|
|
{
|
||
|
|
if (plpobjRight != NULL)
|
||
|
|
m_plpobjRight = plpobjRight;
|
||
|
|
if (plpobjLeft != NULL)
|
||
|
|
m_plpobjLeft = plpobjLeft;
|
||
|
|
if (Plcp() != NULL)
|
||
|
|
Plcp()->SetLists(plpobjRight, plpobjLeft);
|
||
|
|
|
||
|
|
} //*** CListCtrlPairPage::SetLists()
|
||
|
|
|
||
|
|
/////////////////////////////////////////////////////////////////////////////
|
||
|
|
//++
|
||
|
|
//
|
||
|
|
// CListCtrlPairPage::SetLists
|
||
|
|
//
|
||
|
|
// Routine Description:
|
||
|
|
// Set the lists for the list control pair where the right list should
|
||
|
|
// not be modified.
|
||
|
|
//
|
||
|
|
// Arguments:
|
||
|
|
// plpobjRight [IN] List for the right list box.
|
||
|
|
// plpobjLeft [IN] List for the left list box.
|
||
|
|
//
|
||
|
|
// Return Value:
|
||
|
|
// None.
|
||
|
|
//
|
||
|
|
//--
|
||
|
|
/////////////////////////////////////////////////////////////////////////////
|
||
|
|
void CListCtrlPairPage::SetLists(
|
||
|
|
IN const CClusterItemList * plpobjRight,
|
||
|
|
IN const CClusterItemList * plpobjLeft
|
||
|
|
)
|
||
|
|
{
|
||
|
|
if (plpobjRight != NULL)
|
||
|
|
m_plpobjRight = (CClusterItemList *) plpobjRight;
|
||
|
|
if (plpobjLeft != NULL)
|
||
|
|
m_plpobjLeft = plpobjLeft;
|
||
|
|
m_dwStyle |= LCPS_DONT_OUTPUT_RIGHT_LIST;
|
||
|
|
if (Plcp() != NULL)
|
||
|
|
Plcp()->SetLists(plpobjRight, plpobjLeft);
|
||
|
|
|
||
|
|
} //*** CListCtrlPairPage::SetLists()
|