ControlExtensions.AddMaskedTextBox - метод (ControlCollection, Single, Single, Single, Single, String)
Добавляет в заданное расположение в документе новый элемент управления MaskedTextBox указанного размера.
Пространство имен: Microsoft.Office.Tools.Word
Сборка: Microsoft.Office.Tools.Word.v4.0.Utilities (в Microsoft.Office.Tools.Word.v4.0.Utilities.dll)
Синтаксис
'Декларация
<ExtensionAttribute> _
Public Shared Function AddMaskedTextBox ( _
controls As ControlCollection, _
left As Single, _
top As Single, _
width As Single, _
height As Single, _
name As String _
) As MaskedTextBox
public static MaskedTextBox AddMaskedTextBox(
this ControlCollection controls,
float left,
float top,
float width,
float height,
string name
)
Параметры
- controls
Тип: Microsoft.Office.Tools.Word.ControlCollection
Коллекция, в которую добавляется элемент управления.Не формируйте значение этого параметра самостоятельно.При вызове этого метода для коллекции, возвращаемой свойством Document.Controls (в проекте уровня приложения) или свойством DocumentBase.Controls (в проекте уровня документа), данный параметр предоставляется автоматически.
- left
Тип: System.Single
Расстояние в пунктах между левым краем элемента управления и левым краем документа.
- top
Тип: System.Single
Расстояние в пунктах между верхним краем элемента управления и верхним краем документа.
- width
Тип: System.Single
Ширина элемента управления в пунктах.
- height
Тип: System.Single
Высота элемента управления в пунктах.
- name
Тип: System.String
Имя, которое можно использовать для индексации элемента управления в экземпляре класса ControlCollection.
Возвращаемое значение
Тип: Microsoft.Office.Tools.Word.Controls.MaskedTextBox
Элемент управления, добавленный в документ.
Примечание об использовании
В Visual Basic и C# этот метод можно вызывать как метод экземпляра для любого объекта типа ControlCollection. При вызове метода для экземпляра следует опускать первый параметр. Дополнительные сведения см. в разделе Методы расширения (Visual Basic) или Методы расширения (Руководство по программированию в C#).
Заметки
Этот метод используется для добавления объектов MaskedTextBox в конец коллекции ControlCollection.
Чтобы удалить добавленный программно объект MaskedTextBox, воспользуйтесь методом Remove.
Примеры
В приведенном ниже примере кода в начало документа добавляется элемент управления MaskedTextBox, после чего свойству Mask присваивается значение 00/00/0000. Чтобы использовать этот пример, запустите его из класса ThisDocument в проекте уровня документа.
Private Sub WordAddMaskedTextBox()
Me.Paragraphs(1).Range.InsertParagraphBefore()
Dim MaskedTextBox1 As Microsoft.Office.Tools.Word. _
Controls.MaskedTextBox = Me.Controls.AddMaskedTextBox( _
0, 0, 75, 15, "MaskedTextBox1")
MaskedTextBox1.Mask = "00/00/0000"
End Sub
private void WordAddMaskedTextBox()
{
this.Paragraphs[1].Range.InsertParagraphBefore();
Microsoft.Office.Tools.Word.Controls.MaskedTextBox
maskedTextBox1 = this.Controls.AddMaskedTextBox(
0, 0, 75, 15, "maskedTextBox1");
maskedTextBox1.Mask = "00/00/0000";
}
Безопасность платформы .NET Framework
- Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.