WinForms DynamicHelp

ComponentOne
DynamicHelp for WinForms
Copyright 1987-2015 GrapeCity, Inc. All rights reserved.
ComponentOne, a division of GrapeCity

201 South Highland Avenue, Third Floor
Pittsburgh, PA 15206 USA
Website:
Sales:
Telephone:
http://www.componentone.com
sales@componentone.com
1.800.858.2739 or 1.412.681.4343 (Pittsburgh, PA USA Office)
Trademarks
The ComponentOne product name is a trademark and ComponentOne is a registered trademark of GrapeCity, Inc.
All other trademarks used herein are the properties of their respective owners.
Warranty
ComponentOne warrants that the media on which the software is delivered is free from defects in material and
workmanship, assuming normal use, for a period of 90 days from the date of purchase. If a defect occurs during this
time, you may return the defective media to ComponentOne, along with a dated proof of purchase, and
ComponentOne will replace it at no charge. After 90 days, you can obtain a replacement for the defective media by
sending it and a check for $25 (to cover postage and handling) to ComponentOne.
Except for the express warranty of the original media on which the software is delivered is set forth here,
ComponentOne makes no other warranties, express or implied. Every attempt has been made to ensure that the
information contained in this manual is correct as of the time it was written. ComponentOne is not responsible for
any errors or omissions. ComponentOnes liability is limited to the amount you paid for the product. ComponentOne
is not liable for any special, consequential, or other damages for any reason.
Copying and Distribution

While you are welcome to make backup copies of the software for your own use and protection, you are not
permitted to make copies for the use of anyone else. We put a lot of time and effort into creating this product, and
we appreciate your support in seeing that it is used by licensed users only.
Table of Contents
DynamicHelp for WinForms Overview ......................................................................................... 8
Help with WinForms Edition ..................................................................................................... 8
Key Features.................................................................................................................................. 8
DynamicHelp for WinForms Samples ........................................................................................... 9
Using DynamicHelp for WinForms .............................................................................................. 11
For Developers: Mapping at Design Time............................................................................... 11
Specifying the Source Help File ........................................................................................... 13
Mapping a Topic to a Control at Design Time..................................................................... 14
Preparing C1DynamicHelp for Authoring Mode ................................................................. 15
For Help Authors: Mapping in Authoring Mode ..................................................................... 16
Mapping a Topic to a Control in Authoring Mode .............................................................. 19
Removing the Topic Mapping for a Selected Control ......................................................... 20
Assign a Topic to a Parent Control ...................................................................................... 20
Advanced Features ................................................................................................................. 21
Displaying any Help Format ................................................................................................ 22
Mapping to Control Parts or Custom Controls ................................................................... 22
DynamicHelp for WinForms Tutorials......................................................................................... 23
Tutorial 1: Mapping Help Topics at Design Time .................................................................... 23
Step 1 of 6: Add controls to the Windows form ................................................................. 24
Step 2 of 6: Set up the C1DynamicHelp control ................................................................. 25
Step 3 of 6: Associate topics with controls on the form ..................................................... 25
Step 4 of 6: Associate a topic with the form ....................................................................... 26
Step 5 of 6: Show topics programmatically ........................................................................ 27
Step 6 of 6: Run the application.......................................................................................... 28
Tutorial 2: Mapping Help Topics in Authoring Mode ............................................................. 29
Step 1 of 4: Add controls to the Windows form ................................................................. 29
Step 2 of 4: Set up the C1DynamicHelp control ................................................................. 30
Step 3 of 4: Using authoring mode ..................................................................................... 33
Step 4 of 4: Run the Application ......................................................................................... 34
API Reference.............................................................................................................................. 35
C1.Win.C1DynamicHelp.4 Assembly ....................................................................................... 35
Namespaces ........................................................................................................................ 35
C1.Win.C1DynamicHelp Namespace .............................................................................. 35
Overview ..................................................................................................................... 35
Classes ......................................................................................................................... 37
C1DynamicHelp ....................................................................................................... 37
Overview ............................................................................................................. 38
Members ............................................................................................................. 39
C1DynamicHelp Constructor ............................................................................... 48
Methods .............................................................................................................. 49
GetHelpTopic Method .................................................................................... 51
SetHelpTopic Method ..................................................................................... 52
ShowDefaultTopic Method ............................................................................. 52
ShowExternalHelp Method ............................................................................. 53
ShowExternalHelp(HelpTab) Method ......................................................... 54
ShowExternalHelp(HelpTab,Object) Method ............................................. 54
ShowTopic Method ......................................................................................... 55
ShowTopic(String) Method ......................................................................... 56
ShowTopic(HelpTopic) Method .................................................................. 57
ShowTopic(Int32) Method .......................................................................... 58
ShowTopic(Object) Method ........................................................................ 59
ShowTopicForActiveControl Method ............................................................. 59
Properties............................................................................................................ 60
AuthoringMode Property................................................................................ 65
BorderStyle Property ...................................................................................... 66
Browser Property ............................................................................................ 66
ContextMenu Property ................................................................................... 67
ContextMenuStrip Property............................................................................ 68
CurrentTopic Property .................................................................................... 68
DefaultTrigger Property .................................................................................. 69
Dock Property ................................................................................................. 69
HelpSource Property ....................................................................................... 70
IsPinnedDown Property .................................................................................. 70
MainControl Property ..................................................................................... 71
MouseHoverDelay Property ........................................................................... 72
Provider Property............................................................................................ 72
Resolver Property ........................................................................................... 73
TopicMap Property ......................................................................................... 74
Events .................................................................................................................. 75
CurrentTopicChanged Event ........................................................................... 76

CurrentTopicChanging Event .......................................................................... 77
Conflict .................................................................................................................... 78
Overview ............................................................................................................. 79
Members ............................................................................................................. 79
Properties............................................................................................................ 80
DynamicItem Property .................................................................................... 81
Name Property ................................................................................................ 81
StaticItem Property ......................................................................................... 82
UIElementPath Property ................................................................................. 82
HelpTopic ................................................................................................................ 83
Overview ............................................................................................................. 83
Members ............................................................................................................. 84
HelpTopic Constructor ........................................................................................ 85
HelpTopic Constructor(String,String,HelpTopicList) ....................................... 86
HelpTopic Constructor(String,String) .............................................................. 87
Methods .............................................................................................................. 88
SetCtxtId Method ............................................................................................ 88
ToString Method ............................................................................................. 89
Properties............................................................................................................ 90
ContextID Property ......................................................................................... 90
SubTopics Property ......................................................................................... 91
Title Property .................................................................................................. 91
Url Property..................................................................................................... 92
HelpTopicList ........................................................................................................... 92
Overview ............................................................................................................. 93
Members ............................................................................................................. 94
HelpTopicList Constructor................................................................................... 96
MapItem.................................................................................................................. 97
Overview ............................................................................................................. 98
Members ............................................................................................................. 99
MapItem Constructor ....................................................................................... 100
Methods ............................................................................................................ 100
ToString Method ........................................................................................... 100
Properties.......................................................................................................... 101
HelpTopic Property ....................................................................................... 102
HelpTopicTrigger Property ............................................................................ 102

ItemType Property ........................................................................................ 103
ShowDefaultTopicFirst Property ................................................................... 104
UIElement Property ...................................................................................... 104
Url Property................................................................................................... 105
UseDefaultTrigger Property .......................................................................... 105
TopicEventArgs ..................................................................................................... 106
Overview ........................................................................................................... 107
Members ........................................................................................................... 108
Properties.......................................................................................................... 108
Cancel Property............................................................................................. 108
Topic Property............................................................................................... 109
TopicMap .............................................................................................................. 109
Overview ........................................................................................................... 111
Members ........................................................................................................... 112
Methods ............................................................................................................ 114
Add Method .................................................................................................. 115
Add(Object,MapItem) Method ................................................................. 116
Add(String,MapItem) Method .................................................................. 117
Contains Method .......................................................................................... 118
Load Method ................................................................................................. 119
Load(String) Method ................................................................................. 120
Load() Method .......................................................................................... 120
Refresh Method ............................................................................................ 121
Remove Method ........................................................................................... 122
Remove(Object) Method .......................................................................... 122
Remove(String) Method ........................................................................... 123
Save Method ................................................................................................. 124
Save() Method........................................................................................... 125
Save(String) Method ................................................................................. 125
Properties.......................................................................................................... 126
Conflicts Property ......................................................................................... 127
HasChanges Property .................................................................................... 128
Item Property ................................................................................................ 128
XmlSource Property ...................................................................................... 129
Events ................................................................................................................ 130
TopicMapChanged Event .............................................................................. 131

TopicMapSaved Event................................................................................... 131
UIElementInfo ....................................................................................................... 132
Overview ........................................................................................................... 132
Members ........................................................................................................... 133
UIElementInfo Constructor ............................................................................... 134
UIElementInfo Constructor(Object) .............................................................. 134
UIElementInfo Constructor(Object,String,Object) ........................................ 135
Properties.......................................................................................................... 137
Name Property .............................................................................................. 137
Parent Property............................................................................................. 138
UIElement Property ...................................................................................... 138
UIElementResolver................................................................................................ 139
Overview ........................................................................................................... 140
Members ........................................................................................................... 141
Methods ............................................................................................................ 141
HandleUIElementEvent Method ................................................................... 141
Enumerations ............................................................................................................ 143
DisplayTarget ........................................................................................................ 143
HelpTab ................................................................................................................. 144
HelpTopicTrigger ................................................................................................... 145
MapItemType ........................................................................................................ 146
UIElementEvents ................................................................................................... 147
Delegates .................................................................................................................. 148
HelpTopicEventHandler ........................................................................................ 148
C1.Win.C1DynamicHelp.Providers Namespace ............................................................ 149
Overview ................................................................................................................... 149
Classes ....................................................................................................................... 149
ChmProvider ......................................................................................................... 149
Overview ........................................................................................................... 150
Members ........................................................................................................... 151
ChmProvider Constructor ................................................................................. 152
Methods ............................................................................................................ 152
CorrectUrl Method........................................................................................ 153
GetCtxtIdMap Method.................................................................................. 154
GetFullUrl Method ........................................................................................ 154
GetTopics Method ........................................................................................ 155

GetUrlMap Method ...................................................................................... 156
ShowExternalHelp Method ........................................................................... 156
ShowExternalHelp(HelpTab) Method ....................................................... 157
ShowExternalHelp(HelpTab,Object) Method ........................................... 157
Properties.......................................................................................................... 158
Source Property ............................................................................................ 159
NetHelpProvider ................................................................................................... 159
Overview ........................................................................................................... 160
Members ........................................................................................................... 161
NetHelpProvider Constructor ........................................................................... 162
Methods ............................................................................................................ 162
Properties.......................................................................................................... 168
Source Property ............................................................................................ 169
Interfaces .................................................................................................................. 169
IHelpProvider ........................................................................................................ 169
Overview ........................................................................................................... 170
Members ........................................................................................................... 171
Methods ............................................................................................................ 172
Properties.......................................................................................................... 178
Source Property ............................................................................................ 178
DynamicHelp for WinForms Overview

DynamicHelp for WinForms is a container that allows you to view Help files in WinForms
applications. Developers or Help authors can also use DynamicHelp to assign specific Help
topics to controls within an application. The C1DynamicHelp WinForms control displays
context-sensitive help corresponding to the control that is being hovered over or the control
that has the focus. This type of Help system is an advanced feature available in applications
such as Visual Studio, Microsoft Office, Doc-To-Help, and others.
C1DynamicHelp is conceptually similar to using tooltips to provide Help on individual controls
and components. The main difference is that tooltips typically contain only a single sentence or
paragraph. An actual Help topic, by contrast, typically contains more content, often including
hyperlinks, images, tables, and so on. A C1DynamicHelp Help topic also supports selection and
can be copied to the Clipboard.
Topic mapping can be done by software developers or Help authors. The following topics
provide detailed instructions for both groups.
For Developers: Mapping at Design Time

For Help Authors: Mapping in Authoring Mode
See Also
Help with WinForms Edition
Help with WinForms Edition

Getting Started
For information on installing ComponentOne Studio WinForms Edition, licensing, technical
support, namespaces and creating a project with the control, please visit Getting Started with
WinForms Edition.
Key Features
C1DynamicHelp integrates with the application interface

C1DynamicHelp improves the usability of your application by offering immediate and
relevant Help as it is needed, right within the interface of the application. A separate
Help system doesn't need to be opened and searched.
Developers or Help Authors can easily perform topic mapping

Software developers can map topics to controls at design time, or Help Authors can use
authoring mode, a special run-time mode with a simple interface, to do the mapping
themselves. No additional code needs to be added once C1DynamicHelp is integrated
with the application.
Supports Help content selection and copying

The Help that is displayed in the C1DynamicHelp Help window can be selected and
copied to the Clipboard to be pasted into another application.
Quickly activate/deactivate authoring mode

The software developer can specify a way for Help authors to quickly activate and
deactivate authoring mode for topic mapping. Any method can be used, such as a
keystroke combination, an environment variable, a .config file, and so on.
DynamicHelp for WinForms Samples

Please be advised that this ComponentOne software tool is accompanied by various sample
projects and/or demos which may make use of other development tools included with the
ComponentOne Studio.
Please refer to the pre-installed product samples through the following path:
Documents\ComponentOne Samples\WinForms
The following tables provide a short description for each sample.
Visual Basic Samples

Sample
Description
AddingUICommands
This sample shows how to add a toolbar to a C1DynamicHelp

control to provide more functionality:
Allows users to navigate back/forward through help

navigation history.
Allows users to open the Help file in an external window on a

specified tab.
Allows users to pin the current topic down in order to

temporarily disable changing topics.
This sample uses the C1DynamicHelp control.

MultipleForms
This sample demonstrates how to use C1DynamicHelp controls on

multiple forms, how to set them up to use a single help source, and
how to refresh the TopicMap to support controls created dynamically.
UsingUIElementResolver This sample demonstrates how to create a custom UIElementResolver

and use it in the C1DynamicHelp control. This sample uses the
C1DynamicHelp control.
WorkingWithTopicMap
This sample demonstrates how to load topic map from different

locations: from a default topic map file, from a custom file, from
application resources. It also shows how to save a modified topic map
to different locations. This sample uses the C1DynamicHelp control.
C# Samples
Sample
Description
AddingUICommands
This sample shows how to add a toolbar to a C1DynamicHelp

control to provide more functionality:
Allows users to navigate back/forward through help

navigation history.
Allows users to open the Help file in an external window on a

specified tab.
Allows users to pin the current topic down in order to

temporarily disable changing topics.

MultipleForms
This sample demonstrates how to use C1DynamicHelp controls on

multiple forms, how to set them up to use a single help source, and
how to refresh the TopicMap to support controls created dynamically.
UsingUIElementResolver This sample demonstrates how to create a custom UIElementResolver

and use it in the C1DynamicHelp control. This sample uses the
WorkingWithTopicMap
This sample demonstrates how to load topic map from different

locations: from a default topic map file, from a custom file, from
application resources. It also shows how to save a modified topic map
to different locations. This sample uses the C1DynamicHelp control.
10
Using DynamicHelp for WinForms

The process of mapping Help topics to controls within a software application has often been
thought of as an error-prone process of passing a topic map back and forth between Help
authors and software developers. DynamicHelp for WinForms eliminates that painful process
by providing two options:
Software developers can use C1DynamicHelp at design time to map the topics to
controls.
or
Help authors can map topics to controls themselves using the C1DynamicHelp
authoring mode, without having to go through a software developer.
C1DynamicHelp gives you the ability to map a topic to any standard .NET controls and even
parts of those controls. You can also map to custom controls. See the Advanced Features topic
of this documentation for more information on mapping to control parts or custom controls.
DynamicHelp for WinForms supports several Help formats including HTML Help and NetHelp.
No matter who is going to perform the topic mapping, the software developer must specify the
Help file that is going to be used in the application before mapping can occur.
The following topics explain both ways to perform topic mapping.
Note: If you are the software developer of the application and would like the Help author
to map topics to controls, please provide them with this documentation. The For Help
Authors: Mapping in Authoring Mode topic provides all the information needed for topic
mapping at run time in authoring mode.
See Also
For Help Authors: Mapping in Authoring Mode
Advanced Features

