|
|
/////////////////////////////////////////////////////////////////////////////
//
// Copyright (c) 1996-2000 Microsoft Corporation
//
// Module Name:
// LCPrDlg.cpp
//
// Abstract:
// Implementation of the CListCtrlPairDlg dialog template class.
//
// Author:
// David Potter (davidp) August 12, 1996
//
// Revision History:
//
// Notes:
//
/////////////////////////////////////////////////////////////////////////////
#include "stdafx.h"
#include "LCPrDlg.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
/////////////////////////////////////////////////////////////////////////////
// CListCtrlPairDlg
/////////////////////////////////////////////////////////////////////////////
IMPLEMENT_DYNCREATE(CListCtrlPairDlg, CBaseDialog)
/////////////////////////////////////////////////////////////////////////////
// Message Maps
BEGIN_MESSAGE_MAP(CListCtrlPairDlg, CBaseDialog) //{{AFX_MSG_MAP(CListCtrlPairDlg)
ON_WM_CONTEXTMENU() //}}AFX_MSG_MAP
END_MESSAGE_MAP()
/////////////////////////////////////////////////////////////////////////////
//++
//
// CListCtrlPairDlg::CListCtrlPairDlg
//
// Routine Description:
// Constructor.
//
// Arguments:
// None.
//
// Return Value:
// None.
//
//--
/////////////////////////////////////////////////////////////////////////////
CListCtrlPairDlg::CListCtrlPairDlg(void) { CommonConstruct();
} //*** CListCtrlPairDlg::CListCtrlPairDlg()
/////////////////////////////////////////////////////////////////////////////
//++
//
// CListCtrlPairDlg::CListCtrlPairDlg
//
// Routine Description:
// Constructor.
//
// Arguments:
// idd [IN] Resource ID for the dialog template.
// pdwHelpMap [IN] Control-to-Help ID mapping array.
// plpciRight [IN OUT] List for the right list control.
// plpciLeft [IN] List for the left list control.
// 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 buttons if LCPS_ORDERED not specified).
// pfnGetColumn [IN] Function pointer for getting column data.
// pfnDisplayProps [IN] Function pointer for displaying properties.
// pParent [IN OUT] Parent window.
//
// Return Value:
// None.
//
//--
/////////////////////////////////////////////////////////////////////////////
CListCtrlPairDlg::CListCtrlPairDlg( IN UINT idd, IN const DWORD * pdwHelpMap, IN OUT CClusterItemList * plpobjRight, IN const CClusterItemList * plpobjLeft, IN DWORD dwStyle, IN PFNLCPGETCOLUMN pfnGetColumn, IN PFNLCPDISPPROPS pfnDisplayProps, IN OUT CWnd * pParent //=NULL
) : CBaseDialog(idd, pdwHelpMap, pParent) { ASSERT(pfnGetColumn != NULL); ASSERT(pfnDisplayProps != NULL);
CommonConstruct();
if (plpobjRight != NULL) m_plpobjRight = plpobjRight; if (plpobjLeft != NULL) m_plpobjLeft = plpobjLeft;
m_dwStyle = dwStyle; m_pfnGetColumn = pfnGetColumn; m_pfnDisplayProps = pfnDisplayProps;
if (dwStyle & LCPS_ORDERED) ASSERT(m_dwStyle & LCPS_CAN_BE_ORDERED);
} //*** CListCtrlPairDlg::CListCtrlPairDlg()
/////////////////////////////////////////////////////////////////////////////
//++
//
// CListCtrlPairDlg::CommonConstruct
//
// Routine Description:
// Common construction.
//
// Arguments:
// None.
//
// Return Value:
// None.
//
//--
/////////////////////////////////////////////////////////////////////////////
void CListCtrlPairDlg::CommonConstruct(void) { m_plpobjRight = NULL; m_plpobjLeft = NULL; m_dwStyle = 0; m_pfnGetColumn = NULL;
m_plcp = NULL;
} //*** CListCtrlPairDlg::CommonConstruct()
/////////////////////////////////////////////////////////////////////////////
//++
//
// CListCtrlPairDlg::~CListCtrlPairDlg
//
// Routine Description:
// Destructor.
//
// Arguments:
// None.
//
// Return Value:
// None.
//
//--
/////////////////////////////////////////////////////////////////////////////
CListCtrlPairDlg::~CListCtrlPairDlg(void) { delete m_plcp;
} //*** CListCtrlPairDlg::~CListCtrlPairDlg()
/////////////////////////////////////////////////////////////////////////////
//++
//
// 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 CListCtrlPairDlg::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()
/////////////////////////////////////////////////////////////////////////////
//++
//
// CListCtrlPairDlg::DoDataExchange
//
// Routine Description:
// Do data exchange between the dialog and the class.
//
// Arguments:
// pDX [IN OUT] Data exchange object
//
// Return Value:
// None.
//
//--
/////////////////////////////////////////////////////////////////////////////
void CListCtrlPairDlg::DoDataExchange(CDataExchange * pDX) { CBaseDialog::DoDataExchange(pDX); Plcp()->DoDataExchange(pDX); //{{AFX_DATA_MAP(CListCtrlPairDlg)
//}}AFX_DATA_MAP
} //*** CListCtrlPairDlg::DoDataExchange()
/////////////////////////////////////////////////////////////////////////////
//++
//
// CListCtrlPairDlg::OnInitDialog
//
// Routine Description:
// Handler for the WM_INITDIALOG message.
//
// Arguments:
// None.
//
// Return Value:
// TRUE Focus needs to be set.
// FALSE Focus already set.
//
//--
/////////////////////////////////////////////////////////////////////////////
BOOL CListCtrlPairDlg::OnInitDialog( void ) { // 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
CBaseDialog::OnInitDialog(); Plcp()->OnInitDialog();
return TRUE; // return TRUE unless you set the focus to a control
// EXCEPTION: OCX Property Pages should return FALSE
} //*** CListCtrlPairDlg::OnInitDialog()
/////////////////////////////////////////////////////////////////////////////
//++
//
// CListCtrlPairDlg::OnOK
//
// Routine Description:
// Handler for the BN_CLICKED message on the OK button.
//
// Arguments:
// None.
//
// Return Value:
// None.
//
//--
/////////////////////////////////////////////////////////////////////////////
void CListCtrlPairDlg::OnOK(void) { if (Plcp()->BSaveChanges()) CBaseDialog::OnOK();
} //*** CListCtrlPairDlg::OnOK()
/////////////////////////////////////////////////////////////////////////////
//++
//
// CListCtrlPairDlg::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 CListCtrlPairDlg::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 = CBaseDialog::OnCmdMsg(nID, nCode, pExtra, pHandlerInfo); return bHandled;
} //*** CListCtrlPairDlg::OnCmdMsg()
/////////////////////////////////////////////////////////////////////////////
//++
//
// CListCtrlPairDlg::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 CListCtrlPairDlg::OnContextMenu(CWnd * pWnd, CPoint point) { ASSERT(Plcp() != NULL);
if (!Plcp()->OnContextMenu(pWnd, point)) CBaseDialog::OnContextMenu(pWnd, point);
} //*** CListCtrlPairDlg::OnContextMenu()
/////////////////////////////////////////////////////////////////////////////
//++
//
// CListCtrlPairDlg::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 CListCtrlPairDlg::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);
} //*** CListCtrlPairDlg::SetLists()
/////////////////////////////////////////////////////////////////////////////
//++
//
// CListCtrlPairDlg::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 CListCtrlPairDlg::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);
} //*** CListCtrlPairDlg::SetLists()
|