C. Personalizar o think-cell

Este capítulo descreve como personalizar o think-cell, isto é, como alterar as cores padrão e outras propriedades padrão.

As propriedades a seguir podem ser alteradas usando arquivos de estilos:

A primeira seção descreve como criar e carregar um arquivo de estilos e explica como implementá-lo em uma organização. É necessário saber como executar essas tarefas, de qualquer forma. Depois disto, você pode seguir o Tutorial do arquivo de estilos> para criar seu próprio arquivo de estilos ou passar pela referência de formato em Formato de arquivo de estilos.

C.1
Criando um estilo do think-cell
C.2
Carregando arquivos de estilos
C.3
Implementando estilos do think-cell
C.4
Tutorial do arquivo de estilos
C.5
Definir um layout de slide de pauta padrão

C.1 Criando um estilo do think-cell

Podem ser feitas modificações simples em um arquivo de estilos existente usando um editor de texto. Use um editor de XML especializado para criar um novo arquivo de estilos do think-cell. O editor ajudará você a verificar os erros automaticamente e fará sugestões de como resolvê-los. A nossa recomendação para tal editor e dicas para configurá-lo são descritas em

https://www.think-cell.com/kb/0191

Um editor exclusivo XML normalmente destacará erros em seu documento e com um atalho de teclas, como Ctrl + barra de espaço, você pode acionar a autocomplementação: o editor oferecerá a escolha de etiquetas, atributos ou valores aplicáveis ao contexto atual (posição do cursor no texto). Se você mover o mouse sobre erros destacados, será exibida uma dica de ferramenta com uma explicação detalhada do erro.

Junto com o think-cell, você receberá alguns arquivos de estilos de exemplo. Eles estão na subpasta estilos na pasta de instalação do think-cell. Primeiro, encontre a localização da pasta de instalação. É exibido quando você clica em Sobre no menu image  Mais.

Encontrar a pasta de instalação

Abra essa pasta e vá para a subpasta estilos, p. ex.,

C:\Program Files\think-cell\styles

Abra o arquivo generic style.xml. A aparência é como esta:

O arquivo de estilos padrão carregado no Visual Studio Express para a Web

O editor verifica erros do arquivo automaticamente. Você pode visualizar uma lista de erros clicando em Exibir > Lista de erros:

Lista de erros vazia na janela do Visual Studio Express para a Web

Certifique-se de que não há avisos ou erros indicados antes de salvar um arquivo de estilos editado.

Evidentemente, qualquer outro editor com suporte de XML também funciona. O arquivo tem que ser salvo com uma extensão .xml.

C.2 Carregando arquivos de estilos

Para carregar um arquivo de estilos, selecione Carregar arquivo de estilos... no menu image  Mais. Na caixa de diálogo, navegue até a pasta com o arquivo de estilos, selecione o arquivo e clique em Abrir. Ela é usada para novos gráficos na apresentação atual.

Por exemplo, depois de carregar o arquivo de estilos example_style_complex.xml do diretório estilos no caminho de instalação do think-cell, os controles de propriedade da cor e do esquema de cores incluirão itens personalizados.

Lista de cores e esquemas de cores alterados conforme um estilo de exemplo complexo

Se desejar aplicar as cores ou os esquemas de cores do estilo a gráficos existentes, você precisa fazer isto manualmente.

C.2.1 Carregar arquivos de estilo programaticamente

Você também pode carregar arquivos de estilo, por exemplo, como parte de um fluxo de trabalho que prepara modelos novos ou atualizados. A maior precisão de chamadas API também permite especificar opções adicionais ao carregar um arquivo de estilo, como para usar em um layout personalizado específico ou até mesmo restringir o estilo para uma região retangular de um layout personalizado.

Suponha que você tem um layout personalizado com diferentes cores de plano de fundo nos lados esquerdo e direito do slide. O lado direito corresponde ao plano de fundo do restante da sua apresentação, portanto tudo bem se o conjunto de estilo no slide mestre for aplicado aqui. Contudo, o lado esquerdo usa um plano de fundo diferente, para o qual um estilo modificado é apropriado. Nesta situação, você poderia usar Carregar estilo para definir um arquivo de estilo para a apresentação toda. A seguir, você usaria Carregar estilo para região para definir um estilo diferente apenas para o lado do layout personalizado apropriado.

As seções a seguir descrevem as chamadas API disponíveis.

C.2.2 Carregar estilo

C.2.2.1 Assinatura