C1DynamicHelp provides visual editing at design time to make it easier to map specific Help
topics to controls within an application. You can use the C1DynamicHelp smart tag and Select
Help Topic dialog box to quickly perform topic mapping.
C1DynamicHelp Smart Tag
11
In Visual Studio, the C1DynamicHelp component includes a smart tag. A smart tag ( )
represents a short-cut tasks menu that provides the most commonly used properties for a
control.
To access the C1DynamicHelp Tasks menu, click the smart tag in the upper-right corner of the
HelpSource Property
Click the ellipsis button to locate and select the .chm or NetHelp .htm file that will be
used for topic mapping.
Note:If using NetHelp, use the default.htm or the file name that was used as the base URL
for the NetHelp target.
DefaultTrigger Property
The DefaultTrigger property allows you to specify whether the Help topic will appear
when the control has the focus (Enter), the mouse is hovering over the control
(MouseEnter), or not at all (None).
Select Help Topic Dialog Box

Within this dialog box, you can specify the topic to map to the control through the Table of
Contents tab by simply selecting it, or you can choose the topic's context ID from the Context
IDs tab. Additionally, you can specify here whether a topic should be shown when: the control
gets focus; the mouse hovers over it; both; or neither, in which case, you can show the topic
programmatically.
12
See Also
Specifying the Source Help File
Mapping a Topic to a Control at Design Time
Preparing C1DynamicHelp for Authoring Mode
Specifying the Source Help File

No matter who is going to perform the topic mapping, the software developer must specify the
Help file that is going to be used in the application before mapping can occur. Either NetHelp
or a .chm (compiled HTML Help) can be used by C1DynamicHelp. If using NetHelp, all NetHelp
project files must be deployed with your application. If using HTML Help, only the .chm must be
included.
Any other types of Help files can be used, but this requires some additional programming; you
can use the Provider property and IHelpProvider interface.
Note: In Doc-To-Help, NetHelp project files are stored by default in the NetHelp folder; the
compiled HTML Help file is stored in the HTMLHelp folder.
To specify the source Help file to be used:
1.
From the Toolbox, double-click the C1DynamicHelp control to add it to your form. If
you have not already added the C1DynamicHelp control to the Toolbox, see Adding the
C1DynamicHelp Component to a Project.
13
2.
3.
4.
5.
Click the C1DynamicHelp smart tag ( ) to open the Tasks menu.

Click the ellipsis button next to the HelpSource property.
Locate and select the desired Help file. You can use any *.chm file or NetHelp *.htm file
(use the default.htm or the file name that was used as the base URL for the NetHelp
target).
Click Open.
Mapping a Topic to a Control at Design Time

Once a source Help file is specified, you can easily map topics to controls within your
application through C1DynamicHelp.
1.
2.
3.
4.
5.
From the Toolbox, double-click the C1DynamicHelp control to add it to your form. An
extender property, Help Topic on C1DynamicHelp, is added to all controls when
C1DynamicHelp is added to the form.
Locate and select the desired Help file, and click Open.
Select one of the controls on your form and click the ellipsis button next to the
HelpTopic on C1DynamicHelp property in the Properties window. The Select Help
Topic dialog box appears and shows the Table of Contents tab and TOC from the
specified Help file.
By default, the Use default events check box is selected (the selected options will vary
by the control youve chosen to map to). Got focus sets the Help topic to display when
the control has been selected; Mouse hover sets the Help topic to display when the
control has been hovered over. To change the default options, clear the Use default
events check box and select either the Got focus or Mouse hover check box.
14
o
o
If mapping to the TOC: From the Select Help Topic dialog box, Table of
Contents tab, choose a topic.
If mapping to the context ID list: From the Select Help Topic dialog box,
Context ID tab, choose the context ID/Topic pairing.
Note: In order to map to a topic, the topic must be in the Help TOC or have a context ID
assigned to it; otherwise, it will not appear in the Select Help Topic dialog box. Also, if the
Help author renames one of the TOC items, the mapping will break. You must get the
updated Help and re-create the mapping with the updated TOC.
6.
Click OK to close the Select Help Topic dialog box. The topic is mapped to the control
and appears in the C1DynamicHelp Help window at run time when a user clicks or
mouses over the control.
Preparing C1DynamicHelp for Authoring

Mode
To allow Help authors to activate and deactivate C1DynamicHelp authoring mode so that they
can map topics in your application, you have a wide variety of options. You can use anything
from a special keystroke combination to a registry node that, if present, activates authoring
mode.
This example shows how to specify a keystroke combination.
1.
2.
Specify a source Help file for C1DynamicHelp.

Select your Form and set the KeyPreview property to True in the Properties window.
15
3.
4.
Select View | Code so you can add code to override the OnKeyDown method and
specify a keystroke combination to activate and deactivate authoring mode.
Add the following code:
To write code in Visual Basic
Visual Basic
Copy Code
' toggle authoring mode when the user hits Ctrl+Shift+A

Protected Overrides Sub OnKeyDown(ByVal e As
System.Windows.Forms.KeyEventArgs)
If (e.KeyCode = Keys.A And e.Control And e.Shift) Then
C1DynamicHelp1.AuthoringMode = Not C1DynamicHelp1.AuthoringMode
End If
MyBase.OnKeyDown(e)
End Sub
To write code in C#
C#
Copy Code
// toggle authoring mode when the user hits Ctrl+Shift+A

override protected void OnKeyDown(KeyEventArgs e)
{
if (e.KeyCode == Keys.A && e.Control && e.Shift)
{
c1DynamicHelp1.AuthoringMode = !c1DynamicHelp1.AuthoringMode;
}
base.OnKeyDown(e);
}
C1DynamicHelp authoring mode will be activated or deactivated when the user presses the
Ctrl+Shift+A keys.
For Help Authors: Mapping in Authoring

Mode
Topic mapping is generally performed by the application Help author or Information Developer;
for that reason, the roles of the Information Developer and Software Developer in the process
are clearly defined here, although one person may perform both roles.
The files used for mapping include:
16
NetHelp project files or .chm (compiled HTML Help)

The Help file format is specified by the software developer. If using NetHelp, all of the
files in the output folder of your Help project must be deployed with the application. If
using HTML Help, only the .chm must be included.
Note: In Doc-To-Help, NetHelp project files are stored by default in the NetHelp folder; the
compiled HTML Help file is stored in the HTMLHelp folder.
Default.htm.xml or HelpFileName.chm.xml
When you create mappings, they are saved to the default.htm.xml or
HelpFileName.chm.xml located in the same directory as your source Help file, by
default. This XML is used to show the topics when the application runs.
You cannot begin mapping until you place your Help into the correct folder. NetHelp or .chm
files should be copied to the install folder specified by the software developer for your
application (for example: \\program files\componentone\DocToHelp\Help).
When you have finished mapping topics, the .chm or NetHelp project files and the .xml
containing the topic mappings must be given to the software developer.
Note: The .xml mapping file should never be edited manually. If mappings need to be
deleted, use the C1DynamicHelp authoring mode (see below).
C1DynamicHelp Authoring Mode

DynamicHelp for WinForms provides a special run-time mode, authoring mode, for Help
authors to use for assigning topics to controls within an application. When activated, the
authoring mode panel and toolbar appear.
17
Information about the control being mapped to is provided in the Selected control area of the
panel, which is made up of the following fields:
Control Control name : type of control.
Path
The path of the control relative to its placement on the form. For example, a Node
within a TreeView control may have a path that looks like this:
Form1\TreeView1\Node0.
Type
Type of control.
Topic
Topic to associate with the control.
The software developer controls how you to activate and deactivate authoring mode.
See Also
Mapping a Topic to a Control in Authoring Mode
Removing the Topic Mapping for a Selected Control
Assign a Topic to a Parent Control
18
Mapping a Topic to a Control in Authoring

Mode
To map a control to a topic using the C1DynamicHelp authoring mode, use the following
steps:
1.
2.
Display the area of the application's interface that you would like to map. For example,
if you are going to map ribbons, make sure they are all available. If you are going to
map windows, make sure they are all open.
Activate authoring mode using the method specified by the software developer. The
authoring mode panel appears.
3.
4.
Click the Select control button

.
Click the item you would like to map a Help topic to. As you move the mouse over the
controls, you will see information about them in the authoring mode panel: Control
name, Path, control Type, and associated Topic, if applicable.
5.
Click the Attach topic to control button

. The Select Help Topic dialog box
appears and shows the Table of Contents tab and TOC from the source Help file.
By default, the Use default events check box is selected (the selected options will vary
by the control youve chosen to map to). Got focus sets the Help topic to display when
the control has been selected; Mouse hover sets the Help topic to display when the
control has been hovered over. To change the default options, clear the Use default
events check box and select either the Got focus or Mouse hover check box.
19
If mapping to the TOC: From the Select Help Topic dialog box, Table of
Contents tab, choose a topic. Click OK. The topic chosen will display in the
Topic field of the authoring mode panel.
If mapping to the context ID list: From the Select Help Topic dialog box,
Context ID tab, choose the context ID/Topic pairing. Click OK. The topic
chosen will display in the Topic field of the authoring mode panel.
Note: In order to map to a topic, the topic must be in the Help TOC or have a context ID
assigned to it; otherwise, it will not appear in the Select Help Topic dialog box. Also, if you
rename one of the TOC items, the mapping will break. Simply drop the updated Help into
the proper folder and re-create the mapping with the updated TOC.
6.
7.
8.
9.
Click the Save button

.
Continue mapping.
To close the window, use the method specified by the software developer.
Deliver the .xml mapping file to the software developer.
Note: After mapping, you should backup the .xml mapping file elsewhere on your
machine. If you uninstall or reinstall your software product, the .xml mapping file will be
deleted and replaced.
Removing the Topic Mapping for a Selected

Control
To remove the topic mapping for a selected control, use the following steps:
1.
2.
Click the Select Control button

and select the control that you would like to
remove the topic mapping from. The control name appears in the Control field of the
authoring mode panel, so you can make sure the correct control has been selected.
3.
Click the Detach Topic from Control button

. The topic mapping is removed.
Notice there is no longer a topic specified in the Topic field.
4.
5.

.
Close the mapping window and deliver the proper Help and .xml mapping file to the
software developer.
Assign a Topic to a Parent Control

There may be times you need to attach a topic not to a control you can select, but to its parent
or ancestor. Since the parent can be completely covered by child controls and thus
unselectable, there is a special provision to do it in authoring mode.
20
1.
2.
3.
Click the Select control button

.
Click the child control of the parent or ancestor control you would like to map a Help
topic to.
Click the drop-down arrow in the Control combo box and select the parent or ancestor
to map to.
4.
5.
6.
7.
8.

. The Select Help Topic dialog box
appears and shows the Table of Contents tab and TOC from the source Help file.
Select the topic from the Table of Contents tab or select the context ID/Topic pairing
on the Context IDs tab, and specify any desired events.
.
Close the mapping window and deliver the proper Help and .xml mapping file to the
software developer.
Advanced Features
DynamicHelp for WinForms requires almost no programming to be used in most cases, but
sometimes you may want to use the best of it. The following advanced features are described in
this topic:
Displaying any Help format

C1DynamicHelp allows you to use different help formats. This topic describes two builtin help providers, ChmProvider and NetHelpProvider, and how to implement your own
help provider to display a help file in the format you want.
Mapping to part of a control or custom controls

C1DynamicHelp gives you the ability to map a topic not only to standard controls but
also to parts of controls or to custom controls. C1DynamicHelp provides this feature for
standard .Net controls derived from the System.Windows.Forms.Control class. But if you
want to extend it to your needs, you can create your own UI element resolver class.
See Also
Displaying any Help Format
Mapping to Control Parts or Custom Controls
21
Displaying any Help Format

You may want to use different help formats in your application:
HTML help;
NetHelp;
MS Help 2.0;
WinHelp;
RoboHelp WebHelp;
and so on.
C1DynamicHelp provides means for displaying these or any other help formats.
HTML Help and NetHelp formats can be displayed by the C1DynamicHelp control without any
additional programming. There are two built-in help providers in C1DynamicHelp, ChmProvider
and NetHelpProvider, which are used automatically when the HelpSource property points to a
.chm or an .htm/html file, correspondingly.
Any other types of help files can be used, but this requires some additional programming. In
this case you will have to create your own help provider class that implements the IHelpProvider
interface. This interface provides all necessary information about a help format to the
C1DynamicHelp control. So any help provider can read data from a help source and provides
methods to get help topics, to get context IDs, to open help in an external window, to get a
topic URL that can be displayed by the C1DynamicHelp control, and so on. After creating your
own help provider, all you need is to set it to the Provider property.
For more details see:
the IHelpProvider interface, which must be implemented by every help provider;

the Provider property;
the NetHelpProvider sample, which is the full code actually used in the C1DynamicHelp
control.

C1DynamicHelp allows you to map a help topic to any control derived from the
System.Windows.Forms.Control class. In most cases it will be enough, but sometimes you may
want to map a topic not to a control itself but to some part of it or map a topic to a custom
control which is not derived from the System.Windows.Forms.Control. We will refer to these
parts of controls and the custom controls as UI elements. To inform the C1DynamicHelp control
how to handle UI elements, you will need to create your own class derived from the
UIElementResolver class and set it as the Resolver property.
You will need to create a class derived from the UIElementResolver only if you are using custom
controls that cannot be handled by the C1DynamicHelp control automatically and then only if
you need to associate help topics with parts (UI elements) of those controls, not with the
controls themselves.
22
You have no need to create objects of UIElementResolver type, it is sufficient to define a class
derived from UIElementResolver and override its virtual methods. These overridden methods
must provide necessary information about UI elements inside custom controls used in your
application: methods to find UI elements inside a control by name, coordinates, etc., and other
methods necessary for associating dynamic help to UI elements inside a control.
C1DynamicHelp automatically handles most popular, standard controls. For example, it allows
mapping a topic to all standard .Net controls and to their parts. So, for example, you can
associate a help topic to a separate node of the standard TreeView control or to a separate
ListViewItem of the ListView control; that you can do without creating your own
UIElementResolver class.
For more details see:
the UIElementResolver class, from which you derive your own UI element resolver class;
the Resolver property;
the UsingUIElementResolver sample, which shows how to create custom UI element
resolver for the C1Ribbon control to allow mapping topics to items inside C1Ribbon
such as tabs, buttons, groups, etc.
DynamicHelp for WinForms Tutorials

The following tutorials provide step-by-step instructions on mapping Help topics to controls
within an application. Tutorial 1 explains how to map Help topics at design time within Visual
Studio. This is usually done by a software developer. Tutorial 2 explains how software
developers can set up C1DynamicHelp authoring mode and how Help authors can then use it
to assign topics to controls on a form, without having to manually edit a topic map.
See Also
Tutorial 1: Mapping Help Topics at Design Time
Tutorial 2: Mapping Help Topics in Authoring Mode
Tutorial 1: Mapping Help Topics at Design

Time
This tutorial explains how to use C1DynamicHelp to map Help topics to controls on a form at
design time within Visual Studio. This is usually done by a software developer.
See Also
Step 1 of 6: Add controls to the Windows form
Step 2 of 6: Set up the C1DynamicHelp control
Step 3 of 6: Associate topics with controls on the form
Step 4 of 6: Associate a topic with the form
23
Step 5 of 6: Show topics programmatically

