Configuração da Parte de Introdução

org.eclipse.ui.intro.config

3.0

Esse ponto de extensão é utilizado para registrar uma configuração da introdução. Essa configuração fornece implementações de apresentação e conteúdo para uma determinada contribuição de introdução. Uma introdução aparece quando o workbench é ativado pela primeira vez e como uma opção do menu "Ajuda". Geralmente a introdução é utilizada para apresentar ao usuário um produto construído no Eclipse.

As introduções são organizadas em páginas que normalmente refletem uma categoria específica de material introdutório. Por exemplo, uma página Novidades pode apresentar novos conceitos ou funcionalidade desde a versão anterior. O conteúdo definido por uma configuração de introdução pode ser referido e estendido a partir de outros plug-ins que utilizam o ponto de extensão org.eclipse.ui.intro.configExtension.

<!ELEMENT extension (config+)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT config (presentation)>

<!ATTLIST config

introId CDATA #REQUIRED

id      CDATA #REQUIRED

content CDATA #REQUIRED>

Um elemento de configuração pode ser utilizado para configurar uma Parte de Introdução personalizável. Um elemento de configuração deve especificar um ID, um introId e um arquivo de conteúdo. O arquivo de conteúdo da introdução é um arquivo XML que descreve as páginas, os grupos e os links que a introdução possui.



<!ELEMENT presentation (implementation+)>

<!ATTLIST presentation

home-page-id    CDATA #REQUIRED

standby-page-id CDATA #IMPLIED>

O elemento de apresentação que define todas as possíveis implementações da apresentação de uma parte de introdução. Ele pode conter uma ou mais implementações definidas. Somente uma implementação será escolhida na inicialização, baseado nos atributos os/ws das implementações. Caso contrário, será escolhida a primeira implementação que não tenha atributos os/ws definidos.



<!ELEMENT implementation (head?)>

<!ATTLIST implementation

kind  (swt|html)

style   CDATA #IMPLIED

os    CDATA #IMPLIED

ws    CDATA #IMPLIED>

A apresentação da experiência já apresentada da Plataforma possui duas implementações. Uma delas baseia-se no Navegador SWT e a outra baseia-se em Formulários de UI. A parte de introdução personalizável pode ser configurada para obter uma dessas duas apresentações com base no OS e WS atuais. O tipo da implementação pode ser swt ou html.



A seguir está um exemplo do ponto de extensão de configuração.

<extension id=

"intro"

point=

"org.eclipse.ui.intro.config"

>

<config introId=

"com.org.xyz.intro"

id=

"com.org.xyz.introConfig"

content=

"introContent.xml"

>

<presentation home-page-id=

"root"

title=

"%intro.title"

>

<implementation ws=

"win32"

style=

"css/shared.css"

kind=

"html"

os=

"win32"

>

</implementation>

<implementation style=

"css/shared_swt.properties"

kind=

"swt"

>

</implementation>

</presentation>

</config>

</extension>

Para obter detalhes adicionais, consulte a especificação do pacote de API org.eclipse.ui.intro.config.

A introdução contribuída pelo plugin org.eclipse.platform é a única implementação no Eclipse.