Как задать текст, отображаемый элементом управления Windows Forms How to: Set the text displayed by a Windows Forms control

Windows Forms элементы управления обычно отображают некоторый текст, связанный с основной функцией элемента управления. Windows Forms controls usually display some text that’s related to the primary function of the control. Например, Button элемент управления обычно отображает заголовок, указывающий, какое действие будет выполнено при нажатии кнопки. For example, a Button control usually displays a caption indicating what action will be performed if the button is clicked. С помощью свойства Text можно задавать или получать текст для всех элементов управления. For all controls, you can set or return the text by using the Text property. Шрифт можно менять с помощью свойства Font. You can change the font by using the Font property.

Можно также задать текст с помощью конструктора. You can also set the text by using the designer.

Программный Programmatic

Присвойте свойству Text строку. Set the Text property to a string.

Чтобы создать подчеркнутый ключ доступа, включает амперсанд (&) перед буквой, которая будет клавишей доступа. To create an underlined access key, includes an ampersand (&) before the letter that will be the access key.

Присвойте свойству Font объект типа Font. Set the Font property to an object of type Font.

Для отображения в элементах пользовательского интерфейса, например пунктах меню, специальных символов, которые обычно интерпретируются в них по-другому, можно использовать escape-символ. You can use an escape character to display a special character in user-interface elements that would normally interpret them differently, such as menu items. Например, следующая строка кода задает текст пункта меню для чтения «& теперь для чего-то совершенно другого»: For example, the following line of code sets the menu item’s text to read «& Now For Something Completely Different»:

Designer Designer

В окне Свойства в Visual Studio задайте для свойства Text элемента управления соответствующую строку. In the Properties window in Visual Studio, set the Text property of the control to an appropriate string.

Чтобы создать подчеркнутую клавишу, она включает амперсанд (&) перед буквой, которая будет клавишей быстрого вызова. To create an underlined shortcut key, includes an ampersand (&) before the letter that will be the shortcut key.

В окне Свойства нажмите кнопку с многоточием ( ) рядом со свойством Font . In the Properties window, select the ellipsis button ( ) next to the Font property.

В диалоговом окне стандартный шрифт выберите шрифт, стиль шрифта, размер, эффекты (например, зачеркивание или подчеркивание) и нужный сценарий. In the standard font dialog box, select the font, font style, size, effects (such as strikeout or underline), and script that you want.

Практическое руководство. Установка текста, отображаемого элементом управления (Windows Forms .NET) How to: Set the text displayed by a control (Windows Forms .NET)

В элементах управления Windows Forms обычно отображается текст, связанный с их основной функцией. Windows Forms controls usually display some text that’s related to the primary function of the control. Например, в элементе управления Button обычно отображается заголовок, указывающий, какое действие выполняется при нажатии кнопки. For example, a Button control usually displays a caption indicating what action will be performed if the button is clicked. С помощью свойства Text можно задавать или получать текст для всех элементов управления. For all controls, you can set or return the text by using the Text property. Шрифт можно менять с помощью свойства Font. You can change the font by using the Font property.

Задать текст также можно с помощью конструктора. You can also set the text by using the designer.

Документация для Руководства по рабочему столу по .NET 5 (и .NET Core) находится в разработке. The Desktop Guide documentation for .NET 5 (and .NET Core) is under construction.

Designer Designer

В окне Свойства в Visual Studio задайте для свойства Text элемента управления соответствующую строку. In the Properties window in Visual Studio, set the Text property of the control to an appropriate string.

Чтобы создать сочетание клавиш с подчеркиванием, добавьте амперсанд (&) перед буквой, которая будет использоваться в качестве клавиши быстрого вызова. To create an underlined shortcut key, include an ampersand (&) before the letter that will be the shortcut key.

В окне Свойства нажмите кнопку с многоточием ( ) рядом со свойством Font. In the Properties window, select the ellipsis button ( ) next to the Font property.

В диалоговом окне «Стандартный шрифт» настройте тип, размер и стиль шрифта. In the standard font dialog box, adjust the font with settings such as type, size, and style.

Программный Programmatic

Присвойте свойству Text строку. Set the Text property to a string.

Чтобы создать клавишу доступа с подчеркиванием, добавьте амперсанд (&) перед буквой, которая будет использоваться в качестве клавиши доступа. To create an underlined access key, include an ampersand (&) before the letter that will be the access key.

Присвойте свойству Font объект типа Font. Set the Font property to an object of type Font.

Для отображения в элементах пользовательского интерфейса, например пунктах меню, специальных символов, которые обычно интерпретируются в них по-другому, можно использовать escape-символ. You can use an escape character to display a special character in user-interface elements that would normally interpret them differently, such as menu items. Например, следующая строка кода задает такой текст для пункта меню: «& Now For Something Completely Different»: For example, the following line of code sets the menu item’s text to read «& Now For Something Completely Different»:

Шрифты и текст Using Fonts and Text