tcaddin.LoadStyle( _ 
    CustomLayoutOrMaster As Master, _ 
    FileName As String 
)
Ao carregar um arquivo de estilo em um layout personalizado, a assinatura é
tcaddin.LoadStyle( _ 
    CustomLayoutOrMaster As CustomLayout, _ 
    FileName As String _
)

C.2.2.2 Descrição

Chamada do PowerPoint, esta função carrega o arquivo de estilo para FileName em um layout mestre ou personalizado, especificado pelo parâmetro CustomLayoutOrMaster.

C.2.2.3 Exemplo

' When Option Explicit appears in a file, you must 
' explicitly declare all variables using the Dim 
' or ReDim statements. If you attempt to use an 
' undeclared variable name, an error occurs at 
' compile time. 
' Use Option Explicit to avoid incorrectly typing 
' the name of an existing variable or to avoid 
' confusion in code where the scope of the 
' variable is not clear. If you do not use the 
' Option Explicit statement, all undeclared 
' variables are of Object type. 
' http://msdn.microsoft.com/en-us/ 
' library/y9341s4f%28v=vs.80%29.aspx 
Option Explicit
 
Sub LoadStyle_Sample() 
 
   ' Get the think-cell add-in object 
   Dim tcaddin As Object 
   Set tcaddin = Application.COMAddIns("thinkcell.addin").Object 
 
   Dim master As Master
   Set master = Application.ActivePresentation.Designs(1).SlideMaster
   
   Dim style As String
   style = "C:\some\path\styles\style.xml"
 
   Call tcaddin.LoadStyle(master, style)
End Sub

C.2.3 Carregar estilo para região

C.2.3.1 Assinatura

tcaddin.LoadStyleForRegion( _ 
    CustomLayout As CustomLayout, _ 
    FileName As String, _
	Left as Single, _
	Top as Single, _
	Width as Single, _
	Height as Single _
)

C 2.3.2 Descrição

Chamada do PowerPoint, esta função carrega o arquivo de estilo para FileName no layout personalizado CustomLayout e o restringe para uma dada região por Left, Top, Width, Height. No restante do slide, o estilo previamente carregado com LoadStyle se aplica.

Os parâmetros Left, Top, Width, Height são dados nos pontos do PowerPoint. Geralmente, você os definirá como frações da altura e da largura total do slide. Por exemplo, para uma região cobrindo dois terços do lado direito de um slide, Left seria definido para 1/3 da largura do slide e Width para 2/3.

Você também pode adicionar manualmente uma forma para um slide ou layout personalizado, consultar suas propriedades Left, Top, Width, Height programaticamente e usar os valores com LoadStyleForRegion para restringir o estilo para a mesma região coberta pela forma.

O think-cell suporta no máximo dois estilos por layout personalizado. Um é definido com LoadStyle e cobre tudo não restrito a uma região, o outro é definido com LoadStyleForRegion.

C.2.3.3 Exemplo

' When Option Explicit appears in a file, you must 
' explicitly declare all variables using the Dim 
' or ReDim statements. If you attempt to use an 
' undeclared variable name, an error occurs at 
' compile time. 
' Use Option Explicit to avoid incorrectly typing 
' the name of an existing variable or to avoid 
' confusion in code where the scope of the 
' variable is not clear. If you do not use the 
' Option Explicit statement, all undeclared 
' variables are of Object type. 
' http://msdn.microsoft.com/en-us/ 
' library/y9341s4f%28v=vs.80%29.aspx 
Option Explicit
 
Sub LoadStyleForRegion_Sample() 
 
   ' Get the think-cell add-in object 
   Dim tcaddin As Object 
   Set tcaddin = Application.COMAddIns("thinkcell.addin").Object 
 
   Dim layout As CustomLayout
   Set layout = Application.ActivePresentation.Designs(1).SlideMaster.CustomLayouts(2)
   
   Dim left, top, width, height As Single
   top = 0
   left = 0
   width = layout.Width / 2
   height = layout.Height
   
   Dim style As String
   style = "C:\some\path\styles\style.xml"
 
   Call tcaddin.LoadStyleForRegion(layout, style, left, top, width, height)
End Sub

C.2.4 Remover estilos

C.2.4.1 Assinatura

tcaddin.RemoveStyles( _ 
    CustomLayout As CustomLayout _ 
)

C.2.4.2 Descrição

