##  GroupBox класс
Инкапсулирует объект, представляющий групповую ячейку в электронной таблице.



**Наследование:** [`GroupBox`](/cells/python-net/aspose.cells.drawing/groupbox) → 
[`Shape`](/cells/python-net/ru/aspose.cells.drawing/shape)



Тип GroupBox предоставляет следующие элементы:

###  Характеристики
| Свойство| Описание|
| :- | :- |
| [macro_name](/cells/python-net/ru/aspose.cells.drawing/groupbox/macro_name) | Получает и задает имя макроса.|
| [is_equation](/cells/python-net/ru/aspose.cells.drawing/groupbox/is_equation) | Указывает, содержит ли форма только уравнение.|
| [is_smart_art](/cells/python-net/ru/aspose.cells.drawing/groupbox/is_smart_art) | Указывает, является ли фигура интеллектуальным искусством.|
| [z_order_position](/cells/python-net/ru/aspose.cells.drawing/groupbox/z_order_position) | Возвращает положение фигуры в z-порядке.|
| [name](/cells/python-net/ru/aspose.cells.drawing/groupbox/name) | Получает и задает имя фигуры.|
| [alternative_text](/cells/python-net/ru/aspose.cells.drawing/groupbox/alternative_text) | Возвращает или задает описательную (альтернативную) текстовую строку объекта [`Shape`](/cells/python-net/ru/aspose.cells.drawing/shape).|
| [title](/cells/python-net/ru/aspose.cells.drawing/groupbox/title) | Задает заголовок (подпись) текущего объекта формы.|
| [line_format](/cells/python-net/ru/aspose.cells.drawing/groupbox/line_format) | Возвращает объект MsoLineFormat, содержащий свойства форматирования линии для указанной фигуры.|
| [fill_format](/cells/python-net/ru/aspose.cells.drawing/groupbox/fill_format) | Возвращает объект MsoFillFormat, содержащий свойства форматирования заливки для указанной фигуры.|
| [line](/cells/python-net/ru/aspose.cells.drawing/groupbox/line) | Получает стиль линии|
| [fill](/cells/python-net/ru/aspose.cells.drawing/groupbox/fill) | Возвращает объект [`Shape.fill_format`](/cells/python-net/ru/aspose.cells.drawing/shape#fill_format), содержащий свойства форматирования заливки для указанной фигуры.|
| [shadow_effect](/cells/python-net/ru/aspose.cells.drawing/groupbox/shadow_effect) | Представляет объект [`ShadowEffect`](/cells/python-net/ru/aspose.cells.drawing/shadoweffect), который задает эффект тени для элемента или фигуры диаграммы.|
| [reflection](/cells/python-net/ru/aspose.cells.drawing/groupbox/reflection) |Представляет объект [`ReflectionEffect`](/cells/python-net/ru/aspose.cells.drawing/reflectioneffect), который задает эффект отражения для элемента или фигуры диаграммы.|
| [glow](/cells/python-net/ru/aspose.cells.drawing/groupbox/glow) | Представляет объект [`GlowEffect`](/cells/python-net/ru/aspose.cells.drawing/gloweffect), который задает эффект свечения для элемента или фигуры диаграммы.|
| [soft_edges](/cells/python-net/ru/aspose.cells.drawing/groupbox/soft_edges) | Получает и задает радиус размытия, применяемый к краям, в точках.|
| [three_d_format](/cells/python-net/ru/aspose.cells.drawing/groupbox/three_d_format) | Получает и задает 3D-формат фигуры.|
| [format_picture](/cells/python-net/ru/aspose.cells.drawing/groupbox/format_picture) | Получает и задает параметры формата изображения.|
| [is_hidden](/cells/python-net/ru/aspose.cells.drawing/groupbox/is_hidden) | Указывает, виден ли объект.|
| [is_lock_aspect_ratio](/cells/python-net/ru/aspose.cells.drawing/groupbox/is_lock_aspect_ratio) | True означает, что соотношение сторон фигуры зафиксировано.|
| [is_aspect_ratio_locked](/cells/python-net/ru/aspose.cells.drawing/groupbox/is_aspect_ratio_locked) | True означает, что соотношение сторон фигуры зафиксировано.|
| [rotation_angle](/cells/python-net/ru/aspose.cells.drawing/groupbox/rotation_angle) | Получает и задает поворот фигуры.|
| [hyperlink](/cells/python-net/ru/aspose.cells.drawing/groupbox/hyperlink) | Получает гиперссылку формы.|
| [id](/cells/python-net/ru/aspose.cells.drawing/groupbox/id) | Получает идентификатор этой формы.|
| [spid](/cells/python-net/ru/aspose.cells.drawing/groupbox/spid) | Указывает необязательный строковый идентификатор, который приложение может использовать для идентификации конкретной фигуры.|
| [spt](/cells/python-net/ru/aspose.cells.drawing/groupbox/spt) | Указывает необязательное число, которое приложение может использовать для связи конкретной фигуры с определенным типом фигуры.|
| [worksheet](/cells/python-net/ru/aspose.cells.drawing/groupbox/worksheet) | Получает объект [`Shape.worksheet`](/cells/python-net/ru/aspose.cells.drawing/shape#worksheet), содержащий эту форму.|
| [is_group](/cells/python-net/ru/aspose.cells.drawing/groupbox/is_group) | Указывает, является ли данная фигура групповой фигурой.|
| [is_in_group](/cells/python-net/ru/aspose.cells.drawing/groupbox/is_in_group) | Указывает, сгруппирована ли фигура.|
| [is_word_art](/cells/python-net/ru/aspose.cells.drawing/groupbox/is_word_art) |Указывает, является ли данная форма произведением искусства.|
| [text_effect](/cells/python-net/ru/aspose.cells.drawing/groupbox/text_effect) | Возвращает объект TextEffectFormat, содержащий свойства форматирования текста для указанной фигуры.<br/> Применяется к объектам Shape, представляющим WordArt.|
| [is_locked](/cells/python-net/ru/aspose.cells.drawing/groupbox/is_locked) | True означает, что объект не может быть изменен, если лист защищен.<br/> Обратите внимание, что это значение имеет смысл только в том случае, если рабочий лист или объекты на нем защищены.|
| [is_printable](/cells/python-net/ru/aspose.cells.drawing/groupbox/is_printable) | Указывает, можно ли распечатать объект.<br/> Если False, эта форма не будет напечатана при печати.|
| [mso_drawing_type](/cells/python-net/ru/aspose.cells.drawing/groupbox/mso_drawing_type) | Получает тип чертежа.|
| [auto_shape_type](/cells/python-net/ru/aspose.cells.drawing/groupbox/auto_shape_type) | Получает и задает тип автоматической фигуры.|
| [anchor_type](/cells/python-net/ru/aspose.cells.drawing/groupbox/anchor_type) | Получает и задает тип заполнителя якоря формы.|
| [placement](/cells/python-net/ru/aspose.cells.drawing/groupbox/placement) | Представляет собой способ присоединения объекта рисунка к ячейкам под ним.<br/> Свойство управляет размещением объекта на рабочем листе.|
| [upper_left_row](/cells/python-net/ru/aspose.cells.drawing/groupbox/upper_left_row) | Представляет индекс верхней строки.|
| [upper_delta_y](/cells/python-net/ru/aspose.cells.drawing/groupbox/upper_delta_y) | Возвращает или задает вертикальное смещение фигуры от ее верхней левой угловой строки.|
| [upper_left_column](/cells/python-net/ru/aspose.cells.drawing/groupbox/upper_left_column) | Представляет индекс столбца в левом верхнем углу.|
| [upper_delta_x](/cells/python-net/ru/aspose.cells.drawing/groupbox/upper_delta_x) |Возвращает или задает горизонтальное смещение фигуры от ее верхнего левого углового столбца.|
| [lower_right_row](/cells/python-net/ru/aspose.cells.drawing/groupbox/lower_right_row) | Представляет индекс строки в нижнем правом углу.|
| [lower_delta_y](/cells/python-net/ru/aspose.cells.drawing/groupbox/lower_delta_y) | Возвращает или задает вертикальное смещение фигуры от ее нижнего правого угла.|
| [lower_right_column](/cells/python-net/ru/aspose.cells.drawing/groupbox/lower_right_column) | Представляет индекс столбца в правом нижнем углу.|
| [lower_delta_x](/cells/python-net/ru/aspose.cells.drawing/groupbox/lower_delta_x) | Возвращает или задает горизонтальное смещение фигуры от ее нижнего правого углового столбца.|
| [right](/cells/python-net/ru/aspose.cells.drawing/groupbox/right) | Представляет ширину горизонтального смещения фигуры от ее нижнего правого углового столбца в пикселях.|
| [bottom](/cells/python-net/ru/aspose.cells.drawing/groupbox/bottom) | Представляет ширину вертикального смещения фигуры от ее нижнего нижнего угла в пикселях.|
| [width](/cells/python-net/ru/aspose.cells.drawing/groupbox/width) | Представляет ширину фигуры в пикселях.|
| [width_inch](/cells/python-net/ru/aspose.cells.drawing/groupbox/width_inch) | Представляет ширину фигуры в дюймах.|
| [width_pt](/cells/python-net/ru/aspose.cells.drawing/groupbox/width_pt) | Представляет ширину фигуры в точках.|
| [width_cm](/cells/python-net/ru/aspose.cells.drawing/groupbox/width_cm) | Представляет ширину фигуры в сантиметрах.|
| [height](/cells/python-net/ru/aspose.cells.drawing/groupbox/height) | Представляет высоту фигуры в пикселях.|
| [height_inch](/cells/python-net/ru/aspose.cells.drawing/groupbox/height_inch) | Представляет высоту фигуры в дюймах.|
| [height_pt](/cells/python-net/ru/aspose.cells.drawing/groupbox/height_pt) |Представляет высоту фигуры в точках.|
| [height_cm](/cells/python-net/ru/aspose.cells.drawing/groupbox/height_cm) | Представляет высоту фигуры в сантиметрах.|
| [left](/cells/python-net/ru/aspose.cells.drawing/groupbox/left) | Представляет горизонтальное смещение фигуры относительно ее левого столбца в пикселях.|
| [left_inch](/cells/python-net/ru/aspose.cells.drawing/groupbox/left_inch) | Представляет собой горизонтальное смещение фигуры относительно ее левого столбца в дюймах.|
| [left_cm](/cells/python-net/ru/aspose.cells.drawing/groupbox/left_cm) | Представляет собой горизонтальное смещение фигуры относительно ее левого столбца в сантиметрах.|
| [top](/cells/python-net/ru/aspose.cells.drawing/groupbox/top) | Представляет собой вертикальное смещение фигуры относительно ее верхней строки в пикселях.|
| [top_inch](/cells/python-net/ru/aspose.cells.drawing/groupbox/top_inch) | Представляет собой вертикальное смещение фигуры от ее верхней строки в дюймах.|
| [top_cm](/cells/python-net/ru/aspose.cells.drawing/groupbox/top_cm) | Представляет собой вертикальное смещение фигуры относительно ее верхней строки, в сантиметрах.|
| [top_to_corner](/cells/python-net/ru/aspose.cells.drawing/groupbox/top_to_corner) | Возвращает и задает вертикальное смещение фигуры от верхней границы листа в пикселях.|
| [left_to_corner](/cells/python-net/ru/aspose.cells.drawing/groupbox/left_to_corner) | Получает и задает горизонтальное смещение фигуры от левой границы рабочего листа.|
| [x](/cells/python-net/ru/aspose.cells.drawing/groupbox/x) | Возвращает и задает горизонтальное смещение фигуры от левой границы листа в пикселях.|
| [y](/cells/python-net/ru/aspose.cells.drawing/groupbox/y) |Возвращает и задает вертикальное смещение фигуры от верхней границы листа в пикселях.|
| [width_scale](/cells/python-net/ru/aspose.cells.drawing/groupbox/width_scale) | Получает и задает масштаб ширины в процентах от исходной ширины изображения.<br/> Если фигура не является изображением, свойство WidthScale возвращает только 100;|
| [height_scale](/cells/python-net/ru/aspose.cells.drawing/groupbox/height_scale) | Возвращает и задает масштаб высоты в процентах от исходной высоты изображения.<br/> Если фигура не является рисунком, свойство HeightScale возвращает только 100;|
| [top_in_shape](/cells/python-net/ru/aspose.cells.drawing/groupbox/top_in_shape) | Представляет собой вертикальное смещение фигуры от верхней границы родительской фигуры,<br/> в единице 1/4000 высоты родительской формы.|
| [left_in_shape](/cells/python-net/ru/aspose.cells.drawing/groupbox/left_in_shape) | Представляет собой горизонтальное смещение фигуры от левой границы родительской фигуры,<br/> в единице 1/4000 ширины родительской формы.|
| [width_in_shape](/cells/python-net/ru/aspose.cells.drawing/groupbox/width_in_shape) | Представляет ширину фигуры в единицах, равных 1/4000 родительской фигуры.|
| [height_in_shape](/cells/python-net/ru/aspose.cells.drawing/groupbox/height_in_shape) | Представляет собой вертикальное смещение фигуры от верхней границы родительской фигуры в единицах, равных 1/4000 высоты родительской фигуры.|
| [group](/cells/python-net/ru/aspose.cells.drawing/groupbox/group) | Получает групповую фигуру, содержащую данную фигуру.|
| [type](/cells/python-net/ru/aspose.cells.drawing/groupbox/type) |Получает тип автоматической фигуры.|
| [has_line](/cells/python-net/ru/aspose.cells.drawing/groupbox/has_line) | Возвращает и задает видимую границу линии фигуры.|
| [is_filled](/cells/python-net/ru/aspose.cells.drawing/groupbox/is_filled) | Указывает, виден ли формат заполнения.|
| [is_flipped_horizontally](/cells/python-net/ru/aspose.cells.drawing/groupbox/is_flipped_horizontally) | Получает и задает, перевернута ли фигура по горизонтали.|
| [is_flipped_vertically](/cells/python-net/ru/aspose.cells.drawing/groupbox/is_flipped_vertically) | Получает и задает, перевернута ли фигура вертикально.|
| [actual_lower_right_row](/cells/python-net/ru/aspose.cells.drawing/groupbox/actual_lower_right_row) | Возьмите реальный нижний ряд.|
| [relative_to_original_picture_size](/cells/python-net/ru/aspose.cells.drawing/groupbox/relative_to_original_picture_size) | Указывает, соотносится ли форма с исходным размером изображения.|
| [linked_cell](/cells/python-net/ru/aspose.cells.drawing/groupbox/linked_cell) | Возвращает или задает диапазон рабочего листа, связанный со значением элемента управления.|
| [input_range](/cells/python-net/ru/aspose.cells.drawing/groupbox/input_range) | Возвращает или задает диапазон рабочего листа, используемый для заполнения указанного поля со списком.|
| [text_shape_type](/cells/python-net/ru/aspose.cells.drawing/groupbox/text_shape_type) | Получает и задает предустановленный тип формы текста.|
| [text_body](/cells/python-net/ru/aspose.cells.drawing/groupbox/text_body) | Получает и задает настройки текста фигуры.|
| [font](/cells/python-net/ru/aspose.cells.drawing/groupbox/font) | Представляет шрифт формы.|
| [text_options](/cells/python-net/ru/aspose.cells.drawing/groupbox/text_options) | Представляет текстовые параметры фигуры.|
| [text](/cells/python-net/ru/aspose.cells.drawing/groupbox/text) | Получает и задает текст этой фигуры.|
| [is_rich_text](/cells/python-net/ru/aspose.cells.drawing/groupbox/is_rich_text) | Является ли текст форматированным текстом.|
| [html_text](/cells/python-net/ru/aspose.cells.drawing/groupbox/html_text) | Получает и задает HTML-строку, содержащую данные и некоторые форматы в этом текстовом поле.|
| [text_vertical_overflow](/cells/python-net/ru/aspose.cells.drawing/groupbox/text_vertical_overflow) | Получает и задает тип вертикального переполнения текста для фигуры, содержащей текст.|
| [text_horizontal_overflow](/cells/python-net/ru/aspose.cells.drawing/groupbox/text_horizontal_overflow) |Получает и задает тип горизонтального переполнения текста для фигуры, содержащей текст.|
| [is_text_wrapped](/cells/python-net/ru/aspose.cells.drawing/groupbox/is_text_wrapped) | Получает и задает тип обтекания текстом фигуры, содержащей текст.|
| [text_orientation_type](/cells/python-net/ru/aspose.cells.drawing/groupbox/text_orientation_type) | Получает и задает тип ориентации текста фигуры.|
| [text_horizontal_alignment](/cells/python-net/ru/aspose.cells.drawing/groupbox/text_horizontal_alignment) | Получает и задает тип горизонтального выравнивания текста фигуры.|
| [text_vertical_alignment](/cells/python-net/ru/aspose.cells.drawing/groupbox/text_vertical_alignment) | Получает и задает тип вертикального выравнивания текста фигуры.|
| [text_direction](/cells/python-net/ru/aspose.cells.drawing/groupbox/text_direction) | Получает/задает направление потока текста для этого объекта.|
| [text_box_options](/cells/python-net/ru/aspose.cells.drawing/groupbox/text_box_options) | Получает текстовую информацию в форме|
| [control_data](/cells/python-net/ru/aspose.cells.drawing/groupbox/control_data) | Получает данные управления.|
| [active_x_control](/cells/python-net/ru/aspose.cells.drawing/groupbox/active_x_control) | Получает элемент управления ActiveX.|
| [paths](/cells/python-net/ru/aspose.cells.drawing/groupbox/paths) | Получает пути произвольной геометрической формы.|
| [create_id](/cells/python-net/ru/aspose.cells.drawing/groupbox/create_id) | Получает и задает идентификатор создания для этой формы.|
| [is_decorative](/cells/python-net/ru/aspose.cells.drawing/groupbox/is_decorative) | Указывает, является ли объект декоративным.|
| [shadow](/cells/python-net/ru/aspose.cells.drawing/groupbox/shadow) | Указывает, имеет ли групповой элемент тень.|


###  Методы
| Метод| Описание|
| :- | :- |
| [`to_image(self, stream, image_type)`](/cells/python-net/ru/aspose.cells.drawing/groupbox/to_image/#io.rawiobase-aspose.cells.drawing.imagetype) | Создает изображение фигуры и сохраняет его в потоке в указанном формате.|
| [`to_image(self, image_file, options)`](/cells/python-net/ru/aspose.cells.drawing/groupbox/to_image/#str-aspose.cells.rendering.imageorprintoptions) | Сохраняет форму в файле.|
| [`to_image(self, stream, options)`](/cells/python-net/ru/aspose.cells.drawing/groupbox/to_image/#io.rawiobase-aspose.cells.rendering.imageorprintoptions) | Сохраняет форму в потоке.|
| [`get_result_of_smart_art(self)`](/cells/python-net/ru/aspose.cells.drawing/groupbox/get_result_of_smart_art/#) | Преобразование интеллектуального искусства в сгруппированные фигуры.|
| [`to_front_or_back(self, orders)`](/cells/python-net/ru/aspose.cells.drawing/groupbox/to_front_or_back/#int) | Выводит фигуру на передний план или отодвигает её на задний план.|
| [`get_locked_property(self, type)`](/cells/python-net/ru/aspose.cells.drawing/groupbox/get_locked_property/#aspose.cells.drawing.shapelocktype) | Получает значение заблокированного свойства.|
| [`set_locked_property(self, type, value)`](/cells/python-net/ru/aspose.cells.drawing/groupbox/set_locked_property/#aspose.cells.drawing.shapelocktype-bool) | Установить заблокированное свойство.|
| [`add_hyperlink(self, address)`](/cells/python-net/ru/aspose.cells.drawing/groupbox/add_hyperlink/#str) | Добавляет гиперссылку к форме.|
| [`remove_hyperlink(self)`](/cells/python-net/ru/aspose.cells.drawing/groupbox/remove_hyperlink/#) | Удаляет гиперссылку формы.|
| [`move_to_range(self, upper_left_row, upper_left_column, lower_right_row, lower_right_column)`](/cells/python-net/ru/aspose.cells.drawing/groupbox/move_to_range/#int-int-int-int) | Перемещает фигуру в указанный диапазон.|
| [`align_top_right_corner(self, top_row, right_column)`](/cells/python-net/ru/aspose.cells.drawing/groupbox/align_top_right_corner/#int-int) | Перемещает картинку в правый верхний угол.|
| [`get_connection_points(self)`](/cells/python-net/ru/aspose.cells.drawing/groupbox/get_connection_points/#) | Получить точки подключения|
| [`get_linked_cell(self, is_r1c1, is_local)`](/cells/python-net/ru/aspose.cells.drawing/groupbox/get_linked_cell/#bool-bool) | Возвращает диапазон, связанный со значением элемента управления.|
| [`set_linked_cell(self, formula, is_r1c1, is_local)`](/cells/python-net/ru/aspose.cells.drawing/groupbox/set_linked_cell/#str-bool-bool) | Устанавливает диапазон, связанный со значением элемента управления.|
| [`get_input_range(self, is_r1c1, is_local)`](/cells/python-net/ru/aspose.cells.drawing/groupbox/get_input_range/#bool-bool) | Возвращает диапазон, используемый для заполнения элемента управления.|
| [`set_input_range(self, formula, is_r1c1, is_local)`](/cells/python-net/ru/aspose.cells.drawing/groupbox/set_input_range/#str-bool-bool) | Задает диапазон, используемый для заполнения элемента управления.|
| [`update_selected_value(self)`](/cells/python-net/ru/aspose.cells.drawing/groupbox/update_selected_value/#) | Обновить выбранное значение значением связанной ячейки.|
| [`calculate_text_size(self)`](/cells/python-net/ru/aspose.cells.drawing/groupbox/calculate_text_size/#) | Пересчитать текстовую область|
| [`format_characters(self, start_index, length, font, flag)`](/cells/python-net/ru/aspose.cells.drawing/groupbox/format_characters/#int-int-aspose.cells.font-aspose.cells.styleflag) | Форматирует некоторые символы с помощью настроек шрифта.|
| [`characters(self, start_index, length)`](/cells/python-net/ru/aspose.cells.drawing/groupbox/characters/#int-int) |Возвращает объект Characters, представляющий диапазон символов в тексте.|
| [`get_characters(self)`](/cells/python-net/ru/aspose.cells.drawing/groupbox/get_characters/#) | Возвращает все объекты Characters<br/>который представляет собой диапазон символов в тексте.|
| [`get_rich_formattings(self)`](/cells/python-net/ru/aspose.cells.drawing/groupbox/get_rich_formattings/#) | Возвращает все объекты Characters<br/>который представляет собой диапазон символов в тексте.|
| [`remove_active_x_control(self)`](/cells/python-net/ru/aspose.cells.drawing/groupbox/remove_active_x_control/#) | Удалить элемент управления ActiveX.|
| [`is_same_setting(self, obj)`](/cells/python-net/ru/aspose.cells.drawing/groupbox/is_same_setting/#any) | Возвращает, одинакова ли форма.|
| [`get_actual_box(self)`](/cells/python-net/ru/aspose.cells.drawing/groupbox/get_actual_box/#) | Получить фактическое положение и размер фигуры (после применения поворота, отражения и т. д.)|
| [`fit_to_text_size(self)`](/cells/python-net/ru/aspose.cells.drawing/groupbox/fit_to_text_size/#) | Пересчитать текстовую область, подходящую для отображения всего текстового содержимого.|



###  Пример

```python
from aspose.cells import Workbook
from aspose.cells.drawing import PlacementType

# Instantiate a new Workbook.
excelbook = Workbook()
# Add a group box to the first worksheet.
box = excelbook.worksheets[0].shapes.add_group_box(1, 0, 1, 0, 300, 250)
# Set the caption of the group box.
box.text = "Age Groups"
box.placement = PlacementType.FREE_FLOATING
# Make it 2-D box.
box.shadow = False
# Save the excel file.
excelbook.save("groupbox.xls")

```

###  Смотрите также
* модуль [`aspose.cells.drawing`](..)
* класс [`GlowEffect`](/cells/python-net/ru/aspose.cells.drawing/gloweffect)
* класс [`GroupBox`](/cells/python-net/ru/aspose.cells.drawing/groupbox)
* класс [`ReflectionEffect`](/cells/python-net/ru/aspose.cells.drawing/reflectioneffect)
* класс [`ShadowEffect`](/cells/python-net/ru/aspose.cells.drawing/shadoweffect)
* класс [`Shape`](/cells/python-net/ru/aspose.cells.drawing/shape)
