blob: 8f58d225733800a8ffbe6756e009ba09e7d5a77e [file] [log] [blame]
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HEAD><meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<link rel="stylesheet" type="text/css" href="book.css"/>
<link rel="stylesheet" type="text/css" href="schema.css"/>
</HEAD>
<HTML>
<BODY>
<H1><CENTER>Dynamic Stirng Substitution Variables</CENTER></H1>
<h6 class=CaptionFigColumn id=header>Identifier: </h6>org.eclipse.debug.core.dynamicVariables<p>
<h6 class=CaptionFigColumn id=header>Since: </h6>3.0<p>
<h6 class=CaptionFigColumn id=header>Description: </h6>This extension point provides a mechanism for defining dynamic variables used in string substitution. The value of a dynamic variable is resolved at the time a string substitution is performed, with an optional argument.<p><h6 class=CaptionFigColumn id=header>Configuration Markup:</h6></p>
<p class=code id=dtd>&nbsp;&nbsp; &lt;!ELEMENT <a name="e.extension">extension</a> (<a href="#e.variable">variable</a>*)&gt;</p>
<br><br><p class=code id=dtd>&nbsp;&nbsp; &lt;!ATTLIST extension</p>
<br><p class=code id=dtd>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;point&nbsp;CDATA #REQUIRED</p>
<br><p class=code id=dtd>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;id&nbsp;&nbsp;&nbsp;&nbsp;CDATA #IMPLIED</p>
<br><p class=code id=dtd>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;name&nbsp;&nbsp;CDATA #IMPLIED</p>
<br><p class=code id=dtd>&nbsp;&nbsp; &gt;</p>
<ul>
<li><b>point</b> - a fully qualified identifier of the target extension point</li>
<li><b>id</b> - an optional identifier of the extension instance</li>
<li><b>name</b> - an optional name of the extension instance</li>
</ul>
<p class=code id=dtd>&nbsp;&nbsp; &lt;!ELEMENT <a name="e.variable">variable</a> EMPTY&gt;</p>
<br><br><p class=code id=dtd>&nbsp;&nbsp; &lt;!ATTLIST variable</p>
<br><p class=code id=dtd>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;name&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;CDATA #REQUIRED</p>
<br><p class=code id=dtd>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;resolver&nbsp;&nbsp;&nbsp;&nbsp;CDATA #REQUIRED</p>
<br><p class=code id=dtd>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;description&nbsp;CDATA #REQUIRED</p>
<br><p class=code id=dtd>&nbsp;&nbsp; &gt;</p>
<ul>
<li><b>name</b> - specifies a unique name for this variable.</li>
<li><b>resolver</b> - specifies a Java class which implements <samp>org.eclipse.debug.core.stringsubstitution.IContextVariableResolver</samp>, which is used to determine the value of the variable</li>
<li><b>description</b> - specifies a human-readable description of this variable</li>
</ul>
<h6 class=CaptionFigColumn id=header>Examples: </h6>The following is a definition of a dynamic variable that resolves to the name of the selected resource:
<pre>
<p class=code id=tag>&lt;extension point=<p class=code id=cstring>&quot;org.eclipse.debug.core.dynamicVariables&quot;</p><p class=code id=tag>&gt;</p>
<p class=code id=tag>&lt;variable
name=<p class=code id=cstring>&quot;resource_name&quot;</p><p class=code id=tag>
expanderClass=<p class=code id=cstring>&quot;com.example.ResourceNameExpander&quot;</p><p class=code id=tag>
description=<p class=code id=cstring>&quot;The name of the selected resource&quot;</p><p class=code id=tag>&gt;</p>
<p class=code id=tag>&lt;/variable&gt;</p>
<p class=code id=tag>&lt;/extension&gt;</p>
</pre><p>
<h6 class=CaptionFigColumn id=copyright-text>
<p>
<a href="hglegal.htm">
<img SRC="ngibmcpy.gif"
ALT="Copyright (c) 2000, 2003 IBM Corporation and others. All Rights Reserved."
BORDER=0 height=14 width=324></a>
</p><p>
</h6>
</BODY>
</HTML>