TextBox

TextBox class

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

public class TextBox : Shape

Характеристики

ИмяОписание
ActiveXControl { get; }Получает элемент управления ActiveX.
ActualLowerRightRow { get; }Получить фактическую нижнюю строку.
AlternativeText { get; set; }Возвращает или задает описательную (альтернативную) текстовую строкуShape объект.
AnchorType { get; set; }Получает и устанавливает местозаполнитель привязки формы.
AutoShapeType { get; set; }Получает и задает тип автоматической фигуры.
Bottom { get; set; }Представляет ширину смещения фигуры по вертикали от ее нижнего нижнего углового ряда в единицах пикселей.
ControlData { get; }Получает данные управления.
CreateId { get; set; }Получает и устанавливает идентификатор создания для этой фигуры.
Fill { get; }ВозвращаетFillFormat объект, содержащий свойства форматирования заливки для указанной формы.
Font { get; set; }Представляет шрифт shape.
FormatPicture { get; }Получает и задает параметры формата изображения.
Geometry { get; }Получает геометрию
Glow { get; }Представляет объект, определяющий эффект свечения для элемента диаграммы или фигуры.
Group { get; }Получает фигуру группы, которая содержит эту фигуру.
HasLine { get; set; }Получает и устанавливает видимую границу линии фигуры.
Height { get; set; }Представляет высоту фигуры в пикселях.
HeightCM { get; set; }Представляет высоту фигуры в сантиметрах.
HeightInch { get; set; }Представляет высоту фигуры в дюймах.
HeightInShape { get; set; }Представляет вертикальное смещение фигуры от верхней границы родительской фигуры в единицах 1/4000 высоты родительской фигуры..
HeightPt { get; set; }Представляет высоту фигуры в точках.
HeightScale { get; set; }Получает и задает масштаб высоты в процентах от исходной высоты изображения. Если фигура не является изображением, свойство HeightScale возвращает только 100;
HtmlText { get; set; }Получает и задает строку html, содержащую данные и некоторые форматы в этом текстовом поле.
Hyperlink { get; }Получает гиперссылку фигуры.
Id { get; }Получает идентификатор этой фигуры.
InputRange { get; set; }Получает или задает диапазон рабочего листа, используемый для заполнения указанного поля со списком.
IsEquation { get; }Указывает, содержит ли фигура только уравнение.
IsFilled { get; set; }Указывает, виден ли формат заполнения.
IsFlippedHorizontally { get; set; }Получает и устанавливает, отражается ли фигура по горизонтали .
IsFlippedVertically { get; set; }Получает и устанавливает, переворачивается ли фигура по вертикали .
IsGroup { get; }Указывает, является ли фигура группой.
IsHidden { get; set; }Указывает, виден ли объект.
IsInGroup { get; }Указывает, сгруппирована ли фигура.
IsLockAspectRatio { get; set; }True означает, что изменение соотношения сторон запрещено.
IsLocked { get; set; }True, если объект заблокирован, False, если объект можно изменить, когда лист защищен.
IsPrintable { get; set; }Истинно, если объект доступен для печати
IsRichText { get; }Является ли текст форматированным текстом.
IsSmartArt { get; }Указывает, является ли фигура смарт-артом.
IsTextWrapped { get; set; }Получает и задает тип переноса текста для фигуры, содержащей текст.
IsWordArt { get; }Указывает, является ли эта фигура словом art.
Left { get; set; }Представляет горизонтальное смещение фигуры от ее левого столбца в единицах пикселей.
LeftCM { get; set; }Представляет горизонтальное смещение фигуры от ее левого столбца в сантиметрах.
LeftInch { get; set; }Представляет горизонтальное смещение фигуры от ее левого столбца в дюймах.
LeftInShape { get; set; }Представляет горизонтальное смещение фигуры от левой границы родительской фигуры, в единицах 1/4000 ширины родительской фигуры.
LeftToCorner { get; set; }Получает и задает горизонтальное смещение фигуры от левой границы листа.
Line { get; }Получает стиль линии
LinkedCell { get; set; }Получает или задает диапазон рабочего листа, связанный со значением элемента управления.
LowerDeltaX { get; set; }Получает или задает смещение фигуры по горизонтали от нижнего правого углового столбца.
LowerDeltaY { get; set; }Получает или задает вертикальное смещение фигуры от нижнего правого угла строки.
LowerRightColumn { get; set; }Представляет индекс столбца в правом нижнем углу.
LowerRightRow { get; set; }Представляет индекс строки в правом нижнем углу.
MacroName { get; set; }Получает и устанавливает имя макроса.
MsoDrawingType { get; }Получает тип чертежа mso.
Name { get; set; }Получает и задает имя фигуры.
Paths { get; }Получает пути произвольной геометрической формы.
Placement { get; set; }Представляет способ прикрепления объекта чертежа к ячейкам под ним. Свойство управляет размещением объекта на рабочем листе.
Reflection { get; }Представляетобъект, определяющий эффект отражения для элемента диаграммы или формы.
RelativeToOriginalPictureSize { get; set; }Указывает, соответствует ли форма исходному размеру изображения.
Right { get; set; }Представляет ширину горизонтального смещения фигуры от ее нижнего правого углового столбца в единицах пикселей.
RotationAngle { get; set; }Получает и задает поворот фигуры.
ShadowEffect { get; }Представляет объект, определяющий эффект тени для элемента диаграммы или формы.
SoftEdges { get; set; }Получает и задает радиус размытия для краев в точках.
Spid { get; }Указывает необязательную строку, которую приложение может использовать для идентификации конкретной формы.
Spt { get; }Указывает необязательный номер, который приложение может использовать для связывания конкретной фигуры с определенным типом фигуры.
Text { get; set; }Представляет строку в этом объекте TextBox.
TextBody { get; }Получает и задает настройку текста фигуры.
TextDirection { get; set; }Получает/устанавливает направление потока текста для этого объекта.
TextEffect { get; }Возвращает объект TextEffectFormat, содержащий свойства форматирования текстового эффекта для указанной фигуры. Применяется к объектам Shape, представляющим WordArt.
TextHorizontalAlignment { get; set; }Получает и задает тип горизонтального выравнивания текста фигуры.
TextHorizontalOverflow { get; set; }Получает и задает тип горизонтального переполнения текста для фигуры, содержащей текст.
TextOptions { get; set; }Представляет параметры текста фигуры.
TextOrientationType { get; set; }Получает и задает тип ориентации текста фигуры.
TextShapeType { get; set; }Получает и задает заданный тип формы текста.
TextVerticalAlignment { get; set; }Получает и задает тип вертикального выравнивания текста фигуры.
TextVerticalOverflow { get; set; }Получает и задает тип вертикального переполнения текста для фигуры, содержащей текст.
ThreeDFormat { get; }Получает и задает формат 3D формы.
Title { get; set; }Указывает заголовок (заголовок) текущего объекта формы.
Top { get; set; }Представляет вертикальное смещение фигуры от ее верхней строки в единицах пикселей.
TopCM { get; set; }Представляет вертикальное смещение фигуры от верхней строки в сантиметрах.
TopInch { get; set; }Представляет вертикальное смещение фигуры от верхней строки в дюймах.
TopInShape { get; set; }Представляет вертикальное смещение фигуры от верхней границы родительской фигуры, в единицах 1/4000 высоты родительской фигуры.
TopToCorner { get; set; }Получает и задает вертикальное смещение фигуры от верхней границы листа в пикселях.
Type { get; }Получает автоматический тип фигуры.
UpperDeltaX { get; set; }Получает или задает смещение фигуры по горизонтали от ее верхнего левого углового столбца.
UpperDeltaY { get; set; }Получает или задает вертикальное смещение фигуры от ее верхнего левого углового ряда.
UpperLeftColumn { get; set; }Представляет индекс столбца в левом верхнем углу.
UpperLeftRow { get; set; }Представляет индекс строки в верхнем левом углу.
Width { get; set; }Представляет ширину фигуры в пикселях.
WidthCM { get; set; }Представляет ширину фигуры в сантиметрах.
WidthInch { get; set; }Представляет ширину фигуры в дюймах.
WidthInShape { get; set; }Представляет ширину фигуры в единицах 1/4000 родительской фигуры.
WidthPt { get; set; }Представляет ширину фигуры в пунктах.
WidthScale { get; set; }Получает и задает масштаб ширины в процентах от исходной ширины изображения. Если фигура не является изображением, свойство WidthScale возвращает только 100;
Worksheet { get; }ПолучаетWorksheet объект, который содержит эту форму.
X { get; set; }Получает и задает горизонтальное смещение фигуры от левой границы рабочего листа в единицах пикселей.
Y { get; set; }Получает и задает вертикальное смещение фигуры от верхней границы рабочего листа в единицах пикселей.
ZOrderPosition { get; set; }Возвращает позицию фигуры в z-порядке.

