|
| 1 | +## About |
| 2 | +A Windows Forms User Interface library supporting [**TaskScheduler**](https://www.nuget.org/packages/TaskScheduler), a .NET wrapper for the [Windows Task Scheduler](https://docs.microsoft.com/en-us/windows/win32/taskschd/task-scheduler-start-page). It provides controls mimicking all the UI components of the Windows Task Scheduler app with extended features and supporting controls. |
| 3 | + |
| 4 | +More information can be found on the [project page on GitHub](https://github.com/dahall/taskscheduler). |
| 5 | + |
| 6 | +## Support |
| 7 | +Below are links to sites that provide in-depth examples, documentation and discussions. Please go here first with your questions as the community has been active for over a decade. |
| 8 | +* [Wiki](https://github.com/dahall/TaskScheduler/wiki) - Sample code, library how-to, troubleshooting, etc. |
| 9 | +* [API documentation](https://dahall.github.io/TaskScheduler) - Class/method/property documentation and examples |
| 10 | +* [Full Issues Log](https://github.com/dahall/TaskScheduler/issues?q=) - Use the search box to see if your question may already be answered. |
| 11 | +* [Discussion Forum](https://github.com/dahall/TaskScheduler/discussions) - Users helping users, enhancement requests, Q&A (retired Google forum [here](https://groups.google.com/forum/#!forum/taskscheduler)) |
| 12 | + |
| 13 | +## Key Features |
| 14 | +Localized and localizable UI editors and a wizard for tasks which mimic the ones in Vista and later and adds optional pages for new properties. Following is the list of available UI controls: |
| 15 | + |
| 16 | +* Task editor dialog and tabbed control which mimics system editor (`TaskEditDialog` and `TaskPropertiesControl`) |
| 17 | +* Task editor dialog using more modern UI scheme (`TaskOptionsEditor`) |
| 18 | +* Task creation wizard (`TaskSchedulerWizard`) |
| 19 | +* Action editor dialog (`ActionEditDialog`) |
| 20 | +* Trigger editor dialog (`TriggerEditDialog`) |
| 21 | +* Windows Event Log viewer which works for all events, not just Task Scheduler's (`EventViewerDialog` and `EventViewerControl`) |
| 22 | +* Task / task folder selection dialog (`TaskBrowserDialog`) |
| 23 | +* Task history viewer (`TaskHistoryControl`) |
| 24 | +* Task run-times viewer (`TaskRunTimesControl` and `TaskRunTimesDialog`) |
| 25 | +* Task service remote connection dialog (`TaskServiceConnectDialog`) |
| 26 | +* Simplified classes for pulling events from the system event log. |
| 27 | +* A `DropDownCheckList` control that is very useful for selecting flag type enumerations. |
| 28 | +* A `FullDateTimePicker` control which allows both date and time selection in a single control. |
| 29 | +* A `CredentialsDialog` class for prompting for a password which wraps the Windows API. |
| 30 | + |
| 31 | +The currently supported localizations include: English, Spanish, Italian, French, Chinese (Simplified), German, Polish and Russian. |
| 32 | + |
| 33 | +## Usage |
| 34 | +```C# |
| 35 | +// Create a new task |
| 36 | +Task t = TaskService.Instance.AddTask("Test", QuickTriggerType.Daily, "myprogram.exe"); |
| 37 | + |
| 38 | +// Edit task and re-register if user clicks Ok |
| 39 | +TaskEditDialog editorForm = new TaskEditDialog(task: t, editable: true, registerOnAccept: true); |
| 40 | +editorForm.ShowDialog(); |
| 41 | +``` |
| 42 | + |
| 43 | +For extended examples on how to the use the library, look at the [Examples Page](https://github.com/dahall/TaskScheduler/wiki/Examples). |
0 commit comments