Propriedade Shape.UniqueID (Visio)

  • Artigo

Obtém, exclui ou faz o GUID que identifica exclusivamente a forma no escopo do aplicativo. Somente leitura.

Sintaxe

expression. UniqueID( _fUniqueID_ )

Expressão Uma expressão que retorna um objeto Shape .

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
fUniqueID Obrigatório Integer Obtém, exclui ou cria a identificação exclusiva de um objeto Shape. Consulte comentários para os valores possíveis.

Valor de retorno

Cadeia de caracteres

Comentários

O Microsoft Visio identifica formas por meio de duas IDs diferentes: IDs de forma e IDs exclusivas. As IDs de Forma são numéricas e identificam as formas de maneira exclusiva no escopo de uma página de desenho individual. Entretanto, elas não são exclusivas em um escopo mais amplo.

As IDs exclusivas são GUIDs. Eles são exclusivos no escopo do aplicativo.

Para converter identificações de forma em identificações exclusivas e vice-versa, você pode usar dois métodos do objeto Page, ShapeIDsToUniqueIDs e UniqueIDsToShapeIDs.

Por padrão, uma forma não possui identificação exclusiva. Ela somente adquire uma identificação exclusiva quando você define sua propriedade UniqueID.

Se um objeto Shape tiver uma identificação exclusiva, nenhuma outra forma em qualquer outro documento terá a mesma identificação.

O parâmetro fUniqueID controla o comportamento da propriedade UniqueID. Ele deve ter um dos seguintes valores declarados na biblioteca de tipos do Visio em VisUniqueIDArgs.

Constant Valor Descrição
visGetGUID 0 Somente retornará a cadeia de caracteres de identificação exclusiva se a forma já tiver uma identificação exclusiva. Caso contrário, retornará uma cadeia de caracteres de comprimento zero ("").
visGetOrMakeGUID 1 Retorna a cadeia de caracteres de identificação exclusiva da forma. Se a forma ainda não tiver uma identificação exclusiva, ela a atribuirá a ela e retornará a nova identificação.
visDeleteGUID 2 Exclui a identificação exclusiva de uma forma e retorna uma cadeia de caracteres de comprimento zero ("").
visGetOrMakeGUIDWithUndo 3 Retorna a cadeia de caracteres de identificação exclusiva da forma. Se a forma ainda não tiver uma ID exclusiva, atribua uma à forma e retorna a nova ID. Definitivo.
visDeleteGUIDWithUndo 4 Limpa a ID exclusiva de uma forma e retorna uma cadeia de caracteres de comprimento zero (""). Definitivo.

Para obter uma forma se você conhece sua ID exclusiva, use Shapes.Item ( UniqueIDString).

Por exemplo, você pode usar o seguinte código:

Dim vsoShape As Visio.Shape 
Set vsoShape = Visio.ActivePage.Shapes.Item("{2287DC42-B167-11CE-88E9-0020AFDDD917}")

Você também pode usar o seguinte código, que adiciona a letra "U" antes da cadeia de caracteres para identificá-la como uma identificação exclusiva:

Dim vsoShape As Visio.Shape 
Set vsoShape = Visio.ActivePage.Shapes.Item("U{2287DC42-B167-11CE-88E9-0020AFDDD917}")

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.