Label. Auto Size Свойство

Определение

Получает или задает значение, указывающее, изменяются ли размеры элемента управления автоматически для отображения всего его содержимого. Gets or sets a value indicating whether the control is automatically resized to display its entire contents.

Значение свойства

Значение true , если размеры элемента управления подгоняются под ширину его содержимого; в противном случае — false . true if the control adjusts its width to closely fit its contents; otherwise, false .

При добавлении в форму с использованием конструктора значение по умолчанию — true . When added to a form using the designer, the default value is true . При создании экземпляра из кода значение по умолчанию — false . When instantiated from code, the default value is false .

Примеры

В следующем примере кода показано AutoSize свойство. The following code example demonstrates the AutoSize property. Чтобы выполнить этот пример, вставьте следующий код в форму и вызовите InitializeLabel метод из конструктора или Load метода формы. To run this example, paste the following code in a form and call the InitializeLabel method from the form’s constructor or Load method.

Комментарии

Если для этого свойства задано значение true , то параметр Label изменяет ширину для вывода всего содержимого. When this property is set to true , the Label adjusts its width to display its entire contents. Обычно это свойство имеет значение true при использовании Label элемента управления для вывода различной длины текста, например состояния процесса приложения. This property is typically set to true when you use a Label control to display various lengths of text, such as the status of an application process. Это свойство также можно использовать, когда приложение будет отображать текст на различных языках, а размер текста может увеличиваться или уменьшаться в зависимости от языковых параметров в Windows. You can also use this property when the application will display text in various languages, and the size of the text might increase or decrease based on the language settings in Windows.

Если шрифт превышает высоту объекта Label и имеет значение, то для отображения AutoEllipsis true текста необходимо задать параметр AutoSize false . If the font is taller than the height of the Label and AutoEllipsis is true , you must set AutoSize to false for text to be drawn.

Text Box Base. Auto Size Свойство

Определение

Получает или задает значение, указывающее, подстраивается ли автоматически высота элемента управления при изменении шрифта, назначенного для элемента управления. Gets or sets a value indicating whether the height of the control automatically adjusts when the font assigned to the control is changed.

Значение свойства

Значение true , если при изменении шрифта автоматически подстраивается высота элемента управления; в противном случае — значение false . true if the height of the control automatically adjusts when the font is changed; otherwise, false . Значение по умолчанию — true . The default is true .

Примеры

В этом примере предполагается, что у вас есть форма с двумя текстовыми полями, две кнопки и события нажатия для каждой кнопки. This example assumes that you have a form with two text boxes, two buttons, and click events for each of the buttons. В примере демонстрируется AutoSize свойство, присвоив ему значение true для одного текстового поля и false для другого. The example demonstrates the AutoSize property by setting it to true for one text box and false for the other. Если щелкнуть одну кнопку, текстовые поля будут заполнены меньшим текстом, а при нажатии другой кнопки текстовые поля будут заполнены текстом большего размера. When you click one button the text boxes are filled with a smaller text, and when you click the other button the text boxes are filled with larger text. Текстовое поле, AutoSize заданное для расширения высоты в соответствии с true большим текстом. The text box that has AutoSize set to true expands in height to accommodate the larger text. Ширина не изменяется. The width does not change.

Комментарии

Если AutoSize для свойства задано значение true TextBox , то при изменении объект Font TextBox разворачивает или раскрывает объект в соответствии с Height большим или меньшим текстом. When you set the AutoSize property to true for a TextBox, when the Font changes, the TextBox expands or contracts the Height to accommodate the larger or smaller text. WidthОбъекта TextBox не изменяется. The Width of the TextBox does not change.

Если нужно изменить размер элемента управления при вводе текста пользователем, можно использовать RichTextBox элемент управления и использовать его ContentsResized событие для изменения его размера. If you want to change the size of the control as the user enters text, you can use a RichTextBox control and use its ContentsResized event to change its size.

Form. Auto Size Свойство

Определение

Изменяет размеры формы в соответствии со значением AutoSizeMode. Resize the form according to the setting of AutoSizeMode.

Значение свойства

Значение true , если размеры формы будут автоматически изменены; false , если их необходимо изменять вручную. true if the form will automatically resize; false if it must be manually resized.

Примеры

В следующем примере показана форма, созданная с помощью кода, который автоматически изменяет размер в соответствии с содержимым. The following example shows a form created using code that automatically resizes to fit its contents. При запуске форма отображает Label , а TextBox для ввода URL-адреса, а также Button для отображения этого URL-адреса в браузере пользователя по умолчанию. When run, the form displays a Label, a TextBox for entering a URL, and a Button for displaying that URL inside of the user’s default Web browser. В примере используется FlowLayoutPanel для размещения вложенных элементов управления один за другим. The example uses a FlowLayoutPanel to lay out the contained controls one after the other. Он также задает AutoSize и AutoSizeMode для увеличения и уменьшения в соответствии с содержимым его формы. It also sets the AutoSize and AutoSizeMode to grow and shrink to fit the contents of its form.

