DatePickerContentControl - интерфейс

Представляет в документе управляющий элемент выбора даты.

Пространство имен:  Microsoft.Office.Tools.Word
Сборка:  Microsoft.Office.Tools.Word (в Microsoft.Office.Tools.Word.dll)

Синтаксис

'Декларация
<GuidAttribute("96344f0e-9431-43c6-92bd-8c8621fe1520")> _
Public Interface DatePickerContentControl _
    Inherits ContentControlBase, IBindableComponent, IComponent, IDisposable,  _
    ISupportInitialize

[GuidAttribute("96344f0e-9431-43c6-92bd-8c8621fe1520")]
public interface DatePickerContentControl : ContentControlBase, 
    IBindableComponent, IComponent, IDisposable, ISupportInitialize

Тип DatePickerContentControl предоставляет следующие члены.

Свойства

	Имя	Описание
	Application	Получает объект Microsoft.Office.Interop.Word.Application, представляющий текущий экземпляр Microsoft Office Word.
	BindingContext	Возвращает или задает коллекцию диспетчеров валют для IBindableComponent. (Унаследовано от IBindableComponent.)
	Container	Инфраструктура. (Унаследовано от ContentControlBase.)
	ContainerComponent	Инфраструктура. (Унаследовано от ContentControlBase.)
	Creator	Возвращает 32-разрядное целое число, указывающее приложение, в котором был создан элемент управления DatePickerContentControl.
	DataBindings	Возвращает коллекцию объектов привязки данных для данного IBindableComponent. (Унаследовано от IBindableComponent.)
	DateCalendarType	Возвращает или задает тип календаря, отображаемого в элементе управления DatePickerContentControl.
	DateDisplayFormat	Возвращает или задает строку, в которой указывается формат дат, отображаемых в элементе управления DatePickerContentControl.
	DateDisplayLocale	Возвращает или задает языковой формат даты, отображаемой в элементе управления DatePickerContentControl.
	DateStorageFormat	Возвращает или задает форма, в котором элемент управления DatePickerContentControl будет сохранять данные в пользовательскую XML-часть.
	DefaultDataSourceUpdateMode	Получает или задает значение DataSourceUpdateMode по умолчанию для ContentControlBase. (Унаследовано от ContentControlBase.)
	DefaultTextStyle	Возвращает имя стиля знака, используемого для форматирования текста в элементе управления DatePickerContentControl.
	ID	Возвращает уникальное число, идентифицирующее элемент управления содержимым. (Унаследовано от ContentControlBase.)
	InnerObject	Получает базовый объект Microsoft.Office.Interop.Word.ContentControl для объекта Microsoft.Office.Tools.Word.ContentControlBase. (Унаследовано от ContentControlBase.)
	LockContentControl	Возвращает или задает значение, указывающее, можно ли удалить из документа элемент управления DatePickerContentControl.
	LockContents	Возвращает или задает значение, указывающее, можно ли изменять содержимое элемента управления DatePickerContentControl.
	MultiLine	Возвращает или задает значение, указывающее, может ли элемент управления DatePickerContentControl содержать разрывы строк.
	Parent	Возвращает родительский объект для элемента управления DatePickerContentControl.
	ParentContentControl	Возвращает родительский элемент управления содержимым для элемента управления DatePickerContentControl, вложенного в другой элемент управления содержимым.
	PlaceholderText	Возвращает или задает текст, отображаемый в элементе управления DatePickerContentControl, пока текст не будет изменен в результате действий пользователя или иной операции.
	Range	Получает объект Range, представляющий содержимое объекта DatePickerContentControl.
	ShowingPlaceholderText	Возвращает значение, указывающее, отображается ли в настоящее время в элементе управления DatePickerContentControl замещающий текст.
	Site	Возвращает или задает объект ISite, связанный с объектом IComponent. (Унаследовано от IComponent.)
	Tag	Возвращает или задает строку, которую необходимо связать с элементом управления DatePickerContentControl.
	Temporary	Возвращает или задает значение, указывающее, будет ли элемент управления DatePickerContentControl автоматически удаляться из документа при изменении этого элемента управления.
	Text	Возвращает или задает текст в элементе управления DatePickerContentControl.
	Title	Получает или задает заголовок DatePickerContentControl.
	XMLMapping	Возвращает объект XMLMapping, представляющий связь между элементом управления DatePickerContentControl и элементом в пользовательской XML-части.

