Essa página do formulário permite editar a estrutura e as propriedades de objetos do esquema que constituem a gramática do esquema editado.
A estrutura de objetos do esquema é editada na seção Elementos do Ponto de Extensão. Essa seção ocupa a parte superior esquerda da área do editor.
As propriedades de objetos do esquema são editadas nas seções Detalhes do <objeto do esquema>. Essas seções são ativadas na parte superior direita da área do editor, dependendo do tipo de elemento de esquema selecionado na seção Elementos do Ponto de Extensão.
Esta página é formada pelas seguintes seções:
Esta seção permite fazer o seguinte:
Essa seção pode ser acessada diretamente da página de formulário Definição do Esquema.
Utilize o campo do visualizador de elementos do ponto de extensão para fazer o seguinte:
Esse 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 atalho são permitidos como filhos legais. Uma referência de elemento é utilizada para representar o elemento atalho. Um compositor 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 filho legal. Referências de elemento são utilizadas para representar os elementos descrição e categoria. Um compositor Opção é utilizado para representar uma opção de elementos.
Clique no botão Incluir Elemento para incluir uma nova declaração de elemento global na gramática do esquema de ponto de extensão. Essa ação estará disponível quando algum nó estiver selecionado. Nota: A ordem da declaração dos elementos não é importante.
Clique no botão Incluir Atributo para incluir uma nova declaração de atributo local em um elemento selecionado na gramática do esquema de ponto de extensão. Essa ação está disponível para todos os nós elemento selecionados, exceto o nó elemento extensão. O nó elemento extensão sempre tem os mesmos atributos: id, nome, ponto. Nota: A ordem da declaração dos atributos não é importante.
Para excluir um objeto do esquema da gramática do esquema de ponto de extensão, clique com o botão direito em um nó selecionado e selecione Excluir. Essa ação está disponível para todos os nós selecionados, exceto para o nó elemento extensão. Para esquemas não compartilhados, o nó elemento extensão é o elemento raiz especial utilizado para definir o ponto de entrada para a gramática do esquema editado. Qualquer extensão definida no Editor de Manifesto de Plug-ins deve usar um elemento-pai extensão para especificar sua marcação relacionada ao XML.
Para especificar que um filho do elemento seja formado por uma sequência ou uma opção de outros elementos na gramática do esquema de ponto de extensão, faça o seguinte:
Nota: Para especificar se um elemento é o filho de outro elemento, um compositor Sequência ou Opção intermediário deve ser sempre utilizado pelo elemento-pai. Os nós compositor são nós conectores; enquanto que os nós referência de elemento são nós folhas. Portanto, os nós compositor devem sempre especificar pelo menos um nó filho referência de elemento.
Nota: Os compositores Sequência e Opção podem ser aninhados quantas vezes forem necessárias para criar gramáticas mais complexas.
Nota: Uma gramática não precisa conter ciclos auto-referentes. O formulário mais básico de um ciclo proibido ocorre quando o Elemento A exige o Elemento B como um filho e o Elemento B exige o Elemento A como um filho.
Para especificar que um elemento não tenha filhos e permitir que seja especificado texto dentro de suas tags XML de início e término (conteúdo de caractere), simplesmente deixe a estrutura do elemento no estado em que se encontra não incluindo atributos, compositores e referências de elemento para ela (conteúdo de elemento). Nota: Um elemento não pode especificar conteúdo combinado (conteúdo de caractere e conteúdo de elemento).
Esta seção permite fornecer uma breve descrição de qualquer elemento, atributo ou compositor dentro da gramática de esquema editado.
Essa seção pode ser acessada diretamente da página de formulário Definição do Esquema.
Edite o campo de texto da descrição para fornecer uma breve descrição para o nó elemento, atributo ou compositor atual, selecionado na seção Elementos do Ponto de Extensão. A marcação HTML válida pode ser utilizada dentro desse campo, conforme for necessário.
Nota: A atualização de uma descrição de referência atualiza também a descrição da declaração de elemento global à qual ela se refere e vice-versa.
Esta seção permite editar as propriedades de um elemento. Há dois tipos de elementos: elemento de extensão, elemento de não extensão. Um elemento de extensão é a declaração de elemento-raiz especial utilizada para definir o ponto de entrada para a gramática do esquema editado. Um elemento de não extensão é uma declaração de elemento global utilizada como um bloco de construção estrutural básico dentro da gramática do esquema editado.
Esta seção é ativada selecionando um nó elemento extensão ou um nó elemento não extensão na seção Elementos do Ponto de Extensão.
A seção Detalhes do Elemento de um elemento extensão.
A seção Detalhes do Elemento para um elemento de não extensão.
Edite o campo Nome para especificar o nome do elemento.
Clique no botão true ou no botão false no campo Interno para indicar se o elemento é interno, ou não. O Editor de Manifesto de Plug-ins sinalizará qualquer marcação XML da extensão que for interna com um aviso (por padrão). Este campo é análogo ao atributo x-internal nos pacotes exportados.
Clique no botão true ou false do campo Reprovado para indicar se o elemento é reprovado ou não. O Editor do Manifesto de Plug-in sinalizará qualquer marcação XML da extensão que é reprovada com um aviso (por padrão). Esse campo é análogo à tag Javadoc @deprecated do Java.
Se um elemento de extensão for marcado como descontinuado, edite o campo Substituição para especificar o ponto de extensão não descontinuado que o usuário deve usar em seu local para atingir a mesma funcionalidade.
Selecione um dos atributos definidos do elemento no campo Propriedade do Rótulo para especificar o valor do atributo a ser utilizado como o rótulo do elemento no Editor de Manifesto de Plug-in. Por exemplo, se um valor for selecionado, o rótulo do nó do elemento na seção Todas as Extensões da página Extensões do Editor do Manifesto de Plug-in será o seguinte: valor do atributo selecionado (nome do elemento). Caso contrário, se nenhum valor for especificado, o rótulo do nó do elemento será o seguinte: (nome do elemento).
Selecione um dos atributos de tipo de recurso definido do elemento no campo Ícone para especificar o recurso do ícone a ser utilizado para representar o nó do elemento no Editor do Manifesto de Plug-in. Para que o ícone de nó do elemento seja mostrado corretamente na seção Todas as Extensões da página Extensões do Editor do Manifesto de Plug-in, as seguintes condições devem ser atendidas:
Clique no botão true ou false do campo Traduzível para indicar se o conteúdo do caractere do elemento é traduzível ou não. Esse campo é aplicável apenas a elementos que não possuem filhos especificados (conteúdo de elemento) ou atributos e permite a especificação do texto dentro de suas tags XML de início e término (conteúdo de caractere). Se um conteúdo de caractere do elemento estiver marcado como traduzível, as ferramentas PDE poderão ser utilizadas em marcação XML da extensão contribuída para externalizar o conteúdo em um arquivo de propriedades para suporte em vários idiomas.
Utilize o campo Aproximação de DTD de leitura para visualizar um mapeamento um a um aproximado da gramática do esquema de elemento para a gramática DTD do elemento equivalente. Um DTD (Definição de Tipo de Documento) é uma alternativa mais fácil de ler, menos poderosa para Esquema XML para especificar uma gramática formal de um documento XML. A notação a seguir é utilizada para especificar a aproximação de DTD:
Esta seção permite editar as propriedades de um compositor. Há dois tipos de compositores: compositor de sequência e compositor de opção. Um compositor de sequência permite especificar que um filho do elemento é formado por uma sequência de outros elementos na gramática do esquema editado. Um compositor de opção permite especificar que um filho do elemento é formado por uma opção de outros elementos na gramática do esquema editado.
Esta seção é ativada selecionando um nó Sequência ou Opção na seção Elementos do Ponto de Extensão.
Edite o campo Mín. de Ocorrências para especificar o número mínimo de ocorrências que esse compositor de outros elementos e/ou compositores tem permissão para exibir na marcação XML da extensão contribuída. Esse valor de campo é utilizado pelo PDE para validar restrições de multiplicidade dentro do Editor de Manifesto de Plug-ins. Se o Elemento A exigir exatamente um Elemento B ou Elemento C como seu filho e usar um compositor Opção especificando 2 ocorrências mínimas, então quaisquer 2 instâncias do Elemento B em combinação com o Elemento C devem ser definidas na marcação XML de extensão contribuída para serem válidas.
Edite o campo Máx. de Ocorrências para especificar o número máximo de ocorrências que esse compositor de outros elementos e/ou compositores tem permissão para exibir na marcação XML da extensão contribuída. Esse valor de campo é utilizado pelo PDE para validar restrições de multiplicidade dentro do Editor de Manifesto de Plug-ins. Se o Elemento A exigir exatamente um Elemento B ou Elemento C como seu filho e usar um compositor Opção especificando 2 ocorrências máximas, então não mais de 2 instâncias do Elemento B em combinação com o Elemento C podem ser definidas na marcação XML da extensão contribuída para permanecerem válidas.
Marque o campo Sem Vínculo para especificar que não há restrição no número máximo de ocorrências permitidas para que esse compositor possa ser exibido dentro da marcação XML da extensão contribuída.
Selecione um valor no campo Tipo para especificar se esse compositor é uma sequência ou uma opção.
Utilize o campo de leitura Aproximação de DTD para visualizar um mapeamento um a um aproximado da gramática do esquema de compositor para a gramática DTD do compositor. A notação utilizada para especificar a aproximação de DTD é descrita no cabeçalho Campos da Seção de Detalhes do Elemento neste documento.
Esta seção permite editar as propriedades de uma referência do elemento. Uma referência do elemento é uma referência a uma declaração de elemento global dentro da gramática do esquema editado. As referências de elemento são utilizadas por compositores como blocos de construção para definir a gramática para declarações do elemento global.
Esta seção é ativada selecionando um nó referência de elemento na seção Elementos do Ponto de Extensão.
Edite o campo Mín. de Ocorrências para especificar o número mínimo de ocorrências que esse elemento tem permissão de exibir na marcação XML da extensão contribuída. Esse valor de campo é utilizado pelo PDE para validar restrições de multiplicidade dentro do Editor de Manifesto de Plug-ins. Se o Elemento A especificar o mínimo de 2 ocorrências, então 2 instâncias do Elemento A deverão ser definidas na marcação XML da extensão contribuída para que ele seja válido.
Edite o campo Máx. de Ocorrências para especificar o número máximo de ocorrências que esse elemento tem permissão para exibir na marcação XML da extensão contribuída. Esse valor de campo é utilizado pelo PDE para validar restrições de multiplicidade dentro do Editor de Manifesto de Plug-ins. Se o Elemento A especificar o máximo de 2 ocorrências, então não mais do que 2 instâncias do Elemento A poderão ser definidas na marcação XML da extensão contribuída para que permaneça válido.
Marque o campo Sem Vínculo para especificar que não há restrição no número máximo de ocorrências permitidas para que esse elemento possa ser exibido dentro da marcação XML da extensão contribuída.
Utilize o campo Aproximação de DTD de leitura para visualizar um mapeamento um a um aproximado da gramática do esquema de elemento para a gramática DTD do elemento equivalente. A notação utilizada para especificar a aproximação de DTD é descrita no cabeçalho Campos da Seção de Detalhes do Elemento neste documento.
Clique no hyperlink nome do elemento do campo Referência para editar as propriedades da declaração do elemento global às quais se referem essa referência do elemento local. Quando essa ação estiver concluída, o nó elemento referido será selecionado na seção Elementos do Ponto de Extensão e a seção Detalhes do Elemento correspondente será ativada.
Esta seção permite editar as propriedades de um atributo. Os atributos são utilizados para fornecer informações adicionais sobre os elementos.
Esta seção é ativada selecionando um nó atributo obrigatório, atributo opcional, atributo de classe ou atributo de recurso na seção Elementos do Ponto de Extensão.
A seção Detalhes do Atributo de um atributo obrigatório do tipo cadeia que especifica uma restrição de enumeração.
A seção Detalhes do Atributo de um atributo opcional do tipo booleano que especifica um valor padrão.
A seção Detalhes do Atributo de um atributo de classe que indica que a classe representada pelo valor do atributo deve estender a classe especificada e/ou implementar a interface especificada.
A seção Detalhes do Atributo para um atributo de recurso.
Os autores do ponto de extensão podem definir os atributos que fazem referência a outros atributos. Isso é obtido configurando os atributos de seu ponto de extensão como Identificador de tipo e escolhendo o atributo ao qual faz referência. Um exemplo disso seria o ponto de extensão org.eclipse.ui.handlers. O atributo commandId faz referência aos comandos definidos no ponto de extensão org.eclipse.ui.commands.
Os desenvolvedores de extensão que contribuem com um manipulador podem selecionar de todos os identificadores válidos para o atributo commandId. Os avisos são emitidos para identificadores inexistentes a fim de impedir o engano comum de um identificador escrito de forma errada.
Edite o campo Nome para especificar o nome do atributo.
Clique no botão true ou false do campo Reprovado para indicar se o atributo é reprovado ou não. O Editor do Manifesto de Plug-in sinalizará qualquer marcação XML da extensão que é reprovada com um aviso (por padrão). Esse campo é análogo à tag Javadoc @deprecated do Java.
Selecione um valor no campo Uso para indicar se o atributo deve ser especificado em seu elemento de definição dentro da marcação XML de extensão contribuída. As seguintes seleções estão disponíveis:
Edite o campo Valor Padrão para especificar o valor padrão a ser usado para um atributo quando ele não for especificado em seu elemento de definição dentro da marcação XML de extensão contribuída. Esse campo será aplicável apenas quando o valor padrão do campo Utilizar estiver selecionado.
Selecione um valor no campo Tipo para especificar o tipo de valor do atributo. As seguintes seleções estão disponíveis:
Clique no botão true ou false do campo Traduzível para indicar se o valor dos atributos é traduzível ou não. Esse campo será aplicável apenas quando o valor cadeia do campo Tipo estiver selecionado. Se um valor do atributo estiver marcado como traduzível, então as ferramentas PDE poderão ser utilizadas na marcação XML da extensão contribuída para externalizar esses valores para um arquivo de propriedades para suporte em vários idiomas.
Use o campo Restrições para visualizar uma lista de valores de sequência aos quais o atributo está restrito usando como seu próprio valor. Se o campo não contiver valores, então não haverá restrições no valor do atributo. Esse campo será aplicável apenas quando o valor cadeia do campo Tipo estiver selecionado. Nota: Uma restrição na enumeração no tipo de base de cadeia é utilizada na gramática do esquema editado para executar essa funcionalidade.
Edite o campo Extensões 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 subclassificado pela classe especificada como o valor do atributo. O PDE validará o valor do atributo de classe da marcação XML da extensão contribuída para garantir que estenda a superclasse. Esse campo será aplicável apenas quando o valor java do campo Tipo estiver selecionado.
Edite o campo Implementações para especificar um nome de 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 validará o valor do atributo de classe da marcação XML da extensão contribuída para garantir que ele implemente a interface. Esse campo será aplicável apenas quando o valor java do campo Tipo estiver selecionado.
Clique no botão Incluir... do campo Restrições para abrir o diálogo Nova Restrição, a fim de incluir uma nova restrição no valor de atributo. Depois do diálogo ser concluído, a nova restrição é incluída na lista de valores de sequências aos quais o atributo está restrito para usar como seu próprio valor. Essa ação estará disponível apenas quando o valor cadeia do campo Tipo estiver selecionado.
Selecione um valor de sequência dentro do campo Restrições e clique no botão Remover para remover uma restrição da lista de valores de sequência aos quais o atributo está restrito usando como seu próprio valor. Essa ação estará disponível apenas quando o valor cadeia do campo Tipo estiver selecionado.
Se o valor especificado no campo Extensões se referir a um nome de classe totalmente qualificado no caminho de classe da plataforma, então clicar no hyperlink Extensões abrirá essa classe em um novo editor de origem Java. Caso contrário, clicar no hyperlink Extensões abrirá o assistente de Nova Classe Java, permitindo criar a nova classe. Essa ação estará disponível apenas quando o valor java do campo Tipo estiver selecionado.
Se o valor especificado no campo Implementações se referir a um nome de interface totalmente qualificado no caminho de classe da plataforma de destino, então clicar no hyperlink Implementações abrirá essa interface em um novo editor de origem Java. Caso contrário, clicar no hyperlink Implementações abrirá o assistente de Nova Classe Java, permitindo criar a nova interface. Essa ação estará disponível apenas quando o valor java do campo Tipo estiver selecionado.
Clique no botão Procurar... para abrir o diálogo Selecionar Tipo, a fim de selecionar uma classe existente no caminho de classe da plataforma de destino para utilizar como o valor para o campo Extensões. Essa ação estará disponível apenas quando o valor java do campo Tipo estiver selecionado.
Clique no botão Procurar... para abrir o diálogo Selecionar Tipo, a fim de selecionar uma interface existente no caminho de classe da plataforma de destino para utilizar como o valor para o campo Implementações. Essa ação estará disponível apenas quando o valor java do campo Tipo estiver selecionado.