Методы

ИмяОписание
AddHyperlink(string)Добавляет гиперссылку к фигуре.
AlignTopRightCorner(int, int)Перемещает изображение в правый верхний угол.
CalculateTextSize()Пересчитать текстовую область
Characters(int, int)Возвращает объект символов, представляющий диапазон символов в тексте.
FormatCharacters(int, int, Font, StyleFlag)Форматирует некоторые символы с настройкой шрифта.
GetCharacters()Возвращает все объекты символов , представляющие диапазон символов в тексте .
GetConnectionPoints()Получить точки подключения
GetInputRange(bool, bool)Получает диапазон, используемый для заполнения элемента управления.
GetLinkedCell(bool, bool)Получает диапазон, связанный со значением элемента управления.
GetLockedProperty(ShapeLockType)Получает значение заблокированного свойства.
virtual GetResultOfSmartArt()Преобразование смарт-арта в сгруппированные фигуры.
virtual IsSameSetting(object)Возвращает, совпадает ли форма.
MoveToRange(int, int, int, int)Перемещает фигуру в указанный диапазон.
RemoveActiveXControl()Удалить элемент управления ActiveX.
RemoveHyperlink()Удалить гиперссылку формы.
SetInputRange(string, bool, bool)Устанавливает диапазон, используемый для заполнения элемента управления.
SetLinkedCell(string, bool, bool)Устанавливает диапазон, связанный со значением элемента управления.
SetLockedProperty(ShapeLockType, bool)Установить заблокированное свойство.
ToFrontOrBack(int)Перемещает фигуру на передний план или отправляет фигуру на задний план.
ToImage(ImageOrPrintOptions)Возвращает растровый объект формы .
ToImage(Stream, ImageOrPrintOptions)Сохраняет форму в поток.
ToImage(Stream, ImageType)Создает изображение фигуры и сохраняет его в потоке в указанном формате.
ToImage(string, ImageOrPrintOptions)Сохраняет фигуру в файл.
UpdateSelectedValue()Обновить выбранное значение значением связанной ячейки.