Комментарии

Используйте AutoSize , чтобы принудительно изменить размер формы в соответствии с ее содержимым. Use AutoSize to force a form to resize to fit its contents.

Форма не изменяет размер автоматически в конструкторе форм Visual Studio независимо от значений AutoSize AutoSizeMode свойств и. A form does not automatically resize in the Visual Studio forms designer, regardless of the values of the AutoSize and AutoSizeMode properties. Форма правильно изменяет размер самого себя во время выполнения в соответствии со значениями этих двух свойств. The form correctly resizes itself at run time according to the values of these two properties. В отличие от этого, пользователь UserControl автоматически изменяет свой размер как во время разработки, так и во время выполнения. By contrast, a custom UserControl automatically resizes itself both at design time and at run time.

При использовании AutoSize MinimumSize Свойства и учитываются MaximumSize , но текущее значение Size свойства игнорируется. When using AutoSize, the MinimumSize and MaximumSize properties are respected, but the current value of the Size property is ignored. Использование AutoSize , а AutoSizeMode также визуализация AutoScroll свойства, излишнего, так как невозможно сжать форму, чтобы скрыть ее вложенные элементы управления из представления. Using AutoSize and AutoSizeMode also renders the AutoScroll property superfluous, as there is no way to shrink the form to hide its contained controls from view.

Сведения о AutoSizeMode принципах работы формы AutoSize , когда имеет значение, см. в разделе Перечисление true . See the AutoSizeMode enumeration for information on how a form behaves when AutoSize is true .

ComboBox.AutoSize Property (Outlook Forms Script) ComboBox.AutoSize Property (Outlook Forms Script)

Возвращает или задает логическое значение , которое указывает, будет ли объект автоматически изменять размер для отображения всего содержимого. Returns or sets a Boolean that specifies whether an object automatically resizes to display its entire contents. Для чтения и записи. Read/write.

Синтаксис Syntax

Expression. AutoSize expression.AutoSize

Expression (выражение ) Переменная, представляющая объект ComboBox . expression A variable that represents a ComboBox object.

Примечания Remarks

Значение true , чтобы автоматически изменить размер элемента управления для отображения всего содержимого. True to automatically resize the control to display its entire contents. Значение false , чтобы сохранить размер константы элемента управления; содержимое обрезается, когда они выходят за пределы области элемента управления (по умолчанию). False to keep the size of the control constant; contents are clipped when they exceed the area of the control (default).

Для элементов управления без названий это свойство указывает, изменяется ли автоматически размер элемента управления, чтобы полностью отобразить сведения, хранимые в этом элементе управления. For controls without captions, this property specifies whether the control automatically adjusts to display the information stored in the control. Например, в поле со списком, если для параметра AutoSize задано значение true , ширина области отображения автоматически задается равным длине текущего текста. In a ComboBox, for example, setting AutoSize to True automatically sets the width of the display area to match the length of the current text.

Если изменить размер элемента управления вручную при значениисвойства AutoSize , то изменение вручную переопределяет размер, установленный ранее функцией AutoSize. If you manually change the size of a control while AutoSize is True, the manual change overrides the size previously set by AutoSize.

Поддержка и обратная связь 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.

Свойство AutoSize AutoSize Property Overview

AutoSizeСвойство позволяет элементу управления изменять свой размер (при необходимости) для достижения значения, заданного PreferredSize свойством. The AutoSize property enables a control to change its size, if necessary, to attain the value specified by the PreferredSize property. Изменение размеров для конкретных элементов управления регулируется установкой AutoSizeMode Свойства. You adjust the sizing behavior for specific controls by setting the AutoSizeMode property.

Поведение при автоподборе AutoSize Behavior

Свойство поддерживается только некоторыми элементами управления AutoSize . Only some controls support the AutoSize property. Кроме того, некоторые элементы управления, поддерживающие AutoSize свойство, также поддерживают AutoSizeMode свойство. In addition, some controls that support the AutoSize property also support the AutoSizeMode property.

AutoSizeСвойство имеет несколько различное поведение в зависимости от конкретного типа элемента управления и значения AutoSizeMode свойства, если свойство существует. The AutoSize property produces somewhat different behavior, depending on the specific control type and the value of the AutoSizeMode property, if the property exists. В следующей таблице описаны поведения, которые всегда имеют значение true, и приводится краткое описание каждого из них. The following table describes the behaviors that are always true and provides a brief description of each:

