PertChart

Creates an empty PERT chart, with empty Tasks, Links and Holidays lists of its own and a Monday-to-Friday week.

Each chart gets lists of its own, so adding a task to one chart never adds it to another. To share a plan, give several charts the same lists.

Gets or sets the space between one column of boxes and the next, where the arrows turn.

Widen it when many arrows leave one column. A negative value, NaN or an infinity is refused with an ArgumentException.

Gets or sets the colour of the critical path, while ShowCriticalPath is on: the outline of a critical box, the arrows between critical boxes, the word critical, and a float below zero.

In Windows high contrast the system colours are used instead.

Gets or sets the dates that are not worked, beside the days WorkingWeek leaves out.

An ObservableCollection is watched, so adding a date moves the dates in the boxes at once. Give every view of a plan the same holidays, or their dates will disagree.

Gets or sets the colour of the arrows that are not on the critical path.

The arrows into and out of the selected box are drawn in SelectionBrush. In Windows high contrast the system colours are used instead.

Gets or sets the links between the tasks, which decide the order of the boxes and the arrows between them.

A link that cannot be honoured – an unknown task, a repeat, a loop – is left out and reported in ProjectSchedule.Problems. The list is watched as Tasks is; the chart never changes it.

Gets or sets the fill of every box.

Text in a box is drawn in Foreground; choose a fill it reads on. In Windows high contrast the system colours are used instead.

<pm:PertChart Background="#F4F6F8" NodeBackgroundBrush="White" NodeBorderBrush="#B0BAC5"
              CriticalBrush="#C62828" ProgressBrush="#2E7D32" />

Gets or sets the outline of a box that is not critical, and – fainter – the lines that divide a box into its cells and the track behind its progress strip.

In Windows high contrast the system colours are used instead.

Gets or sets the height of every box.

A negative value, NaN or an infinity is refused with an ArgumentException.

Gets or sets the width of every box.

A long task name is cut short with an ellipsis; widen the boxes to show more of it. A negative value, NaN or an infinity is refused with an ArgumentException.

Gets or sets the fill of the progress strip along the foot of a box, which fills from the left with the task's ProjectTask.Progress.

In Windows high contrast the system colours are used instead.

Gets or sets the first day work on the plan can happen.

A date that is not worked is read as the next working day.

Gets or sets the space between one row of boxes and the next, along which an arrow that skips a column runs.

A negative value, NaN or an infinity is refused with an ArgumentException.

Gets the plan as scheduled: every task's early and late dates, its float, the critical path, and what in the input could not be used.

The plan is scheduled again first when anything has changed. A chart that is not loaded is not listening to its plan, so it schedules afresh each time this is read – which is what lets a chart that is never shown answer from the plan as it is now.

Gets or sets the selected task: the box with the highlighted ring, which the arrow keys move from.

Setting a summary, or a task not in Tasks, highlights no box, and the property is cleared the next time the plan is scheduled. When the list is replaced, the selection moves to the task that now has the selected task's id, if there is one. Selecting does not scroll; call ScrollToTask for that.

Gets or sets the colour of the ring round the selected box and of the arrows into and out of it, so its neighbours in the network can be traced.

In Windows high contrast the system colours are used instead.

Gets or sets whether the critical boxes, and the arrows between them, are outlined in CriticalBrush and marked critical.

Turning it off changes only the drawing; the critical tasks are still in ProjectSchedule.CriticalPath.

Gets or sets the tasks of the plan: a flat list in outline order, in which a subtask names its summary through ProjectTask.ParentId.

Every task with no subtasks is a box; a summary is not. While the chart is loaded, an ObservableCollection or a BindingList<T> is watched, and so is every task in it. A plain List<T> is read when it is assigned; call Reschedule after changing one.

Gets or sets the date the charts treat as today. A PERT chart has no timeline and draws nothing for it.

It is here so that the same settings can be given to a GanttChart, which draws its today line there, a PERT chart and a TaskBoard alike, by one style or one binding.

Gets the number of child elements: the vertical and the horizontal scroll bar. Everything else is drawn.

Gets or sets the days of the week on which work happens.

Durations and float are counted in these working days. In XAML: WorkingWeek="Monday, Tuesday, Wednesday, Thursday".

Gets or sets how large the network is drawn.

A change keeps the middle of the view (or the point under the pointer, for Ctrl and the wheel) where it is on screen, and raises ZoomFactorChanged.

<Slider Minimum="0.25" Maximum="3" Value="{Binding ZoomFactor, ElementName=pert}" />
<pm:PertChart x:Name="pert" Tasks="{Binding Tasks}" Links="{Binding Links}" />

Places the scroll bars, which appear only when the network is larger than the chart, and carries out a fit or a scroll asked for before the chart had a size.

arrangeBounds: the chart uses all of it.

Draws the whole network as an image, at its own size and a zoom of 1, whatever part of it is in view and whatever is selected.

The image, frozen, so that it can be saved or handed to another thread.

The image uses the chart's colours, font and reading direction. The chart need not be on screen: one made only for exporting reads its plan afresh. An empty plan gives a small image that says "No tasks".

