Método Shape.Cut (Visio)
Exclui um objeto ou seleção e o(a) coloca na Área de Transferência.
Sintaxe
expressão. Corte (Sinalizadores)
expressão Uma variável que representa um objeto Shape.
Parâmetros
| Nome | Obrigatório/Opcional | Tipo de dados | Descrição |
|---|---|---|---|
| Flags | Opcional | Variant | Determina como as formas são traduzidas durante a operação de recortar. |
Valor de retorno
Nada
Comentários
Os possíveis valores de Flags são declarados pela biblioteca de tipos do Visio em VisCutCopyPasteCodes e são descritos na tabela a seguir.
| Flag | Valor | Descrição |
|---|---|---|
| visCopyPasteNormal | &H0 | Segue o comportamento padrão de cópia. |
| visCopyPasteNoTranslate | &H1 | Copia formas para as localizações de coordenadas originais. |
| visCopyPasteCenter | &H2 | Copia formas para o centro da página. |
| visCopyPasteNoHealConnectors | &H4 | Não limpa conectores anexados a formas cortadas. |
| visCopyPasteNoContainerMembers | &H8 | Não corta e cola membros não selecionados de contêineres ou listas. |
| visCopyPasteNoAssociatedCallouts | &H16 | Não corta e cola textos explicativos não selecionados associados a formas. |
| visCopyPasteDontAddToContainers | &H32 | Não adiciona formas coladas a contêineres subjacentes. |
| visCopyPasteNoCascade | &H64 | Não desloca formas na cópia. |
A definição de Flags como visCopyPasteNormal equivale ao comportamento na interface do usuário. Você deve usar visCopyPasteNormal e os outros sinalizadores de forma consistente. Por exemplo, se você utilizar o valor visCopyPasteNoTranslate para copiar, deve usá-lo também para colar, pois essa é a única maneira de garantir que as formas sejam coladas nas suas localizações de coordenadas originais.
Exemplo
O exemplo a seguir mostra como usar o método Cut. Ele desenha um retângulo e o recorta da página (e o coloca na Área de Transferência).
Public Sub Cut_Example()
Dim vsoShape As Visio.Shape
Set vsoShape = ActivePage.DrawRectangle(1, 5, 5, 1)
'Cut shape from the page
vsoShape.Cut
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.