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.
Obtém, elimina ou faz o GUID que identifica exclusivamente a forma no âmbito da aplicação. Somente leitura.
Sintaxe
expression.
UniqueID( _fUniqueID_ )
expressão Uma expressão que devolve um objeto Forma .
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.
Os IDs exclusivos são GUIDs. São exclusivos no âmbito da aplicação.
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 um ID exclusivo, atribui um à forma e devolve o novo ID. Anulável. |
| visDeleteGUIDWithUndo | 4 | Limpa o ID exclusivo de uma forma e devolve uma cadeia de comprimento zero (""). Anulável. |
Para obter uma forma se souber o ID exclusivo, utilize 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.