Vyer
ID:
org.eclipse.ui.views
Beskrivning:
Den här utökningspunkten används för att definiera flera vyer för arbetsmiljön. En vy är en visuell komponent på en arbetsmiljösida. En vy används vanligen till att navigera i en informationshierarki (till exempel arbetsmiljön), öppna en redigerare eller visa egenskaper för den aktiva redigeraren. Användaren visar vyn genom att välja Fönster > Visa vy. Vyn stängs från namnlisten.
Genom att gruppera vyerna i kategorier kan du göra dialogrutan Visa vy mer användarvänlig.
Konfigurationsmärkordsuppsättning:
<!ELEMENT extension (category | view | stickyView)*>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point - ett fullständigt ID för målutökningspunkten
- id - ett valfritt ID för utökningsförekomsten
- name - ett valfritt namn på utökningsförekomsten
<!ELEMENT category EMPTY>
<!ATTLIST category
id CDATA #REQUIRED
name CDATA #REQUIRED
parentCategory CDATA #IMPLIED>
- id - ett unikt namn som används för att identifiera kategorin
- name - ett översättningsbart namn som används i användargränssnittet för kategorin
- parentCategory - en valfri sökväg som består av kategori-ID som avgränsas med '/'. På det sättet kan du skapa en hierarki av kategorier.
<!ELEMENT view (description?)>
<!ATTLIST view
id CDATA #REQUIRED
name CDATA #REQUIRED
category CDATA #IMPLIED
class CDATA #REQUIRED
icon CDATA #IMPLIED
fastViewWidthRatio CDATA #IMPLIED
allowMultiple (true | false) >
- id - ett unikt namn som används för att identifiera vyn
- name - ett översättningsbart namn som används i användargränssnittet för vyn
- category - ett valfritt attribut som består av kategori-ID som avgränsas med '/'. Var och en av de refererade kategorierna måste deklareras i motsvarande kategorielement.
- class - ett fullständigt namn på den klass som implementerar org.eclipse.ui.IViewPart. Ett vanligt tillvägagångssätt är att ange org.eclipse.ui.part.ViewPart som underordnad klass så att standardfunktionerna ärvs.
- icon - ett relativt namn på den ikon som associeras till vyn.
- fastViewWidthRatio - den andel av arbetsmiljöns bredd, uttryckt i procent, som upptas av en aktiv snabbvy.
Värdet måste anges som ett flyttal och ligga mellan 0,05 och 0,95.
Om inget värde anges används standardvärdet.
- allowMultiple - flagga som anger om flera vyförekomster kan skapas med hjälp av IWorkbenchPage.showView(String id, String secondaryId). Standardvärdet är "false".
<!ELEMENT description (#PCDATA)>
ett valfritt underelement vars innehållsdel ger en kort beskrivning av vyn.
<!ELEMENT stickyView EMPTY>
<!ATTLIST stickyView
id CDATA #REQUIRED
location (RIGHT|LEFT|TOP|BOTTOM)
closeable (true | false)
moveable (true | false) >
En klibbig vy är en vy som visas som standard i alla perspektiv när den har öppnats. Vyns inledande placering styrs av platsattributet men vyn kan både flyttas och stängas av användaren. Elementet skapar en platshållare för vyn. Själva vyn visas inte. Lägg märke till att elementet bör användas med stor försiktighet för vyer som måste visas i alla perspektiv. Sedan 3.0
- id - ID för vyn som ska göras klibbig.
- location - valfritt attribut som anger platsen för den klibbiga vyn i förhållande till redigerarområdet. Om attributet inte används dockas vyn till höger om redigerarområdet.
- closeable - valfritt attribut som anger om vyn ska kunna stängas. Om attributet inte används kommer vyn att kunna stängas.
- moveable - valfritt attribut som anger om vyn ska kunna flyttas. Om attributet inte används kommer vyn att kunna flyttas.
Exempel:
Följande är ett exempel på utökningspunkten:
<extension point=
"org.eclipse.ui.views"
>
<category
id=
"com.xyz.views.XYZviews"
name=
"XYZ"
/>
<view
id=
"com.xyz.views.XYZView"
name=
"XYZ View"
category=
"com.xyz.views.XYZviews"
class=
"com.xyz.views.XYZView"
icon=
"icons/XYZ.gif"
/>
</extension>
Här följer ett exempel på en deklaration för en klibbig vy:
<extension point=
"org.eclipse.ui.views"
>
<stickyView
id=
"com.xyz.views.XYZView"
/>
</extension>
API-information:
Värdet i attributet class måste vara ett fullständigt kvalificerat namn på den klass som implementerar
org.eclipse.ui.IViewPart. Det är praxis att ange org.eclipse.ui.ViewPart som underordnad klass vid utveckling av en ny vy.
Medföljande implementering:
Eclipse-plattformen tillhandahåller ett antal standardvyer, till exempel navigeringsvyn, egenskapsvyn, dispositionsvyn och uppgiftsvyn. Från användarens synvinkel skiljer sig de här vyerna inte från vyerna som tillhandahålls av insticksprogrammen. Alla vyer kan visas med hjälp av undermenyn "Visa vy" på menyn "Fönster". Vyns placering sparas när vyn stängs och återställs när vyn öppnas på nytt. Placeringen sparas även mellan olika arbetsmiljösessioner.
Copyright (c) 2002, 2005 IBM Corporation and others.
All rights
reserved. Detta program och medföljande material tillhandahålls under villkoren för Eclipse Public License v1.0 som medföljer denna distribution och finns tillgänglig på
http://www.eclipse.org/legal/epl-v10.html