A newer version of this page is available. Switch to the current version.

ISchedulerHitInfo Interface

Contains information about a specific point within a scheduler.

Namespace: DevExpress.Xpf.Scheduling

Assembly: DevExpress.Xpf.Scheduling.v19.1.dll

Declaration

public interface ISchedulerHitInfo
Public Interface ISchedulerHitInfo

Related API Members

The following members accept/return ISchedulerHitInfo objects:

Remarks

ISchedulerHitInfo objects can be created by calling the scheduler view's SchedulerControl.CalcHitInfo method. This method requires the test point passed as a parameter, or its coordinates.

The ISchedulerHitInfo implements the following properties which provide the capability to obtain information about a specific point within a scheduler.

Examples

The following code snippet shows how to use the SchedulerControl.CalcHitInfo method in the Scheduler.MouseMove event handler to obtain the hit information for the scheduler element over which the mouse pointer is hovering. The information on the element located under the mouse pointer is shown in the top panel.

DXScheduler_Examples_HitTest

private void SchedulerControl_MouseMove(object sender, MouseEventArgs e)
{
    // Obtain hit information under the test point.
    Point position = e.GetPosition(schedulerControl1);
    ISchedulerHitInfo hitInfo = schedulerControl1.CalcHitInfo(position);
    if (hitInfo != null) {
        this.hitResultsHeader.Text = "Hit Test Results";
        StringBuilder builder = new StringBuilder();
        builder.AppendLine(Enum.GetName(typeof(SchedulerHitTestType), hitInfo.HitTestType));
        switch (hitInfo.HitTestType) {
            case SchedulerHitTestType.Appointment:
                AppointmentViewModel appViewModel = hitInfo.ViewModel as AppointmentViewModel;
                if (appViewModel != null) {
                    builder.AppendLine("Subject: " + appViewModel.Appointment.Subject);
                    builder.AppendLine("Start: " + appViewModel.Appointment.Start.ToString());
                    builder.AppendLine("End: " + appViewModel.Appointment.End.ToString());
                }
                break;
            case SchedulerHitTestType.Cell:
                builder.AppendLine("Interval: " + hitInfo.ViewModel.Interval.ToString());
                builder.AppendLine("Selected: " + hitInfo.ViewModel.IsSelected.ToString());
                break;
            case SchedulerHitTestType.Ruler:
               TimeRulerCellViewModel rulerViewModel = hitInfo.ViewModel as TimeRulerCellViewModel;
                if (rulerViewModel != null) {
                    builder.AppendLine("Time: " + rulerViewModel.Time.ToString());
                    builder.AppendLine("Time Scale: " + rulerViewModel.TimeScale.ToString());
                }
                break;
        }
        this.hitResultsText.Text = builder.ToString();
    }
    else {
        ClearResults();
    }
}
See Also