Chamada do PowerPoint, esta função remove todos os estilos do layout personalizado CustomLayout. Posteriormente, o estilo carregado no slide mestre aplica-se. Potencialmente, pode haver um estilo carregado no layout personalizado e outro estilo restrito a uma região específica do layout personalizado. Como RemoveStyles remove todos os estilos, ambos serão removidos. O estilo carregado em um slide mestre não pode ser removido, pois sempre precisa ser um estilo válido associado a um slide mestre. Ele pode ser substituído por um arquivo de estilo diferente.

C.2.4.3 Exemplo

' When Option Explicit appears in a file, you must 
' explicitly declare all variables using the Dim 
' or ReDim statements. If you attempt to use an 
' undeclared variable name, an error occurs at 
' compile time. 
' Use Option Explicit to avoid incorrectly typing 
' the name of an existing variable or to avoid 
' confusion in code where the scope of the 
' variable is not clear. If you do not use the 
' Option Explicit statement, all undeclared 
' variables are of Object type. 
' http://msdn.microsoft.com/en-us/ 
' library/y9341s4f%28v=vs.80%29.aspx 
Option Explicit
 
Sub RemoveStyles_Sample() 
 
   ' Get the think-cell add-in object 
   Dim tcaddin As Object 
   Set tcaddin = Application.COMAddIns("thinkcell.addin").Object 
 
   Dim layout As CustomLayout
   Set layout = Application.ActivePresentation.Designs(1).SlideMaster.CustomLayouts(2)
   
   Call tcaddin.RemoveStyles(layout)
End Sub

C.3 Implementando estilos do think-cell

Carregar arquivo de estilos... no menu image  Mais na barra de ferramentas do think-cell carrega um arquivo de estilos no slide mestre da apresentação atual. Quando a apresentação é distribuída como um modelo do PowerPoint, o estilo do think-cell também é distribuído implicitamente. É possível mudar entre estilos mudando os modelos do PowerPoint. Não deve ser necessário dar um arquivo de estilos do think-cell a usuários individuais.

Recomendamos distribuir seus estilos de think-cell junto com seu modelo do PowerPoint. Tipicamente ambos são necessários para implementar seu design corporativo e implementá-los juntos é a opção mais fácil para os usuários.

Se não for possível seguir nossa recomendação para implantar o estilo do think-cell como parte do seu modelo do PowerPoint, um arquivo de estilos padrão pode ser especificado com o parâmetro de configuração defaultstyle (consulte Parâmetros de configuração). O valor do parâmetro é o nome do caminho para um arquivo de estilos valido. Se nenhum caminho absoluto for incluído, o nome de arquivo especificado é carregado a partir do local de instalação do think-cell.

O arquivo de estilos padrão é carregado automaticamente em duas ocasiões:

  1. Quando uma nova apresentação é criada.
  2. Quando uma apresentação existente é aberta e ela não contém no momento um estilo. Quando esta apresentação é salva e aberta novamente ela conterá um estilo, portanto o estilo padrão não é carregado novamente.

O arquivo de estilos padrão que será carregado automaticamente é destacado com um anexo (padrão) na lista de arquivos de estilos disponíveis e recentemente carregados:

Comando de menu Carregar arquivo de estilos com a lista de estilos disponíveis e usados recentemente

C.4 Tutorial do arquivo de estilos

