Método Pages.GetNames (Visio)
Devuelve los nombres de todos los elementos de una colección.
Sintaxis
expresión. GetNames (localeSpecificNameArray())
Expresión Variable que representa un objeto Pages .
Parameters
| Nombre | Obligatorio/opcional | Tipo de datos | Descripción |
|---|---|---|---|
| localeSpecificNameArray() | Obligatorio | String | Parámetro de salida. Matriz que recibe los nombres de los miembros del objeto indicado. |
Valor devuelto
Nothing
Comentarios
Si el método GetNames se ejecuta correctamente, localeSpecificNameArray() devuelve una matriz unidimensional de n cadenas indizadas desde 0 hasta n - 1, donde n es igual al valor de la propiedad Count del objeto. localeSpecificNameArray() es un parámetro de salida asignado por el método GetNames, que pasa la propiedad de nuevo al llamador. El llamador deberá realizar finalmente el procedimiento SafeArrayDestroy en la matriz devuelta. Observe que el procedimiento SafeArrayDestroy tiene como efecto secundario la liberación de las cadenas a las que hacen referencia las entradas de la matriz. (Microsoft Visual Basic y Microsoft Visual Basic para Aplicaciones (VBA) se encargan de hacerlo).
Nota:
A partir de Microsoft Visio 2000, puede usar nombres locales y universales para hacer referencia a formas, patrones, documentos, páginas, filas, complementos, celdas, hipervínculos, estilos, fuentes, accesos directos maestros, objetos de interfaz de usuario y capas de Visio. Cuando un usuario asigna un nombre a una forma, por ejemplo, el usuario especifica un nombre local. A partir de Microsoft Office Visio 2003, la hoja de cálculo ShapeSheet solo muestra nombres universales en fórmulas y valores de celda. (En versiones anteriores, los nombres universales no eran visibles en la interfaz de usuario).
Como programador, puede usar nombres universales en un programa cuando no desee cambiar un nombre cada vez que localice una solución. Utilice el método GetNames para obtener el nombre local de más de un objeto. Utilice el método GetNamesU para obtener el nombre universal de más de un objeto.
Ejemplo:
La macro siguiente muestra cómo utilizar el método GetNames para obtener los nombres de todos los objetos Master de la colección Masters del documento activo e imprimirlos en la ventana Inmediato.
Public Sub GetNames_Example()
Dim strMasterNames() As String
Dim intLowerBound As Integer
Dim intUpperBound As Integer
ActiveDocument.Masters.GetNames strMasterNames
intLowerBound = LBound(strMasterNames)
intUpperBound = UBound(strMasterNames)
Debug.Print ActiveDocument; " Lower bound:"; intLowerBound; "Upper bound:"; intUpperBound
While intLowerBound <= intUpperBound
Debug.Print strMasterNames (intLowerBound)
intLowerBound = intLowerBound + 1
Wend
End Sub
Soporte técnico y comentarios
¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación? Vea Soporte técnico y comentarios sobre VBA para Office para obtener ayuda sobre las formas en las que puede recibir soporte técnico y enviar comentarios.