ListBox класс
ListBox класс
Представляет объект списка.
Тип ListBox предоставляет следующие члены:
Характеристики
| Свойство | Описание |
|---|---|
| macro_name | Получает и задает имя макроса. |
| is_equation | Указывает, содержит ли фигура только уравнение. |
| is_smart_art | Указывает, является ли фигура интеллектуальным искусством. |
| z_order_position | Возвращает позицию фигуры в z-порядке. |
| name | Получает и задает имя фигуры. |
| alternative_text | Возвращает или задает описательную (альтернативную) текстовую строку объекта Shape. |
| title | Задает заголовок (заголовок) текущего объекта формы. |
| line_format | Возвращает объект MsoLineFormat, содержащий свойства форматирования линии для указанной фигуры. |
| fill_format | Возвращает объект MsoFillFormat, содержащий свойства форматирования заливки для указанной фигуры. |
| format | Представляет параметр форматирования фигуры. |
| line | Получает стиль линии |
| fill | Возвращает объект Shape.fill_format, содержащий свойства форматирования заливки для указанной фигуры. |
| shadow_effect | Представляет объект ShadowEffect, определяющий эффект тени для элемента диаграммы или фигуры. |
| reflection | Представляет объект ReflectionEffect, задающий эффект отражения для элемента диаграммы или фигуры. |
| glow | Представляет объект GlowEffect, задающий эффект свечения для элемента диаграммы или фигуры. |
| soft_edges | Получает и задает радиус размытия, применяемый к краям, в точках. |
| three_d_format | Получает и задает 3D-формат фигуры. |
| text_frame | Возвращает объект TextFrame, содержащий свойства выравнивания и привязки для указанной фигуры. |
| format_picture | Получает и задает параметры формата изображения. |
| is_hidden | Указывает, виден ли объект. |
| is_lock_aspect_ratio | True означает, что не допускается изменение соотношения сторон. |
| rotation_angle | Получает и задает поворот фигуры. |
| hyperlink | Получает гиперссылку фигуры. |
| id | Получает идентификатор этой фигуры. |
| spid | Указывает необязательную строку, которую приложение может использовать для идентификации конкретной фигуры. |
| spt | Указывает необязательный номер, который приложение может использовать для связывания конкретной фигуры с определенным типом фигуры. |
| worksheet | Получает объект Shape.worksheet, содержащий эту фигуру. |
| is_group | Указывает, является ли фигура группой. |
| is_in_group | Указывает, сгруппирована ли фигура. |
| is_word_art | Указывает, является ли эта фигура искусством слова. |
| text_effect | Возвращает объект TextEffectFormat, содержащий свойства форматирования текстового эффекта для указанной фигуры.
Применяется к объектам Shape, представляющим WordArt. |
| is_locked | True, если объект заблокирован, False, если объект можно изменить, когда лист защищен. |
| is_printable | Истинно, если объект доступен для печати |
| mso_drawing_type | Получает тип рисования mso. |
| auto_shape_type | Получает и задает автоматический тип фигуры. |
| anchor_type | Получает и задает заполнитель привязки формы. |
| placement | Представляет способ прикрепления объекта рисования к ячейкам под ним.
Свойство управляет размещением объекта на рабочем листе. |
| upper_left_row | Представляет индекс строки в верхнем левом углу. |
| upper_delta_y | Получает или задает вертикальное смещение фигуры от ее верхнего левого углового ряда. |
| upper_left_column | Представляет индекс столбца в левом верхнем углу. |
| upper_delta_x | Получает или задает смещение фигуры по горизонтали от ее верхнего левого углового столбца. |
| lower_right_row | Представляет индекс строки в правом нижнем углу. |
| lower_delta_y | Получает или задает вертикальное смещение фигуры от ее нижнего правого углового ряда. |
| lower_right_column | Представляет индекс столбца в правом нижнем углу. |
| lower_delta_x | Получает или задает смещение фигуры по горизонтали от нижнего правого углового столбца. |
| right | Представляет ширину горизонтального смещения фигуры от нижнего правого углового столбца в пикселях. |
| bottom | Представляет ширину смещения фигуры по вертикали от нижнего нижнего углового ряда в пикселях. |
| width | Представляет ширину фигуры в пикселях. |
| width_inch | Представляет ширину фигуры в дюймах. |
| width_pt | Представляет ширину фигуры в пунктах. |
| width_cm | Представляет ширину фигуры в сантиметрах. |
| height | Представляет высоту фигуры в пикселях. |
| height_inch | Представляет высоту фигуры в дюймах. |
| height_pt | Представляет высоту фигуры в точках. |
| height_cm | Представляет высоту фигуры в сантиметрах. |
| left | Представляет горизонтальное смещение фигуры от ее левого столбца в единицах пикселей. |
| left_inch | Представляет горизонтальное смещение фигуры от ее левого столбца в дюймах. |
| left_cm | Представляет горизонтальное смещение фигуры от ее левого столбца в сантиметрах. |
| top | Представляет вертикальное смещение фигуры от ее верхней строки в единицах пикселей. |
| top_inch | Представляет вертикальное смещение фигуры от верхней строки в дюймах. |
| top_cm | Представляет вертикальное смещение фигуры от верхнего ряда в сантиметрах. |
| top_to_corner | Получает и задает вертикальное смещение фигуры от верхней границы рабочего листа в пикселях. |
| left_to_corner | Получает и задает горизонтальное смещение фигуры от левой границы рабочего листа. |
| x | Получает и задает горизонтальное смещение фигуры от левой границы рабочего листа в единицах пикселей. |
| y | Получает и задает вертикальное смещение фигуры от верхней границы рабочего листа в единицах пикселей. |
| width_scale | Получает и задает масштаб ширины в процентах от исходной ширины изображения.
Если фигура не является изображением, свойство WidthScale возвращает только 100; |
| height_scale | Получает и задает масштаб высоты в процентах от исходной высоты изображения.
Если фигура не является изображением, свойство HeightScale возвращает только 100; |
| top_in_shape | Представляет вертикальное смещение фигуры от верхней границы родительской фигуры,
в единице 1/4000 высоты родительской формы. |
| left_in_shape | Представляет горизонтальное смещение фигуры от левой границы родительской фигуры,
в единицах 1/4000 ширины родительской формы. |
| width_in_shape | Представляет ширину фигуры в 1/4000 от родительской фигуры. |
| height_in_shape | Представляет вертикальное смещение фигуры от верхней границы родительской фигуры в единицах 1/4000 высоты родительской фигуры. |
| group | Получает фигуру группы, содержащую эту фигуру. |
| type | Получает автоматический тип фигуры. |
| has_line | Получает и задает видимую границу линии фигуры. |
| is_filled | Указывает, виден ли формат заполнения. |
| is_flipped_horizontally | Получает и задает, отражается ли фигура по горизонтали. |
| is_flipped_vertically | Получает и задает, отражается ли фигура по вертикали. |
| actual_lower_right_row | Получите фактическую нижнюю строку. |
| connection_points | Получите точки подключения |
| relative_to_original_picture_size | Указывает, соответствует ли форма исходному размеру изображения. |
| linked_cell | Получает или задает диапазон рабочего листа, связанный со значением элемента управления. |
| input_range | Получает или задает диапазон рабочего листа, используемый для заполнения указанного поля со списком. |
| text_shape_type | Получает и задает заданный тип фигуры текста. |
| text_body | Получает и задает настройку текста фигуры. |
| font | Представляет шрифт фигуры. |
| text_options | Представляет параметры текста фигуры. |
| text | Представляет строку в этом объекте TextBox. |
| is_rich_text | Является ли текст форматированным текстом. |
| html_text | Получает и задает строку html, содержащую данные и некоторые форматы в этом текстовом поле. |
| text_vertical_overflow | Получает и задает тип вертикального переполнения текста для фигуры, содержащей текст. |
| text_horizontal_overflow | Получает и задает тип горизонтального переполнения текста для фигуры, содержащей текст. |
| is_text_wrapped | Получает и задает тип переноса текста для фигуры, содержащей текст. |
| text_orientation_type | Получает и задает тип ориентации текста фигуры. |
| text_horizontal_alignment | Получает и задает тип горизонтального выравнивания текста фигуры. |
| text_vertical_alignment | Получает и задает тип вертикального выравнивания текста фигуры. |
| text_direction | Получает/устанавливает направление потока текста для этого объекта. |
| control_data | Получает данные управления. |
| active_x_control | Получает элемент управления ActiveX. |
| paths | Получает пути пользовательской геометрической формы. |
| geometry | Получает геометрию |
| create_id | Получает и задает идентификатор создания для этой фигуры. |
| item_count | Получает количество элементов в списке. |
| selected_index | Получает или задает порядковый номер текущего выбранного элемента в списке или поле со списком.
С нуля. |
| selected_cells | Получает выбранные ячейки.
Возвращает null, если диапазон ввода не установлен или элемент не выбран. |
| shadow | Указывает, имеет ли поле со списком трехмерное затенение. |
| selection_type | Получает или задает режим выбора указанного списка. |
| page_change | Определяет величину, на которую изменяется значение элемента управления.
когда пользователь щелкает область полосы прокрутки вверх или вниз. |
Методы
| Метод | Описание |
|---|---|
| to_image(stream, image_type) | Создает изображение формы и сохраняет его в потоке в указанном формате. |
| to_image(image_file, options) | Сохраняет форму в файл. |
| to_image(stream, options) | Сохраняет форму в поток. |
| format_characters(start_index, length, font, flag) | Форматирует некоторые символы с настройкой шрифта. |
| format_characters(start_index, length, font) | Форматирует некоторые символы с настройкой шрифта. |
| get_result_of_smart_art() | Преобразование смарт-арта в сгруппированные фигуры. |
| to_front_or_back(orders) | Выводит фигуру на передний план или отправляет фигуру на задний план. |
| get_locked_property(type) | Получает значение заблокированного свойства. |
| set_locked_property(type, value) | Установите заблокированное свойство. |
| add_hyperlink(address) | Добавляет гиперссылку к фигуре. |
| remove_hyperlink() | Удалите гиперссылку формы. |
| move_to_range(upper_left_row, upper_left_column, lower_right_row, lower_right_column) | Перемещает фигуру в указанный диапазон. |
| align_top_right_corner(top_row, right_column) | Перемещает изображение в правый верхний угол. |
| get_connection_points() | Получите точки подключения |
| get_linked_cell(is_r1c1, is_local) | Получает диапазон, связанный со значением элемента управления. |
| set_linked_cell(formula, is_r1c1, is_local) | Задает диапазон, связанный со значением элемента управления. |
| get_input_range(is_r1c1, is_local) | Получает диапазон, используемый для заполнения элемента управления. |
| set_input_range(formula, is_r1c1, is_local) | Устанавливает диапазон, используемый для заполнения элемента управления. |
| update_selected_value() | Обновите выбранное значение значением связанной ячейки. |
| calculate_text_size() | Пересчитать текстовую область |
| characters(start_index, length) | Возвращает объект Characters, представляющий диапазон символов в тексте. |
| get_characters() | Возвращает все объекты символов
который представляет собой диапазон символов в тексте. |
| remove_active_x_control() | Удалить элемент управления ActiveX. |
| is_same_setting(obj) | Возвращает, совпадает ли форма. |
| selected_item(item_index, is_selected) | Устанавливает, выбран ли элемент |
| is_selected(item_index) | Указывает, выбран ли элемент. |
Пример
from aspose.cells import Workbook
from aspose.cells.drawing import PlacementType, SelectionType
# Create a new Workbook.
workbook = Workbook()
# Get the first worksheet.
sheet = workbook.worksheets[0]
# Get the worksheet cells collection.
cells = sheet.cells
# Input a value.
cells.get("B3").put_value("Choose Dept:")
# Set it bold.
style = cells.get("B3").get_style()
style.font.is_bold = True
cells.get("B3").set_style(style)
# Input some values that denote the input range
# for the list box.
cells.get("A2").put_value("Sales")
cells.get("A3").put_value("Finance")
cells.get("A4").put_value("MIS")
cells.get("A5").put_value("R&D")
cells.get("A6").put_value("Marketing")
cells.get("A7").put_value("HRA")
# Add a new list box.
listBox = sheet.shapes.add_list_box(2, 0, 3, 0, 122, 100)
# Set the placement type.
listBox.placement = PlacementType.FREE_FLOATING
# Set the linked cell.
listBox.linked_cell = "A1"
# Set the input range.
listBox.input_range = "A2:A7"
# Set the selection style.
listBox.selection_type = SelectionType.SINGLE
# Set the list box with 3-D shading.
listBox.shadow = True
# Saves the file.
workbook.save(r"tstlistbox.xls")
Смотрите также
- модуль aspose.cells.drawing
- класс GlowEffect
- класс ListBox
- класс ReflectionEffect
- класс ShadowEffect
- класс Shape