Всегда истинное поведение Always true behavior	Описание Description
Автоматическое изменение размера — это функция времени выполнения. Automatic sizing is a run-time feature.	Это означает, что он никогда не растет и не сжимает элемент управления и не оказывает дальнейших эффектов. This means it never grows or shrinks a control and then has no further effect.
Если размер элемента управления изменяется, значение его Location свойства всегда остается постоянным. If a control changes size, the value of its Location property always remains constant.	Когда содержимое элемента управления вызывает увеличение, элемент управления увеличивается в направлении вправо и вниз. When a control’s contents cause it to grow, the control grows toward the right and downward. Элементы управления не увеличиваются до левого края. Controls do not grow to the left.
DockСвойства и учитываются, Anchor Если AutoSize имеет значение true . The Dock and Anchor properties are honored when AutoSize is true .	Значение свойства элемента управления Location корректируется на правильное значение. The value of the control’s Location property is adjusted to the correct value. Примечание . Label Этот элемент управления является исключением из этого правила. Note The Label control is the exception to this rule. Если для свойства закрепленного элемента управления задано значение Label AutoSize true , Label элемент управления не будет растягиваться. When you set the value of a docked Label control’s AutoSize property to true , the Label control will not stretch.
MaximumSizeСвойства и элемента управления MinimumSize всегда учитываются, независимо от значения его AutoSize Свойства. A control’s MaximumSize and MinimumSize properties are always honored, regardless of the value of its AutoSize property.	MaximumSize MinimumSize Свойство не влияет на свойства и AutoSize . The MaximumSize and MinimumSize properties are not affected by the AutoSize property.
Минимальный размер по умолчанию не задан. There is no minimum size set by default.	Это означает, что если для элемента управления выбрано сжатие в AutoSize и он не имеет содержимого, значение его Size свойства равно 0, 0. This means that if a control is set to shrink under AutoSize and it has no contents, the value of its Size property is 0,0. В этом случае элемент управления будет сжиматься до точки, и он не будет виден. In this case, your control will shrink to a point, and it will not be readily visible.
Если элемент управления не реализует GetPreferredSize метод, GetPreferredSize метод возвращает последнее значение, присвоенное Size свойству. If a control does not implement the GetPreferredSize method, the GetPreferredSize method returns last value assigned to the Size property.	Это означает, что параметр не AutoSize true будет оказывать никакого влияния. This means that setting AutoSize to true will have no effect.
Элемент управления в TableLayoutPanel ячейке всегда сжимается в соответствии с ячейкой, пока MinimumSize не будет достигнут ее размер. A control in a TableLayoutPanel cell always shrinks to fit in the cell until its MinimumSize is reached.	Этот размер применяется в качестве максимального размера. This size is enforced as a maximum size. Это не так, когда ячейка является частью AutoSize строки или столбца. This is not the case when the cell is part of an AutoSize row or column.

AutoSizeMode, свойство AutoSizeMode Property

AutoSizeMode Свойство обеспечивает более детализированный контроль над поведением по умолчанию AutoSize . The AutoSizeMode property provides more fine-grained control over the default AutoSize behavior. AutoSizeMode Свойство определяет, как размер элемента управления изменяется в соответствии с его содержимым. The AutoSizeMode property specifies how a control sizes itself to its content. Например, содержимым может быть текст для Button элемента управления или дочерние элементы управления для контейнера. The content, for example, could be the text for a Button control or the child controls for a container.

В следующей таблице показаны AutoSizeMode Параметры и описание поведения, которое задается каждым параметром. The following table shows the AutoSizeMode settings and a description of the behavior each setting elicits.

Параметр AutoSizeMode AutoSizeMode setting	Поведение Behavior
гровандшринк GrowAndShrink	Элемент управления растет или сжимается, чтобы охватывать его содержимое. The control grows or shrinks to encompass its contents. MinimumSizeЗначения и учитываются MaximumSize , но текущее значение Size свойства игнорируется. The MinimumSize and MaximumSize values are honored, but the current value of the Size property is ignored. Это то же поведение, что и элементы управления со AutoSize свойством и без AutoSizeMode Свойства. This is the same behavior as controls with the AutoSize property and no AutoSizeMode property.
гровонли GrowOnly	Элемент управления растет столько же, сколько необходимо для того, чтобы охватывать его содержимое, но не будет уменьшаться меньше, чем значение, заданное Size свойством. The control grows as much as necessary to encompass its contents, but it will not shrink smaller than the value specified by its Size property. Это значение по умолчанию для AutoSizeMode . This is the default value for AutoSizeMode .

Элементы управления, поддерживающие свойство AutoSize Controls That Support the AutoSize Property

В следующей таблице перечислены элементы управления, которые поддерживают AutoSize AutoSizeMode Свойства и. The following table lists the controls that support the AutoSize and AutoSizeMode properties.