Существует несколько классов, предлагаемых GDI+ и GDI для рисования текста на Windows Forms. There are several classes offered by GDI+ and GDI for drawing text on Windows Forms. Класс GDI+ Graphics содержит несколько DrawString методов, позволяющих задавать различные функции текста, такие как расположение, ограничивающий прямоугольник, шрифт и формат. The GDI+ Graphics class has several DrawString methods that allow you to specify various features of text, such as location, bounding rectangle, font, and format. Кроме того, можно рисовать и измерять текст с помощью GDI, используя статические DrawText методы и, MeasureText предлагаемые TextRenderer классом. In addition, you can draw and measure text with GDI using the static DrawText and MeasureText methods offered by the TextRenderer class. Методы GDI также позволяют задавать расположение, шрифт и формат. The GDI methods also allow you to specify location, font, and format. Для отрисовки текста можно выбрать либо GDI, либо GDI+. Однако GDI обычно обеспечивает лучшую производительность и более точное измерение текста. You can choose either GDI or GDI+ for text rendering; however, GDI generally offers better performance and more accurate text measuring. Другие классы, участвующие в отрисовке текста FontFamily , включают,, Font StringFormat и TextFormatFlags . Other classes that contribute to text rendering include FontFamily , Font , StringFormat, and TextFormatFlags .

в этом разделе In This Section

Практическое руководство. Разработка шрифтов и их семейств How to: Construct Font Families and Fonts
Показывает, как создавать Font FontFamily объекты и. Shows how to create Font and FontFamily objects.

Практическое руководство. Рисование текста в указанной позиции How to: Draw Text at a Specified Location
Описание способов рисования текста в определенном расположении с помощью GDI+ и GDI. Describes how to draw text in a certain location using GDI+ and GDI.

Практическое руководство. Многострочный вывод текста в прямоугольнике How to: Draw Wrapped Text in a Rectangle
Описывает Рисование текста в прямоугольнике с помощью GDI+ и GDI. Explains how to draw text in a rectangle using GDI+ and GDI.

Практическое руководство. Рисование текста с использованием GDI How to: Draw Text with GDI
Демонстрирует использование GDI для рисования текста. Demonstrates how to use GDI for drawing text.

Практическое руководство. Выравнивание рисуемого текста How to: Align Drawn Text
Показывает, как форматировать текст GDI+ и GDI. Shows how to format GDI+ and GDI text.

Практическое руководство. Вывод текста по вертикали How to: Create Vertical Text
Описывает Рисование текста с выравниванием по вертикали с помощью GDI+. Describes how to draw vertically aligned text with GDI+.

Практическое руководство. Установка позиций табуляции для выводимого текста How to: Set Tab Stops in Drawn Text
Показывает, как рисовать текст с позициями табуляции с помощью GDI+. Shows how draw text with tab stops with GDI+.

Практическое руководство. Перебор установленных шрифтов How to: Enumerate Installed Fonts
Содержит сведения о том, как вывести список имен установленных шрифтов. Explains how to list the names of installed fonts.

Практическое руководство. Получение метрик шрифтов How to: Obtain Font Metrics
Показывает, как получить метрики шрифта, такие как дохождение и спуск ячеек. Shows how to obtain font metrics such as cell ascent and descent.

Практическое руководство. Сглаживание текста How to: Use Antialiasing with Text
Объясняется, как использовать сглаживание при рисовании текста. Explains how to use antialiasing when drawing text.

Справочник Reference

Font
Описывает этот класс и содержит ссылки на все его члены. Describes this class and contains links to all of its members.

FontFamily
Описывает этот класс и содержит ссылки на все его члены. Describes this class and contains links to all of its members.

PrivateFontCollection
Описывает этот класс и содержит ссылки на все его члены. Describes this class and contains links to all of its members.

TextRenderer
Описывает этот класс и содержит ссылки на все его члены. Describes this class and contains links to all of its members.

TextFormatFlags
Описывает этот класс и содержит ссылки на все его члены. Describes this class and contains links to all of its members.

Свойство Text (Microsoft Forms) Text property (Microsoft Forms)

Возвращает или задает текст в текстовом поле. Returns or sets the text in a TextBox. Изменяет выбранную строку в элементе ComboBox или ListBox. Changes the selected row in a ComboBox or ListBox.

Синтаксис Syntax

объект. Text [= строка ] object.Text [= String ]

Синтаксис свойства Text включает следующие элементы: The Text property syntax has these parts:

Часть Part	Описание Description
object object	Обязательный. Required. Допустимый объект. A valid object.
String String	Необязательно. Optional. Строковое выражение, содержащее текст. A string expression specifying text. Значение по умолчанию — пустая строка («»). The default value is a zero-length string («»).

Примечания Remarks

В элементе управления TextBox любое значение, назначенное свойству Text, также назначается свойству Value. For a TextBox, any value you assign to the Text property is also assigned to the Value property.

В элементе управления ComboBox свойство Text можно использовать, чтобы изменять значение элемента. For a ComboBox, you can use Text to update the value of the control. Если значение свойства Text совпадает с существующим элементом списка, свойство ListIndex (номер текущей строки) принимает значение номера элемента, совпавшего со свойством Text. If the value of Text matches an existing list entry, the value of the ListIndex property (the index of the current row) is set to the row that matches Text. Если значение Text не равно строке, для параметра ListIndex задано значение-1. If the value of Text does not match a row, ListIndex is set to -1.

В элементе управления ListBox значение свойства Text должно совпадать с одним из элементов списка. For a ListBox, the value of Text must match an existing list entry. При указании значения, не совпадающего ни с одним из элементов списка, возникает ошибка. Specifying a value that does not match an existing list entry causes an error.

При помощи свойства Text невозможно изменять значение записи в элементах управления ComboBox и ListBox. Для этого используются свойства Column и List. You cannot use Text to change the value of an entry in a ComboBox or ListBox; use the Column or List property for this purpose.

Свойство ForeColor определяет цвет текста. The ForeColor property determines the color of the text.

См. также See also

Поддержка и обратная связь Support and feedback

Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Have questions or feedback about Office VBA or this documentation? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь. Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.