Примеры


[C#]

//Создание новой книги.
Workbook workbook = new Workbook();
//Получить первый рабочий лист в книге.
Worksheet worksheet = workbook.Worksheets[0];
//Добавить новое текстовое поле в коллекцию.
int textboxIndex = worksheet.TextBoxes.Add(2, 1, 160, 200);
//Получить объект текстового поля.
Aspose.Cells.Drawing.TextBox textbox0 = worksheet.TextBoxes[textboxIndex];
// Заполнить текст.
textbox0.Text = "ASPOSE______The .NET and JAVA Component Publisher!";
// Установите текстовое поле, чтобы настроить его в соответствии с его содержимым.
textbox0.TextBody.TextAlignment.AutoSize = true;
//Установить место размещения.
textbox0.Placement = PlacementType.FreeFloating;
//Установить цвет шрифта.
textbox0.Font.Color = Color.Blue;
// Установите жирный шрифт.
textbox0.Font.IsBold = true;
//Установить размер шрифта.
textbox0.Font.Size = 14;
// Установить атрибут шрифта курсивом.
textbox0.Font.IsItalic = true;
//Добавить гиперссылку в текстовое поле.
textbox0.AddHyperlink("http://www.aspose.com/");
//Получить filformat текстового поля.
FillFormat fillformat = textbox0.Fill;
//Установить цвет заливки.
fillformat.SolidFill.Color = Color.Silver;
//Получить тип формата строки текстового поля.
LineFormat lineformat = textbox0.Line;
//Установить стиль линии.
lineformat.CompoundType = MsoLineStyle.ThinThick;
//Установить толщину линии.
lineformat.Weight = 6;
//Установите стиль тире на квадратную точку.
lineformat.DashStyle = MsoLineDashStyle.SquareDot;
//Добавить еще одно текстовое поле.
textboxIndex = worksheet.TextBoxes.Add(15, 4, 85, 120);
//Получить второе текстовое поле.
Aspose.Cells.Drawing.TextBox textbox1 = worksheet.TextBoxes[textboxIndex];
//Вводим в него какой-нибудь текст.
textbox1.Text = "This is another simple text box";
//Установите тип размещения, так как текстовое поле будет перемещаться и
//изменить размер с ячейками.
textbox1.Placement = PlacementType.MoveAndSize;
// Сохраняем файл excel.
workbook.Save("tsttextboxes.xlsx");

[Visual Basic]

'Создайте новую рабочую книгу.
Dim workbook As Workbook = New Workbook()
'Получить первый рабочий лист в книге.
Dim worksheet As Worksheet = workbook.Worksheets(0)
'Добавьте новое текстовое поле в коллекцию.
Dim textboxIndex As Integer = worksheet.TextBoxes.Add(2, 1, 160, 200)
'Получите объект текстового поля.
Dim textbox0 As Aspose.Cells.Drawing.TextBox = worksheet.TextBoxes(textboxIndex)
'Заполните текст.
textbox0.Text = "ASPOSE______The .NET and JAVA Component Publisher!"
'Установите текстовое поле, чтобы настроить его в соответствии с его содержимым.
textbox0.TextBody.TextAlignment.AutoSize = True
'Установите размещение.
textbox0.Placement = PlacementType.FreeFloating
'Установите цвет шрифта.
textbox0.Font.Color = Color.Blue
'Установите жирный шрифт.
textbox0.Font.IsBold = True
'Установите размер шрифта.
textbox0.Font.Size = 14
'Установите атрибут шрифта курсивом.
textbox0.Font.IsItalic = True
'Добавьте гиперссылку в текстовое поле.
textbox0.AddHyperlink("http://www.aspose.com/")
'Получите filformat текстового поля.
Dim fillformat As FillFormat = textbox0.Fill
'Установите цвет заливки.
fillformat.SolidFill.Color = Color.Silver
'Получите тип формата строки текстового поля.
Dim lineformat As LineFormat = textbox0.Line
'Установите стиль линии.
lineformat.CompoundType = MsoLineStyle.ThinThick
'Установите вес линии.
lineformat.Weight = 6
'Установите стиль тире на квадратную точку.
lineformat.DashStyle = MsoLineDashStyle.SquareDot
'Добавьте еще одно текстовое поле.
textboxIndex = worksheet.TextBoxes.Add(15, 4, 85, 120)
'Получите второе текстовое поле.
Dim textbox1 As Aspose.Cells.Drawing.TextBox = worksheet.TextBoxes(textboxIndex)
'Введите в него текст.
textbox1.Text = "This is another simple text box"
'Установите тип размещения, так как текстовое поле будет перемещаться и
'изменить размер с ячейками.
textbox1.Placement = PlacementType.MoveAndSize
'Сохраните файл Excel.
workbook.Save("tsttextboxes.xlsx")

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