The IEmbeddedHelpSystem is an interface that exposes functionality for CSH, embedded help, and dynamic help.
Embedded CSH:
To embed a topic from your help system into your application, use the LoadTopic() method. To embed search results from your help system into your application, use the EmbeddedSearch() method. You must set the DynamicHelpPanel property prior to calling LoadTopic(). Similarly, you must set the SearchPanel property prior to calling EmbeddedSearch().
Dynamic help:
Dynamic help is a feature where a help window automatically displays help topics from your help system that are relevant to the context of the user that is using your application. To use this functionality, you must set the EnableDynamicHelp property to true. The CSH engine needs a way to determine the appropriate topic to display. Your application can supply this information in either of two ways. One way is to implement the ICSHIDProvider interface. The other way is to set the control's Tag property to the desired CSH ID string. In this case, you must prefix the string with "CSH:". For example, if your CSH ID is "MyHelpTopic", you would set the Tag object to the string "CSH:MyHelpTopic".
Refer to the sample application called HelpViewerEmbeddedClientTester.
Name | Description |
---|---|
public void EmbeddedSearch( string searchString ) | Performs a search for the string specified in the searchString parameter. Displays the results embedded in the control that is set as the SearchPanel property. |
public void EnableHelpButton( System.Windows.Forms.Form form ) | Enables the help button in the form specified inform. |
public void LoadTopic( string cshid) |
Loads the topic specified in cshid. Displays the topic embedded in the control that is set as the DynamicHelpPanel property. |
public void Search( string searchString ) | Performs a search for the string specified in the searchString parameter. Displays the results in a new Help Viewer window. |
public void Search( string searchString, string cshid ) |
Performs a search for the string specified in the searchString parameter. The cshid parameter is used to override the default starting topic of the help system. Displays the results in a new Help Viewer window. |
public void ShowHelp() | Opens the help system in a new Help Viewer window. |
public void ShowTopic( string cshid ) | Opens the help system with the topic specified in cshid. |
System.Windows.Forms.Control DynamicHelpPanel | Gets or sets the control where the embedded help topic will be loaded. This must be set before calling LoadTopic(). |
bool EnableDynamicHelp | Gets or sets whether dynamic help is enabled for the form. |
bool EnableF1Help | Gets or sets whether F1 help is enabled for the form. |
System.Windows.Forms.Control SearchPanel | Gets or sets the control where the embedded help search results will be loaded. This must be set before calling EmbeddedSearch(). |