CBCGPEditListBase

Detailed Description

The CBCGPEditListBase class provides the basic functionality that allows to create various controls with editable items and manages an extensible list of buttons to control these items.

To take advantage of the CBCGPEditListBase class features you must inherit your own class from it, because CBCGPEditListBase class is abstract class, and you have to implement the actual editing methods.

The CBCGPEditListBase class supports four standard buttons for Add, Delete, Move Up and Move Down operations on the item list. You need to call SetStandardButtons() method with the desired combination to enable them. The button images are loaded from the BCGControlBar Library resource file. You may add your own buttons and images by the AddButton() method. You may want to override some notification methods to take a specific actions when a user is editing the item list.

See also

CBCGPButton, CBCGPEditListBox

Inheritance diagram for CBCGPEditListBase:

Public Member Functions
	AddButton	Adds a new button to the list control
	AddItem	Adds a new item to the CBCGPEditListBase - derived object. Implementation required.
	EditItem	Allows to edit an item in-place. Implementation required
	EnableBrowseButton	Enables or disables browse button for each item of a list box.
	EnableButton	Allows to enable or disable a button that manages list control items
	GetButtonID	Given a button's index returns the button's ID.
	GetButtonNum	Given a button ID returns the button's index
	GetButtonsCount	Returns the number of buttons.
	GetCount	Returns the number of items in a list control. Implementation required.
	GetItemData	Returns the data value associated with the list item. Implementation required.
	GetItemText	Returns the text associated with the list item. Implementation required.
	GetSelItem	Returns the zero-based index of the currently selected item in a list control.
	IsBrowseButton	Specifies whether browse button is enabled or not.
	IsGrayDisabledButtons	Tells whether the disabled button will be drawn grayed.
	OnAfterAddItem	Called when a new item has been added by in-place editing.
	OnAfterMoveItemDown	Called when a list box item has been moved down
	OnAfterMoveItemUp	Called when a list control item has been moved up
	OnAfterRenameItem	Called when a list box item has been renamed
	OnBeforeRemoveItem	Called when a list box item is about to be deleted.
	OnBrowse	Called by the framework when the user release the left mouse button over a browse button.
	OnClickButton	Called when the use clicks the button
	OnEndEditLabel	Called when in-place editing of the list control item's text has been finished
	OnGetImage	Called when an edit list control needs to display an item.
	OnKey	Called when the user pressed the keyboard key.
	OnSelectionChanged	Called when the selection in the list control has been changed
	RemoveAllButtons	Removes all standard and custom buttons.
	RemoveAllItems	Removes all list control items.
	RemoveItem	Deletes an item from a list control. Implementation required.
	SelectItem	Selects a list control item. Implementation required.
	SetGrayDisabledButtons	Allows to draw disabled button grayed. By default, the disabled button will be drawn with the regular look.
	SetItemData	Sets the data value associated with the list control item. Implementation required.
	SetItemText	Changes the text of a list control item. Implementation required.
	SetStandardButtons	Allows to specify which standard buttons should be created at the top of control.

Protected Member Functions
	CreateNewItem	Creates a new list control item in-place
	GetListHwnd	Returns the handle to the list control window. Implementation required.
	OnCreateList	Called by the framework as a part of initialization process. Implementation required.
	OnSizeList	Called when the layout of CBCGPEdiListBoxBase - derived control has changed. Implementation required.