Esta página de formato permite ao utilizador editar a estrutura e as propriedades dos objectos de esquema que constituem a gramática do esquema editado.
A estrutura dos objectos do esquema são editados na secção Elementos do Ponto de Extensão. Esta secção ocupa a parte superior esquerda da área do editor.
As propriedades dos objectos do esquema são editados nas secções <objecto-esquema> Detalhes. Estas secções são activadas na parte superior direita da área do editor dependendo do tipo de elemento de esquema seleccionado na secção Elementos do Ponto de Extensão.
Esta página é composta pelas seguintes secções:
Esta secção permite ao utilizador fazer o seguinte:
Esta secção está directamente acessível através da página de formato Definição do Esquema.
Utilize o campo do visualizador do elemento do ponto de extensão para fazer o seguinte:
Este visualizador contém os seguintes nós:
Elementos:
Compositores:
Atributos:
Exemplo: o elemento extensão especifica que uma sequência de um ou mais elementos de atalho são permitidos como seus descendentes legais Uma referência de elemento é utilizada para representar o elemento atalho . Um Compositor de sequência é utilizado para representar uma sequência de elementos.
Exemplo: o elemento atalho especifica que um elemento descrição ou categoria é permitido como seu descendente legal. As referências de elemento são utilizadas para representar os elementos descrição e categoria. Um Compositor de selecção é utilizado para representar uma selecção de elementos.
Faça clique no botão Adicionar Elemento para adicionar uma nova instrução de elemento global à gramática do esquema do ponto de extensão. Esta acção está disponível quando qualquer nó estiver seleccionado. Nota: A ordem da instrução do elemento não é importante.
Faça clique no botão Adicionar Atributo para adicionar uma nova instrução de atributo local a um elemento seleccionado na gramática do esquema do ponto de extensão. Esta acção está disponível para todos os nós de elemento seleccionados excepto para o nó do elemento extensão. O nó de elemento extensão tem sempre os mesmos atributos: id, nome, ponto. Nota: A ordem da instrução do atributo não é importante.
Para eliminar um objecto de esquema a partir da gramática do esquema do ponto de extensão, faça clique com o botão direito do rato sobre um nó seleccionado e seleccione Eliminar. Esta acção está disponível para todos os nós excepto para o nó de elemento extensão. Para esquemas não partilhados, o nó de elemento extensão é o elemento raiz especial utilizado para definir o ponto de entrada da gramática do esquema editado. Qualquer extensão definida no Editor de ficheiros manifest de plug-ins tem de utilizar um elemento ascendente extensão para especificar a respectiva marcação relacionada com XML.
Para especificar que um descendente do elemento é composto por uma sequência ou selecção de outros elementos na gramática do esquema do ponto de extensão, faça o seguinte:
Nota: Para especificar que um elemento é o descendente de outro elemento, um compositor de Sequência ou Selecção intermédio tem de ser sempre utilizado pelo elemento ascendente. Os nós de compositor são nós de conector; enquanto os nós de referência de elemento são nós de folha. Por conseguinte, os nós de compositor devem especificar sempre pelo menos um nó de referência de elemento descendente.
Nota: Os compositores de Sequência e Selecção podem ser testados as vezes que forem necessárias para criar gramáticas mais complexas.
Nota: Uma gramática não deve conter ciclos que façam referência a si próprios. O formato mais básico de um ciclo proibido quando um Elemento A requer o Elemento B como um descendente e o Elemento B requer o Elemento A como um descendente.
Para especificar que um elemento não tem descendentes e permite que seja especificado texto dentro nos identificadores de início e fim XML (conteúdo de caracteres), deixe simplesmente a estrutura do elemento como está não adicionando referências a atributos, colaboradores e elementos (conteúdo de elementos). Nota: Um elemento não pode especificar conteúdo misto (conteúdo de caracteres e conteúdo de elemento).
Esta secção permite ao utilizador fornecer uma breve descrição para qualquer elemento, atributo ou compositor dentro da gramática do esquema editado.
Esta secção está directamente acessível através da página de formato Definição do Esquema.
Edite o campo de texto da descrição para fornecer uma breve descrição para o nó de elemento, atributo ou compositor actual seleccionado na secção Elementos de Ponto de Extensão. Pode utilizar uma marcação HTML válida dentro deste campo conforme o necessário.
Nota: Actualizar uma descrição de referência do elemento também actualiza a descrição da instrução do elemento global a que se refere e vice-versa.
Esta secção permite ao utilizador editar as propriedades de um elemento. Existem dois tipos de elementos: elemento de extensão e elemento de não extensão. Um elemento de extensão é a instrução de elemento raiz especial utilizado para definir o ponto de entrada à gramática do esquema editado. Um elemento de não extensão é uma instrução de elemento global utilizada como um bloco de construção estrutural básico dentro da gramática do esquema editado.
Esta secção é activada através da selecção de um nó de elemento extensão ou um nó de elemento não extensão na secção Elementos de Ponto de Extensão.
A secção Detalhes do Elemento para um elemento extensão.
A secção Detalhes do Elemento para um elemento de não extensão.
Edite o campo Nome para especificar o nome do elemento.
Faça clique no botão verdadeiro ou falso dentro do campo Interno para indicar se o elemento é interno ou não. O Editor do Manifesto de Plug-ins irá sinalizar qualquer marcação XML de extensão que é interno com um aviso (por predefinição). O campo é análogo a um atributo x-internal em pacotes exportados.
Faça clique no botão verdadeiro ou falso dentro do campo Obsoleto para indicar se o elemento é obsoleto ou não. O Editor de Manifesto de Plug-ins irá sinalizar qualquer marcação XML de extensão que é obsoleto com um aviso (por predefinição). Este campo é análogo ao controlo Java Javadoc, @deprecated.
Se um elemento de extensão estiver marcado como obsoleto, edite o campo Substituição para especificar o ponto de extensão não obsoleto que o utilizador deveria utilizar em substituição para conseguir a mesma funcionalidade.
Seleccione um dos atributos definidos do elemento no campo Propriedade de Identificador para especificar o valor do atributo para utilizar como o identificador do elemento no Editor de Manifesto de Plug-ins. Por exemplo, se estiver seleccionado um valor, o identificador do nó do elemento na secção Todas as Extensões da página Extensões no Editor de Manifesto de Plug-ins será como se segue: valor-atributo-seleccionado (nome-elemento). Caso contrário, se não estiver seleccionado nenhum valor, o identificador do nó será como se segue: (nome-elemento).
Seleccione um dos atributos de tipo de recurso definido do elemento no campo Ícone para especificar o recurso do ícone a utilizar para representar o nó do elemento no Editor de Manifesto de Plug-ins. Para que o ícone do nó do elemento seja apresentado correctamente na secção Todas as Extensões da página Extensões no Editor de Manifesto de Plug-ins, é necessário cumprir as seguintes condições:
Faça clique no botão verdadeiro ou falso dentro do campo Conversível para indicar se o conteúdo de caracteres do elemento é ou não conversível. Este campo apenas é aplicável a elementos que não têm descendentes especificados (conteúdo de elementos) ou atributos e permitir que texto seja especificado dentro dos identificadores de início e fim XML (conteúdo de caracteres). Se o conteúdo de caracteres de um elemento é marcado como conversível, então as ferramentas do PDE podem ser utilizadas na marcação XML de extensão de contribuição para exteriorizar o conteúdo num ficheiro de propriedades para suporte de vários idiomas.
Utilize o campo aproximação de DTD apenas de leitura para ver uma correlação um-para-um aproximada da gramática do esquema do elemento com a gramática de DTD do elemento equivalente. Uma DTD (Definição de Tipo de Documento) é uma alternativa mais fácil de ler e menos poderosa ao esquema XML para especificar a gramática formal de um documento XML. A notação seguinte é utilizada para especificar a aproximação de DTD:
Esta secção permite ao utilizador editar as propriedades de um compositor. Existem dois tipos de compositores: compositor de sequência e compositor de selecção. Um compositor de sequência permite ao utilizador especificar que um descendente de um elemento é composto por uma sequência de outros elementos na gramática do esquema editado. Um compositor de selecção permite ao utilizador especificar que um descendente do elemento é composto por uma selecção de outros elementos na gramática do esquema editado.
Esta secção é activada através da selecção do nó Sequência ou Selecção na secção Elementos do Ponto de Extensão.
Edite o campo Mín. Ocorrências para especificar o número mínimo de ocorrências que é permitido a este compositor de outros elementos e/ou compositores aparecer na marcação XML de extensão de contribuição. O valor deste campo é utilizado pelo PDE para validar a multiplicidade de restrições dentro do Editor de Manifesto de Plug-ins. Se um Elemento A requer exactamente um Elemento B ou Elemento C como seu descendente e utiliza um compositor Opção especificando 2 ocorrências mínimas, então 2 instâncias de Elemento B em combinação com Elemento C têm de ser definidas na marcação contribuída XML de extensão para ser válido.
Edite o campo Máx. Ocorrências para especificar o número máximo de ocorrências que é permitido a este compositor de outros elementos e/ou compositores aparecer na marcação XML de extensão de contribuição. O valor deste campo é utilizado pelo PDE para validar a multiplicidade de restrições dentro do Editor de Manifesto de Plug-ins. Se o Elemento A requer exactamente um Elemento B ou Elemento C como seu descendente e utiliza um compositor Opção especificando 2 ocorrências máximas, então não podem ser definidas mais de 2 instâncias de Elemento B em combinação com Elemento C na marcação contribuída XML de extensão para ser válido.
Seleccione o campo Desassociado para especificar que não existe qualquer restrição ao número máximo de ocorrências permitidas em que este compositor pode aparecer na marcação XML de extensão de contribuição.
Seleccione um valor no campo Tipo para especificar se este compositor é de sequência ou de selecção.
Utilize o campo aproximação de DTD apenas de leitura para ver uma correlação um-para-um aproximada da gramática do esquema do compositor com a gramática de DTD do compositor equivalente. A notação utilizada para especificar a aproximação de DTD é descrita sob o cabeçalho Campos da Secção Detalhes do Elemento neste documento.
Esta secção permite ao utilizador editar as propriedades de uma referência de elemento. Uma referência de elemento é uma referência a uma instrução de elemento global dentro da gramática do esquema editado. As referências a elementos são utilizadas pelos compositores como blocos de construção atómicos para definir a gramática para as declarações de elemento global.
Esta secção é activada através da selecção de um nó referência de elemento na secção Elementos do Ponto de Extensão.
Edite o campo Mín. Ocorrências para especificar o número mínimo de ocorrências que é permitido a este elemento aparecer na marcação XML de extensão de contribuição. O valor deste campo é utilizado pelo PDE para validar a multiplicidade de restrições dentro do Editor de Manifesto de Plug-ins. Se o Elemento A especifica um mínimo de 2 ocorrências, então devem ser definidas 2 instâncias do Elemento A na marcação XML de contribuição para serem válidas.
Edite o campo Máx. Ocorrências para especificar o número máximo de ocorrências que é permitido a este elemento aparecer na marcação XML de extensão de contribuição. O valor deste campo é utilizado pelo PDE para validar a multiplicidade de restrições dentro do Editor de Manifesto de Plug-ins. Se o Elemento A especifica um máximo de 2 ocorrências, então devem ser definidas 2 instâncias do Elemento A na marcação XML de contribuição para permanecerem válidas.
Seleccione o campo Desassociado para especificar que não existe qualquer restrição ao número máximo de ocorrências permitidas em que este elemento pode aparecer na marcação XML de extensão de contribuição.
Utilize o campo aproximação de DTD apenas de leitura para ver uma correlação um-para-um aproximada da gramática do esquema do elemento com a gramática de DTD do elemento equivalente. A notação utilizada para especificar a aproximação de DTD é descrita sob o cabeçalho Campos da Secção Detalhes do Elemento neste documento.
Faça clique na hiperligação nome-elemento no campo Referência para editar as propriedades da instrução de elemento global a que esta referência de elemento local faz referência. Quando a acção estiver concluída, o nó de elemento referenciado é seleccionado na secção Elementos do Ponto de Extensão e a secção Detalhes do Elemento correspondente é activada.
Esta secção permite ao utilizador editar as propriedades de um atributo. Os atributos são utilizados para fornecer informações adicionais sobre os elementos.
Esta secção á activada através da selecção de um nó atributo necessário, atributo opcional, atributo de classe ou atributo de recurso na secção Elementos do Ponto de Extensão.
A secção Detalhes do Atributo para um atributo necessário do tipo cadeia que especifica uma restrição de enumeração.
A secção Detalhes do Atributo para um atributo opcional do tipo booleano que especifica um valor predefinido.
A secção Detalhes do Atributo para um atributo de classe que indica que a classe representada pelo valor do atributo deve expandir a classe especificada e/ou implementar a interface especificada.
A secção Detalhes do Atributo para um atributo de recursos.
Os autores de pontos de extensão podem definir atributos que fazem referência a outros atributos. Isto é conseguido definindo atributos de um ponto de extensão como identificadores de tipo e escolhendo o atributo que referencia. Um exemplo desta acção é o ponto de extensão org.eclipse.ui.handlers. O atributo commandId faz referência a comandos definidos no ponto de extensão org.eclipse.ui.commands.
Os programadores de extensões que escreverem uma rotina de tratamento podem depois seleccionar a partir de todos os identificadores válidos para o atributo commandId. São emitidos avisos para identificadores que não existem de modo a prevenir o erro comum de um identificador escrito incorrectamente.
Edite o campo Nome para especificar o nome do atributo.
Faça clique no botão verdadeiro ou falso dentro do campo Obsoleto para indicar se o atributo é obsoleto ou não. O Editor de Manifesto de Plug-ins irá sinalizar qualquer marcação XML de extensão que é obsoleto com um aviso (por predefinição). Este campo é análogo ao controlo Java Javadoc, @deprecated.
Seleccione um valor do campo Utilizar para indicar se tem de ser especificado um atributo no seu elemento de definição dentro da marcação contribuída XML de extensão. Estão disponíveis as seguintes selecções:
Edite o campo Valor predefinido para especificar o valor predefinido para utilizar para um atributo quando não for especificado no respectivo elemento de definição dentro da marcação contribuída XML de extensão. Este campo apenas se aplica quando o valor predefinido do campo Utilizar estiver seleccionado.
Seleccione um valor do campo Tipo para especificar o tipo de valor do atributo. Estão disponíveis as seguintes selecções:
Faça clique no botão verdadeiro ou falso dentro do campo Conversível para indicar se o valor do atributo é ou não conversível. Este campo apenas se aplica quando o valor da cadeia no campo Tipo estiver seleccionado. Se um valor de atributo for marcado como conversível, então as ferramentas do PDE pode ser utilizadas na marcação XML de extensão de contribuição para exteriorizar esses valores num ficheiro de propriedades para suporte de vários idiomas.
Utilize o campo Restrições para visualizar uma lista de valores de cadeia que o atributo está restringido a utilizar como seu próprio valor. Se o campo não tiver quaisquer valores, então é porque não existem quaisquer restrições no valor do atributo. Este campo apenas se aplica quando o valor da cadeia no campo Tipo estiver seleccionado. Nota: Uma restrição de enumeração no tipo base de cadeia é utilizada na gramática do esquema editado para atingir esta funcionalidade.
Edite o campo Expande para especificar um nome de classe totalmente qualificado no caminho de classe da plataforma de destino (por exemplo, org.eclipse.ui.part.EditorPart) que deve ser classificado numa subclasse pela classe especificada como o valor do atributo. O PDE irá validar o valor do atributo de classe na marcação XML de extensão de contribuição para assegurar que expande a super-classe. Este campo apenas se aplica quando o valor java no campo Tipo estiver seleccionado.
Edite o campo Implementa para especificar o nome da interface totalmente qualificado no caminho de classe da plataforma de destino (por exemplo, org.eclipse.ui.IEditorPart) que deve ser implementado pela classe especificada como o valor do atributo. O PDE irá validar o valor do atributo de classe na marcação XML de extensão de contribuição para assegurar que implementa a interface. Este campo apenas se aplica quando o valor java no campo Tipo estiver seleccionado.
Faça clique no botão Adicionar... no campo Restrições para abrir a caixa de diálogo Nova Restrição para adicionar uma nova restrição ao valor do atributo. Assim que a caixa de diálogo estiver concluída, a nova restrição é adicionada à lista de valores de cadeia que o atributo está restringido a utilizar como seu próprio valor. Esta acção apenas está disponível quando o valor cadeia no campo Tipo estiver seleccionado.
Seleccione um valor de cadeia dentro do campo Restrições e faça clique no botão Remover para remover uma restrição da lista de valores de cadeia que o atributo está restringido a utilizar como seu próprio valor. Esta acção apenas está disponível quando o valor cadeia no campo Tipo estiver seleccionado.
Se o valor especificado no campo Expande faz referência a um nome de classe totalmente qualificado no caminho de classe da plataforma de destino, então, ao fazer clique na hiperligação Expande irá abrir essa classe num novo editor de origem Java. Caso contrário, ao fazer clique na hiperligação Expande irá abrir o assistente Nova Classe Java que permite ao utilizador criar a nova classe. Esta acção apenas está disponível quando o valor java no campo Tipo estiver seleccionado.
Se o valor especificado no campo Implementa faz referência a um nome de interface totalmente qualificado no caminho de classe da plataforma de destino, então, ao fazer clique na hiperligação Implementa irá abrir essa interface num novo editor de origem Java. Caso contrário, ao fazer clique na hiperligação Implementa irá abrir o assistente Nova Classe Java que permite ao utilizador criar a nova interface. Esta acção apenas está disponível quando o valor java no campo Tipo estiver seleccionado.
Faça clique no botão Procurar... para abrir a caixa de diálogo Seleccionar Tipo para seleccionar uma classe existente no caminho de classe da plataforma de destino a utilizar como o valor para o campo Expande. Esta acção apenas está disponível quando o valor java no campo Tipo estiver seleccionado.
Faça clique no botão Procurar... para abrir a caixa de diálogo Seleccionar Tipo para seleccionar uma interface existente no caminho de classe da plataforma de destino a utilizar como o valor para o campo Implementa. Esta acção apenas está disponível quando o valor java no campo Tipo estiver seleccionado.