Rozšíření položky Cheat Sheet
Identifikátor:
org.eclipse.ui.cheatsheets.cheatSheetItemExtension
Od:
3.0
Popis:
Tento bod rozšíření by se měl použít, když je třeba přidat dodatečné tlačítko k nějakému kroku v pohledu Cheat sheet.
Do značky "item" v souboru s obsahem pohledu Cheat sheet můžete vložit nový atribut, a když je tato hodnota přečtena rámcem Cheat sheet, bude zkontrolováno, zda existuje třída registrovaná prostřednictvím tohoto bodu rozšíření, která ošetří tento atribut. Název atributu nalezený v souboru s obsahem pohledu Cheat sheet je porovnáván se všemi hodnotami nalezenými v atributu "itemAttribute" u všech registrovaných implementací bodů cheatsheetItemExtension. Je-li nalezena shoda, načte se pomocí rámce Cheat sheet třída určená k ošetření atributu této položky a je volána k ošetření atributu specifikovanému v souboru s obsahem pohledu Cheat sheet. Po analýze hodnoty atributu položky zůstává třída dostupná rámci Cheat sheet. Jakmile je položka vykreslena pro Cheat sheet, je znovu volána třída k ošetření přidání složek ke kompozitnímu prvku. Položky, které jsou přidány k tomuto kompozitnímu prvku, jsou zobrazeny v kroku pohledu Cheat sheet (aktuálně vedle ikony pro nápovědu). Zobrazí se pouze pro krok, který je popsán značkou "item", jejíž atribut se objevil v souboru s obsahem pohledu Cheat sheet.
Předpokládaným použitím tohoto bodu rozšíření je přidání malého tlačítka (16 x 16) s grafikou, které při stisknutí otevře dialogové okno.
Konfigurační markup:
<!ELEMENT extension (itemExtension)*>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point - Úplný identifikátor cílového bodu rozšíření.
- ID - Nepovinný identifikátor instance rozšíření.
- name - Nepovinný název instance rozšíření.
<!ELEMENT itemExtension EMPTY>
<!ATTLIST itemExtension
itemAttribute CDATA #REQUIRED
class CDATA #REQUIRED>
Použijte toto rozšíření položky k přidání prvků ke krokům pohledu Cheat sheet. Můžete použít tento bod rozšíření k přidání ikon a tlačítek (aktuálně vedle ikony pro nápovědu) pro některý krok v pohledu Cheat sheet.
Určíte název atributu, který budete vkládat do značky položky Cheat sheet. Určíte také třídu, která ošetří analýzu hodnoty atributu ze souboru s obsahem pohledu Cheat sheet, když je Cheat sheet zaváděn. Hodnotou atributu musí být řetězec. Uvedená třída musí vytvořit podtřídu org.eclipse.ui.cheatsheets.AbstractItemExtensionElement
. Po analýze a načtení souboru s obsahem Cheat sheet je znovu prostřednictvím rozhraní volána třída určená v bodu rozšíření, aby přidala grafiku nebo tlačítka ke kroku v pohledu Cheat sheet (aktuálně vedle ikony pro nápovědu).
- itemAttribute - Tato hodnota atributu musí být řetězec s hodnotou názvu atributu, který je vložen do značky položky v souboru s obsahem pohledu Cheat sheet. Pokud souhlasí tento řetězec atributu s atributem analyzovaným ze značky položky v souboru s obsahem pohledu Cheat sheet, určená třída bude načtena a volána k analýze plné hodnoty atributu pomocí specifikace w3 DOM. Později bude volána k přidání obslužných prvků ke kompozitnímu prvku a přidané komponenty (obvykle grafického prvku nebo tlačítka) se zobrazí v kroku pohledu Cheat sheet pro určenou položku (aktuálně vedle ikony pro nápovědu pro tento krok).
- class - Úplný kvalifikovaný název třídy, která vytváří podtřídu
org.eclipse.ui.cheatsheets.AbstractItemExtensionElement
k ošetření neznámých atributů v souboru s obsahem pohledu Cheat sheet a rozšiřuje kroky v tomto pohledu Cheat sheet. Tato třída musí být veřejná a musí mít veřejný konstruktor 1-argument, který akceptuje název atributu (String
).
Příklady:
Zde je příklad implementace tohoto bodu rozšíření:
<extension point=
"org.eclipse.ui.cheatsheets.cheatSheetItemExtension"
>
<itemExtension
itemAttribute=
"xyzButton"
class=
"com.example.HandleParsingAndAddButton"
>
</itemExtension>
</extension>
A zde je atribut položky pro uvedené rozšíření:
<item title=
"XYZ Title"
xyzButton=
"/icon/button.gif"
/>
Vezměte na vědomí, že hodnotou atributu ve značce položky může být COKOLIV. Může to být cokoliv, protože třída, která analyzuje uvedený atribut, je třídou HandleParsingAndAddButton, která v tomto příkladě analyzuje řetězec /icon/button.gif z atributu. Později použije tuto informaci k načtení souboru gif a ten použije jako ikonu pro nové tlačítko.
Informace rozhraní API:
Další podrobnosti o rozhraní API naleznete v informacích dokumentace Javadoc pro org.eclipse.ui.cheatsheets.AbstractItemExtensionElement.
Dodaná implementace:
V současné době není žádná dodávaná implementace.
Copyright (c) 2004 IBM Corporation a další.
Všechna práva vyhrazena.
Tento program a doprovodné materiály jsou zpřístupněny za podmínek licence Eclipse Public License
v1.0, která je součástí této distribuce a je k dispozici na adrese
http://www.eclipse.org/legal/epl-v10.html