Step 6 of 6: Run the application
Step 1 of 6: Add controls to the Windows

form
In this step, you will add the C1DynamicHelp control to your form, along with a TextBox,
Button, and Checkbox.
1.
2.
3.
4.
5.
Create a .NET project and add the C1DynamicHelp control to the Toolbox. An extender
property, Help Topic on C1DynamicHelp, is added to all controls when
C1DynamicHelp is added to the form.
From the Toolbox, double-click the C1DynamicHelp control. It docks at the right of your
form.
Add a TextBox control to the form:
1. From the Toolbox, double-click the TextBox control to add it to your form.
2. From the Properties window, set the textBox1.Text property to Show topic on
got focus.
Add a Button control to the form:
1. From the Toolbox, double-click the Button control to add it to your form.
2. From the Properties window, set the button1.Text property to Show topic on
mouse hover.
Add a CheckBox control to the form:
1. From the Toolbox, double-click the CheckBox control to add it to your form.
2. From the Properties window, set the checkBox1.Text property to Show topic
programmatically.
You have successfully added the controls to your form, which should look similar to the
following:
In the next step you will set up the C1DynamicHelp control.
24
Step 2 of 6: Set up the C1DynamicHelp

control
In order to associate topics from your Help file with form controls, you must specify the source
Help file.
You can do this from the C1DynamicHelp Tasks menu by setting the HelpSource property to
any *.chm file or NetHelp *.htm file (use the default.htm or the file name that was used as the
base URL for the NetHelp target.). In this example, we will use the C1Sample.chm installed with
DynamicHelp for WinForms, by default.
1.
2.
3.
4.

Locate and select the C1Sample.chm. It is located in the Tutorials/Data folder, by
default.
Click Open.
Step 3 of 6: Associate topics with controls on

the form
You can associate Help topics with controls using the Select Help Topic dialog box.
1.
Select Button1 and click the ellipsis button next to the HelpTopic on
C1DynamicHelp1 property in the Properties window. The Select Help Topic dialog
box opens:
25
2.
3.
4.
Select any help topic from the Table of Contents tab and click OK. In this example, we
will select the Overview topic.
Select TextBox1 and set its HelpTopic on C1DynamicHelp1 property to any topic
from the Table of Contents tab.
In the Events group of the Select Help Topic dialog box, uncheck Use default events
and check the Got focus checkbox next to Show on events.
Unchecking Use default events allows you to specify the events on a per-control basis.
Otherwise, the DefaultTrigger property is used for all controls. Using the Events
settings makes showing topics automatic when a control obtains focus or the mouse
hovers over it, or in both cases. But if you want manual control over what triggers topic
display, you can uncheck both check boxes (or set DefaultTrigger=None; this will do it
for all controls if it's not overridden on a per-control basis) and show topics
programmatically.
5.
Click OK.
Step 4 of 6: Associate a topic with the form

You can also use the Select Help Topic dialog box to associate a topic with your form.
1.
Select Form1 and click the ellipsis button next to the HelpTopic on C1DynamicHelp1
property in the Properties window. The Select Help Topic dialog box appears, but
notice the Events group is different; in this case, it has one check box Always show
default topic first on form open.
The topic associated with the form is the default topic. It is shown when the control that
displays the current topic due to a focus/mouse hover event loses focus/mouse hover.
26
If the check box Always show default topic first on form open is checked, the default
topic is also shown when the form is opened.
2.
Select the default topic from the Table of Contents tab.
Step 5 of 6: Show topics programmatically

You can show a specific topic programmatically by using the ShowTopic method.
Create a CheckedChanged event handler for CheckBox1 and add code so it looks like the
following:
Visual Basic
Copy Code
Private Sub CheckBox1_CheckedChanged(ByVal sender As System.Object, ByVal e

As System.EventArgs) Handles CheckBox1.CheckedChanged
C1DynamicHelp1.ShowTopic("WordDocuments/glossaryofterms.htm")
End Sub
To write code in C#
27
C#
Copy Code
private void checkBox1_CheckedChanged(object sender, System.EventArgs e)

{
c1DynamicHelp1.ShowTopic("WordDocuments/glossaryofterms.htm");
}
Step 6 of 6: Run the application

To run the application, click the Start Debugging button and notice the following results:
When Form1 is loaded, the default topic is shown.

When the mouse is over the button, the topic is displayed.
Check or uncheck Show topic programmatically to display its associated topic.
When TextBox1 gets the focus, it displays the specified topic.
Congratulations, you have successfully completed Tutorial 1! In this tutorial you have learned
how to:
Add and set up the C1DynamicHelp control.

Associate topics with controls on a form at design-time.
Show topics programmatically.
28
Tutorial 2: Mapping Help Topics in

Authoring Mode
This tutorial shows the second method of assigning Help topics to controls on a form. It is done
entirely by Help authors; once a software developer sets up his application to use the
C1DynamicHelp authoring mode, he doesn't need to do anything to map topics to controls!
This eliminates the error-prone process of passing the topic/control map back and forth
between Help authors and software developers.
The first two steps of this tutorial explain how software developers can set up their applications
for authoring mode. Step 3 explains how Help authors can assign topics to controls in
authoring mode. The final step shows how the Help appears in the application.
See Also
Step 1 of 4: Add controls to the Windows form
Step 2 of 4: Set up the C1DynamicHelp control
Step 3 of 4: Using authoring mode
Step 4 of 4: Run the Application
Step 1 of 4: Add controls to the Windows

form
To set up your new Form with the C1DynamicHelp control, a TextBox, and a TreeView control,
complete the following steps. These steps should be performed by the software developer.
1.
2.
3.
4.
Create a .NET project and add the C1DynamicHelp control to the Toolbox.
From the Toolbox, double-click the C1DynamicHelp control. It docks at the right of your
form.
Add a TextBox control to the form:
1. From the Toolbox, double-click the TextBox control to add it to your form.
2. From the Properties window, set the textBox1.Text property to Show topic on
got focus.
Add the TreeView control to the form:
1. From the Toolbox, double-click the TreeView control to add it to your form.
2. From the Properties window, add nodes to the treeView1 according to the
following image:
29
In the next step you will set up the C1DynamicHelp control.
Step 2 of 4: Set up the C1DynamicHelp

control
In order to associate topics from your Help file with form controls, you must specify the source
Help file.
You can do this from the C1DynamicHelp Tasks menu by setting the HelpSource property to
any *.chm file or NetHelp *.htm file (use the default.htm or the file name that was used as the
base URL for the NetHelp target.). In this example, we will use the C1Sample.chm installed with
DynamicHelp for WinForms, by default.
Once a source Help file is specified, you can prepare the C1DynamicHelp control to be used in
authoring mode. This step should be performed by the developer.
1.
2.
3.
4.

Locate and select the C1Sample.chm. It is located in the Tutorials/Data folder, by
default.
Prepare the C1DynamicHelp control for using in authoring mode:
1. From the Properties window, set the Form1.KeyPreview property to True.
2. Override the OnKeyDown method by adding the following code:
Visual Basic
Copy Code
' toggle authoring mode when the user hits Ctrl+Shift+A
30
Protected Overrides Sub OnKeyDown(ByVal e As

System.Windows.Forms.KeyEventArgs)
If (e.KeyCode = Keys.A And e.Control And e.Shift) Then
C1DynamicHelp1.AuthoringMode = Not C1DynamicHelp1.AuthoringMode
End If
MyBase.OnKeyDown(e)
End Sub
To write code in C#
C#
Copy Code
// toggle authoring mode when the user hits Ctrl+Shift+A

override protected void OnKeyDown(KeyEventArgs e)
{
if (e.KeyCode == Keys.A && e.Control && e.Shift)
{
c1DynamicHelp1.AuthoringMode = !c1DynamicHelp1.AuthoringMode;
}
base.OnKeyDown(e);
}
3.
Create a handler for the Form_Load event and insert the following code to
instruct the C1DynamicHelp control to subscribe the controls to the events for
showing topics:
Visual Basic
Copy Code
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As

System.EventArgs) Handles MyBase.Load
C1DynamicHelp1.TopicMap.Refresh()
End Sub
To write code in C#
C#
Copy Code
31
private void Form1_Load(object sender, EventArgs e)

{
c1DynamicHelp1.TopicMap.Refresh();
}
5.
Create a handler for the Form_Closing event and insert the following code to ask the
user whether to save changes made in the topic map:
Visual Basic
Copy Code
Private Sub Form1_FormClosing(ByVal sender As System.Object, ByVal e As

System.Windows.Forms.FormClosingEventArgs) Handles MyBase.FormClosing
If (C1DynamicHelp1.TopicMap.HasChanges) Then
Dim dr As DialogResult
dr = MessageBox.Show("Would you like to save the changes you made to
control/topic map?", "C1DynamicHelp Tutorial", MessageBoxButtons.YesNoCancel,
MessageBoxIcon.Question)
If (dr = DialogResult.Yes) Then
C1DynamicHelp1.TopicMap.Save()
ElseIf (dr = DialogResult.Cancel) Then
e.Cancel = True
End If
End If
End Sub
To write code in C#
C#
Copy Code
private void Form1_FormClosing(object sender, FormClosingEventArgs e)

{
if (c1DynamicHelp1.TopicMap.HasChanges)
{
DialogResult result = MessageBox.Show("Would you like to save the
changes you made to control/topic map?", "C1DynamicHelp Tutorial",
MessageBoxButtons.YesNoCancel , MessageBoxIcon.Question);
if (result == DialogResult.Yes)
c1DynamicHelp1.TopicMap.Save();
32
else if (result == DialogResult.Cancel)

e.Cancel = true;
}
}
No controls have topics associated with them yet. The application can now be used by a Help
author to map topics to controls.
Step 3 of 4: Using authoring mode

This step explains how the Help author can activate authoring mode and associate topics with
controls.
1.
Run the application from the software developer and press the Ctrl+Shift+A keys
together to activate authoring mode. The authoring mode panel appears.
2.
Map a topic to the TextBox control:

1.
Click Select control button
and select TextBox1.
2.
3.

. The Select Help Topic dialog
box appears.
3. On the Table of Contents tab, select the Glossary of Terms topic.
4. Uncheck the Use default events and Mouse hover checkboxes so that only
Got focus is checked.
5. Click OK. Note that a topic is now displayed only when TextBox1 gets focus not when the mouse hovers over it.
Map a topic to the TreeView nodes:
1.
Click Select control button
2.

. The Select Help Topic dialog
box appears.
On the Table of Contents tab, select the Overview topic and click OK.
Assign the How to use C1DynamicHelp topic to the How to Use node using
steps a-c.
Assign the Design time support topic to the Design time node using steps a-c.
Assign the Runtime support topic to the Runtime node using steps a-c. Note
that the corresponding topics are displayed when the mouse hovers over each
of the TreeView nodes.
3.
4.
5.
6.
and select the Overview node.
Note: In authoring mode you have the ability to associate topics with objects whose class
is not derived from Component, such as TreeNode or ListBox items. This cannot be done
at design time, because there is no Component to set for the HelpTopic on
33
C1DynamicHelp1 property.
4.
Click the Save control/topic mapping

that serves as the topic map.
button to save the changes to an .xml file
Note: If you close the application without saving the control/topic mapping, a dialog box
will appear, prompting you to save the changes.
5.
6.
7.
8.
The topic map is saved to the same location as the Help file specified in the HelpSource
property. It will also have the same name as the specified Help file, only with an .xml
extension. In this example, the topic map can be found in the C1Sample.chm.xml file.
It should now look like this:
XML code
<Dictionary>
<item>
<key>Form1\textBox1</key>
<value>WordDocuments/glossaryofterms.htm</value>
<events useDefaultEvents="False">1</events>
</item>
<item>
<key>Form1\treeView1\Node1</key>
<value>WordDocuments/howtousec1dynamichelp.htm</value>
<events useDefaultEvents="True">3</events>
</item>
<item>
<key>Form1\treeView1\Node0</key>
<value>WordDocuments/overview.htm</value>
</item>
<item>
<key>Form1\treeView1\Node1\Node2</key>
<value>WordDocuments/designtimesupport.htm</value>
</item>
<item>
<key>Form1\treeView1\Node1\Node3</key>
<value>WordDocuments/runtimesupport.htm</value>
</item>
</Dictionary>
Give the C1Sample.chm.xml file, along with the updated Help file(s), if changed, to the
software developer.
Step 4 of 4: Run the Application

To run the application, click the Start Debugging button and notice the following results. This
step should be performed by the developer.
34
When the mouse hovers over the TreeView nodes, the specified topics are displayed.
Only when TextBox1 gets the focus will it display a topic.
Congratulations, you have successfully completed Tutorial 2! In this tutorial you have learned
how to:
Add and set up the C1DynamicHelp control.

Activate/deactivate authoring mode.
Associate topics to controls on a form in authoring mode.
Save changes in the topic map.
API Reference
The following topics contain the API reference for DynamicHelp for WinForms.
See Also
C1.Win.C1DynamicHelp.4 Assembly
Namespaces
C1.Win.C1DynamicHelp Namespace
Overview
Classes
35
Class
Description
C1DynamicHelp
Provides dynamic help for applications.
Conflict
Class used in the TopicMap.Conflicts property of the TopicMap.
HelpTopic
Represents a topic in a help file.
HelpTopicList
List of HelpTopic objects.
MapItem
Class containing a pair consisting of a topic and a user action

triggering its display.
TopicEventArgs
Provides data for a topic change event.
TopicMap
Class used to store combinations of topics and user actions that cause
their display.
UIElementInfo
This class contains information about a UI element: its Name and

Parent.
UIElementResolver This class provides methods to find UI elements inside a control by

name, coordinates, etc, and other methods necessary for associating
dynamic help to UI elements inside a control.
Delegates
Delegate
Description
HelpTopicEventHandler Represents a method that will handle the

C1DynamicHelp.CurrentTopicChanging event of a
C1DynamicHelp.
Enumerations
Enumeration
Description
DisplayTarget
Enumeration that specifies where a topic will be displayed.
36
HelpTab
Enumeration specifying the part/element of the help file to display.
HelpTopicTrigger Enumeration that specifies user actions that cause a HelpTopic to be

displayed.
MapItemType
Enumeration that specifies topic map item type.
UIElementEvents
Enumeration that specifies which of the monitored events occurred for

a UI element.
See Also
Reference
Classes
C1DynamicHelp
Object Model
Syntax
Visual Basic (Declaration)
Public Class C1DynamicHelp
Inherits System.Windows.Forms.Control
C#
public class C1DynamicHelp : System.Windows.Forms.Control
Remarks
The C1DynamicHelp control displays help topics from CHM, NetHelp and other help files.
The HelpSource property specifies the help file containing the documentation.
Topics in the help file can be associated with components in the application either by a
programmer at design time, using the HelpTopic extender property, or without programmers,
using the control's 'authoring mode' facilities.
37
Inheritance Hierarchy
System.Object
System.MarshalByRefObject
System.ComponentModel.Component
System.Windows.Forms.Control
C1.Win.C1DynamicHelp.C1DynamicHelp
Requirements
Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server
2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or
later), Windows Server 2003 SP2
See Also
Reference
C1DynamicHelp Members
Overview
Object Model
Syntax
Public Class C1DynamicHelp
Inherits System.Windows.Forms.Control
C#
public class C1DynamicHelp : System.Windows.Forms.Control
Remarks
The C1DynamicHelp control displays help topics from CHM, NetHelp and other help files.
The HelpSource property specifies the help file containing the documentation.
Topics in the help file can be associated with components in the application either by a
programmer at design time, using the HelpTopic extender property, or without programmers,
using the control's 'authoring mode' facilities.
38
System.Object
System.MarshalByRefObject
System.ComponentModel.Component
System.Windows.Forms.Control
C1.Win.C1DynamicHelp.C1DynamicHelp
Requirements
See Also
Reference
Members
Properties Methods Events
The following tables list the members exposed by C1DynamicHelp.
Public Constructors
Name
Description
C1DynamicHelp Constructor Creates a new instance of the C1DynamicHelp control.

