blob: 29605143aa693791b07c1626e097ce4a428e7293 [file] [log] [blame]
Xiaoying Gu07591712010-12-06 06:28:46 +00001<?xml version="1.0" encoding="UTF-8"?>
2<!DOCTYPE html
3 PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
4<html lang="en" xml:lang="en">
5<head>
6<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
7<meta name="copyright" content="(C) Copyright 2005"/>
8<meta name="DC.rights.owner" content="(C) Copyright 2005"/>
9<meta name="DC.Type" content="concept"/>
10<meta name="DC.Title" content="Help Keys"/>
11<meta name="abstract" content="Rather than declaring help context IDs directly, UI controls use help keys (that is, helpKey constants). Though meaningless to the Eclipse help system, helpKey constants provide an abstraction in the Java code from the actual help context IDs and help search expressions."/>
12<meta name="description" content="Rather than declaring help context IDs directly, UI controls use help keys (that is, helpKey constants). Though meaningless to the Eclipse help system, helpKey constants provide an abstraction in the Java code from the actual help context IDs and help search expressions."/>
13<meta name="DC.Relation" scheme="URI" content="../../../../../projects/dtp/dtp/en/source/c_dtp_help_helper.html"/>
14<meta name="DC.Creator" content="dresch"/>
15<meta name="DC.Format" content="XHTML"/>
16<meta name="DC.Identifier" content="concept_BA505FE560B547D7A26FB13209A499D9"/>
17<meta name="DC.Language" content="en"/>
18<link rel="stylesheet" type="text/css" href="../../../../../styles/commonltr.css"/>
19<link rel="stylesheet" type="text/css" href="../../../../../styles/doc.css"/>
20<title>Help Keys</title>
21<meta name="provider" content="Sybase, Inc."/></head>
22<body id="concept_BA505FE560B547D7A26FB13209A499D9"><a name="concept_BA505FE560B547D7A26FB13209A499D9"><!-- --></a>
23<br/>
24
25 <h1 class="topictitle1">Help Keys</h1>
26
27
28 <div><p>Rather than declaring help context IDs directly, UI controls use help keys
29 (that is, helpKey constants). Though meaningless to the Eclipse help system,
30 helpKey constants provide an abstraction in the Java code from the actual help
31 context IDs and help search expressions.
32 </p>
33
34
35 <p>Each helpKey constant is used to reference an actual help context ID string and
36 a corresponding help search expression, which are defined in properties files
37 (one each for help context IDs and help search expressions).
38 </p>
39
40
41 <p>Any plug-in can contribute the helpKey properties files for a UI component
42 by declaring an extension to org.eclipse.datatools.help.helpKeyProperties in its
43 plugin.xml file. For example, a dedicated context-sensitive help plug-in could
44 contribute both the helpKey properties files and the Eclipse context XML files,
45 independent of the UI plug-in and the UA content contributor (online
46 documentation) plug-in.
47 </p>
48
49 <p>Similar to externalized messages, helpKey constants are declared as public
50 static final String in an interface class.
51 </p>
52
53 <p>UI components must implement a helpKey constants interface class to reference
54 the externalized help context IDs in a ResourceBundle properties file.
55
56 </p>
57
58 </div>
59
60<div>
61<div class="familylinks">
62<div class="parentlink"><strong>Parent topic:</strong> <a href="../../../../../projects/dtp/dtp/en/source/c_dtp_help_helper.html" title="The DTP help-helper plug-in (org.eclipse.datatools.help) provides a “help key” extension point (org.eclipse.datatools.help.helpKeyProperties), and supplies a context provider delegate implementation (org.eclipse.datatools.help.ContextProviderDelegate).">DTP Help-Helper</a></div>
63</div>
64</div>
65<div/>
66</body>
67</html>