Compartilhar via


Selection.DrawRegion method (Visio) (Método Selection.DrawRegion [Visio])

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 De seleção .

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.
ResultsMaster 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 forem especificados x e y , a forma resultante é a região mais pequena 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 entre os caminhos das formas selecionadas, o resultado é a união de todas as formas que teriam sido criadas utilizando a operação Fragmentar .

  • Se nenhuma região fechada for definida pelas formas selecionadas, o método DrawRegion retornará Nothing e não levantará exceções.

O argumento Sinalizadores pode ser uma ou uma combinação das seguintes constantes 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.