Top
Public Properties
Name
Description
AccessibilityObject
(Inherited from System.Windows.Forms.Control)
AccessibleDefaultActionDescription (Inherited from System.Windows.Forms.Control)

AccessibleDescription
AccessibleName
AccessibleRole
39
Anchor
AuthoringMode
Gets or sets a value indicating whether the control is

currently in 'authoring mode'.
AutoScrollOffset
BindingContext
BorderStyle
Gets or sets the type of border to display around the

control.
Bottom
Bounds
Browser
Provides access to the browser object used to display

the topics, so the programmer can use browser
features programmatically, for example, to navigate
help topics inside the C1DynamicHelp control.
CanFocus
CanSelect
Capture
CausesValidation
ClientRectangle
ClientSize
CompanyName
Container
(Inherited from
System.ComponentModel.Component)
40
ContainsFocus
ContextMenu
Overridden. Gets or sets the shortcut menu

associated with the control.
ContextMenuStrip
Overridden. Gets or sets the

System.Windows.Forms.ContextMenuStrip associated
with this control.
Controls
Created
CurrentTopic
Gets or sets the HelpTopic that is currently displayed

by the C1DynamicHelp control.
DataBindings
DefaultTrigger
Gets or sets a default HelpTopicTrigger value for the

DisplayRectangle
Disposing
Dock
Overridden. Gets or sets which control borders are

docked to its parent control and determines how the
control is resized with its parent.
Focused
Handle
HasChildren
Height
HelpSource
Gets or sets the location of the help source, such as
41
the name of a .chm file (for HTML Help) or the name

of the main .htm file (for NetHelp).
InvokeRequired
IsAccessible
IsDisposed
IsHandleCreated
IsMirrored
IsPinnedDown
Gets or sets a value indicating whether the current

help topic is pinned down.
LayoutEngine
Left
Location
MainControl
Gets or sets a reference to another C1DynamicHelp

control which will be used as a source of data for the
current C1DynamicHelp control.
Margin
MaximumSize
MinimumSize
MouseHoverDelay
Gets or sets the interval, in milliseconds, between the

time the mouse enters a control or component and
the time the associated HelpTopic is displayed in the
Name
42
Parent
PreferredSize
ProductName
ProductVersion
Provider
Gets or sets a reference to a help provider.
RecreatingHandle
Region
Resolver
Represents a class with virtual methods that are used

to supply information about custom controls used in
the application.
Right
Site
Size
TabIndex
TabStop
Tag
Top
TopicMap
A dictionary that maps UI elements to MapItem

objects.
TopLevelControl
Visible
43
Width
Top
Public Methods
Name
Description
BeginInvoke
Overloaded. (Inherited from System.Windows.Forms.Control)
BringToFront
Contains
CreateControl
CreateGraphics
CreateObjRef
(Inherited from System.MarshalByRefObject)
Dispose()
(Inherited from System.ComponentModel.Component)
DoDragDrop
DrawToBitmap
EndInvoke
FindForm
Focus
GetChildAtPoint
GetContainerControl
GetHelpTopic
Gets the MapItem object currently associated with a given UI

element.
44
GetLifetimeService
GetNextControl
GetPreferredSize
Hide
InitializeLifetimeService
Invalidate
Invoke
PerformLayout
PointToClient
PointToScreen
PreProcessControlMessage
PreProcessMessage
RectangleToClient
RectangleToScreen
Refresh
ResetText
ResumeLayout
Scale
Select
45
SelectNextControl
SendToBack
SetBounds
SetHelpTopic
Associates a MapItem object with a UI element.
Show
ShowDefaultTopic
Shows the topic associated with the Form where the

C1DynamicHelp control is placed.
ShowExternalHelp
Overloaded. Displays the contents of the help file in an

external help viewer window instead of in the C1DynamicHelp
panel.
ShowTopic
Overloaded. Shows the topic with the given URL in the

ShowTopicForActiveControl Shows in DisplayTarget the topic associated with the active

control (control currently in focus).
SuspendLayout
ToString
Update
Top
Public Events
Name
Description
CausesValidationChanged
ClientSizeChanged
46
ContextMenuChanged
ContextMenuStripChanged (Inherited from System.Windows.Forms.Control)

ControlAdded
ControlRemoved
CurrentTopicChanged
Fires after the value of the CurrentTopic has changed.
CurrentTopicChanging
Fires before the value of the CurrentTopic changes.
Disposed
DockChanged
GotFocus
HandleCreated
HandleDestroyed
Invalidated
LocationChanged
LostFocus
MarginChanged
Move
ParentChanged
PreviewKeyDown
RegionChanged
47
Resize
SizeChanged
SystemColorsChanged
TabIndexChanged
TabStopChanged
Validated
Validating
VisibleChanged
Top
See Also
Reference
C1DynamicHelp Class
C1DynamicHelp Constructor
Creates a new instance of the C1DynamicHelp control.
Syntax
Public Function New()
C#
public C1DynamicHelp()
Requirements
See Also
48
Reference
C1DynamicHelp Class
Methods
>
Name
Description
BeginInvoke
BringToFront
Contains
CreateControl
CreateGraphics
CreateObjRef
Dispose()
DoDragDrop
DrawToBitmap
EndInvoke
FindForm
Focus
GetChildAtPoint
GetContainerControl
GetHelpTopic
Gets the MapItem object currently associated with a given UI

element.
GetLifetimeService
GetNextControl
GetPreferredSize
Hide
InitializeLifetimeService
Invalidate
49
Invoke
PerformLayout
PointToClient
PointToScreen
PreProcessControlMessage (Inherited from System.Windows.Forms.Control)

PreProcessMessage
RectangleToClient
RectangleToScreen
Refresh
ResetText
ResumeLayout
Scale
Select
SelectNextControl
SendToBack
SetBounds
SetHelpTopic
Show
ShowDefaultTopic
Shows the topic associated with the Form where the

C1DynamicHelp control is placed.
ShowExternalHelp
Overloaded. Displays the contents of the help file in an external

help viewer window instead of in the C1DynamicHelp panel.
ShowTopic
Overloaded. Shows the topic with the given URL in the

ShowTopicForActiveControl
Shows in DisplayTarget the topic associated with the active

control (control currently in focus).
SuspendLayout
ToString
Update
50
Top
See Also
Reference
C1DynamicHelp Class
GetHelpTopic Method
Represents a UI element associated with a help topic.
Gets the MapItem object currently associated with a given UI element.
Syntax
Public Function GetHelpTopic( _
ByVal uiElement As Component _
) As MapItem
C#
public MapItem GetHelpTopic(
Component uiElement
)
Parameters
uiElement
Represents a UI element associated with a help topic.
Return Value
The MapItem object associated with the specified UI element.
Requirements
Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows
Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported
with SP1 or later), Windows Server 2003 SP2
See Also
Reference
C1DynamicHelp Class
51
SetHelpTopic Method
Object associated with the help topic.
The MapItem object to associate with the uiElement.
Syntax
Public Sub SetHelpTopic( _
ByVal uiElement As Component, _
ByVal info As MapItem _
)
C#
public void SetHelpTopic(
Component uiElement,
MapItem info
)
Parameters
uiElement
Object associated with the help topic.
info
The MapItem object to associate with the uiElement.
Requirements
Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3,
Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server
Core supported with SP1 or later), Windows Server 2003 SP2
See Also
Reference
C1DynamicHelp Class
ShowDefaultTopic Method
Shows the topic associated with the Form where the C1DynamicHelp control is placed.
Syntax
52

Public Sub ShowDefaultTopic()
C#
public void ShowDefaultTopic()
Requirements
See Also
Reference
C1DynamicHelp Class
ShowExternalHelp Method
Displays the contents of the help file in an external help viewer window instead of in the
C1DynamicHelp panel.
Overload List
Overload
Description
ShowExternalHelp(HelpTab)
Displays the contents of the help file in an external help

viewer window instead of in the C1DynamicHelp panel.
ShowExternalHelp(HelpTab,Object) Displays the contents of the help file in an external help

Requirements
See Also
Reference
C1DynamicHelp Class
53
ShowExternalHelp(HelpTab) Method
One of the HelpTab values.
Syntax
Public Overloads Sub ShowExternalHelp( _
ByVal tab As HelpTab _
)
C#
public void ShowExternalHelp(
HelpTab tab
)
Parameters
tab
Requirements
See Also
Reference
C1DynamicHelp Class
Overload List
ShowExternalHelp(HelpTab,Object) Method
Syntax
54
ByVal tab As HelpTab, _

ByVal parameter As Object _
)
C#
HelpTab tab,
object parameter
)
Parameters
tab
parameter
Requirements
See Also
Reference
C1DynamicHelp Class
Overload List
ShowTopic Method
Shows the topic with the given URL in the C1DynamicHelp control.
Overload List
Overload
Description
ShowTopic(String)
ShowTopic(HelpTopic) Shows the given HelpTopic in the C1DynamicHelp control.

ShowTopic(Int32)
Shows the topic with the given context id in the C1DynamicHelp

control.
55
ShowTopic(Object)
Shows the topic associated in the TopicMap with a UI element in the

Requirements
See Also
Reference
C1DynamicHelp Class
ShowTopic(String) Method
String that represents the topic's internal URL.
Syntax
Public Overloads Sub ShowTopic( _
ByVal topicUrl As String _
)
C#
public void ShowTopic(
string topicUrl
)
Parameters
topicUrl
String that represents the topic's internal URL.
Exceptions
Exception
Description
System.ArgumentNullException topicUrl is null.
Requirements
56
See Also
Reference
C1DynamicHelp Class
Overload List
ShowTopic(HelpTopic) Method
HelpTopic object representing the topic.
Shows the given HelpTopic in the C1DynamicHelp control.
Syntax
ByVal topic As HelpTopic _
)
C#
HelpTopic topic
)
Parameters
topic
HelpTopic object representing the topic.
Exceptions
Exception
Description
System.ArgumentNullException topic is null.
Requirements
See Also
57
Reference
C1DynamicHelp Class
Overload List
ShowTopic(Int32) Method
Context id representing the topic.
Shows the topic with the given context id in the C1DynamicHelp control.
Syntax
ByVal contextID As Integer _
)
C#
int contextID
)
Parameters
contextID
Context id representing the topic.
Exceptions
Exception
Description
System.ArgumentException specified context id is unknown.
Requirements
See Also
Reference
C1DynamicHelp Class
Overload List
58
ShowTopic(Object) Method
Object associated with the topic to display.
Shows the topic associated in the TopicMap with a UI element in the C1DynamicHelp control.
Syntax
ByVal uiElement As Object _
)
C#
object uiElement
)
Parameters
uiElement
Object associated with the topic to display.
Exceptions
Exception
Description
System.ArgumentNullException uiElement is null.
Requirements
See Also
Reference
C1DynamicHelp Class
Overload List
ShowTopicForActiveControl Method
DisplayTarget where a topic will be displayed.
Shows in DisplayTarget the topic associated with the active control (control currently in focus).
59
Syntax
Public Sub ShowTopicForActiveControl( _
ByVal displayTarget As DisplayTarget _
)
C#
public void ShowTopicForActiveControl(
DisplayTarget displayTarget
)
Parameters
displayTarget
DisplayTarget where a topic will be displayed.
Requirements
See Also
Reference
C1DynamicHelp Class
Properties
%%scrap%%
" -->
For a list of all members of this type, see C1DynamicHelp members.
Public Properties
Name
Description
AccessibilityObject
AccessibleDefaultActionDescription (Inherited from System.Windows.Forms.Control)
60
AccessibleDescription
AccessibleName
AccessibleRole
Anchor
AuthoringMode
Gets or sets a value indicating whether the control is

currently in 'authoring mode'.
AutoScrollOffset
BindingContext
BorderStyle
Gets or sets the type of border to display around the

control.
Bottom
Bounds
Browser
Provides access to the browser object used to display

the topics, so the programmer can use browser
features programmatically, for example, to navigate
help topics inside the C1DynamicHelp control.
CanFocus
CanSelect
Capture
CausesValidation
ClientRectangle
ClientSize
61
CompanyName
Container
(Inherited from
System.ComponentModel.Component)
ContainsFocus
ContextMenu
Overridden. Gets or sets the shortcut menu associated

with the control.
ContextMenuStrip
Overridden. Gets or sets the

System.Windows.Forms.ContextMenuStrip associated
with this control.
Controls
Created
CurrentTopic
Gets or sets the HelpTopic that is currently displayed

by the C1DynamicHelp control.
DataBindings
DefaultTrigger
Gets or sets a default HelpTopicTrigger value for the

DisplayRectangle
Disposing
Dock
Overridden. Gets or sets which control borders are

docked to its parent control and determines how the
Focused
Handle
62
HasChildren
Height
HelpSource
Gets or sets the location of the help source, such as

the name of a .chm file (for HTML Help) or the name
of the main .htm file (for NetHelp).
InvokeRequired
IsAccessible
IsDisposed
IsHandleCreated
IsMirrored
IsPinnedDown
Gets or sets a value indicating whether the current

help topic is pinned down.
LayoutEngine
Left
Location
MainControl
Gets or sets a reference to another C1DynamicHelp

control which will be used as a source of data for the
current C1DynamicHelp control.
Margin
MaximumSize
MinimumSize
MouseHoverDelay
Gets or sets the interval, in milliseconds, between the
63
time the mouse enters a control or component and

the time the associated HelpTopic is displayed in the
Name
Parent
PreferredSize
ProductName
ProductVersion
Provider
RecreatingHandle
Region
Resolver
Represents a class with virtual methods that are used

to supply information about custom controls used in
the application.
Right
Site
Size
TabIndex
TabStop
Tag
Top
64
TopicMap
A dictionary that maps UI elements to MapItem

objects.
TopLevelControl
Visible
Width
Top
See Also
Reference
C1DynamicHelp Class
AuthoringMode Property
Gets or sets a value indicating whether the control is currently in 'authoring mode'.
Syntax
Public Property AuthoringMode As Boolean
C#
public bool AuthoringMode {get; set;}
Remarks
This property allows the application user to create or modify the TopicMap at run time, and
save it to an XML file. All map items created in authoring mode have their ItemType property
set to MapItemType.Dynamic.
The map items with dynamic ItemType have precedence over the items with static
MapItem.ItemType. If a UI element appears with both dynamic and static MapItem.ItemType,
the entry with the dynamic MapItem.ItemType will be used instead of the static one.
Authoring mode is typically enabled only in special builds used by control authors to create the
dynamic topic map that is shipped with the release version of the application. In most cases,
authoring mode needs to be be disabled in the release application to prevent users from
accidentally activating the authoring mode. A typical implementation can look like this:
// toggle authoring mode when the user hits ctrl+shift+a override
protected void OnKeyDown(KeyEventArgs e) { #if AUTHOR_MODE if
(e.KeyCode == Keys.A && e.Control && e.Shift) {
65
c1DynamicHelp1.AuthoringMode = !c1DynamicHelp1.AuthoringMode; } #endif

base.OnKeyDown(e); }
Requirements
See Also
Reference
C1DynamicHelp Class
BorderStyle Property
Gets or sets the type of border to display around the control.
Syntax
Public Property BorderStyle As BorderStyle
C#
public BorderStyle BorderStyle {get; set;}
Requirements
See Also
Reference
C1DynamicHelp Class
Browser Property
Provides access to the browser object used to display the topics, so the programmer can use
browser features programmatically, for example, to navigate help topics inside the
Syntax
66
Public ReadOnly Property Browser As WebBrowser