An image that would be wider or taller than 16,384 pixels, or larger than 128 megapixels, is made at the highest resolution below dpi that fits; its DpiX says which.

Gets the two scroll bars, as logical children, so that they take the chart's resources and styles.

Returns one of the two scroll bars.

The scroll bar.

Asks for the network's size at the current ZoomFactor, or for the room available when that is less.

The size wanted. An empty plan asks for 240 by 120, room for its "No tasks" message.

Gives UI Automation the chart as a list of boxes, so that a screen reader can read and move through the network.

The chart's automation peer.

Each box is a list item named with what it shows in words – its dates, length, float or that it is critical, and the tasks it follows and leads to – and can be selected, scrolled into view and invoked, which raises TaskActivated.

Draws the network again for a new display scale, so that its text is sharp on the new pixels.

Shows the focus cue and tells a screen reader which box is current.

Carries out the chart's keys: the arrows, Home and End move between boxes, Enter activates the selected one, Page Up and Page Down scroll, and Ctrl with Plus, Minus or 0 zooms in, out, or back to actual size.

Right goes to the nearest task that follows the selected one, Left to the nearest it follows, Up and Down along its column. With FrameworkElement.FlowDirection right to left, Left and Right swap. With nothing selected, the first key selects the first box, or for End the last.

Takes the focus cue away when the chart loses the keyboard.

Ends a pan when something else takes the mouse, such as another window coming to the front.

Hides the tooltip when the pointer leaves the chart.

Selects the box under the pointer, raising TaskActivated on a double-click, or starts panning when the press is on the background.

Ends a pan.

Pans while the background is dragged; otherwise shows, after the hover time, a tooltip saying in words what the box under the pointer means.

Scrolls up and down, 48 logical units a notch; with Shift, scrolls sideways; with Ctrl, zooms about the pointer, by a factor of 1.2 a notch.

Redraws when a setting the drawing reads from the control itself changes: the font, Foreground, Background, FrameworkElement.Language, FrameworkElement.FlowDirection or the text formatting mode.

An override should call the base implementation.

Shows a hand over a box, which can be chosen, and a four-way arrow while panning.

Draws the chart: the network under the current scroll and zoom, then the selected box, its arrows and the focus cue over it.

Schedules the plan again now and redraws.

Needed only after changing a plain List<T> or array, or a task in one; observable collections and the objects in them are watched. Objects newly added to a plain list are watched from here on. ScheduleChanged is raised before this returns.

Scrolls the view, as little as it needs to, so that a task's box is in it with a margin round it.

The selection does not change. Called before the chart has a size, it waits for the first layout.

Draws the network a fifth larger (ZoomFactor times 1.2, up to 3), keeping the middle of the view where it is.

Draws the network smaller (ZoomFactor divided by 1.2, down to 0.25), keeping the middle of the view where it is.

Sets the ZoomFactor at which the whole network fits the chart, within 0.25 to 3, and scrolls to its start.

An empty plan is left as it is. Called before the chart has a size – from a constructor, say – it waits for the first layout and then fits.

Occurs after the plan has been scheduled again because something changed: a task, a link, one of the lists, or a scheduling setting.

Changes arriving together are scheduled once and announced once, from the dispatcher, after they have all arrived; so a handler sees the finished result. Reschedule raises it before it returns. A chart that is not loaded does not raise it; nor does loading one, so read Schedule when the chart is loaded if you need the first result.

Occurs when SelectedTask changes: the reader chose another box, the application set the property, or the selected task left the plan.

Occurs when the reader asks to open a task: by double-clicking its box, or by pressing Enter on the selected box.

The chart does nothing else with it; it is the place to open the task's details or switch to it in a GanttChart. The box is already selected.

pert.TaskActivated += (sender, e) =>
{
    tabs.SelectedItem = scheduleTab;      // show the Gantt chart...
    gantt.SelectedTask = e.Task;          // ...on the same task
    gantt.ScrollToTask(e.Task);
};

Occurs when ZoomFactor changes: set by the application, or by the reader with Ctrl and the wheel, Ctrl+Plus, Ctrl+Minus or Ctrl+0.

pert.ZoomFactorChanged += (sender, e) => zoomText.Text = pert.ZoomFactor.ToString("P0");

Identifies the ColumnGap dependency property.

Identifies the CriticalBrush dependency property.

Identifies the Holidays dependency property.

Identifies the LinkBrush dependency property.

Identifies the Links dependency property.

Identifies the NodeBackgroundBrush dependency property.

Identifies the NodeBorderBrush dependency property.

Identifies the NodeHeight dependency property.

Identifies the NodeWidth dependency property.

Identifies the ProgressBrush dependency property.

Identifies the ProjectStart dependency property.

Identifies the RowGap dependency property.

Identifies the SelectedTask dependency property.

Identifies the SelectionBrush dependency property.

Identifies the ShowCriticalPath dependency property.

Identifies the Tasks dependency property.

Identifies the Today dependency property.

Identifies the WorkingWeek dependency property.

Identifies the ZoomFactor dependency property.