Método Master.Open (Visio)

  • Artigo

Abre um mestre existente para que possa ser editado.

Sintaxe

expressão. Aberto

Expressão Uma variável que representa um objeto Mestre .

Valor de retorno

Master

Comentários

Use o método Open para um objeto Master em conjunto com o método Close para editar de forma confiável as formas e células de um mestre. Em algumas versões anteriores do Visio, você podia editar formas e células de um objeto Master, mas as alterações não eram empurradas para instâncias do mestre e as informações da caixa de alinhamento exibidas ao instanciar o mestre editado não eram corretas.

Para editar as formas e células de um objeto Master a partir de um programa

  1. Abra o objeto Mestre para edição usando masterObjCopy = masterObj. Abra. Esse código falhará se houver uma janela de desenho aberta no masterObj ou se outros programas já tiverem o masterObj aberto. Se o método Open obtiver êxito, masterObjCopy será uma cópia de masterObj.

  2. Altere as formas e as células no masterObjCopy , não no masterObj.

  3. Feche o objeto Master usando masterObjCopy. Feche. O método Close falhará se masterObjCopy não for um objeto Master que resultou de uma chamada de masterObj. Abra a chamada. Caso contrário, o método Close mesclará as alterações feitas na etapa 2 de masterObjCopy de volta em masterObj. Ele também atualizará todas as instâncias de masterObj para refletir as alterações e atualizar as informações armazenadas em cache em masterObj. Se masterObj. IconUpdate não for visManual (0), o método Close atualizará o ícone mostrado na janela do estêncil para masterObj representar uma imagem de masterObjCopy.

Se você alterar as formas e células de um mestre diretamente, em oposição a abrir e fechar o mestre como descrito no procedimento anterior, os efeitos listados na etapa 3 não ocorrerão.

Um programa que cria uma cópia de um masterObj para editar deve fechar e liberar a cópia. Normalmente, o Microsoft Visual Basic a libera automaticamente. Contudo, ao codificar em C ou C++, você deve liberar a cópia explicitamente, como faria para qualquer outro objeto.

Observação

A partir do Microsoft Office Visio 2003, somente estênciis criados pelo usuário são editáveis. Por padrão, estênceis do Visio não são editáveis.

Exemplo

Esta macro do Microsoft Visual Basic for Applications (VBA) mostra como abrir um objeto Master para edição. Ele abre uma cópia de um mestre a partir do estêncil do documento e altera a cor de preenchimento do primeiro plano do mestre e de todas as formas no desenho derivadas desse mestre.

Antes de executar essa macro, feche todos os documentos abertos do Visio. Em seguida, clique na guia Arquivo , clique em Novo e clique em Criar para abrir um novo documento com base em nenhum modelo. Clique na ferramenta Retângulo e desenhe um retângulo na página de desenho. Abra o estêncil do documento (na janela Formas, clique em Mais Formas, em Mostrar Estêncil de Documento) e, em seguida, arraste a forma de retângulo para o estêncil do documento para criar um mestre. Por fim, arraste várias cópias do mestre do retângulo para a página de desenho.

 
Public Sub OpenMaster_Example() 
 
    Dim vsoMaster As Visio.Master 
    Dim vsoMasterCopy As Visio.Master 
    Dim vsoShape As Visio.Shape 
    Dim vsoCell As Visio.Cell 
 
    Set vsoMaster = Visio.Documents.Masters(1) 
    Set vsoMasterCopy = vsoMaster.Open 
 
    Set vsoShape = vsoMasterCopy.Shapes.Item(1) 
 
    Set vsoCell = vsoShape.CellsU("FillForegnd") 
    vsoCell.Formula = 9 
 
    vsoMasterCopy.Close 
 
End Sub

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.