| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" |
| "http://www.w3.org/TR/html4/loose.dtd"> |
| <html> |
| <head> |
| <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> |
| <title>Plug-in Extensions</title> |
| <script language="JavaScript" type="text/javascript" src="PLUGINS_ROOT/org.eclipse.help/livehelp.js"></script> |
| <link href="../../../book.css" rel="stylesheet" type="text/css"> |
| <style type="text/css"> |
| <!-- |
| .style1 { |
| font-size: 18px; |
| font-weight: bold; |
| } |
| .style2 { |
| font-size: 12pt; |
| font-weight: bold; |
| } |
| --> |
| </style> |
| </head> |
| |
| <body> |
| <p class="style1">Plug-in Extensions</p> |
| <p>Extensions are the central mechanism for contributing behavior to the platform. Unless your plug-in is a documentation plug-in or a simple Java API library made available to other plug-ins, new behavior is contributed as an extension.</p> |
| <p>The <strong>Extensions</strong> page is where you can add, remove and modify the extensions your plug-in contributes to the platform.</p> |
| <p> </p> |
| <p class="style2">All Extensions</p> |
| <p>In the <strong>All Extensions</strong> section, press <strong>Add...</strong> to view all the available extension points that you can extend. </p> |
| <p><img src="../../../images/plugin_editor/extensions_details.png" alt="Extension Details" hspace="30"></p> |
| <p>Each extension point comes with an XML schema specifying its grammar. When you select a new extension, PDE extracts the grammar for the corresponding extension point and populates the context menu of each element selected in the <strong>All Extensions</strong> viewer with a list of valid child elements that you can create.</p> |
| <p>For each selected element in the body of an extension, PDE populates the <strong>Extension Element Details</strong> section with all the valid attributes for that element. Required attributes are denoted with an asterisk. </p> |
| <p>When you hover your mouse over an attribute name, a tool tip box appears showing the description of that attribute.</p> |
| <p>When an attribute expects the name of a Java class as a value (e.g. the <em>class</em> attribute above), clicking on the name of the attribute will open the Java file specified - if it exists. If the file does not exist, then clicking on the <em>class</em> link will bring up the JDT New Class wizard to create a new Java class on the fly. </p> |
| <p>Some extension elements do not have attributes. Instead they require a description which can be specified in the <strong>Body Text</strong> section: </p> |
| <p><img src="../../../images/plugin_editor/extensions_body.png" alt="Body Text" hspace="30"></p> |
| <p> </p> |
| <p> </p> |
| </body> |
| </html> |