ObjectListView
does not contain any functionality for actions (creation, preservation, etc.) with the data objects displayed in the list. The programmer must write code that catches» «events in ObjectListView
, and work out an appropriate response. On the contrary, if there has been some action, you need to report it ObjectListView
for adequate display of objects.
To catch events, you must:
- Hang up the handler on event
CreateObject
in the implementation of actions to create the data object, the event occurs when the user clicks the toolbar button create объекта; - Hang up the handler on event
EditObject
in the implementation of action to edit the data object, the event occurs when the user clicks the toolbar button edit объекта; - Hang up the handler on event
DeleteObject
in the implementation of actions to create the data object, the event occurs when the user clicks the toolbar button removal объекта;
For information about ObjectListView
occurred, you must:
- Call method
AddObject
if the data object has been added, it will appear inObjectListView
(Important! The call, prior to processing the data object service data will result in an error, becauseObjectListView
will attempt to read object data from storage, where it does not); - Call method
UpdateObject
if the data object has been modified, then the fields inObjectListView
change the value to the appropriate object данных; - Call method
DeleteObject
if the data object was deleted, then it will disappear fromObjectListView
.
load Events list
download Information list
In the event handler ОbjectListView.AfterFillData
there is a possibility to obtain information about the success of the download. As the event parameter is of type EventArgs
is transferred to his heir AfterFillDataEventArgs
.
Type AfterFillDataEventArgs
has three properties:
/// <summary>
/// An exception occurred while downloading
/// </summary>
public Exception Exception { get; private set;}
/// <summary>
/// Download canceled by the user
/// </summary>
public bool CanceledByUser { get; private set; }
/// <summary>
/// Download completed successfully
/// </summary>
public bool IsFillSuccessfullyCompleted { get; private set; }
Example:
private void objectListView1_AfterFillData(object sender, EventArgs e)
{
if (e is AfterFillDataEventArgs)
{
var afterFillDataEventArgs = e as AfterFillDataEventArgs;
MessageBox.Show(
string.Format("CancelByUser: {0}, Exception: {1}, IsFillSuccessfullyCompleted: {2} ",
afterFillDataEventArgs.CanceledByUser, afterFillDataEventArgs.Exception, afterFillDataEventArgs.IsFillSuccessfullyCompleted));
}
}
Tracking data is being loaded
To track the load data in ObjectListView
possible with the help of events AfterFillData
and properties IsDataLoaded
. Event AfterFillData
occurs at the end of loading, and IsDataLoaded
property is true if the data is loaded and ObjectListView
is not in the status updates.
state of the list
row Selection
To monitor changes in the status of a line (selected or not) ObjectListView
possible with the help of events MarkObjectChanged
. As the event argument is passed DataObjectDef
of the object and the state of the row.
public event MarkObjectChangedEventHandler MarkObjectChanged;
ObjectListView
does not contain any functionality for actions (creation, preservation, etc.) with the data objects displayed in the list. The programmer must write code that catches» «events in ObjectListView
, and work out an appropriate response. On the contrary, if there has been some action, you need to report it ObjectListView
for adequate display of objects.
To catch events, you must:
- Hang up the handler on event
CreateObject
in the implementation of actions to create the data object, the event occurs when the user clicks the toolbar button create объекта; - Hang up the handler on event
EditObject
in the implementation of action to edit the data object, the event occurs when the user clicks the toolbar button edit объекта; - Hang up the handler on event
DeleteObject
in the implementation of actions to create the data object, the event occurs when the user clicks the toolbar button removal объекта;
For information about ObjectListView
occurred, you must:
- Call method
AddObject
if the data object has been added, it will appear inObjectListView
(Important! Do not call this method before processing the data object service data, as this may cause an error, becauseObjectListView
will attempt to read object data from storage, where it does not); - Call method
UpdateObject
if the data object has been modified, then the fields inObjectListView
change the value to the appropriate object данных; - Call method
DeleteObject
if the data object was deleted, then it will disappear fromObjectListView
.
Display prompts for the individual lines
In ObjectListView
implemented the ability to display tooltips for individual lines.
To enable this mode, you must set the property ObjectListView.ShowToolTip
.
To set the tooltip text you need to handle the event ObjectListView.BeforeToolTipRequired
. To configure settings to display a tooltip (delay of occurrence, duration of display, appearance) should change the properties of an object ObjectListView.ToolTip
.
Example:
This example displays the hint to the cells of the first 5 columns.
private void objectListView1_BeforeToolTipRequired(object sender, BeforeToolTipRequiredEventArgs e)
{
e.TipText = string.Format("Line {0}, column {1}", e.Row, e.Column);
if (e.Column>5)
e.Cancel = true;
}
Additional events, properties and methods
OnChangeCurrentObject
— occurs when the user selects an object (moves the cursor) in the list.ObjectDblClick
— proishodit where the current object is madeDblClick
.ObjectCount
— get the number of objects in the list.GetObject
— receiving the data object directly from the list by various criteria.FillData
— populate list data (update).HideToolBar
— show/hide the toolbar.UseToolBar
is to use a custom toolbar, some other, outside, it automatically» «spread buttons fromObjectListView
.ClearCache
— cleaning.ObjectListView.BeforeRefresh
occurs before the data is updated in the list. Data refresh can be initiated when the user clicks a button to Update the» «or method callRefresh
.SetObject
- method to add an object to the list.SetObjects
- method to add multiple objects to the list.