COMSafeArray
Resize
Disponible desde la versión 8.0.
Sintaxis:
Resize(<Count>, <LowerBoundary>)
Parámetros:
<Count> (obligatorio)
Tipo: Número.
El nuevo número de elementos en la primera (nula) dimensión.
<LowerBoundary> (opcional)
Tipo: Número.
El nuevo valor mínimo del índice para la primera (nula) dimensión.
Valor predeterminado: 0.
Descripción:
Cambia el valor mínimo del índice en la primera dimensión de un COMSafeArray y el número de elementos en la primera dimensión. Si el nuevo número de elementos es mayor que el número anterior, los elementos antiguos del COMSafeArray se conservan y los valores de los elementos añadidos son indefinidos. Al reducir el número de elementos, se pierden los valores de los elementos adicionales con los valores de índice más altos.
Por ejemplo, si un COMSafeArray consta de los elementos: [0, 0] = 1; [0, 1] = 2; [1, 0] = 3; [1, 1] = 4;
después de Resize(3,-1) contendrá: [-1, 0] = 1; [-1, 1] = 2; [0, 0] = 3; [0, 1] = 4; [1, 0] = ?; [1, 1] = ?;
pero después de Resize(1,2) contendrá: [2, 0] = 1; [2, 1] = 2.
Disponibilidad:
Servidor, cliente grueso, conexión externa.
Nota:
Utiliza la función SafeArrayRedim de la API de Windows, diseñada para cambiar el tamaño del array. En algunas versiones de Windows, el cambio del límite superior del índice puede ser ignorado si el número de elementos en el array no cambia.
Ejemplo:
| // Para el índice principal del array, se establece el número de elementos en 10 // y se establece el valor mínimo del índice en -1. If Array.IsResizable() Then Array.Resize(10, –1); EndIf; |
Disponible desde:
Disponible desde la versión 8.0.