В начало страницы

Методы

	Имя	Описание
	BeginInit	Подает сигнал объекту о начале инициализации. (Унаследовано от ISupportInitialize.)
	Copy	Копирует элемент управления DatePickerContentControl из документа в буфер обмена.
	Cut	Удаляет из документа элемент управления DatePickerContentControl и заносит его в буфер обмена.
	Delete	Удаляет из документа и коллекции ControlCollection динамически созданный элемент управления содержимым. (Унаследовано от ContentControlBase.)
	Dispose	Выполняет определяемые приложением задачи, связанные с высвобождением или сбросом неуправляемых ресурсов. (Унаследовано от IDisposable.)
	EndInit	Подает объекту сигнал о завершении инициализации. (Унаследовано от ISupportInitialize.)
	SetPlaceholderText	Выводит текст, хранящийся в объекте BuildingBlock, объекте Range или строке в качестве замещающего текста в элементе управления DatePickerContentControl.

В начало страницы

События

	Имя	Описание
	Added	Происходит после добавления в документ элемента управления содержимым. (Унаследовано от ContentControlBase.)
	BindingContextChanged	Происходит при изменении значения свойства BindingContext объекта ContentControlBase. (Унаследовано от ContentControlBase.)
	ContentUpdating	Происходит непосредственно перед тем, как приложение Microsoft Office Word обновляет текст в элементе управления содержимым, если этот элемент управления привязан к настраиваемой XML-части. (Унаследовано от ContentControlBase.)
	Deleting	Происходит непосредственно перед удалением из документа элемента управления содержимым. (Унаследовано от ContentControlBase.)
	Disposed	Представляет метод, обрабатывающий событие Disposed компонента. (Унаследовано от IComponent.)
	Entering	Происходит, когда пользователь щелкает мышью внутри элемента управления содержимым, либо при программном перемещении курсора внутрь элемента управления содержимым. (Унаследовано от ContentControlBase.)
	Exiting	Происходит, когда пользователь щелкает мышью за пределами элемента управления содержимым, либо при программном перемещении курсора за пределы элемента управления содержимым. (Унаследовано от ContentControlBase.)
	StoreUpdating	Происходит непосредственно перед тем, как приложение Microsoft Office Word обновляет в пользовательской XML-части, связанной с элементом управления содержимым (то есть после того, как изменится текст в элементе управления содержимым). (Унаследовано от ContentControlBase.)
	Validated	Происходит после успешной проверки элемента управления содержимым. (Унаследовано от ContentControlBase.)
	Validating	Происходит при проверке содержимого элемента управления. (Унаследовано от ContentControlBase.)

В начало страницы

Заметки

Элемент управления DatePickerContentControl предоставляет календарь, с помощью которого пользователи могут выбирать даты.Календарь появляется, когда пользователь щелкает стрелку раскрывающегося списка элемента управления.

Чтобы указать формат отображаемой даты, воспользуйтесь свойствами DateDisplayFormat и DateDisplayLocale.Чтобы выбрать местный календарь, воспользуйтесь свойством DateCalendarType.

Примечание
Данный интерфейс реализован набором средств Visual Studio Tools for Office (среда выполнения). Он не предназначен для реализации в пользовательском коде. Дополнительные сведения см. в разделе Общие сведения об инструментах Visual Studio для среды выполнения Office.

Элементы управления содержимым

