able/windows-nt
1
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity
windows-nt/Source/XPSP1/NT/admin/netui/common/h/bltlb.hxx

1067 lines
32 KiB
C++
Raw Normal View History

Add source files
2020-09-26 03:20:57 -05:00
/**********************************************************************/
/** Microsoft Windows/NT **/
/** Copyright(c) Microsoft Corp., 1991 **/
/**********************************************************************/
/*
bltlb.hxx
BLT listbox control classes: definitions
FILE HISTORY:
RustanL 13-Feb-1991 Created
RustanL 22-Feb-1991 Modified for revised LC hierarchy
rustanl 22-Mar-1991 Rolled in code review changes
from CR on 20-Mar-1991, attended by
JimH, GregJ, Hui-LiCh, RustanL.
gregj 08-Apr-1991 Reintegrated caching listbox
gregj 01-May-1991 Added GUILTT support
beng 14-May-1991 Made clients depend on blt.hxx
rustanl 07-Aug-1991 Added METALLIC_STR_DTE
rustanl 04-Sep-1991 Added ReplaceItem
KeithMo 23-Oct-1991 Added forward references.
beng 19-Apr-1992 Added LISTBOX, LAZY_LISTBOX
jonn 25-Apr-1992 Disabled LAZY_LISTBOX build fix
beng 10-May-1992 Re-enabled (given 1.264)
beng 01-Jun-1992 Changed GUILTT support
jonn 04-Aug-1992 HAW-for-Hawaii support
jonn 11-Aug-1992 HAW-for-Hawaii for other LBs
Yi-HsinS 10-Dec-1992 Support variable size LBI in BLT_LISTBOX
*/
#ifndef _BLT_HXX_
#error "Don't include this file directly; instead, include it through blt.hxx"
#endif // _BLT_HXX_
#ifndef _BLTLB_HXX_
#define _BLTLB_HXX_
#include "bltbitmp.hxx" // DISPLAY_MAP
#include "bltfont.hxx" // FONT
//
// Forward references.
//
DLL_CLASS DTE;
DLL_CLASS DM_DTE;
DLL_CLASS DMID_DTE;
DLL_CLASS STR_DTE;
DLL_CLASS MULTILINE_STR_DTE;
DLL_CLASS METALLIC_STR_DTE;
DLL_CLASS DISPLAY_TABLE;
DLL_CLASS LBI;
DLL_CLASS LISTBOX;
DLL_CLASS BLT_LISTBOX;
DLL_CLASS LAZY_LISTBOX;
DLL_CLASS SET_CONTROL;
// Maximum number of columns in a listbox
#define MAX_DISPLAY_TABLE_ENTRIES 10
/**********************************************************************
NAME: GUILTT_INFO
SYNOPSIS: Packaged parameters for use in GUILTT processing
INTERFACE: pnlsOut - string into which to place output
errOut - error code to return
HISTORY:
gregj 01-May-1991 Created
beng 14-Feb-1992 Win32 conversion
beng 01-Jun-1992 GUILTT changes
**********************************************************************/
struct GUILTT_INFO
{
NLS_STR * pnlsOut;
APIERR errOut;
};
/**********************************************************************
NAME: HAW_FOR_HAWAII_INFO (hawinfo)
SYNOPSIS: Packaged parameters for use in
BLT_LISTBOX::CD_Char_HAWforHawaii()
INTERFACE: _nls: string containing current HAW prefix
_time: time when this prefix will time out
HISTORY:
jonn 04-Aug-1992 HAW-for-Hawaii support
**********************************************************************/
DLL_CLASS HAW_FOR_HAWAII_INFO : public BASE
{
public:
NLS_STR _nls;
LONG _time;
HAW_FOR_HAWAII_INFO();
~HAW_FOR_HAWAII_INFO();
};
/**********************************************************************
NAME: DTE
SYNOPSIS: Display table entry abstract class
INTERFACE: Paint() - paint function
AppendDataTo() - returns GUILTT information
PARENT: BASE
CAVEATS:
While most DTEs cannot fail construction, a few, such
as DMID_DTE, can.
HISTORY:
RustanL 13-Feb-1991 Created
gregj 01-May-1991 Added GUILTT support
beng 10-Jul-1991 Changed Paint protocol; inherits
from BASE
beng 04-Oct-1991 Win32 conversion
beng 07-Nov-1991 Inlined (empty) ctor
beng 01-Jun-1992 GUILTT changes
**********************************************************************/
DLL_CLASS DTE: public BASE
{
protected:
DTE() { }
public:
virtual VOID Paint( HDC hdc, const RECT * prect ) const = 0;
virtual UINT QueryLeftMargin() const;
virtual APIERR AppendDataTo( NLS_STR * pnlsOut ) const = 0;
};
/**********************************************************************
NAME: DM_DTE
SYNOPSIS: DTE which works with a DISPLAY_MAP
INTERFACE: DM_DTE() - constructor
Paint() - paint function
AppendDataTo() - support for GUILTT
QueryDisplayWidth() - Returns the width (including
left margin) that the DTE
will require in order to be
displayed in full
QueryDisplayMap() - Get the display map
PARENT: DTE
USES: DISPLAY_MAP
NOTES: CODEWORK. If it would prove useful, QueryDisplayWidth
could be made virtual at the DTE level, and would then
always return the width (including the left margin)
needed to fully display the DTE.
HISTORY:
RustanL 13-Feb-1991 Created
gregj 01-May-1991 Added GUILTT support
beng 10-Jul-1991 Changed Paint
rustanl 03-Sep-1991 Added QueryDisplayWidth method
beng 04-Oct-1991 Win32 conversion
beng 07-Nov-1991 Unsigned width
beng 01-Jun-1992 GUILTT changes
**********************************************************************/
DLL_CLASS DM_DTE : public DTE
{
private:
DISPLAY_MAP * _pdm;
protected:
DM_DTE();
VOID SetPdm( DISPLAY_MAP * pdm );
public:
DM_DTE( DISPLAY_MAP * pdm );
virtual VOID Paint( HDC hdc, const RECT * prect ) const;
virtual APIERR AppendDataTo( NLS_STR * pnlsOut ) const;
UINT QueryDisplayWidth() const;
DISPLAY_MAP *QueryDisplayMap( VOID ) const
{ return _pdm; }
};
/**********************************************************************
NAME: DMID_DTE
SYNOPSIS: DTE which works from a DMID.
It constructs the DM for the client.
INTERFACE: DMID_DTE() - constructor
~DMID_DTE() - destructor
PARENT: DM_DTE
USES: DISPLAY_MAP
CAVEATS:
Since this constructs a DM, *it can fail construction*.
HISTORY:
RustanL 13-Feb-1991 Created
beng 10-Jul-1991 Added caveat
**********************************************************************/
DLL_CLASS DMID_DTE : public DM_DTE
{
private:
DISPLAY_MAP _dm;
public:
DMID_DTE( DMID dmid );
};
/**********************************************************************
NAME: STR_DTE
SYNOPSIS: DTE which presents a simple string
INTERFACE: STR_DTE() - constructor
Paint() - paint function
GetData() - support for GUILTT
SetPch() - Painting Optimization
PARENT: DTE
USES:
CAVEATS:
NOTES:
Should this use NLS_STR? Its string is presented to the user.
Need to rethink SetPch.
HISTORY:
RustanL 13-Feb-1991 Created
gregj 01-May-1991 Added GUILTT support
beng 20-May-1991 Made _pch pointer-to-const
kevinl 30-May-1991 Added SetPch member
beng 10-Jul-1991 Changed Paint
beng 04-Oct-1991 Win32 conversion
beng 07-Nov-1991 Inlined ctor
beng 01-Jun-1992 GUILTT changes
**********************************************************************/
DLL_CLASS STR_DTE : public DTE
{
private:
const TCHAR * _pch;
public:
STR_DTE( const TCHAR * pch ) : _pch(pch) { }
VOID SetPch( const TCHAR * pch )
{ _pch = pch; }
const TCHAR *QueryPch( VOID ) const
{ return _pch; }
virtual VOID Paint( HDC hdc, const RECT * prect ) const;
virtual APIERR AppendDataTo( NLS_STR * pnlsOut ) const;
};
/*************************************************************************
NAME: METALLIC_STR_DTE
SYNOPSIS: DTE which presents a simple string, painted in a
metallic colored 3D looking format.
INTERFACE: METALLIC_STR_DTE() - constructor
Paint() - virtual replacement of Paint
method
QueryLeftMargin() - virtual replacement for returning
the left margin which is to
be left in between columns.
QueryVerticalMargins() - static method returning the
number of pixels taken up by
vertical margins when the DTE
is painted
PARENT: STR_DTE
HISTORY:
rustanl 22-Jul-1991 Created
rustanl 07-Aug-1991 Added to BLT
beng 04-Oct-1991 Win32 conversion
beng 08-Nov-1991 Unsigned widths
**************************************************************************/
DLL_CLASS METALLIC_STR_DTE : public STR_DTE
{
private:
static const UINT _dyTopMargin;
static const UINT _dyBottomMargin;
inline static UINT CalcTopTextMargin();
inline static UINT CalcBottomTextMargin();
public:
METALLIC_STR_DTE( const TCHAR * pch ) : STR_DTE( pch ) { }
virtual VOID Paint( HDC hdc, const RECT * prect ) const;
virtual UINT QueryLeftMargin() const;
static UINT QueryVerticalMargins();
};
/**********************************************************************
NAME: MULTILINE_STR_DTE
SYNOPSIS: DTE which presents a multi-line string
INTERFACE: MULTILINE_STR_DTE() - constructor
Paint() - paint function
PARENT: STR_DTE
USES:
CAVEATS:
NOTES:
HISTORY:
Yi-HsinS 13-Dec-1992 Created
**********************************************************************/
DLL_CLASS MULTILINE_STR_DTE : public STR_DTE
{
public:
MULTILINE_STR_DTE( const TCHAR * pch ) : STR_DTE(pch) {}
virtual VOID Paint( HDC hdc, const RECT * prect ) const;
};
/**********************************************************************
NAME: COUNTED_STR_DTE
SYNOPSIS: DTE which displays a counted (rather than \0 terminated)
string.
INTERFACE: COUNTED_STR_DTE() - constructor
Paint() - paint function
PARENT: STR_DTE
HISTORY:
KeithMo 15-Dec-1992 Created
**********************************************************************/
DLL_CLASS COUNTED_STR_DTE : public STR_DTE
{
private:
INT _cch;
public:
COUNTED_STR_DTE( const TCHAR * pch, INT cch ) : STR_DTE(pch), _cch(cch) {}
INT QueryCount( VOID ) const
{ return _cch; }
virtual VOID Paint( HDC hdc, const RECT * prect ) const;
};
#define DEFAULT_DM_DY 1
#define DEFAULT_TEXT_DY 3
/**********************************************************************
NAME: OWNER_DRAW_STR_DTE
SYNOPSIS: STR_DTE which presents a string centered according to nDy
INTERFACE: OWNER_DRAW_STR_DTE() - constructor
Paint() - paint function
PARENT: STR_DTE
USES:
CAVEATS:
NOTES:
HISTORY:
Yi-HsinS 13-Dec-1992 Created
**********************************************************************/
DLL_CLASS OWNER_DRAW_STR_DTE : public STR_DTE
{
private:
INT _nDy;
public:
OWNER_DRAW_STR_DTE( const TCHAR * pch, INT nDy = DEFAULT_TEXT_DY )
: STR_DTE ( pch ),
_nDy( nDy ) { }
virtual VOID Paint( HDC hdc, const RECT * prect ) const;
};
/**********************************************************************
NAME: OWNER_DRAW_DMID_DTE
SYNOPSIS: DMID_DTE in which the owner will paint according to nDy.
INTERFACE: OWNER_DRAW_DMID_DTE() - constructor
Paint() - paint function
PARENT: DMID_DTE
USES:
CAVEATS:
HISTORY:
Yi-HsinS 23-Dec-1992 Created
**********************************************************************/
DLL_CLASS OWNER_DRAW_DMID_DTE : public DMID_DTE
{
private:
INT _nDy;
public:
OWNER_DRAW_DMID_DTE( DMID dmid, INT nDy = DEFAULT_DM_DY )
: DMID_DTE( dmid ),
_nDy( nDy ) {}
virtual VOID Paint( HDC hdc, const RECT * prect ) const;
};
/**********************************************************************
NAME: OWNER_DRAW_MULTILINE_STR_DTE
SYNOPSIS: MULTILINE_STR_DTE which is centered according to _nDy
INTERFACE: OWNER_DRAW_MULTILINE_STR_DTE() - constructor
Paint() - paint function
PARENT: MULTILINE_STR_DTE
USES:
CAVEATS:
NOTES:
HISTORY:
Yi-HsinS 13-Dec-1992 Created
**********************************************************************/
DLL_CLASS OWNER_DRAW_MULTILINE_STR_DTE : public MULTILINE_STR_DTE
{
private:
INT _nDy;
public:
OWNER_DRAW_MULTILINE_STR_DTE( const TCHAR * pch, INT nDy = DEFAULT_TEXT_DY )
: MULTILINE_STR_DTE(pch),
_nDy( nDy ) {}
virtual VOID Paint( HDC hdc, const RECT * prect ) const;
};
/**********************************************************************
NAME: DISPLAY_TABLE
SYNOPSIS: Table of DTEs used by the BLT listbox
INTERFACE:
DISPLAY_TABLE() - constructor
Paint() - paint function
operator[]() - return the specified entry in the display table
CalcColumnWidths() - generate array of column widths
USES: DTE
NOTES:
To use this properly, a listbox should keep an array of column
widths as a member, which it gives to each display table built
within it. That array should be built with CalcColumnWidths
in order to synchronize the spacing of the listbox columns and
their respective column headers (static text controls above
the listbox).
HISTORY:
RustanL 13-Feb-1991 Created
gregj 01-May-1991 Added GUILTT support
beng 04-Oct-1991 Win32 conversion
beng 07-Nov-1991 Unsigned widths
beng 08-Nov-1991 Added CalcColumnWidths
beng 21-Apr-1992 Generalized BLT_LISTBOX to LISTBOX
**********************************************************************/
DLL_CLASS DISPLAY_TABLE
{
private:
const UINT *_pdxColWidth; // points to array of column widths
UINT _cdx;
DTE * _apdte[ MAX_DISPLAY_TABLE_ENTRIES ];
public:
DISPLAY_TABLE( UINT cColumns, const UINT * pdxColWidth );
VOID Paint( LISTBOX * plb, HDC hdc, const RECT * prect,
GUILTT_INFO * pginfo ) const;
VOID Paint( LISTBOX * plb, HDC hdc, const RECT * prect ) const;
DTE * & operator[]( UINT i ) ;
static APIERR CalcColumnWidths( UINT * pdx, UINT cdx,
OWNER_WINDOW * pwnd,
CID cidListbox, BOOL fHaveIcon );
};
/**********************************************************************
NAME: LBI
SYNOPSIS: Listbox item
INTERFACE:
LBI() - constructor
~LBI() - destructor
Paint() - paint function
Compare() - compare two items in the list box
QueryLeadingChar() - unknown
Compare_HAWforHawaii() - special compare routine for
HAW-for-Hawaii purposes. Redefine iff the
listbox uses CD_Char_HAWforHawaii().
PARENT: BASE
CAVEATS:
CODEWORK - Generalize the QueryLeadingChar protocol for
Haw-for-Hawaii support.
NOTES:
The Paint() method may be called in response to a
GUILTT request as well as for a WM_DRAWITEM message.
The pGUILTT parameter to Paint() should be passed on
to the DISPLAY_TABLE class without modification.
HISTORY:
RustanL 13-Feb-1991 Created
gregj 01-May-1991 Added GUILTT support
beng 20-May-1991 Added OnCompareItem and OnDeleteItem;
QueryLeadingChar now returns WCHAR
beng 04-Oct-1991 Win32 conversion
kevinl 05-Nov-1991 Added IsDestroyable
beng 21-Apr-1992 Generalized BLT_LISTBOX to LISTBOX
jonn 04-Aug-1992 HAW-for-Hawaii support
**********************************************************************/
DLL_CLASS LBI : public BASE
{
protected:
virtual BOOL IsDestroyable();
public:
LBI();
virtual ~LBI();
// Note, CalcHeight is currently only called for variable size items
virtual UINT CalcHeight( UINT nSingleLineHeight );
virtual VOID Paint( LISTBOX * plb, HDC hdc, const RECT * prect,
GUILTT_INFO * pGUILTT ) const;
virtual INT Compare( const LBI * plbi ) const;
virtual INT Compare_HAWforHawaii( const NLS_STR & nls ) const;
virtual WCHAR QueryLeadingChar() const;
// Response code for WM_COMPAREITEM and WM_DELETEITEM
//
static INT OnCompareItem( WPARAM wParam, LPARAM lParam );
static VOID OnDeleteItem( WPARAM wParam, LPARAM lParam );
};
/**********************************************************************
NAME: LISTBOX
SYNOPSIS: Listbox (owner-draw) control class
INTERFACE: LISTBOX() - constructor
InvalidateItem() - invalidate the item
IsReadOnly() - predicate, TRUE if r.o. listbox
QueryScrollPos() - return horizontal scroll position
SetScrollPos() - set scroll position (default 0)
default is zero
PARENT: LIST_CONTROL
USES: FONT
CAVEATS:
All listboxes must have LBS_OWNERDRAWFIXED or LBS_OWNERDRAWVARIABLE.
HISTORY:
beng 19-Apr-1992 Created from old BLT_LISTBOX
beng 01-Jun-1992 Changed GUILTT support
KeithMo 09-Feb-1993 Added Query/SetHorizontalExtent methods.
**********************************************************************/
DLL_CLASS LISTBOX: public LIST_CONTROL
{
private:
BOOL _fReadOnly;
FONT _fontListBox;
UINT _dxScroll; // pane scroll increment, in pels
protected:
// Replacement of virtual CONTROL_WINDOW methods
//
virtual BOOL CD_Draw( DRAWITEMSTRUCT * pdis );
virtual INT CD_VKey( USHORT nVKey, USHORT nLastPos );
// Get a LBI, whether listbox conventional or lazy
//
virtual LBI * RequestLBI( const DRAWITEMSTRUCT * pdis ) = 0;
virtual VOID ReleaseLBI( LBI * plbi ) = 0;
public:
LISTBOX( OWNER_WINDOW * powin, CID cid,
BOOL fReadOnly = FALSE,
enum FontType font = FONT_DEFAULT,
BOOL fIsCombo = FALSE );
LISTBOX( OWNER_WINDOW * powin, CID cid,
XYPOINT xy, XYDIMENSION dxy,
ULONG flStyle,
BOOL fReadOnly = FALSE,
enum FontType font = FONT_DEFAULT,
BOOL fIsCombo = FALSE );
VOID InvalidateItem( INT i, BOOL fErase = TRUE );
BOOL IsReadOnly() const
{ return _fReadOnly; }
UINT QueryScrollPos() const
{ return _dxScroll; }
VOID SetScrollPos( UINT dxNewPos = 0 );
UINT QueryHorizontalExtent( VOID ) const;
VOID SetHorizontalExtent( UINT dxNewExtent );
};
/**********************************************************************
NAME: BLT_LISTBOX
SYNOPSIS: BLT listbox control class
INTERFACE: BLT_LISTBOX() - constructor
AddItem() - add an item to the listbox
AddItemIdemp() - add an item to the listbox if the
item does not exist already.
SetItem() - set the value of the specified item
FindItem() - find an item from the listbox
QueryItem() - Query item
RemoveItem() - Removes the LBI from the listbox w/o
deleting it
RemoveAllItems - Does RemoveItem to all items in LB
CD_Char_HAWforHawaii() - Standard CD_Char handler for
listboxes with HAW-for-Hawaii functionality.
Redefine CD_Char() to call this. Pass in a
pointer to a HAW_FOR_HAWAII_INFO associated
with this listbox, which must have constructed
successfully. Also redefine
LBI::Compare_HAWforHawaii().
PARENT: LISTBOX
HISTORY:
RustanL 13-Feb-1991 Created
Johnl 05-Apr-1991 Added _fontListBox member, added font
param. to const. & defaulted to
FONT_DEFAULT
gregj 08-Apr-1991 Added extra scrolling members for two
column support
gregj 01-May-1991 Added GUILTT support
beng 16-May-1991 Added app-window constructor
beng 21-Aug-1991 Removed LC_CURRENT_ITEM magic value
beng 15-Oct-1991 Win32 conversion
beng 07-Nov-1991 Removed 2-pane listbox support
beng 19-Apr-1992 Factored out new LISTBOX control
beng 01-Jun-1992 Changed GUILTT support
jonn 04-Aug-1992 HAW-for-Hawaii support
Johnl 27-Oct-1992 Added RemoveItem
Johnl 07-Dec-1992 Added RemoveAllItems
Yi-HsinS 10-Dec-1992 Added CD_Measure for OWNERDRAWVARIABLE listbox
KeithMo 17-Dec-1992 Added InsertItem
**********************************************************************/
DLL_CLASS BLT_LISTBOX : public LISTBOX
{
friend class SET_CONTROL;
private:
UINT _nSingleLineHeight;
VOID SetItem( INT ilbi, LBI * plbi );
// Replacement of virtual LISTBOX methods
//
virtual LBI * RequestLBI( const DRAWITEMSTRUCT * pdis );
virtual VOID ReleaseLBI( LBI * plbi );
protected:
// Replacement of virtual CONTROL_WINDOW methods
//
virtual INT CD_Char( WCHAR wch, USHORT nLastPos );
virtual APIERR CD_Guiltt( INT ilb, NLS_STR * pnlsOut );
INT CD_Char_HAWforHawaii( WCHAR wch,
USHORT nLastPos,
HAW_FOR_HAWAII_INFO * phawinfo );
// note, CD_Measure is currently only called for variable size items
virtual BOOL CD_Measure( MEASUREITEMSTRUCT * pmis );
public:
BLT_LISTBOX( OWNER_WINDOW * powin, CID cid,
BOOL fReadOnly = FALSE,
enum FontType font = FONT_DEFAULT,
BOOL fIsCombo = FALSE );
BLT_LISTBOX( OWNER_WINDOW * powin, CID cid,
XYPOINT xy, XYDIMENSION dxy,
ULONG flStyle,
BOOL fReadOnly = FALSE,
enum FontType font = FONT_DEFAULT,
BOOL fIsCombo = FALSE );
INT AddItem( LBI * plbi );
INT AddItemIdemp( LBI * plbi );
INT InsertItem( INT i, LBI * plbi );
INT FindItem( const LBI & lbi ) const;
LBI * QueryItem( INT i ) const;
LBI * QueryItem() const
{ return QueryItem(QueryCurrentItem()); }
LBI * RemoveItem( INT i ) ;
LBI * RemoveItem()
{ return RemoveItem( QueryCurrentItem()) ; }
//
// Note that the LBIs must be deleted (and are assumed to be in an
// external list)
//
void RemoveAllItems( void ) ;
APIERR ReplaceItem( INT i, LBI * plbiNew, LBI * * pplbiOld = NULL );
APIERR Resort( void );
UINT QuerySingleLineHeight( VOID )
{ return _nSingleLineHeight; }
APIERR CalcSingleLineHeight( VOID );
};
/*************************************************************************
NAME: BLT_COMBOBOX
SYNOPSIS: Owner draw combo box
INTERFACE:
PARENT: BLT_LISTBOX
NOTES: Usage is exactly like a BLT_LISTBOX (i.e., use the same LBIs,
etc) except the container is a combo.
We subclass the window proc so the 'H' for Hawaii will work
(combo boxes don't support this functionality).
HISTORY:
Johnl 21-Oct-1992 Moved out of MPR
**************************************************************************/
DLL_CLASS BLT_COMBOBOX : public BLT_LISTBOX
{
public:
BLT_COMBOBOX( OWNER_WINDOW * powin, CID cid,
BOOL fReadOnly = FALSE,
enum FontType font = FONT_DEFAULT ) ;
BLT_COMBOBOX( OWNER_WINDOW * powin, CID cid,
XYPOINT xy, XYDIMENSION dxy,
ULONG flStyle,
BOOL fReadOnly = FALSE,
enum FontType font = FONT_DEFAULT ) ;
~BLT_COMBOBOX() ;
BOOL IsDropped( void ) const ;
protected:
/* We do a little bit of subclassing so the H for Hawaii works
*/
static LRESULT WINAPI CBSubclassProc( HWND hwnd,
UINT msg,
WPARAM wParam,
LPARAM lParam ) ;
private:
//
// Old window proc (restored when all occurrences of BLT_COMBOBOX are
// destructed.
//
static WNDPROC _OldCBProc ;
//
// Reference count. When this reaches 0, the old window proc is restored
//
static UINT _cReferences ;
} ;
#if defined(WIN32)
/*************************************************************************
NAME: LAZY_LISTBOX
SYNOPSIS: Listbox control which defers line definition
A lazy listbox is a listbox-like control which postpones defining
the contents of a line until that line must be shown. Compare a
conventional listbox control, which requires a BLT_LISTBOX::AddItem
for each line therein before any may be shown.
Do not confuse this control with a "caching" listbox. I think it's
a good idea to decouple any "caching" logic of an app (such as the
event-log viewer) from the "virtual listbox" logic. This control,
then, knows nothing beyond listbox items and indices in the listbox.
It leaves all caching knowledge up to its client application.
To define the particular lazy listbox, derive a class from class
LAZY_LISTBOX which redefines the (pure, virtual) OnNewItem callback.
OnNewItem should return a pointer to a LBI for the i-th element in
the listbox. For instance, you could define it as
return new MY_FABULOUS_LBI(pmumble, i);
Return NULL if you fail to construct any LBI.
Too, if you want to support keyboard H-for-Hawaii manipulation,
redefine the CONTROL_WINDOW::CD_Char member function.
The total number of items is set, and also redefinable
at any time, via LAZY_LISTBOX::SetCount(). Alternately, you can
use the Insert etc. members of LIST_CONTROL.
The LAZY_LISTBOX::Refresh() function tells the listbox to discard all
its entries and start anew.
INTERFACE:
SetCount() - resets the total number of lines in the list
OnNewItem() - callback: returns pointer to a new item. Must
be defined by user
OnDeleteItem() - callback: process the obsolete LBI.
PARENT: LISTBOX
CAVEATS:
A lazy listbox requires the LBS_NODATA and LBS_OWNERDRAWFIXED
styles, and may never have LBS_SORT or LBS_HASSTRINGS.
NOTES:
The lazy listbox demands that the client redefine CD_Char instead
of supporting the LBI::QueryLeadingChar protocol used by its
sibling BLT_LISTBOX, since that protocol would force linear
searches potentially to walk the entire contents of the list.
HISTORY:
beng 27-Nov-1991 Created
beng 16-Apr-1992 Implemented
beng 01-Jun-1992 Changed GUILTT support
KeithMo 17-Dec-1992 Added InsertItem
**************************************************************************/
DLL_CLASS LAZY_LISTBOX: public LISTBOX
{
private:
// Replacement of virtual LISTBOX methods
//
LBI * RequestLBI( const DRAWITEMSTRUCT * pdis );
VOID ReleaseLBI( LBI * plbi );
protected:
// Called by the lazylb when it needs a new item.
// Client must supply suitable implementation.
//
virtual LBI * OnNewItem( UINT i ) = 0;
virtual VOID OnDeleteItem( LBI *plbi );
// Replace control-window implementation
//
virtual APIERR CD_Guiltt( INT ilb, NLS_STR * pnlsOut );
public:
LAZY_LISTBOX( OWNER_WINDOW * pwnd, CID cid,
BOOL fReadOnly = FALSE,
enum FontType font = FONT_DEFAULT );
LAZY_LISTBOX( OWNER_WINDOW * powin, CID cid,
XYPOINT xy, XYDIMENSION dxy,
ULONG flStyle,
BOOL fReadOnly = FALSE,
enum FontType font = FONT_DEFAULT );
// Sets and resets the number of elements in the listbox
//
VOID SetCount( UINT cvlbi );
INT InsertItem( INT i = -1 )
{ return InsertItemData( i, NULL ); }
};
#endif // WIN32
/**********************************************************************
NAME: BLT_LISTBOX_HAW
SYNOPSIS: BLT listbox control class with HAW-for-Hawaii support.
Listboxes do not have to inherit from BLT_LISTBOX_HAW
to have HAW-for-Hawaii support, but it does take care
of creating the HAW_FOR_HAWAII_INFO object and
redefining CD_Char() appropriately. The LBIs must
still support Compare_HAWforHawaii.
INTERFACE: BLT_LISTBOX_HAW() - constructor
CD_Char - Standard CD_Char handler for
listboxes with HAW-for-Hawaii functionality.
PARENT: BLT_LISTBOX
HISTORY:
jonn 11-Aug-1992 HAW-for-Hawaii for other LBs
**********************************************************************/
DLL_CLASS BLT_LISTBOX_HAW : public BLT_LISTBOX
{
private:
HAW_FOR_HAWAII_INFO _hawinfo;
protected:
// Replacement of virtual CONTROL_WINDOW methods
//
virtual INT CD_Char( WCHAR wch, USHORT nLastPos );
public:
BLT_LISTBOX_HAW( OWNER_WINDOW * powin, CID cid,
BOOL fReadOnly = FALSE,
enum FontType font = FONT_DEFAULT,
BOOL fIsCombo = FALSE );
BLT_LISTBOX_HAW( OWNER_WINDOW * powin, CID cid,
XYPOINT xy, XYDIMENSION dxy,
ULONG flStyle,
BOOL fReadOnly = FALSE,
enum FontType font = FONT_DEFAULT,
BOOL fIsCombo = FALSE );
};
// The following macro is used by BLT_LISTBOX subclasses to easily implement
// a new QueryItem call, which returns a different type than LBI *.
//
// Usage:
// In public section of class declaration, put
// DECLARE_LB_QUERY_ITEM( type )
// where 'type' is a class derived from LBI.
//
// Notes:
// The macro, nor the compiler, can check if 'type' is indeed a
// type derived from LBI.
//
// As a reminder, despite of the return code from the new QueryItem
// method, BLT does not guarantee that the listbox will only contain
// 'type' LBI items.
//
// In spite of its name, the macro both declares and defines the
// derived inline QueryItem method.
#define DECLARE_LB_QUERY_ITEM( type ) \
type * QueryItem() const \
{ return (type *)BLT_LISTBOX::QueryItem(); } \
type * QueryItem( INT i ) const \
{ return (type *)BLT_LISTBOX::QueryItem( i ); }
#endif // _BLTLB_HXX_ - end of file
Reference in a new issue Copy permalink