OpenOffice.org/Macro/ThisComponent/DrawPages

ThisComponent.DrawPages é a forma de acessar os desenhos (pages, ou páginas) de um documento Draw e os slides de um documento Impress . Neste texto, cada uma destas unidades (os desenhos do Draw e os slides do Impress) serão chamados genericamente de páginas.

ThisComponent.DrawPages é um array de objetos, e pode ser acessado como um array normal (através dos índices; lembrando que no BASIC os arrays se iniciam no zero)

Exemplo

  Dim pagina0 As Object
  Dim nome As String
  pagina0 = ThisComponent.DrawPages(0)
  nome = pagina0.getName()
  MsgBox nome
  pagina0.Name = "Novo nome da pagina 0"
  nome = pagina0.Name
  MsgBox nome

Atributos e métodos

• .getName() - retorna uma string com o nome da página
• .setName(string) - modifica o nome da página
• .Name - pode ser usado como uma variável, para acessar e modificar o nome da página
• .getByName(string) - seleciona um página pelo nome
• .hasByName(string) - verifica se a página existe
• .insertByName(string, objeto-planilha) - insere nova página no fim do documento
• .insertNewByName(string, pos) - insere uma nova página com este nome na posição escolhida
• .insertNewByIndex(pos) - insere uma nova página nesta posição
• .duplicate(objeto) - duplica uma página
• .removeByName(string) - remove página
• .remove(objeto) - remove uma pagina (objeto deve ter sido chamado anteriormente como, por exemplo, objeto = ThisComponent.DrawPages(0))

O objeto DrawPage

O objeto definido por ThisComponent.DrawPages(0) (ou algum outro método equivalente) é um objeto suportado pelo serviço com.sun.star.drawing.DrawPage.

Estes objetos tem os seguintes métodos e atributos, mas estes atributos, apesar de serem utilizados em cada página, se aplicam igualmente a todas as páginas do documento. Ou seja, modificando-se um destes atributos na página ThisComponent.DrawPages(0), modifica-se também na página (se existir) ThisComponent.DrawPages(42). As medidas lineares são, salvo exceção, em centésimos de milímetro (10^-5 metros) :

• BorderLeft (Long) - tamanho da borda esquerda
• BorderRight (Long) - tamanho da borda direita
• BorderTop (Long) - tamanho da borda de cima
• BorderBottom (Long) - tamanho da borda de baixo
• Width (Long) - largura da página
• Height (Long) - altura da página
• Number (Short) - número de páginas (read-only)
• Orientation (Enum) - orientação das páginas, de acordo com a variável enumeração em com.sun.star.view.PaperOrientation

Objetos de desenho

Os objetos de desenho são formas (retângulos, círculos, etc), linhas e textos. Estes objetos são tratados pelo serviço com.sun.star.drawing.Shape.