C#
public WebBrowser Browser {get;}
Requirements
See Also
Reference
C1DynamicHelp Class
ContextMenu Property
Gets or sets the shortcut menu associated with the control.
Syntax
Public Overrides Property ContextMenu As ContextMenu
C#
public override ContextMenu ContextMenu {get; set;}
Property Value
A System.Windows.Forms.ContextMenu that represents the shortcut menu associated with the
control.
Requirements
See Also
Reference
C1DynamicHelp Class
67
ContextMenuStrip Property
Gets or sets the System.Windows.Forms.ContextMenuStrip associated with this control.
Syntax
Public Overrides Property ContextMenuStrip As ContextMenuStrip
C#
public override ContextMenuStrip ContextMenuStrip {get; set;}
Property Value
The System.Windows.Forms.ContextMenuStrip for this control, or null if there is no
System.Windows.Forms.ContextMenuStrip. The default is null.
Requirements
See Also
Reference
C1DynamicHelp Class
CurrentTopic Property
Gets or sets the HelpTopic that is currently displayed by the C1DynamicHelp control.
Syntax
Public Property CurrentTopic As HelpTopic
C#
public HelpTopic CurrentTopic {get; set;}
Requirements
68
See Also
Reference
C1DynamicHelp Class
DefaultTrigger Property
Gets or sets a default HelpTopicTrigger value for the C1DynamicHelp control.
Syntax
Public Property DefaultTrigger As HelpTopicTrigger
C#
public HelpTopicTrigger DefaultTrigger {get; set;}
Remarks
All map items in the TopicMap that have their MapItem.UseDefaultTrigger property set to true
(default) display their topic when the event specified in the DefaultTrigger property occurs. Map
items that have MapItem.UseDefaultTrigger = false specify their triggers individually in
HelpTopicTrigger.
Requirements
See Also
Reference
C1DynamicHelp Class
Dock Property
Gets or sets which control borders are docked to its parent control and determines how the
Syntax
Public Overrides Property Dock As DockStyle
69
C#
public override DockStyle Dock {get; set;}
Requirements
See Also
Reference
C1DynamicHelp Class
HelpSource Property
Gets or sets the location of the help source, such as the name of a .chm file (for HTML Help) or
the name of the main .htm file (for NetHelp).
Syntax
Public Property HelpSource As String
C#
public string HelpSource {get; set;}
Remarks
The name of the file may be absolute or relative. In most cases, the name will be relative and
will refer to the application's bin folder.
Requirements
See Also
Reference
C1DynamicHelp Class
IsPinnedDown Property
Gets or sets a value indicating whether the current help topic is pinned down.
70
Syntax
Public Property IsPinnedDown As Boolean
C#
public bool IsPinnedDown {get; set;}
Requirements
See Also
Reference
C1DynamicHelp Class
MainControl Property
Gets or sets a reference to another C1DynamicHelp control which will be used as a source of
data for the current C1DynamicHelp control.
Syntax
Public Property MainControl As C1DynamicHelp
C#
public C1DynamicHelp MainControl {get; set;}
Remarks
The current C1DynamicHelp control will use the MainControl's properties: HelpSource, Resolver,
Provider, etc instead of its own properties. It is used to place C1DynamicHelp controls on
multiple forms that will display topics from one help source. In this case you will have one main
C1DynamicHelp control and set properties for it, and all you need to do for the other
C1DynamicHelp controls is to set their MainControl property to the main C1DynamicHelp
control.
Requirements
71
See Also
Reference
C1DynamicHelp Class
MouseHoverDelay Property
Gets or sets the interval, in milliseconds, between the time the mouse enters a control or
component and the time the associated HelpTopic is displayed in the C1DynamicHelp control.
Syntax
Public Property MouseHoverDelay As Integer
C#
public int MouseHoverDelay {get; set;}
Requirements
See Also
Reference
C1DynamicHelp Class
Provider Property
Syntax
Public Property Provider As IHelpProvider
C#
public IHelpProvider Provider {get; set;}
72
Exceptions
Exception
Description
System.ArgumentNullException Provider cannot be null.
Remarks
You should set this property only if you implement your own help provider class (an advanced
feature). A help provider can read data from a help source and provides methods to get a help
topic list, to get a dictionary of context ids and help topics, to open help in an external window,
to get a topic URL that can be displayed in a C1DynamicHelp control, etc.
There are two built-in help providers in C1DynamicHelp: ChmProvider and NetHelpProvider
which are used automatically when the HelpSource property points to a .chm or .html/.htm file
correspondingly.
Requirements
See Also
Reference
C1DynamicHelp Class
Resolver Property
Represents a class with virtual methods that are used to supply information about custom
controls used in the application.
Syntax
Public Property Resolver As UIElementResolver
C#
public UIElementResolver Resolver {get; set;}
Remarks
This property must be set only if custom/third-party controls are used in the application and it
is necessary to associate help with parts of such controls (called UI elements, for example,
buttons on a custom ribbon control). It should provide a way to get the Name and Parent for
73
every UI element, get a UI element inside the control by coordinates, get a UI element inside
the control by name, etc.
Requirements
See Also
Reference
C1DynamicHelp Class
TopicMap Property
A dictionary that maps UI elements to MapItem objects.
Syntax
Public ReadOnly Property TopicMap As TopicMap
C#
public TopicMap TopicMap {get;}
Remarks
A MapItem object specifies a help topic to display and a user action that causes the display
(control getting focus, mouse hovering). This dictionary can be created at design time and
persisted as part of the form (called static mappings), or at run-time (using the controls
authoring mode) and persisted as an XML file (called dynamic mappings).
This property enables you to obtain a reference to the topic map items that are currently stored
in the C1DynamicHelp. With this reference, you can add items, remove items, and obtain a
count of the items in the collection. The TopicMap class has members that allow users to check
whether the map has changed since it was created and to persist the map to and from XML.
Requirements
See Also
Reference
74
C1DynamicHelp Class
Events
%%scrap%%
" -->
For a list of all members of this type, see C1DynamicHelp members.
Public Events
Name
Description
CausesValidationChanged
ClientSizeChanged
ContextMenuChanged
ContextMenuStripChanged (Inherited from System.Windows.Forms.Control)

ControlAdded
ControlRemoved
CurrentTopicChanged
CurrentTopicChanging
Disposed
DockChanged
GotFocus
HandleCreated
HandleDestroyed
Invalidated
75
LocationChanged
LostFocus
MarginChanged
Move
ParentChanged
PreviewKeyDown
RegionChanged
Resize
SizeChanged
SystemColorsChanged
TabIndexChanged
TabStopChanged
Validated
Validating
VisibleChanged
Top
See Also
Reference
C1DynamicHelp Class
CurrentTopicChanged Event
76
Syntax
Public Event CurrentTopicChanged As EventHandler
C#
public event EventHandler CurrentTopicChanged
Requirements
See Also
Reference
C1DynamicHelp Class
CurrentTopicChanging Event
Syntax
Public Event CurrentTopicChanging As HelpTopicEventHandler
C#
public event HelpTopicEventHandler CurrentTopicChanging
Event Data
The event handler receives an argument of type TopicEventArgs containing data related to this
event. The following TopicEventArgs properties provide information specific to this event.
Property
Description
Cancel
Gets or sets a value indicating whether the event should be canceled.
Topic
Gets a value indicating the help topic becoming current.
Requirements
77
See Also
Reference
C1DynamicHelp Class
Conflict
Object Model
Syntax
Public Class Conflict
C#
public class Conflict
Remarks
This class contains data describing a conflict between two map items, one static, the other
dynamic. A conflict exists between two map items if they refer to the same UI element.
System.Object
C1.Win.C1DynamicHelp.Conflict
Requirements
See Also
Reference
Conflict Members
78
Overview
Object Model
Syntax
Public Class Conflict
C#
public class Conflict
Remarks
This class contains data describing a conflict between two map items, one static, the other
dynamic. A conflict exists between two map items if they refer to the same UI element.
System.Object
C1.Win.C1DynamicHelp.Conflict
Requirements
See Also
Reference
Conflict Members
Members
Properties
The following tables list the members exposed by Conflict.
Public Properties
Name
Description
79
DynamicItem
Returns the dynamic map item.
Name
Returns the name of the UI element (serving as the identifier of the static
map item).
StaticItem
Returns the static map item.
UIElementPath
Returns the UI element's path string (serving as the identifier of the

dynamic map item).
Top
See Also
Reference
Conflict Class
Properties
%%scrap%%
" -->
For a list of all members of this type, see Conflict members.
Public Properties
Name
Description
DynamicItem
Name
Returns the name of the UI element (serving as the identifier of the static
map item).
StaticItem
UIElementPath
Returns the UI element's path string (serving as the identifier of the

dynamic map item).
Top
See Also
Reference
80
Conflict Class
DynamicItem Property
Syntax
Public Property DynamicItem As MapItem
C#
public MapItem DynamicItem {get; set;}
Requirements
See Also
Reference
Conflict Class
Conflict Members
Name Property
Returns the name of the UI element (serving as the identifier of the static map item).
Syntax
Public Property Name As String
C#
public string Name {get; set;}
Requirements
See Also
81
Reference
Conflict Class
Conflict Members
StaticItem Property
Syntax
Public Property StaticItem As MapItem
C#
public MapItem StaticItem {get; set;}
Requirements
See Also
Reference
Conflict Class
Conflict Members
UIElementPath Property
Returns the UI element's path string (serving as the identifier of the dynamic map item).
Syntax
Public Property UIElementPath As String
C#
public string UIElementPath {get; set;}
Requirements
82
See Also
Reference
Conflict Class
Conflict Members
HelpTopic
Object Model
Syntax
Public Class HelpTopic
C#
public class HelpTopic
Remarks
You need to explicitly create HelpTopic objects in your code only if you implement your own
help provider.
System.Object
C1.Win.C1DynamicHelp.HelpTopic
Requirements
See Also
Reference
HelpTopic Members
Overview
83
Object Model
Syntax
Public Class HelpTopic
C#
public class HelpTopic
Remarks
You need to explicitly create HelpTopic objects in your code only if you implement your own
help provider.
System.Object
C1.Win.C1DynamicHelp.HelpTopic
Requirements
See Also
Reference
HelpTopic Members
Members
Properties Methods
The following tables list the members exposed by HelpTopic.
Public Constructors
Name
Description
HelpTopic Constructor Overloaded.

Top
84
Public Properties
Name
Description
ContextID
Gets the unique numeric ID of the topic within the help system used for
context sensitive help purposes.
SubTopics
Gets the list of child topics.
Title
Gets the name of the help topic.
Url
Gets the topic URL relative to the help source.
Top
Public Methods
Name
Description
SetCtxtId
Set context ID for this HelpTopic.
ToString
Gets a string representation of this HelpTopic.
Top
See Also
Reference
HelpTopic Class
HelpTopic Constructor
Overload List
Overload
Description
HelpTopic Constructor(String,String,HelpTopicList) Creates a new instance of HelpTopic.

