Método Shape.InsertObject (Visio)
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 Shape.
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.