No diretório de instalação do think-cell (normalmente C:\Program Files\think-cell), no subdiretório styles, você pode encontrar o arquivo de estilosgeneric style.xml. Esse estilo usa as cores e esquemas de cores disponíveis logo após a instalação, quando nenhum estilo está carregado. Por isso,

  1. Faça uma cópia degeneric style.xml e carregue-a no editor de XML (consulte Criando um estilo do think-cell para escolher um editor adequado).
  2. Percorra todo o arquivo e aplique as alterações descritas nos passos seguintes.
  3. Remova todas as cores desnecessárias da lista no elemento fillLst. Você encontrará os elementos solidFill, pattFill e separator correspondentes aos itens na lista de cores exibida no think-cell (consulte Cor e preenchimento). Para remover, por exemplo, um elemento solidFill, remova tudo entre e incluindo a guia inicial <solidFill ...> e a marca final </solidFill>.
  4. Opcionalmente, crie uma nova seção para as suas cores. Para fazer isso, insira uma separator tag gravando<separator/> no local apropriado na lista de cores. Você poderá também usar quebras de linhas, indentação e linhas vazias para estruturar o código XML do arquivo de estilos desejado. Os espaços e as quebras de linhas não têm efeitos no estilo resultante.
  5. Adicione as suas cores usando o elemento solidFill. A sua cor precisa de um nome e valores para os canais de vermelho, verde e azul. Você deve ter esses valores do documento de especificações para a identidade corporativa da sua empresa. Se o nome da cor for “Verde Claro”, o valor decimal do canal vermelho for 170, para verde for 255 e para azul for 42, a cor deverá ter este aspecto:
    <solidFill name="Light Green"> 
      <sdrgbClr r="170" g="255" b="42"/> 
    </solidFill>
    
  6. Remova os esquemas de cores desnecessários da lista dentro do elemento fillSchemeLst. Você irá encontrar elementos fillScheme correspondentes aos itens na lista do esquema de cores exibida no think-cell (consulte )Esquema de cores. Para remover um elemento fillScheme, remova tudo entre e incluindo a marca inicial <fillScheme ...> e a marca de final </fillScheme>.
  7. Opcionalmente, modifique um esquema de cores existente. Você pode
    • remover uma ou várias cores do esquema removendo os elementos respectivos fillRef ou
    • reordenando as cores existentes ao reordenar os elementos fillRef ou
    • Inclua um das suas próprias cores adicionando um fillRef elemento no interior do fillScheme elemento, no local apropriado. Se desejar incluir a cor definida acima, adicione a linha seguinte:
      <fillRef name="Light Green"/>
      

    Observe que você só pode usar cores que foram definidas na seção fillLst (consulte os passos 3.-5.) acima. Em particular, se você removeu cores no passo 3., também tem que remover essas cores dos esquemas de cores.

  8. Opcionalmente, crie um novo esquema de cor usando o elemento fillScheme. Seu esquema precisa de um nome, por exemplo, “Green Scheme”, uma referência de cor a ser usada pelas demais séries em um atributo exigido fillSchemeLst, e uma lista de referências de cores como fillRef elementos. Se você definiu as cores “Laranja” e “Verde Escuro” e “Verde Médio” além do “Verde Claro”, seu esquema de cores tem este aspecto:
    <fillScheme name="Green Scheme" fillRefOtherSeries="Orange"> 
      <fillRef name="Dark Green"/> 
      <fillRef name="Medium Green"/> 
      <fillRef name="Light Green"/> 
    </fillScheme>
    
  9. Verifique os conteúdos do elemento fillSchemeRefDefault. O atributo name especifica o esquema de cores usado por padrão ao inserir novos gráficos. Se desejar definir o seu próprio esquema de cores com o novo padrão, modifique o código da seguinte forma:
    <fillSchemeRefDefault name="Green scheme"/>
    
  10. Salve o arquivo de estilos modificado, carregue-o (consulte Carregando arquivos de estilos) e teste o arquivo.
  11. Implemente o novo estilo na sua organização conforme descrito em Implementando estilos do think-cell. Em particular, não é necessário enviar o arquivo XML aos seus colegas, mas deverá mantê-lo para referência.

C.5 Definir um layout de slide de pauta padrão

A agenda think-cell pode usar um layout personalizado específico em sua apresentação para definir a posição da agenda e outras formas em um slide da agenda como cabeçalhos ou imagens. Ao adicionar esse layout personalizado a um modelo, você pode definir essas configurações para toda uma organização.

  1. No modo de exibição mestre do slide do PowerPoint, crie um novo layout personalizado. Normalmente, você duplicará um dos layouts personalizados existentes que melhor correspondem ao aspecto desejado de um slide da agenda think-cell.
  2. Nomeie o novo layout personalizado “agenda do think-cell”. O think-cell irá usar esse layout personalizado somente se ele corresponder exatamente a esse nome, que diferencia letras maiúsculas de minúsculas.
  3. Somente inclua formas no layout personalizado da “agenda do think-cell” que devem aparecer dessa forma em todos os slides da agenda.
  4. Ao editar o layout personalizado, escolha image  o Espaço reservado da pauta no menu elementos. Este elemento só está disponível ao editar um layout personalizado. Ele adiciona um espaço reservado da agenda no layout personalizado atual.
  5. Escolha a posição do espaço reservado da agenda conforme descrito em Posicionar a pauta.

Quando um layout personalizado criado dessa maneira com o nome de “agenda do think-cell” é encontrado na apresentação atual, o image  Capítulo usará esse layout personalizado, incluindo quaisquer formas adicionais nele, e colocará a agenda na posição predefinida.

Compartilhe