get_param_value_in_array_mode метод

get_param_value_in_array_mode

Получает значения параметра по заданному индексу. Если параметр представляет собой какое-то выражение, которое необходимо вычислить, тогда он будет рассчитан в режиме массива.

Возврат

Массив, содержащий все элементы, представленные указанным параметром.

def get_param_value_in_array_mode(self, index, max_row_count, max_column_count):
    ...
ПараметрТипОписание
indexintИндекс параметра (на основе 0)
max_row_countintПредел количества строк для возвращаемого массива.
Если оно не положительное или превышает фактическое количество строк, будет использоваться фактическое количество строк.
max_column_countintПредел количества столбцов для возвращаемого массива.
Если оно не положительное или превышает фактическое количество строк, будет использоваться фактическое количество столбцов.

Примечания

Для выражения, которое необходимо вычислить, на примере A:A+B:B: В режиме значений оно будет рассчитано до одного значения в соответствии с текущей базой ячеек. Но в режиме массива все значения A1+B1,A2+B2,A3+B3,… будут рассчитаны и использованы для построения возвращаемого массива. И в такой ситуации лучше указать ограничение на количество строк/столбцов. (например, по Cells.max_data_row и Cells.max_data_column), в противном случае возвращаемый большой массив может увеличить затраты памяти из-за большого количества бесполезных данных.

Смотрите также