Элемент управления DatePickerContentControl является одним из восьми типов элементов управления содержимым, используемых для разработки документов и шаблонов в приложении Microsoft Office Word.Элементы управления с содержимым обладают пользовательским интерфейсом с управляемым вводом, подобным тому, который используется в формах.С помощью элементов управления содержимым можно запретить пользователям редактировать защищенные разделы документа или шаблона; эти элементы управления также можно привязать к источнику данных.Дополнительные сведения см. в разделе Элементы управления содержимым.

Использование

В настоящей документации описывается версия этого типа, которая используется в проектах Office, предназначенных для платформ .NET Framework 4 и .NET Framework 4.5. В проектах, предназначенных для платформы .NET Framework 3.5, этот тип может содержать другие члены, а примеры кода, приведенные для этого типа, могут не работать. Документацию о данном типе в проектах, предназначенных для платформы .NET Framework 3.5, см. в следующем справочном разделе документации Visual Studio 2008: https://go.microsoft.com/fwlink/?LinkId=160658.

Примеры

В следующем примере кода в начало документа добавляется новый элемент управления DatePickerContentControl.В данном примере также изменяется формат, в котором элемент управления выводит даты.

Эта версия предназначена для настройки уровня документа.Чтобы воспользоваться этим кодом, вставьте его в проекте в класс ThisDocument и вызовите из метода ThisDocument_Startup метод AddDatePickerControlAtSelection.

Dim datePickerControl1 As Microsoft.Office.Tools.Word.DatePickerContentControl

Private Sub AddDatePickerControlAtSelection()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Me.Paragraphs(1).Range.Select()
    datePickerControl1 = Me.Controls.AddDatePickerContentControl("datePickerControl1")
    datePickerControl1.DateDisplayFormat = "MMMM d, yyyy"
    datePickerControl1.PlaceholderText = "Choose a date"
End Sub

private Microsoft.Office.Tools.Word.DatePickerContentControl datePickerControl1;

private void AddDatePickerControlAtSelection()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    this.Paragraphs[1].Range.Select();

    datePickerControl1 = this.Controls.AddDatePickerContentControl("datePickerControl1");
    datePickerControl1.DateDisplayFormat = "MMMM d, yyyy";
    datePickerControl1.PlaceholderText = "Choose a date";
}

Эта версия предназначена для надстройки уровня приложения.Чтобы воспользоваться этим кодом, вставьте его в проекте в класс ThisAddIn и вызовите из метода ThisAddIn_Startup метод AddDatePickerControlAtSelection.

Dim datePickerControl1 As Microsoft.Office.Tools.Word.DatePickerContentControl

Private Sub AddDatePickerControlAtSelection()
    If Me.Application.ActiveDocument Is Nothing Then
        Return
    End If

    Dim vstoDoc As Document = Globals.Factory.GetVstoObject(Me.Application.ActiveDocument)
    vstoDoc.Paragraphs(1).Range.InsertParagraphBefore()
    vstoDoc.Paragraphs(1).Range.Select()
    datePickerControl1 = vstoDoc.Controls.AddDatePickerContentControl("datePickerControl1")
    datePickerControl1.DateDisplayFormat = "MMMM d, yyyy"
    datePickerControl1.PlaceholderText = "Choose a date"
End Sub

private Microsoft.Office.Tools.Word.DatePickerContentControl datePickerControl1;

private void AddDatePickerControlAtSelection()
{
    if (this.Application.ActiveDocument == null)
        return;

    Document vstoDoc = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);
    vstoDoc.Paragraphs[1].Range.InsertParagraphBefore();
    vstoDoc.Paragraphs[1].Range.Select();

    datePickerControl1 = vstoDoc.Controls.AddDatePickerContentControl("datePickerControl1");
    datePickerControl1.DateDisplayFormat = "MMMM d, yyyy";
    datePickerControl1.PlaceholderText = "Choose a date";
}

См. также

Ссылки

Microsoft.Office.Tools.Word - пространство имен

Другие ресурсы

Элементы управления содержимым

Практическое руководство. Добавление элементов управления содержимым в документы Word

Практическое руководство. Защита частей документов с помощью элементов управления содержимым

Пошаговое руководство. Создание шаблона с помощью элементов управления содержимым