Rozšíření perspektivy
Identifikátor:
org.eclipse.ui.perspectiveExtensions
Popis:
Tento bod rozšíření se používá k rozšíření perspektiv registrovaných jinými moduly plug-in. Perspektiva definuje počáteční obsah řádků s akcemi okna
(nabídka a panel nástrojů) a počáteční množinu pohledů
a jejich rozvržení v rámci stránky pracovní plochy.
Další moduly plug-in mohou poskytovat akce nebo pohledy perspektivě, které se zobrazují, pokud je tato perspektiva zvolena. Volitelné dodatky od jiných modulů plug-in se přidávají k výchozí definici.
Konfigurační markup:
<!ELEMENT extension (perspectiveExtension*)>
<!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 perspectiveExtension (actionSet | viewShortcut | perspectiveShortcut | newWizardShortcut | view | showInPart)*>
<!ATTLIST perspectiveExtension
targetID CDATA #REQUIRED>
- targetId - Jedinečný identifikátor perspektivy (jak je uvedeno v registru), do kterého se přispívá.
<!ELEMENT actionSet EMPTY>
<!ATTLIST actionSet
id CDATA #REQUIRED>
- id - Jedinečný identifikátor akční sady, která bude přidána do perspektivy.
<!ELEMENT viewShortcut EMPTY>
<!ATTLIST viewShortcut
id CDATA #REQUIRED>
- id - Jedinečný identifikátor pohledu, který bude přidán do podnabídky "Zobrazit pohled" v nabídce "Okno" dané perspektivy.
<!ELEMENT perspectiveShortcut EMPTY>
<!ATTLIST perspectiveShortcut
id CDATA #REQUIRED>
- id - Jedinečný identifikátor perspektivy, která bude přidána do podnabídky "Otevřít perspektivu" v nabídce "Okno" dané perspektivy.
<!ELEMENT newWizardShortcut EMPTY>
<!ATTLIST newWizardShortcut
id CDATA #REQUIRED>
- id - Jedinečný identifikátor nového průvodce, který bude přidán do podnabídky "Nový" v nabídce "Soubor" dané perspektivy.
<!ELEMENT showInPart EMPTY>
<!ATTLIST showInPart
id CDATA #IMPLIED>
- id - Jedinečný identifikátor pohledu, který bude přidán do výzvy "Zobrazit v..." v nabídce Navigovat dané perspektivy.
<!ELEMENT view EMPTY>
<!ATTLIST view
id CDATA #REQUIRED
relative CDATA #IMPLIED
relationship (stack|left|right|top|bottom|fast)
ratio CDATA #IMPLIED
visible (true | false)
closeable (true | false)
moveable (true | false)
standalone (true | false)
showTitle (true | false) >
- id - Jedinečný identifikátor pohledu, který bude přidán do rozvržení perspektivy.
- relative - Jedinečný identifikátor pohledu, který v perspektivě již existuje. Bude použit jako referenční bod pro umístění pohledu. Vztah mezi těmito dvěma pohledy se definuje pomocí atributu relationship. Ignorováno v případě, že vztah je "fast".
- relationship - Určuje vztah mezi hodnotami id a relative.
Jsou podporovány následující hodnoty:
fast - Rozšíření pohledu bude vytvořeno jako rychlý pohled.
stack - Rozšíření pohledu bude seskupeno s relativním pohledem do složky.
left, right, top, bottom - Rozšíření pohledu bude umístěno vedle relativního pohledu. V tomto případě musí být také definována hodnota ratio.
- ratio - Procentuální podíl oblasti uvnitř relativního pohledu, který bude věnován rozšíření pohledu. Pokud je rozšířením pohledu Rychlý pohled, hodnota ratio odpovídá procentuálnímu podílu pracovní plochy, který bude rychlý pohled pokrývat, pokud bude aktivní. Musí být definována jako hodnota s pohyblivou řádovou čárkou a ležet mezi hodnotami 0,05 a 0,95.
- visible - Určuje, zda se má pohled zobrazovat při otevření perspektivy. Tento atribut by měl mít hodnotu "true" nebo "false", pokud je použit. Pokud tento atribut není použit, pohled se bude ve výchozím nastavení zpočátku zobrazovat.
- closeable - Určuje, zda je možno pohled zavřít v cílové perspektivě. Tento atribut by měl mít hodnotu "true" nebo "false", pokud je použit. Pokud tento atribut není použit, pohled bude možno zavřít, pokud perspektiva není označena jako pevná.
- moveable - Určuje, zda je možno pohled přesunout. Nepřesunutelný pohled není možno přesunout ani v rámci jedné složky, ani mezi složkami v perspektivě. Tento atribut by měl mít hodnotu "true" nebo "false", pokud je použit. Pokud tento atribut není použit, pohled bude možno přesunout, pokud perspektiva není označena jako pevná.
- standalone - Určuje, zda se jedná o samostatný pohled. Samostatný pohled nelze uložit společně s jinými do stejné složky. Tento atribut by měl mít hodnotu "true" nebo "false", pokud je použit. Tento atribut je ignorován, pokud je atribut relationship roven hodnotě "fast" nebo "stacked". Pokud tento atribut není použit, pohled bude běžný, nikoli samostatný (výchozí hodnota je "false").
- showTitle - Určuje, zda se zobrazí titulek pohledu. Tento atribut by měl mít hodnotu "true" nebo "false", pokud je použit. Tento atribut se týká pouze samostatných pohledů. Pokud tento atribut není použit, titulek pohledu se zobrazí (výchozí hodnota je "true").
Příklady:
Následuje příklad rozšíření perspektivy (všimněte si dílčích prvků a způsobu použití atributů):
<extension point=
"org.eclipse.ui.perspectiveExtensions"
>
<perspectiveExtension
targetID=
"org.eclipse.ui.resourcePerspective"
>
<actionSet id=
"org.eclipse.jdt.ui.JavaActionSet"
/>
<viewShortcut id=
"org.eclipse.jdt.ui.PackageExplorer"
/>
<newWizardShortcut id=
"org.eclipse.jdt.ui.wizards.NewProjectCreationWizard"
/>
<perspectiveShortcut id=
"org.eclipse.jdt.ui.JavaPerspective"
/>
<view id=
"org.eclipse.jdt.ui.PackageExplorer"
relative=
"org.eclipse.ui.views.ResourceNavigator"
relationship=
"stack"
/>
<view id=
"org.eclipse.jdt.ui.TypeHierarchy"
relative=
"org.eclipse.ui.views.ResourceNavigator"
relationship=
"left"
ratio=
"0.50"
/>
</perspectiveExtension>
</extension>
Ve výše uvedeném příkladu je počátečnímu obsahu perspektivy prostředků poskytnuta akční sada, zástupce pohledu,
zástupce nového průvodce a zástupce perspektivy. Kromě toho se pohled Průzkumníka balíčků seskupí na navigátor prostředků a pohled Hierarchie typů se přidá vedle navigátora prostředků.
Informace rozhraní API:
Položky definované v rozšíření perspektivy jsou poskytovány počátečnímu obsahu cílové perspektivy. Následně poté může uživatel odebrat jakýkoli příspěvek, nebo přidat jiné příspěvky do perspektivy z uživatelského rozhraní pracovní plochy.
Copyright (c) 2002, 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