Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Desenha uma nova forma que representa a região contendo um ponto dado.
Sintaxe
expressão.
DrawRegion( _Tolerance_ , _Flags_ , _x_ , _y_ , _ResultsMaster_ )
expressão Uma variável que representa um objeto Selection .
Parâmetros
| Nome | Obrigatório/Opcional | Tipo de dados | Descrição |
|---|---|---|---|
| Tolerance | Obrigatório | Double | Tolerância de erros ao determinar a coincidência de pontos. Uma distância expressa em unidades internas no espaço coordenado da forma que contém o objeto Selection; o espaço máximo entre caminhos que é tolerado ao construir os limites de uma região. |
| Flags | Obrigatório | Integer | Uma constante ou inteiro que especifica como desenhar a região. |
| x | Opcional | Variant | Coordenada x em unidades internas no espaço coordenado do objeto Selection. |
| y | Opcional | Variant | Coordenada y em unidades internas no espaço coordenado do objeto Selection. |
| ResultadosMestre | Opcional | Variant | O objeto Master do qual o novo objeto Shape deve ser uma instância. |
Valor de retorno
Forma
Comentários
O método DrawRegion cria um novo objeto Shape de pedaços de caminhos no objeto Selection.
Se x e y forem especificados, a forma resultante será a menor região que contém o ponto ( x,y).
Na ausência de x ou y, ou se o ponto ( x,y) não estiver contido em nenhuma região delimitada pelos caminhos das formas selecionadas, o resultado será a união de todas as formas que teriam sido criadas usando a operação Fragment .
Se nenhuma região fechada for definida pelas formas selecionadas, o método DrawRegion retornará Nothing e não levantará exceções.
O argumento Flags pode ser uma ou uma combinação das constantes a seguir declaradas pela biblioteca de tipos do Visio em VisDrawRegionFlags.
| **Nome ** | Valor | Descrição |
|---|---|---|
| visDrawRegionDeleteInput | &H4 | Excluir itens na seleção. |
| visDrawRegionIgnoreVisible | &H20 | Excluir geometria visível. |
| visDrawRegionIncludeDataGraphics | &H40 | Incluir formas de texto explicativo do gráfico de dados e suas subformas. |
| visDrawRegionIncludeHidden | &H10 | Incluir geometria oculta. |
Se o método DrawRegion passar ResultsMaster de tipo VT_EMPTY ou VT_ERROR (que é como o VBA passa um argumento opcional não especificado), a nova forma não é uma instância de um mestre e os estilos de preenchimento, linha e texto da nova região são definidos nos estilos padrão do documento.
Se o método DrawRegion passar uma referência para um objeto Master em ResultsMaster (tipo VT_UNKNOWN ou VT_DISPATCH), o método DrawRegion exemplifica esse objeto Master e adicionar geometria computada dado o objeto Selection.
O novo objeto Shape não possui texto diferente do texto já em ResultsMaster.
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.