Partilhar via


Propriedade Shape.DistanceFrom (Visio)

Retorna a distância de uma forma a outra, medida entre os pontos mais próximos nas duas formas. Ambas devem estar na mesma página ou no mesmo mestre. Somente leitura.

Sintaxe

expression. DistanceFrom( _OtherShape_ , _Flags_ )

expressão Uma variável que representa um objeto Shape.

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
OtherShape Obrigatório [IVSHAPE] O outro objeto Shape envolvido na comparação.
Flags Obrigatório Integer Sinalizadores que influenciam o tipo de entradas retornadas nos resultados.

Valor de retorno

Duplo

Comentários

A propriedade DistanceFrom retorna:

  • Zero e cria uma exceção quando as formas comparadas estão em mestres ou páginas diferentes.

  • Zero quando as formas comparadas estão sobrepostas.

  • Zero quando uma forma contém a outra ou uma forma é contida pela outra.

O argumento Flags pode ser qualquer combinação dos valores das constantes definidas na tabela a seguir. Essas constantes também são definidas em VisSpatialRelationFlags, na biblioteca de tipos do Microsoft Visio.

Constant Valor Descrição
visSpatialIncludeDataGraphics &H40 Inclui formas de texto explicativo do gráfico de dados e suas subformas. Por padrão, as formas de texto explicativo do gráfico de dados e suas subformas não são incluídas. Se a própria forma pai for um texto explicativo do gráfico de dados, as pesquisas serão feitas entre a geometria da forma pai e formas não relacionadas a texto explicativo, a menos que esse sinalizador esteja definido.
visSpatialIncludeHidden &H10 Considerar seções Geometry ocultas. Por padrão, seções de Geometria ocultas não influenciam o resultado.
visSpatialIgnoreVisible &H20 Desconsiderar seções Geometry visíveis. Por padrão, as seções Geometry visíveis influenciam o resultado.

Use a célula NoShow para determinar se uma seção Geometry está oculta ou visível. Seções Geometry ocultas possuem um valor de TRUE e seções Geometry visíveis possuem um valor de FALSE na célula NoShow.

Se a forma-pai ou a OutraForma não tiverem geometria, ou se Sinalizadores excluir a consideração de qualquer geometria em ambas as formas, a propriedade DistanceFrom retornará um número grande (1E+30) que deverá ser interpretado como infinito.

A propriedade DistanceFrom não considera a largura da linha, sombras, extremidades de linhas, pontos de controle ou pontos de conexão das formas durante a comparação de duas formas.

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.