Rozšíření položky Cheat Sheet

org.eclipse.ui.cheatsheets.cheatSheetItemExtension

3.0

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.

<!ELEMENT extension (itemExtension)*>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!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).



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.

Další podrobnosti o rozhraní API naleznete v informacích dokumentace Javadoc pro org.eclipse.ui.cheatsheets.AbstractItemExtensionElement.

V současné době není žádná dodávaná implementace.