Share via

Método Master.InsertObject (Visio)

  • Artigo

Adiciona um novo objeto incorporado ou controle ActiveX em uma página, mestre ou grupo.

Sintaxe

expression. InsertObject( _ClassOrProgID_ , _Flags_ )

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

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
ClassOrProgID Obrigatório String Identifica o tipo de objeto ou controle a ser criado.
Flags Obrigatório Integer Sinalizadores que influenciam a operação.

Valor de retorno

Forma

Comentários

ClassOrProgID é uma sequência de caracteres que identifica o tipo de objeto ou controle a ser criado. Pode ser a identificação de classe do objeto ou controle (GUID) na forma de sequência de caracteres ou a identificação do programa do objeto ou controle do manipulador da classe.

  • Se ClassOrProgID for uma sequência de caracteres representando uma identificação de classe, terá a aparência "{D3E34B21-9D75-101A-8C3D-00AA001A1652}".

  • Se ClassOrProgID for uma sequência de caracteres representando uma identificação do programa, terá a aparência "paint.picture" ou "forms.combobox.1".

Consulte a documentação específica do fornecedor ou procure no Registro para determinar que identificações de classe e identificações do programa estão associadas com objetos e controles fornecidos por outros aplicativos.

O argumento Flags é uma bitmask que pode incluir um dos valores a seguir.

Constant Valor Descrição
visInsertIcon &H10 Exibe a nova forma como um ícone.
visInsertDontShow &H1000 Não execute o verbo mostrar do novo objeto.

Se visInsertIcon e visInsertDontShow forem especificados, o método InsertObject falhará. Se desejar inserir um objeto exibido como um ícone, permita que o aplicativo execute o verbo mostrar do objeto.

O argumento Flags também pode incluir um dos valores a seguir.

Constant Valor
visInsertAsControl &H2000
visInsertAsEmbed &H4000

Os valores em visInsertAsControl e visInsertAsEmbed terão efeito somente se a classe identificada por ClassOrProgID for identificada no Registro como um controle que pode ser inserido. Se visInsertAsControl e visInsertAsEmbed não forem especificados e o objeto puder ser um controle ou um objeto incorporado, o aplicativo o inserirá como um controle.

Em casos raros, o Visio 5.0 ou versões posteriores podem inserir um controle, enquanto versões anteriores do Visio teriam respondido à mesma chamada inserindo um objeto incorporado. Se for inserido um controle, este método colocará o documento no modo de design, fazendo qualquer código executado no documento parar até que o documento seja retornado ao modo de execução.

Cuidado

Tenha cuidado ao adicionar controles ActiveX ao aplicativo. Os controles ActiveX podem ser criados de uma forma que sua utilização pode gerar um risco de segurança. We recommend that you use controls from trusted sources only. Assine todos os controles que você criar.

Aviso

Modificar o registro do Windows de qualquer maneira, seja por meio do Editor do Registro ou programaticamente, sempre carrega algum grau de risco. Uma modificação incorreta pode causar problemas sérios que talvez exijam a reinstalação do sistema operacional. É recomendável que você sempre faça um backup do registro do computador antes de modificá-lo.

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.