Bonus630DevToolsBar - DrawUIExplorer

DrawUIExplorer, umas das primeiras ferramentas que criei para o auxilio na criação de Addons para CorelDraw

Publicado:06/08/2023 Modificado:17/03/2024

DrawUIExplorer

DrawUI.xml

Umas das primeiras ferramentas que criei para o auxilio na criação de Addons para CorelDraw, em uma época que não tinhamos quase nenhuma informação de como customizar a interface do CorelDraw, nossa única alternativa era estudar o arquivo DrawUI.xml.

O CorelDraw possui um nível de customização de sua UI (Interface do Usuário) bem alto, ele utiliza de arquivos xslt para esse fim. Aqui não vou me aprofundar sobre os arquivos xslt, mas para um bom uso dessa ferramenta é recomendado conhecimento básico sobre o assunto.

Os arquivos xslt tem como função, na criação de Addon, de modificar a interface do usuário, para isso o arquivo Drawui.xml é modificado no tempo de execução do CorelDraw. O arquivo DrawUI.xml se encontra na pasta \Draw\UIConfig, este arquivo nunca deve ser modificado.

O arquivo Drawui.xml é um xml padrão, com tags e atributos, para este estudo também é recomendado um conhecimento prévio do assunto.

Conhecendo a ferramenta DrawUIExplorer

Como o nome já diz, essa ferramenta é um explorador do arquivo Drawui.xml, mas também podemos utiliza-lo para explorar área de trabalho salvas, a ferramenta tem formato de uma janela padrão e faz a leitura do xml e gera uma árvore exibidas em um TreeView, como no Explorador de arquivos dos Sistemas operacionias desktop (Windows,Linux,Max).

Podemos executar essa ferramenta dentro do CorelDraw ou fora, mas quando não estamos no CorelDraw está ferramenta vai conter varias limitações.

Está ferramenta ainda apresenta alguns bugs, e um comportamento estranho nas trocas de janelas.

A Interface

Possuie uma interface simples, vamos ver os detalhes dela, a imagem abaixo é da inferface com o arquivo Drawui.xml já carregado, basicamente a ferramenta não tem nenhuma interface antes de carregar algum arquivo nela(Drawui.xml, workspace.cdws).

Árvore Principal: Após carregar o contéudo do arquivo Drawui.xml ou de uma área de trabalho, este será exibido nesta árvore, cada item dessa árvore pode ser selecionado com um click e temos um menu com diversas opções com o click contrario do mouse, estas opções variam de acordo com o tipo de item.
Árvore de Refêrencia: Está árvore será visivel após selecionar um item que está referenciado a outro pelo atributo guidRef, este item referenciado será a raiz dessa árvore.
Árvore de Pesquisa: Quando ocorrer uma pesquisa na Aba Pesquisa será criado um item nessa árvore com o resultado da pesquisa feita
Abas Principais: Contendo aba de detalhes, cujo é mostrado os detalhes do item selecionado em alguma das árvores, aba de pesquisa, para realizarmos nossas pesquisas, e a aba para testes xsl.
1. Details: Esta aba mostra os detalhes do item selecionado em alguma das árvores, além disso ela contém inumeros comandos por meio de click e menus de contexto. Dentre algumas informações e comandos dessa aba.
  - Visualizar o icone, se existir.
  - O rotulo do item.
  - O método utilizado para adiquirir o rótulo
  - Guid
  - GuidRef
  - xPath
  - Lista de atributos
  - Abrir o icone no CorelDraw
  - Copiar guid,e guidRef, além dos atributos
  - Pesquisar diretamente pelo guidRef, por exemplo um item de menu que tem outros items como filhos, este vai possuir o atributo flyoutBarRef, com isso você pode encontrar esse item facilmente
  - Rodar comandos do DataSource e atribuir e recuperar valores das propriedades do DataSource. Esta função fica disponivel no menu de contexto de um atributo com valor de DataSource por Exemplo onInvoke='*Bind(DataSource=WNewDocumentDataSource;Path=NewDocCombo)'
2. Search: Podemos pesquisar pelo Guid Value, Tags, Attribute Name, e Attribute Value. e selecionar em qual item quer fazer a pesquisa, a pesquisa é aculumativa e sequencial, você deve adicionar os termos com o botão +, e poderá remove-los com o botão -, ou apenas ignorar sem remover com o botão olho. O resultado será exibido na árvore de Pesquisa.
  
  O botão List de cada campo preenche o combobox do campo com o contéudo do item Selecionado, por exemplo.
  Você pode adiquirir a lista com as tags dos items filhos de uma tag de commandBar.
  No campo Attribute Value é permitido digitar algum valor selecionando o RadioButton Like.
  É possivel realizar uma pesquisa em uma pesquisa, basta selecionar um item na árvore de pesquisa e marcar o radio button.
3. Xsl Tester: Aqui você testa seu xslt, e pode verificar se ele está modificando o XML de maneira correta
Abas de Consoles: Rode alguns comandos na aba InputCommands, visualize XML na aba de Xml Viewer, mensagens de rotinas são exibidas na aba Console e na na aba Corel EventViewer temos o eventos disparados pelo CorelDraw.
1. Input Commands: os comandos dispniveis são:
  - Help
    Mostra lista de comandos disponiveis.
  - Guid
    Gera um Guid
  - CQL [cql]
    Executa um CQL
  - InvokeItem [itemGuid]
    Executa um item, como se fosse clicado
  - InvokeDialogItem [dialogGuid] [itemGuid]
    Abre uma caixa de Dialogo
  - TryHighLightItem [itemGuid] [itemParentGuid]
    Destaca um item
  - RunMacro [macro]
    Executa uma macro VBA no formato Projeto.Modulo.Macro
2. Xml Viewer: Visualizador de XML, quando alguma operação tem como resultado um xml este vem para esta aba.
3. Console: Todas mensagens e resultados são concentrados nessa aba
4. Corel EventViewer: podemos ver o nome e os parametros do evento OnApplicationEvent
Barra de Commandos: Aqui se encontra alguns botões para executar ações basicas, como destacar um item, receber o guid do item ativo, configurações, abrir o arquivo drawui.xml e abrir o arquivo de área de trabalho.
1. Highlight: botão para destacar um item, com esse botão podemos destacar o item selecionado de uma árvore no CorelDraw, o item só poderá ser destacado se estiver visivel na tela.
2. Get Active Tool: Este comando retorna o valor do Guid da ferramenta ativa, na caixa de ferramentas, o resultado é exibido na Aba Console.
3. Config: Abre a janela de Configurações
  Na janela de configurações, você pode, definir o tamanho da fonte no editor xsl, mostrar numero de linhas no console, definir se deseja abrir um arquivo sempre que abrir o aplicativo e definir seu caminho e também é possivel adicionar um editor padrão de xml.
4. Abre seu arquivo Drawui.xml
5. Abre um arquivo de área de trabalho (*.cdws)