HelpTopic Constructor(String,String)
Creates a new instance of HelpTopic.
Requirements
85
See Also
Reference
HelpTopic Class
HelpTopic Members
HelpTopic Constructor(String,String,HelpTopicList)
A title for the help topic being created.
A URL for the help topic being created.
Child topics for the topic being created.
Syntax
Public Function New( _
ByVal title As String, _
ByVal url As String, _
ByVal subtopics As HelpTopicList _
)
C#
public HelpTopic(
string title,
string url,
HelpTopicList subtopics
)
Parameters
title
url
subtopics
Child topics for the topic being created.
86
Requirements
Windows Server 2008 (Server Core not supported), Windows Server 2008 R2
(Server Core supported with SP1 or later), Windows Server 2003 SP2
See Also
Reference
HelpTopic Class
HelpTopic Members
Overload List
HelpTopic Constructor(String,String)
Syntax
ByVal title As String, _
ByVal url As String _
)
C#
public HelpTopic(
string title,
string url
)
Parameters
title
url
Requirements
87
See Also
Reference
HelpTopic Class
HelpTopic Members
Overload List
Methods
%%scrap%%
" -->
For a list of all members of this type, see HelpTopic members.
Public Methods
Name
Description
SetCtxtId
ToString
Top
See Also
Reference
HelpTopic Class
SetCtxtId Method
Context ID for thisHelpTopic.
Syntax
Public Sub SetCtxtId( _
ByVal ctxtId As Integer _
)
C#
public void SetCtxtId(
int ctxtId
88
Parameters
ctxtId
Context ID for thisHelpTopic.
Remarks
This method should be used only for creating you own help provider class.
Requirements
See Also
Reference
HelpTopic Class
HelpTopic Members
ToString Method
Syntax
Public Overrides Function ToString() As String
C#
public override string ToString()
Requirements
See Also
Reference
HelpTopic Class
HelpTopic Members
89
Properties
%%scrap%%
" -->
For a list of all members of this type, see HelpTopic members.
Public Properties
Name
Description
ContextID
Gets the unique numeric ID of the topic within the help system used for
context sensitive help purposes.
SubTopics
Title
Url
Top
See Also
Reference
HelpTopic Class
ContextID Property
Gets the unique numeric ID of the topic within the help system used for context sensitive help
purposes.
Syntax
Public ReadOnly Property ContextID As Integer
C#
public int ContextID {get;}
Requirements
90
See Also
Reference
HelpTopic Class
HelpTopic Members
SubTopics Property
Syntax
Public ReadOnly Property SubTopics As HelpTopicList
C#
public HelpTopicList SubTopics {get;}
Requirements
See Also
Reference
HelpTopic Class
HelpTopic Members
Title Property
Syntax
Public ReadOnly Property Title As String
C#
public string Title {get;}
Requirements
91
See Also
Reference
HelpTopic Class
HelpTopic Members
Url Property
Syntax
Public ReadOnly Property Url As String
C#
public string Url {get;}
Remarks
Since this is the relative URL, the help viewer/browser may be unable to display topics given
only that URL. Full URL can be obtained from the IHelpProvider.GetFullUrl method.
Requirements
See Also
Reference
HelpTopic Class
HelpTopic Members
HelpTopicList
Object Model
Syntax
92

Public Class HelpTopicList
Inherits System.Collections.Generic.List(Of HelpTopic)
C#
public class HelpTopicList : System.Collections.Generic.List<HelpTopic>
System.Object
System.Collections.Generic.List<T>
C1.Win.C1DynamicHelp.HelpTopicList
Requirements
See Also
Reference
HelpTopicList Members
Overview
Object Model
Syntax
Public Class HelpTopicList
Inherits System.Collections.Generic.List(Of HelpTopic)
C#
public class HelpTopicList : System.Collections.Generic.List<HelpTopic>
93
System.Object
System.Collections.Generic.List<T>
C1.Win.C1DynamicHelp.HelpTopicList
Requirements
See Also
Reference
Members
Properties Methods
The following tables list the members exposed by HelpTopicList.
Public Constructors
Name
Description
HelpTopicList Constructor
Top
Public Properties
Name
Description
Capacity
(Inherited from System.Collections.Generic.List<HelpTopic>)
Count
Item
Top
Public Methods
Name
Description
Add
94
AddRange
AsReadOnly
BinarySearch
Overloaded. (Inherited from System.Collections.Generic.List<HelpTopic>)
Clear
Contains
ConvertAll
CopyTo
Exists
Find
FindAll
FindIndex
FindLast
FindLastIndex
ForEach
GetEnumerator
GetRange
IndexOf
Insert
InsertRange
95
LastIndexOf
Remove
RemoveAll
RemoveAt
RemoveRange
Reverse
Sort
ToArray
TrimExcess
TrueForAll
Top
See Also
Reference
HelpTopicList Class
HelpTopicList Constructor
Syntax
C#
public HelpTopicList()
Requirements
96
See Also
Reference
HelpTopicList Class
MapItem
Class containing a pair consisting of a topic and a user action triggering its display.
Object Model
Syntax
Public Class MapItem
C#
public class MapItem
Remarks
Objects of this class are stored in the TopicMap dictionary. Map items are created automatically
at design time and in authoring mode. You can also create them at run time programmatically.
Map items created at design time have their ItemType property set to MapItemType.Static,
whereas map items created in authoring mode have their ItemType property set to
MapItemType.Dynamic. If you create a map item programmatically, you can set this property to
any of the two values.
System.Object
C1.Win.C1DynamicHelp.MapItem
Requirements
See Also
97
Reference
MapItem Members
Overview
Class containing a pair consisting of a topic and a user action triggering its display.
Object Model
Syntax
Public Class MapItem
C#
public class MapItem
Remarks
Objects of this class are stored in the TopicMap dictionary. Map items are created automatically
at design time and in authoring mode. You can also create them at run time programmatically.
Map items created at design time have their ItemType property set to MapItemType.Static,
whereas map items created in authoring mode have their ItemType property set to
MapItemType.Dynamic. If you create a map item programmatically, you can set this property to
any of the two values.
System.Object
C1.Win.C1DynamicHelp.MapItem
Requirements
See Also
Reference
MapItem Members
98
Members
" -->
Public Constructors
Name
Description
MapItem Constructor Initializes a new of instance of a MapItem

Top
Public Properties
Name
Description
HelpTopic
Gets the HelpTopic object by the Url value.
HelpTopicTrigger
Specifies what triggers the topic display.
ItemType
Gets or sets an item type.
Gets or sets a value indicating whether the default topic (the topic
associated with the form) should be always displayed when the form
ShowDefaultTopicFirst
is loaded and becomes visible, even if a UI element inside the form
got focus and has a topic associated with it.
UIElement
Gets or sets a UI element for which a help topic is displayed.
Url
Gets or sets the URL of a help topic that will be displayed.

Gets or sets a value indicating whether a topic will be displayed
depending on its own HelpTopicTrigger value or on the
C1DynamicHelp.DefaultTrigger value of the C1DynamicHelp control.
UseDefaultTrigger
Top
Public Methods
Name
ToString
Description
Returns a string representation of a MapItem, which is the topic URL.
Top
See Also
Reference
MapItem Class
99
MapItem Constructor
Initializes a new of instance of a MapItem
Syntax
C#
public MapItem()
Requirements
See Also
Reference
MapItem Class
MapItem Members
Methods
>
Name
ToString
Description
Top
See Also
Reference
MapItem Class
ToString Method
Syntax
Public Overrides Function ToString() As String
100
C#
public override string ToString()
Return Value
A System.String that represents the current MapItem.
Requirements
See Also
Reference
MapItem Class
MapItem Members
Properties
%%scrap%%
" -->
For a list of all members of this type, see MapItem members.
Public Properties
Name
Description
HelpTopic
HelpTopicTrigger
ItemType
ShowDefaultTopicFirst Gets or sets a value indicating whether the default topic (the topic
associated with the form) should be always displayed when the
form is loaded and becomes visible, even if a UI element inside the
form got focus and has a topic associated with it.
UIElement
Url
101
UseDefaultTrigger
Gets or sets a value indicating whether a topic will be displayed

depending on its own HelpTopicTrigger value or on the
C1DynamicHelp.DefaultTrigger value of the C1DynamicHelp
control.
Top
See Also
Reference
MapItem Class
HelpTopic Property
Syntax
Public ReadOnly Property HelpTopic As HelpTopic
C#
public HelpTopic HelpTopic {get;}
Requirements
See Also
Reference
MapItem Class
MapItem Members
HelpTopicTrigger Property
Syntax
Public Property HelpTopicTrigger As HelpTopicTrigger
102
C#
public HelpTopicTrigger HelpTopicTrigger {get; set;}
Remarks
This property is used only if the UseDefaultTrigger property is set to false. If UseDefaultTrigger
is set to true, this property is ignored and C1DynamicHelp.DefaultTrigger property is used
instead.
Requirements
See Also
Reference
MapItem Class
MapItem Members
ItemType Property
Syntax
Public Property ItemType As MapItemType
C#
public MapItemType ItemType {get; set;}
Remarks
Items with MapItemType.Dynamic are created in authoring mode and saved to an XML file.
Items with MapItemType.Static are created at design time and persisted as part of the form.
Items of both types can be created programmatically at run time.
Requirements
See Also
103
Reference
MapItem Class
MapItem Members
ShowDefaultTopicFirst Property
Gets or sets a value indicating whether the default topic (the topic associated with the form)
should be always displayed when the form is loaded and becomes visible, even if a UI element
inside the form got focus and has a topic associated with it.
Syntax
Public Property ShowDefaultTopicFirst As Boolean
C#
public bool ShowDefaultTopicFirst {get; set;}
Remarks
This property is used only for top level controls (Form objects), it is ignored for other UI
elements.
Requirements
See Also
Reference
MapItem Class
MapItem Members
UIElement Property
Syntax
Public Property UIElement As Object
C#
public object UIElement {get; set;}
104
Remarks
This property should be set only once and shouldn't be changed after that.
Requirements
See Also
Reference
MapItem Class
MapItem Members
Url Property
Syntax
Public Property Url As String
C#
public string Url {get; set;}
Requirements
See Also
Reference
MapItem Class
MapItem Members
UseDefaultTrigger Property
Gets or sets a value indicating whether a topic will be displayed depending on its own
HelpTopicTrigger value or on the C1DynamicHelp.DefaultTrigger value of the C1DynamicHelp
control.
Syntax
105

Public Property UseDefaultTrigger As Boolean
C#
public bool UseDefaultTrigger {get; set;}
Remarks
If this property is set to false, the HelpTopicTrigger property is used to determine when the
topic should be shown. Otherwise, the C1DynamicHelp.DefaultTrigger value determines when
the topic will be displayed.
Requirements
See Also
Reference
MapItem Class
MapItem Members
TopicEventArgs
Object Model
Syntax
Public Class TopicEventArgs
Inherits System.ComponentModel.CancelEventArgs
C#
public class TopicEventArgs : System.ComponentModel.CancelEventArgs
System.Object
System.EventArgs
106
System.ComponentModel.CancelEventArgs
C1.Win.C1DynamicHelp.TopicEventArgs
Requirements
See Also
Reference
TopicEventArgs Members
Overview
Object Model
Syntax
Public Class TopicEventArgs
Inherits System.ComponentModel.CancelEventArgs
C#
public class TopicEventArgs : System.ComponentModel.CancelEventArgs
System.Object
System.EventArgs
System.ComponentModel.CancelEventArgs
C1.Win.C1DynamicHelp.TopicEventArgs
Requirements
See Also
Reference
107
Members
Properties
The following tables list the members exposed by TopicEventArgs.
Public Properties
Name
Description
Cancel
Topic
Top
See Also
Reference
TopicEventArgs Class
Properties
>
Name
Description
Cancel
Topic
Top
See Also
Reference
Cancel Property
Syntax
108
Public Shadows Property Cancel As Boolean

C#
public new bool Cancel {get; set;}
Requirements
See Also
Reference
Topic Property
Syntax
Public ReadOnly Property Topic As HelpTopic
C#
public HelpTopic Topic {get;}
Requirements
See Also
Reference
TopicMap
Class used to store combinations of topics and user actions that cause their display.
Object Model
109
Syntax
Public Class TopicMap
Inherits System.Collections.Generic.Dictionary(Of Object,MapItem)
C#
public class TopicMap : System.Collections.Generic.Dictionary<object,MapItem>
Remarks
This class is a dictionary that associates UI elements to MapItem objects that specify a help
topic to display and the user action that causes the display (control getting focus, mouse
hovering).
This class allows you to add items, remove items, and obtain a count of the items in the
collection. The TopicMap class has members that allow users to check whether the map has
changed since it was created and to persist the map to and from XML.
It can contain items of two different types: MapItemType.Dynamic and MapItemType.Static.
Map items with dynamic type are created in authoring mode, and only items of this type can be
saved to an XML file with the Save method and then loaded with the Load method. As opposed
to dynamic map items, static map items are created at design time and aren't saved to or
loaded from XML file.
Dynamic map items use a "control path" string (the name of the UI element itself prepended
with the names of all its ancestors up to the form level) as the UI element identifier. So, if you
include controls that are created dynamically, at run time, you need to call the Refresh method
that finds UI elements by their "control path" and adds them to the dynamic help system. As the
controls on the form can be created dynamically, you may need to call the Refresh method
more than once (or, for example, it can be done on timer).
System.Object
System.Collections.Generic.Dictionary<TKey,TValue>
C1.Win.C1DynamicHelp.TopicMap
Requirements
See Also
110
Reference
TopicMap Members
Overview
Class used to store combinations of topics and user actions that cause their display.
Object Model
Syntax
Public Class TopicMap
Inherits System.Collections.Generic.Dictionary(Of Object,MapItem)
C#
public class TopicMap : System.Collections.Generic.Dictionary<object,MapItem>
Remarks
This class is a dictionary that associates UI elements to MapItem objects that specify a help
topic to display and the user action that causes the display (control getting focus, mouse
hovering).
This class allows you to add items, remove items, and obtain a count of the items in the
collection. The TopicMap class has members that allow users to check whether the map has
changed since it was created and to persist the map to and from XML.
It can contain items of two different types: MapItemType.Dynamic and MapItemType.Static.
Map items with dynamic type are created in authoring mode, and only items of this type can be
saved to an XML file with the Save method and then loaded with the Load method. As opposed
to dynamic map items, static map items are created at design time and aren't saved to or
loaded from XML file.
Dynamic map items use a "control path" string (the name of the UI element itself prepended
with the names of all its ancestors up to the form level) as the UI element identifier. So, if you
include controls that are created dynamically, at run time, you need to call the Refresh method
that finds UI elements by their "control path" and adds them to the dynamic help system. As the
controls on the form can be created dynamically, you may need to call the Refresh method
more than once (or, for example, it can be done on timer).
111
System.Object
System.Collections.Generic.Dictionary<TKey,TValue>
C1.Win.C1DynamicHelp.TopicMap
Requirements
See Also
Reference
TopicMap Members
Members
Properties Methods Events
The following tables list the members exposed by TopicMap.
Public Properties
Name
Description
Comparer
(Inherited from System.Collections.Generic.Dictionary<object,MapItem>)
Conflicts
Gets an array of conflicting map items.
Count
HasChanges
Gets a value that determines whether the TopicMap has changed since it
was initialized (read from an XML file).
Item
Gets or sets the value associated with the specified key.
Keys
Values
XmlSource
Gets or sets an System.Xml.XmlDocument value representing a TopicMap

created in authoring mode (so it consists of dynamic map items, static
map items aren't included), which is saved to an XML file.
112
Top
Public Methods
Name
Description
Add
Overloaded. Adds the specified uiElement and value to the TopicMap.
Clear
(Inherited from
System.Collections.Generic.Dictionary<object,MapItem>)
Contains
Determines whether the TopicMap contains the specified key.
ContainsKey
(Inherited from
ContainsValue
(Inherited from
GetEnumerator
(Inherited from
GetObjectData
(Inherited from
Load
Overloaded. Loads the TopicMap contents from an XML file.
OnDeserialization (Inherited from

Refresh
Refreshes topic map items with the ItemType property set to

MapItemType.Dynamic. For every control path in the map that does not
yet have a UI element found for it, it tries to find a UI element.
Remove
Overloaded. Removes the value with the specified uiElement from the
TopicMap
Save
Overloaded. Saves the TopicMap contents to an XML file with the same
name as the HelpSource with .xml extension.
113
TryGetValue
(Inherited from
Top
Public Events
Name
Description
TopicMapChanged Fires after changes were made in the topic map.

TopicMapSaved
Fires after the topic map is saved to an XML file.
Top
See Also
Reference
TopicMap Class
Methods
%%scrap%%
" -->
For a list of all members of this type, see TopicMap members.
Public Methods
Name
Description
Add
Overloaded. Adds the specified uiElement and value to the TopicMap.
Clear
(Inherited from
Contains
ContainsKey
(Inherited from
ContainsValue
(Inherited from
114
GetEnumerator
(Inherited from
GetObjectData
(Inherited from
Load
Overloaded. Loads the TopicMap contents from an XML file.
OnDeserialization (Inherited from

Refresh
Refreshes topic map items with the ItemType property set to

MapItemType.Dynamic. For every control path in the map that does not
yet have a UI element found for it, it tries to find a UI element.
Remove
Overloaded. Removes the value with the specified uiElement from the
TopicMap
Save
Overloaded. Saves the TopicMap contents to an XML file with the same
name as the HelpSource with .xml extension.
TryGetValue
(Inherited from
Top
See Also
Reference
TopicMap Class
Add Method
Adds the specified uiElement and value to the TopicMap.
Overload List
Overload
Description
115
Add(Object,MapItem) Adds the specified uiElement and value to the TopicMap.

Add(String,MapItem)
Adds the specified path and value to the TopicMap.
Requirements
See Also
Reference
TopicMap Class
TopicMap Members
Add(Object,MapItem) Method
The key of the element to add.
The value of the element to add.
Adds the specified uiElement and value to the TopicMap.
Syntax
Public Overloads Shadows Sub Add( _
ByVal uiElement As Object, _
)
C#
public new void Add(
object uiElement,
MapItem info
)
Parameters
uiElement
info
116
Exceptions
Exception
Description
System.ArgumentNullException uiElement or info is null

System.ArgumentException
An element with the same uiElement already exists in the

TopicMap.
Requirements
See Also
Reference
TopicMap Class
TopicMap Members
Overload List
Add(String,MapItem) Method
Adds the specified path and value to the TopicMap.
Syntax
Public Overloads Sub Add( _
ByVal path As String, _
)
C#
public void Add(
string path,
MapItem info
)
Parameters
path
117

info
Exceptions
Exception
Description
System.ArgumentNullException path or info is null

System.ArgumentException
An element with the same path already exists in the TopicMap.
Requirements
See Also
Reference
TopicMap Class
TopicMap Members
Overload List
Contains Method
The key to locate in the TopicMap.
Syntax
Public Function Contains( _
ByVal path As String _
) As Boolean
C#
public bool Contains(
string path
)
Parameters
path
118
The key to locate in the TopicMap.
Return Value
true if the TopicMap contains an element with the specified key; otherwise, false.
Exceptions
Exception
Description
System.ArgumentNullException path is null.
Requirements
See Also
Reference
TopicMap Class
TopicMap Members
Load Method
Loads the TopicMap contents from an XML file.
Overload List
Overload
Description
Load(String)
Load()
Loads the TopicMap contents from an XML file with the same name as the
HelpSource with .xml extension.
Requirements
See Also
Reference
TopicMap Class
TopicMap Members
119
Load(String) Method
The location of the file containing a topic map.
Syntax
Public Overloads Sub Load( _
ByVal fileName As String _
)
C#
public void Load(
string fileName
)
Parameters
fileName
The location of the file containing a topic map.
Remarks
All items loaded with this method will have ItemType property set to
MapItemType.Dynamic.
Requirements
See Also
Reference
TopicMap Class
TopicMap Members
Overload List
Load() Method
Loads the TopicMap contents from an XML file with the same name as the HelpSource with .xml
extension.
Syntax
120

Public Overloads Sub Load()
C#
public void Load()
Remarks
All items loaded with this method will have ItemType property set to MapItemType.Dynamic.
Requirements
See Also
Reference
TopicMap Class
TopicMap Members
Overload List
Refresh Method
Refreshes topic map items with the ItemType property set to MapItemType.Dynamic. For every
control path in the map that does not yet have a UI element found for it, it tries to find a UI
element.
Syntax
Public Sub Refresh()
C#
public void Refresh()
Remarks
If a UI element is found, it is added to the dynamic help system, that is, the events (focus
enter/leave, mouse hover) for it are monitored and the associated topic is shown when
triggered by those events.
Requirements
121
See Also
Reference
TopicMap Class
TopicMap Members
Remove Method
Removes the value with the specified uiElement from the TopicMap
Overload List
Overload
Description
Remove(Object)
Remove(String)
Removes the value with the specified path from the TopicMap
Requirements
See Also
Reference
TopicMap Class
TopicMap Members
Remove(Object) Method
The key of the element to remove.
Syntax
Public Overloads Shadows Sub Remove( _
)
C#
122
public new void Remove(

object uiElement
)
Parameters
uiElement
Exceptions
Exception
Description
Requirements
See Also
Reference
TopicMap Class
TopicMap Members
Overload List
Remove(String) Method
Removes the value with the specified path from the TopicMap
Syntax
Public Overloads Sub Remove( _
ByVal path As String _
)
C#
public void Remove(
string path
)
Parameters
123
path
Exceptions
Exception
Description
System.ArgumentNullException path is null.
Requirements
See Also
Reference
TopicMap Class
TopicMap Members
Overload List
Save Method
Saves the TopicMap contents to an XML file with the same name as the HelpSource with .xml
extension.
Overload List
Overload
Description
Save()
Saves the TopicMap contents to an XML file with the same name as the
HelpSource with .xml extension.
Save(String)
Saves the TopicMap contents to an XML file with a given name/location.
Requirements
See Also
Reference
TopicMap Class
TopicMap Members
124
Save() Method
Saves the TopicMap contents to an XML file with the same name as the HelpSource with .xml
extension.
Syntax
Public Overloads Sub Save()
C#
public void Save()
Remarks
Only map items with ItemType set to MapItemType.Dynamic are saved to the XML file.
Requirements
See Also
Reference
TopicMap Class
TopicMap Members
Overload List
Save(String) Method
The location of the file where you want to save the topic map.
Saves the TopicMap contents to an XML file with a given name/location.
Syntax
Public Overloads Sub Save( _
ByVal fileName As String _
)
C#
public void Save(
string fileName
125
Parameters
fileName
The location of the file where you want to save the topic map.
Remarks
Only map items with ItemType set to MapItemType.Dynamic are saved to the XML file.
Requirements
See Also
Reference
TopicMap Class
TopicMap Members
Overload List
Properties
%%scrap%%
" -->
Public Properties
Name
Description
Comparer
Conflicts
Count
HasChanges
Gets a value that determines whether the TopicMap has changed since it
was initialized (read from an XML file).
Item
126
Keys
Values
XmlSource
Gets or sets an System.Xml.XmlDocument value representing a TopicMap

created in authoring mode (so it consists of dynamic map items, static
map items aren't included), which is saved to an XML file.
Top
See Also
Reference
TopicMap Class
Conflicts Property
Syntax
Public ReadOnly Property Conflicts As Conflict()
C#
public Conflict[] Conflicts {get;}
Remarks
A conflict exists between two map items, one static and the other dynamic, when they refer to
the same UI element. In such a case, the precedence is with the dynamic map item, no error is
generated, the static map item is silently ignored.
Usually, there is no need to worry about these conflicts (mostly because static and dynamic
mappings are rarely mixed, usually either only static or only dynamic mappings are used), but in
case the programmer wants to know which items are in conflict with each other, that can be
done using this property.
Requirements
See Also
127
Reference
TopicMap Class
TopicMap Members
HasChanges Property
Gets a value that determines whether the TopicMap has changed since it was initialized (read
from an XML file).
Syntax
Public ReadOnly Property HasChanges As Boolean
C#
public bool HasChanges {get;}
Remarks
This property is typically used in authoring mode, to check whether the TopicMap has changed
and should therefore be saved before the application closes.
It will return false if authoring mode is not used, unless the application changes the map
programmatically.
Requirements
See Also
Reference
TopicMap Class
TopicMap Members
Item Property
The UI element of the value to get or set.
Syntax
Public Shadows Default Property Item( _
128

) As MapItem
C#
public new MapItem this[
object uiElement
]; {get; set;}
Parameters
uiElement
The UI element of the value to get or set.
Property Value
The value associated with the specified key. If the specified key is not found, a get
operation throws a System.Collections.Generic.KeyNotFoundException, and a set
operation creates a new element with the specified key.
Exceptions
Exception
Description
System.Collections.Generic.KeyNotFoundException The property is retrieved and key does not

exist in the collection.
System.ArgumentNullException
key is null.
Requirements
See Also
Reference
TopicMap Class
TopicMap Members
XmlSource Property
Gets or sets an System.Xml.XmlDocument value representing a TopicMap created in authoring
mode (so it consists of dynamic map items, static map items aren't included), which is saved to
an XML file.
Syntax
129

Public Property XmlSource As XmlDocument
C#
public XmlDocument XmlSource {get; set;}
Remarks
You can set this property instead of loading topic map from an XML file. For example, you can
choose to store the XML in application resources, create an XmlDocument at run time and
assign it to the XmlSource property.
Requirements
See Also
Reference
TopicMap Class
TopicMap Members
Events
%%scrap%%
" -->
Public Events
Name
Description
TopicMapChanged Fires after changes were made in the topic map.

TopicMapSaved
Top
See Also
Reference
TopicMap Class
130
TopicMapChanged Event
Fires after changes were made in the topic map.
Syntax
Public Event TopicMapChanged As EventHandler
C#
public event EventHandler TopicMapChanged
Requirements
See Also
Reference
TopicMap Class
TopicMap Members
TopicMapSaved Event
Syntax
Public Event TopicMapSaved As EventHandler
C#
public event EventHandler TopicMapSaved
Requirements
See Also
Reference
131
TopicMap Class
TopicMap Members
UIElementInfo
This class contains information about a UI element: its Name and Parent.
Object Model
Syntax
Public Class UIElementInfo
C#
public class UIElementInfo
Remarks
This class should be used only if you want to assign topics to UI elements in custom controls. If
you need to handle UI elements inside custom controls, you have to create your own
UIElementResolver object and override its virtual methods. Namely, when you override the
UIElementResolver.GetUIElementInfo method, you need to create a UIElementInfo object and
set its Name and Parent properties.
System.Object
C1.Win.C1DynamicHelp.UIElementInfo
Requirements
See Also
Reference
UIElementInfo Members
Overview
This class contains information about a UI element: its Name and Parent.
Object Model
132
Syntax
Public Class UIElementInfo
C#
public class UIElementInfo
Remarks
This class should be used only if you want to assign topics to UI elements in custom controls. If
you need to handle UI elements inside custom controls, you have to create your own
UIElementResolver object and override its virtual methods. Namely, when you override the
UIElementResolver.GetUIElementInfo method, you need to create a UIElementInfo object and
set its Name and Parent properties.
System.Object
C1.Win.C1DynamicHelp.UIElementInfo
Requirements
See Also
Reference
Members
Properties
The following tables list the members exposed by UIElementInfo.
Public Constructors
Name
Description
UIElementInfo Constructor Overloaded.

Top
133
Public Properties
Name
Description
Name
Gets or sets the name of the UIElement. The name should be unique
inside the parent control.
Parent
Gets or sets the parent object of the UIElement.
UIElement
Gets the UI element for which this UIElementInfo object contains data.
Top
See Also
Reference
UIElementInfo Class
UIElementInfo Constructor
Overload List
Overload
Description
UIElementInfo Constructor(Object)
Initializes a new of instance of a

UIElementInfo
UIElementInfo Constructor(Object,String,Object) Initializes a new of instance of a

UIElementInfo
Requirements
See Also
Reference
UIElementInfo Class
UIElementInfo Constructor(Object)
UI element for which this UIElementInfo object contains data.
134
Initializes a new of instance of a UIElementInfo
Syntax
)
C#
public UIElementInfo(
object uiElement
)
Parameters
uiElement
Exceptions
Exception
Description
Requirements
See Also
Reference
UIElementInfo Class
Overload List
UIElementInfo Constructor(Object,String,Object)
Name property for the specified uiElement
Parent property for the specified uiElement
Initializes a new of instance of a UIElementInfo
135
Syntax
ByVal uiElement As Object, _
ByVal name As String, _
ByVal parent As Object _
)
C#
public UIElementInfo(
object uiElement,
string name,
object parent
)
Parameters
uiElement
name
Name property for the specified uiElement
parent
Parent property for the specified uiElement
Exceptions
Exception
Description
Requirements
Windows Server 2008 (Server Core not supported), Windows Server 2008 R2
(Server Core supported with SP1 or later), Windows Server 2003 SP2
See Also
Reference
136
UIElementInfo Class
Overload List
Properties
%%scrap%%
" -->
For a list of all members of this type, see UIElementInfo members.
Public Properties
Name
Description
Name
Gets or sets the name of the UIElement. The name should be unique
inside the parent control.
Parent
UIElement
Top
See Also
Reference
UIElementInfo Class
Name Property
Gets or sets the name of the UIElement. The name should be unique inside the parent control.
Syntax
Public Property Name As String
C#
public string Name {get; set;}
Requirements
137
See Also
Reference
UIElementInfo Class
Parent Property
Syntax
Public Property Parent As Object
C#
public object Parent {get; set;}
Requirements
See Also
Reference
UIElementInfo Class
UIElement Property
Syntax
Public ReadOnly Property UIElement As Object
C#
public object UIElement {get;}
Requirements
138
See Also
Reference
UIElementInfo Class
UIElementResolver
This class provides methods to find UI elements inside a control by name, coordinates, etc, and
other methods necessary for associating dynamic help to UI elements inside a control.
Object Model
Syntax
Public Class UIElementResolver
C#
public class UIElementResolver
Remarks
A class derived from this class is necessary only if you are using custom controls that cannot be
handled by the C1DynamicHelp control automatically and then only if you need to associate
help topics with parts (UI elements) of those controls, not with the controls themselves.
You have no need to create objects of this type, it is sufficient to define a class derived from
UIElementResolver and override its virtual methods. These overridden methods should provide
necessary information about UI elements inside custom controls used in your application.
System.Object
C1.Win.C1DynamicHelp.UIElementResolver
Requirements
139
See Also
Reference
UIElementResolver Members
Overview
This class provides methods to find UI elements inside a control by name, coordinates, etc, and
other methods necessary for associating dynamic help to UI elements inside a control.
Object Model
Syntax
Public Class UIElementResolver
C#
public class UIElementResolver
Remarks
A class derived from this class is necessary only if you are using custom controls that cannot be
handled by the C1DynamicHelp control automatically and then only if you need to associate
help topics with parts (UI elements) of those controls, not with the controls themselves.
You have no need to create objects of this type, it is sufficient to define a class derived from
UIElementResolver and override its virtual methods. These overridden methods should provide
necessary information about UI elements inside custom controls used in your application.
System.Object
C1.Win.C1DynamicHelp.UIElementResolver
Requirements
See Also
Reference
140
Members
Methods
The following tables list the members exposed by UIElementResolver.
Public Methods
Name
Description
HandleUIElementEvent Simulates an event for a UI element.

Top
See Also
Reference
UIElementResolver Class
Methods
>
Name
Description
HandleUIElementEvent Simulates an event for a UI element.

Top
See Also
Reference
HandleUIElementEvent Method
A UI element for which an event occurred.
One of the UIElementEvents values, determining the type of the event (Enter or Leave).
Simulates an event for a UI element.
Syntax
Public Sub HandleUIElementEvent( _
141
ByVal sender As Object, _

ByVal uiElementEvent As UIElementEvents _
)
C#
public void HandleUIElementEvent(
object sender,
UIElementEvents uiElementEvent
)
Parameters
sender
A UI element for which an event occurred.
uiElementEvent
One of the UIElementEvents values, determining the type of the event (Enter or Leave).
Remarks
You should call this method whenever one of the UIElementEvents (Enter/Leave)
occurs for a UI element that must be handled by your code, that is, the
C1DynamicHelp control cannot monitor this UI element for Enter/Leave events
automatically (because it does not have those events). By calling this method you
notify C1DynamicHelp that an event has occurred, so C1DynamicHelp can show the
topic associated with that UI element. Typical usage is to override the
ActivateUIElement method, subscribing there to some events that would help you
to detect the moments the focus enters/leaves the UI elements, and call
HandleUIElementEvent method from those event handlers. In the
HandleUIElementEvent call, the sender parameter is the UI element for which an
event occurred, and uiElementEvent is the type of the event (Enter or Leave).
Requirements
See Also
Reference
142
Enumerations
DisplayTarget
Enumeration that specifies where a topic will be displayed.
Syntax
Public Enum DisplayTarget
Inherits System.Enum
C#
public enum DisplayTarget : System.Enum
Members
Member
Description
ControlPanel
Specifies that a topic should be displayed in the C1DynamicHelp control.
ExternalWindow
Specifies that a topic should be displayed in an external window.
PanelAndWindow Specifies that a topic should be displayed both in the C1DynamicHelp

control and in an external help viewer window.
Remarks
This enumeration is used in C1DynamicHelp.ShowTopicForActiveControl, which is typically used
when a user presses the F1 key to get help. It allows to show a topic in the C1DynamicHelp
control, in an external window or both.
System.Object
System.ValueType
System.Enum
C1.Win.C1DynamicHelp.DisplayTarget
Requirements
143
See Also
Reference
HelpTab
Enumeration specifying the part/element of the help file to display.
Syntax
Public Enum HelpTab
C#
public enum HelpTab : System.Enum
Members
Member
Description
Find
The help file opens on the search page.
Index
The help file opens on the index.
TableOfContents The help file opens on the table of contents.

Topic
The help file opens on a specified topic.
Remarks
It is used by the C1DynamicHelp.ShowExternalHelp method.
System.Object
System.ValueType
System.Enum
C1.Win.C1DynamicHelp.HelpTab
Requirements
144
See Also
Reference
HelpTopicTrigger
Enumeration that specifies user actions that cause a HelpTopic to be displayed.
Syntax
Public Enum HelpTopicTrigger
C#
public enum HelpTopicTrigger : System.Enum
Members
Member
Description
Enter
Show topic when a UI element gets the focus.
MouseEnter
Show help topic when the mouse hovers over a UI element.
None
Show topic programmatically, not by events.
Remarks
You can use combinations of this enumeration to show topics both on Enter and MouseHover
events.
System.Object
System.ValueType
System.Enum
C1.Win.C1DynamicHelp.HelpTopicTrigger
Requirements
145
See Also
Reference
MapItemType
Enumeration that specifies topic map item type.
Syntax
Public Enum MapItemType
C#
public enum MapItemType : System.Enum
Members
Member
Description
Dynamic
Indicates map items created in authoring mode, saved to an XML file.
Static
Indicates map items created at design time, persisted in form code.
Remarks
Map items created at design time have the MapItemType.Static type, they are stored in the
form's code and cannot be saved to an XML file. Map items created in authoring mode have the
MapItemType.Dynamic type, they are saved to the XML file when the map is persisted. If you
create map items programmatically, you can choose any of these two types.
System.Object
System.ValueType
System.Enum
C1.Win.C1DynamicHelp.MapItemType
Requirements
146
See Also
Reference
UIElementEvents
Enumeration that specifies which of the monitored events occurred for a UI element.
Syntax
Public Enum UIElementEvents
C#
public enum UIElementEvents : System.Enum
Members
Member
Description
Enter
UI element received focus.
Leave
UI element lost focus.
Remarks
It is used only in the UIElementResolver.HandleUIElementEvent method to specify the type of an
event. You need this enumeration only if you use custom controls and want to associate topics
with UI elements inside them.
System.Object
System.ValueType
System.Enum
C1.Win.C1DynamicHelp.UIElementEvents
Requirements
147
See Also
Reference
Delegates
HelpTopicEventHandler
The source of the event.
A TopicEventArgs that contains the event data.
Represents a method that will handle the C1DynamicHelp.CurrentTopicChanging event of a
C1DynamicHelp.
Syntax
Public Delegate Sub HelpTopicEventHandler( _
ByVal sender As Object, _
ByVal e As TopicEventArgs _
)
C#
public delegate void HelpTopicEventHandler(
object sender,
TopicEventArgs e
)
Parameters
sender
The source of the event.
e
A TopicEventArgs that contains the event data.
Requirements
148
See Also
Reference
HelpTopicEventHandler Members
C1.Win.C1DynamicHelp.Providers Namespace
Overview
Classes
Class
Description
ChmProvider
The class providing the IHelpProvider functionality for HTML Help (.chm
files).
NetHelpProvider The class providing the IHelpProvider functionality for ComponentOne

NetHelp.
Interfaces
Interface
Description
IHelpProvider
The interface that needs to be implemented by a help provider class.
See Also
Reference
Classes
ChmProvider
The class providing the IHelpProvider functionality for HTML Help (.chm files).
Object Model
Syntax
149

Public Class ChmProvider
Implements IHelpProvider
C#
public class ChmProvider : IHelpProvider
System.Object
C1.Win.C1DynamicHelp.Providers.ChmProvider
Requirements
See Also
Reference
ChmProvider Members
Overview
The class providing the IHelpProvider functionality for HTML Help (.chm files).
Object Model
Syntax
Public Class ChmProvider
C#
public class ChmProvider : IHelpProvider
System.Object
C1.Win.C1DynamicHelp.Providers.ChmProvider
150
Requirements
See Also
Reference
ChmProvider Members
Members
Properties Methods
The following tables list the members exposed by ChmProvider.
Public Constructors
Name
Description
ChmProvider Constructor
Top
Public Properties
Name
Description
Source
Gets or sets the help file.
Top
Public Methods
Name
Description
CorrectUrl
Checks whether the URL is in correct format and corrects it if necessary.
GetCtxtIdMap
Returns a dictionary of help topics indexed by their context IDs

(contains only topics that have context ids).
GetFullUrl
Returns a URL in a specific for the help provider format that can be
displayed by the C1DynamicHelp control.
151
GetTopics
Returns a hierarchical list of topics in the help file.
GetUrlMap
Returns a dictionary of help topics indexed by their URLs (contains all

topics).
ShowExternalHelp Overloaded. Show help navigation (in a separate window).

Top
See Also
Reference
ChmProvider Class
ChmProvider Constructor
Syntax
C#
public ChmProvider()
Requirements
See Also
Reference
ChmProvider Class
ChmProvider Members
Methods
>
Name
Description
CorrectUrl
GetCtxtIdMap
Returns a dictionary of help topics indexed by their context IDs (contains
152
only topics that have context ids).

GetFullUrl
GetTopics
GetUrlMap

topics).

Top
See Also
Reference
ChmProvider Class
CorrectUrl Method
URL to be checked and corrected
Syntax
Public Function CorrectUrl( _
) As String
C#
public string CorrectUrl(
string url
)
Parameters
url
Return Value
A corrected URL if some changes were made, otherwise the initial URL value
Remarks
153
Clicking some links in a *.chm file can lead to losing the path specified in the Source
property.
Requirements
See Also
Reference
ChmProvider Class
ChmProvider Members
GetCtxtIdMap Method
Returns a dictionary of help topics indexed by their context IDs (contains only topics that have
context ids).
Syntax
Public Function GetCtxtIdMap() As Dictionary(Of Integer,HelpTopic)
C#
public Dictionary<int,HelpTopic> GetCtxtIdMap()
Requirements
See Also
Reference
ChmProvider Class
ChmProvider Members
GetFullUrl Method
Returns a URL in a specific for the help provider format that can be displayed by the
Syntax
154
Public Function GetFullUrl( _

) As String
C#
public string GetFullUrl(
string url
)
Parameters
url
Requirements
See Also
Reference
ChmProvider Class
ChmProvider Members
GetTopics Method
Syntax
Public Function GetTopics() As HelpTopicList
C#
public HelpTopicList GetTopics()
Requirements
See Also
Reference
155
ChmProvider Class
ChmProvider Members
GetUrlMap Method
Returns a dictionary of help topics indexed by their URLs (contains all topics).
Syntax
Public Function GetUrlMap() As Dictionary(Of String,HelpTopic)
C#
public Dictionary<string,HelpTopic> GetUrlMap()
Requirements
See Also
Reference
ChmProvider Class
ChmProvider Members
Show help navigation (in a separate window).
Overload List
Overload
Description
ShowExternalHelp(HelpTab,Object) Show help navigation (in a separate window).
Requirements
See Also
Reference
156
ChmProvider Class
ChmProvider Members
Initial help page to display, typically HelpTab.Find, HelpTab.Index, or
HelpTab.TableOfContents.
Syntax
)
C#
HelpTab tab
)
Parameters
tab
Requirements
See Also
Reference
ChmProvider Class
ChmProvider Members
Overload List
Topic identifier
157
Syntax
)
C#
HelpTab tab,
object parameter
)
Parameters
tab
parameter
Topic identifier
Requirements
See Also
Reference
ChmProvider Class
ChmProvider Members
Overload List
Properties
%%scrap%%
" -->
For a list of all members of this type, see ChmProvider members.
Public Properties
158
Name
Description
Source
Top
See Also
Reference
ChmProvider Class
Source Property
Syntax
Public Property Source As String
C#
public string Source {get; set;}
Requirements
See Also
Reference
ChmProvider Class
ChmProvider Members
NetHelpProvider
The class providing the IHelpProvider functionality for ComponentOne NetHelp.
Object Model
Syntax
159

Public Class NetHelpProvider
C#
public class NetHelpProvider : IHelpProvider
System.Object
C1.Win.C1DynamicHelp.Providers.NetHelpProvider
Requirements
See Also
Reference
NetHelpProvider Members
Overview
The class providing the IHelpProvider functionality for ComponentOne NetHelp.
Object Model
Syntax
Public Class NetHelpProvider
C#
public class NetHelpProvider : IHelpProvider
System.Object
C1.Win.C1DynamicHelp.Providers.NetHelpProvider
160
Requirements
See Also
Reference
Members
Properties Methods
The following tables list the members exposed by NetHelpProvider.
Public Constructors
Name
Description
NetHelpProvider Constructor
Top
Public Properties
Name
Description
Source
Top
Public Methods
Name
Description
CorrectUrl
This method is not meaningful for the NetHelpProvider. It is used only

to implement the IHelpProvider interface.
GetCtxtIdMap

GetFullUrl
161
GetTopics
GetUrlMap

topics).

Top
See Also
Reference
NetHelpProvider Class
NetHelpProvider Constructor
Syntax
C#
public NetHelpProvider()
Requirements
See Also
Reference
Methods
%%scrap%%
" -->
For a list of all members of this type, see NetHelpProvider members.
Public Methods
162
Name
Description
CorrectUrl
This method is not meaningful for the NetHelpProvider. It is used only

to implement the IHelpProvider interface.
GetCtxtIdMap

GetFullUrl
GetTopics
GetUrlMap

topics).

Top
See Also
Reference
CorrectUrl Method
Url to be checked and corrected
This method is not meaningful for the NetHelpProvider. It is used only to implement the
IHelpProvider interface.
Syntax
Public Function CorrectUrl( _
) As String
C#
public string CorrectUrl(
163
string url
)
Parameters
url
Url to be checked and corrected
Return Value
Always the initial url
Requirements
See Also
Reference
GetCtxtIdMap Method
context ids).
Syntax
Public Function GetCtxtIdMap() As Dictionary(Of Integer,HelpTopic)
C#
public Dictionary<int,HelpTopic> GetCtxtIdMap()
Requirements
See Also
Reference
164
GetFullUrl Method
Syntax
Public Function GetFullUrl( _
) As String
C#
public string GetFullUrl(
string url
)
Parameters
url
Requirements
See Also
Reference
GetTopics Method
Syntax
Public Function GetTopics() As HelpTopicList
C#
public HelpTopicList GetTopics()
Requirements
165
See Also
Reference
GetUrlMap Method
Syntax
Public Function GetUrlMap() As Dictionary(Of String,HelpTopic)
C#
public Dictionary<string,HelpTopic> GetUrlMap()
Requirements
See Also
Reference
Overload List
Overload
Description
ShowExternalHelp(HelpTab,Object) Show help navigation (in a separate window).
Requirements
166
See Also
Reference
Syntax
)
C#
HelpTab tab
)
Parameters
tab
Requirements
See Also
Reference
Overload List
167
Topic identifier
Syntax
)
C#
HelpTab tab,
object parameter
)
Parameters
tab
parameter
Topic identifier
Requirements
See Also
Reference
Overload List
Properties
>
168
Name
Source
Description
Top
See Also
Reference
Source Property
Syntax
Public Property Source As String
C#
public string Source {get; set;}
Requirements
See Also
Reference
Interfaces
IHelpProvider
Object Model
Syntax
169

Public Interface IHelpProvider
C#
public interface IHelpProvider
Remarks
You need to know this interface only if you want to create your own custom help provider (an
advanced feature). A help provider can read data from a help source and provides methods to
get help topics, to get context IDs, to open help in an external window, to get a topic URL that
can be displayed by the C1DynamicHelp control, etc. There are two built-in help providers in
the C1DynamicHelp: ChmProvider and NetHelpProvider which are used automatically when the
HelpSource property points to a .chm or a .htm/html file, correspondingly. If you want to use
another help source type (for example, MS Help 2.0) you can do it by creating your own help
provider class implementing this interface.
Requirements
See Also
Reference
IHelpProvider Members
Overview
Object Model
Syntax
Public Interface IHelpProvider
C#
public interface IHelpProvider
170
Remarks
You need to know this interface only if you want to create your own custom help provider (an
advanced feature). A help provider can read data from a help source and provides methods to
get help topics, to get context IDs, to open help in an external window, to get a topic URL that
can be displayed by the C1DynamicHelp control, etc. There are two built-in help providers in
the C1DynamicHelp: ChmProvider and NetHelpProvider which are used automatically when the
HelpSource property points to a .chm or a .htm/html file, correspondingly. If you want to use
another help source type (for example, MS Help 2.0) you can do it by creating your own help
provider class implementing this interface.
Requirements
See Also
Reference
Members
Properties Methods
The following tables list the members exposed by IHelpProvider.
Public Properties
Name
Description
Source
Top
Public Methods
Name
Description
CorrectUrl
GetCtxtIdMap

171
GetFullUrl
GetTopics
GetUrlMap

topics).
ShowExternalHelp Overloaded. Displays the contents of the help file in an external help
Top
See Also
Reference
IHelpProvider Interface
Methods
%%scrap%%
" -->
For a list of all members of this type, see IHelpProvider members.
Public Methods
Name
Description
CorrectUrl
GetCtxtIdMap

GetFullUrl
GetTopics
GetUrlMap
172
topics).
ShowExternalHelp Overloaded. Displays the contents of the help file in an external help
Top
See Also
Reference
CorrectUrl Method
Syntax
Function CorrectUrl( _
) As String
C#
string CorrectUrl(
string url
)
Parameters
url
Return Value
A corrected URL if some changes were made, otherwise the initial URL value
Requirements
See Also
173
Reference
GetCtxtIdMap Method
context ids).
Syntax
Function GetCtxtIdMap() As Dictionary(Of Integer,HelpTopic)
C#
Dictionary<int,HelpTopic> GetCtxtIdMap()
Requirements
See Also
Reference
GetFullUrl Method
Syntax
Function GetFullUrl( _
) As String
C#
string GetFullUrl(
string url
)
174
Parameters
url
Requirements
See Also
Reference
GetTopics Method
Syntax
Function GetTopics() As HelpTopicList
C#
HelpTopicList GetTopics()
Requirements
See Also
Reference
GetUrlMap Method
Syntax
175
Function GetUrlMap() As Dictionary(Of String,HelpTopic)

C#
Dictionary<string,HelpTopic> GetUrlMap()
Requirements
See Also
Reference
Overload List
Overload
Description
Displays the contents of the help file in an external help

ShowExternalHelp(HelpTab,Object) Displays the contents of the help file in an external help

Requirements
See Also
Reference
One of the C1.Win.C1DynamicHelp.HelpTab values.
176
Syntax
Overloads Sub ShowExternalHelp( _
)
C#
void ShowExternalHelp(
HelpTab tab
)
Parameters
tab
Requirements
See Also
Reference
Overload List
Syntax
Overloads Sub ShowExternalHelp( _
177
)
C#
void ShowExternalHelp(
HelpTab tab,
object parameter
)
Parameters
tab
parameter
Requirements
See Also
Reference
Overload List
Properties
>
Name
Source
Description
Top
See Also
Reference
Source Property
Syntax
178

Property Source As String
C#
string Source {get; set;}
Requirements
See Also
Reference
179

WinForms DynamicHelp

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

WinForms DynamicHelp

Uploaded by

Copyright:

Available Formats

ComponentOne

DynamicHelp for WinForms

Copyright 1987-2015 GrapeCity, Inc. All rights reserved.

ComponentOne, a division of GrapeCity

Copying and Distribution

CurrentTopicChanged Event ........................................................................... 76

HelpTopicTrigger Property ............................................................................ 102

TopicMapChanged Event .............................................................................. 131

GetTopics Method ........................................................................................ 155

Source Property ............................................................................................ 178

DynamicHelp for WinForms Overview

For Developers: Mapping at Design Time

Help with WinForms Edition

C1DynamicHelp integrates with the application interface

Developers or Help Authors can easily perform topic mapping

Supports Help content selection and copying

Quickly activate/deactivate authoring mode

DynamicHelp for WinForms Samples

Visual Basic Samples

This sample shows how to add a toolbar to a C1DynamicHelp

Allows users to navigate back/forward through help

Allows users to open the Help file in an external window on a

Allows users to pin the current topic down in order to

This sample uses the C1DynamicHelp control.

This sample demonstrates how to use C1DynamicHelp controls on

UsingUIElementResolver This sample demonstrates how to create a custom UIElementResolver

This sample demonstrates how to load topic map from different

This sample shows how to add a toolbar to a C1DynamicHelp

Allows users to navigate back/forward through help

Allows users to open the Help file in an external window on a

Allows users to pin the current topic down in order to

This sample uses the C1DynamicHelp control.

This sample demonstrates how to use C1DynamicHelp controls on

UsingUIElementResolver This sample demonstrates how to create a custom UIElementResolver

This sample demonstrates how to load topic map from different

Using DynamicHelp for WinForms

For Developers: Mapping at Design Time

C1DynamicHelp Smart Tag

Select Help Topic Dialog Box

Specifying the Source Help File

Click the C1DynamicHelp smart tag ( ) to open the Tasks menu.

Mapping a Topic to a Control at Design Time

Preparing C1DynamicHelp for Authoring

Specify a source Help file for C1DynamicHelp.

' toggle authoring mode when the user hits Ctrl+Shift+A

// toggle authoring mode when the user hits Ctrl+Shift+A

For Help Authors: Mapping in Authoring

NetHelp project files or .chm (compiled HTML Help)

C1DynamicHelp Authoring Mode

Topic to associate with the control.

Mapping a Topic to a Control in Authoring

Click the Select control button

Click the Attach topic to control button

Click the Save button

Removing the Topic Mapping for a Selected

Click the Select Control button

Click the Detach Topic from Control button

Click the Save button

Assign a Topic to a Parent Control

Click the Select control button

Click the Attach topic to control button

Displaying any Help format

Mapping to part of a control or custom controls