blob: 71d8de12f517de2f2571f61d456c0f654d2f2c55 [file] [log] [blame]
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html lang="en" xml:lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
<meta name="copyright" content="(C) Copyright 2005"/>
<meta name="DC.rights.owner" content="(C) Copyright 2005"/>
<meta name="DC.Type" content="concept"/>
<meta name="DC.Title" content="Help Context Abstraction"/>
<meta name="abstract" content="Help context abstraction is a technique to simplify the handling of help context IDs and help search expressions in the UI code, by abstracting them to “help keys.”"/>
<meta name="description" content="Help context abstraction is a technique to simplify the handling of help context IDs and help search expressions in the UI code, by abstracting them to “help keys.”"/>
<meta name="DC.Relation" scheme="URI" content="../../../../../projects/dtp/dtp/en/source/c_introduction_to_csh.html"/>
<meta name="DC.Creator" content="dresch"/>
<meta name="DC.Format" content="XHTML"/>
<meta name="DC.Identifier" content="concept_9B577F7CD24240E2925D439CC1E2F313"/>
<meta name="DC.Language" content="en"/>
<link rel="stylesheet" type="text/css" href="../../../../../styles/commonltr.css"/>
<link rel="stylesheet" type="text/css" href="../../../../../styles/doc.css"/>
<title>Help Context Abstraction</title>
<meta name="provider" content="Sybase, Inc."/></head>
<body id="concept_9B577F7CD24240E2925D439CC1E2F313"><a name="concept_9B577F7CD24240E2925D439CC1E2F313"><!-- --></a>
<br/>
<h1 class="topictitle1">Help Context Abstraction</h1>
<div><p>Help context abstraction is a technique to simplify the handling of help context
IDs and help search expressions in the UI code, by abstracting them to “help
keys.”
</p>
<div class="p">Help context abstraction provides the following benefits:
<br/><a name="concept_9B577F7CD24240E2925D439CC1E2F313__ul_CF8AC6CB65F14CA49EB983B85C178D6E"><!-- --></a><ul id="concept_9B577F7CD24240E2925D439CC1E2F313__ul_CF8AC6CB65F14CA49EB983B85C178D6E">
<li id="concept_9B577F7CD24240E2925D439CC1E2F313__li_D2FEF367CBE3485CB93AE96C198F1CD8"><a name="concept_9B577F7CD24240E2925D439CC1E2F313__li_D2FEF367CBE3485CB93AE96C198F1CD8"><!-- --></a>Development teams are free to associate new help contexts with UI controls,
without necessitating that corresponding help context IDs or help search
expressions exist.</li>
<li id="concept_9B577F7CD24240E2925D439CC1E2F313__li_6EE7CDE942A94065862D4A53F6F02DEA"><a name="concept_9B577F7CD24240E2925D439CC1E2F313__li_6EE7CDE942A94065862D4A53F6F02DEA"><!-- --></a>Documentation teams are free to define UA help contexts, modify help context
IDs, and control the mapping from abstract help contexts to concrete help
context IDs, without necessitating any change in the UI code.</li>
<li id="concept_9B577F7CD24240E2925D439CC1E2F313__li_26AB981095A643A9A1061E85A07E89FC"><a name="concept_9B577F7CD24240E2925D439CC1E2F313__li_26AB981095A643A9A1061E85A07E89FC"><!-- --></a>Documentation teams are free to define and modify context-specific help search
expressions, and the mapping from abstract help contexts to help search
expressions, without necessitating any change in the UI code.</li>
</ul>
</div>
<div class="tip"><span class="tiptitle">Tip:</span> Help search expressions include human-readable text, so they must be
externalized for localization.
</div>
<p>This separation of responsibilities enables the project team to provide higher
quality, and more precisely targeted, dynamic context-sensitive help.
</p>
<p>Together, the DTP help-helper and a context-sensitive help UA plug-in provide an
abstraction layer, which enables dynamic context-sensitive help, with a
practical and easily maintained implementation in the UI code.
</p>
<br/><a name="concept_9B577F7CD24240E2925D439CC1E2F313__image_C9359815603B4120B909F47EC022EC44"><!-- --></a><div class="imagecenter"><img id="concept_9B577F7CD24240E2925D439CC1E2F313__image_C9359815603B4120B909F47EC022EC44" src="../images/dtp_csh_abstraction_layer.jpg" alt="Image shows abstraction layer between the UI plug-in and the Eclipse Help system."/></div><br/>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="../../../../../projects/dtp/dtp/en/source/c_introduction_to_csh.html" title="Context-sensitive help is focused user assistance content, specific to the current application context (that is, the help context), and presented on demand when a platform-specific trigger is activated (for example, F1 on Windows).">Introduction to Context-Sensitive Help</a></div>
</div>
</div>
<div/>
</body>
</html>