Compartilhar via


Interface DatePickerContentControl

Representa um controle de selecionador de data em um documento.

Namespace:  Microsoft.Office.Tools.Word
Assembly:  Microsoft.Office.Tools.Word (em Microsoft.Office.Tools.Word.dll)

Sintaxe

'Declaração
<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

O tipo DatePickerContentControl expõe os membros a seguir.

Propriedades

  Nome Descrição
Propriedade pública Application Obtém um Microsoft.Office.Interop.Word.Application que representa a instância atual do Word de Microsoft Office.
Propriedade pública BindingContext Obtém ou define uma coleção dos gerenciadores de moeda para o IBindableComponent. (Herdado de IBindableComponent.)
Propriedade pública Container Infraestrutura. (Herdado de ContentControlBase.)
Propriedade pública ContainerComponent Infraestrutura. (Herdado de ContentControlBase.)
Propriedade pública Creator Obtém um inteiro de 32 bits que indica o aplicativo no qual o DatePickerContentControl foi criado.
Propriedade pública DataBindings Obtém a coleção de objetos de ligação de dados para este IBindableComponent. (Herdado de IBindableComponent.)
Propriedade pública DateCalendarType Obtém ou define o tipo de calendário é exibido na DatePickerContentControl.
Propriedade pública DateDisplayFormat Obtém ou define uma seqüência de caracteres que especifica o formato no qual o DatePickerContentControl exibe as datas.
Propriedade pública DateDisplayLocale Obtém ou define o formato de idioma da data que é exibido na DatePickerContentControl.
Propriedade pública DateStorageFormat Obtém ou define o formato no qual o DatePickerContentControl salva as datas em um part. XML personalizado
Propriedade pública DefaultDataSourceUpdateMode Obtém ou define o padrão DataSourceUpdateMode para o ContentControlBase. (Herdado de ContentControlBase.)
Propriedade pública DefaultTextStyle Obtém o nome do estilo de caractere que é usado para formatar o texto da DatePickerContentControl.
Propriedade pública ID Obtém um número exclusivo que identifica o controle de conteúdo. (Herdado de ContentControlBase.)
Propriedade pública InnerObject Obtém a base Microsoft.Office.Interop.Word.ContentControl de objeto para o Microsoft.Office.Tools.Word.ContentControlBase. (Herdado de ContentControlBase.)
Propriedade pública LockContentControl Obtém ou define um valor que especifica se o DatePickerContentControl pode ser excluído do documento.
Propriedade pública LockContents Obtém ou define um valor que especifica se o conteúdo da DatePickerContentControl pode ser editado.
Propriedade pública MultiLine Obtém ou define um valor que especifica se o DatePickerContentControl pode conter quebras de linha.
Propriedade pública Parent Obtém o pai do DatePickerContentControl.
Propriedade pública ParentContentControl Obtém o pai de controle de conteúdo uma DatePickerContentControl que está aninhado em outro controle de conteúdo.
Propriedade pública PlaceholderText Obtém ou define o texto exibido na DatePickerContentControl até que o texto é alterado por uma ação do usuário ou alguma outra operação.
Propriedade pública Range Obtém um Range que representa o conteúdo do DatePickerContentControl.
Propriedade pública ShowingPlaceholderText Obtém um valor que indica se a DatePickerContentControl atualmente está exibindo texto de espaço reservado.
Propriedade pública Site Obtém ou define o ISite associados a IComponent. (Herdado de IComponent.)
Propriedade pública Tag Obtém ou define uma seqüência de caracteres que você deseja associar a DatePickerContentControl.
Propriedade pública Temporary Obtém ou define um valor que especifica se o DatePickerContentControl é excluído automaticamente do documento quando o controle é editado.
Propriedade pública Text Obtém ou define o texto a DatePickerContentControl.
Propriedade pública Title Obtém ou define o título da DatePickerContentControl.
Propriedade pública XMLMapping Obtém um XMLMapping que representa a ligação entre o DatePickerContentControl e um elemento em um part. XML personalizado

Início

Métodos

  Nome Descrição
Método público BeginInit Sinaliza o objeto que a inicialização está iniciando. (Herdado de ISupportInitialize.)
Método público Copy Cópias do DatePickerContentControl do documento para a área de transferência.
Método público Cut Remove o DatePickerContentControl do documento e o adiciona à área de transferência.
Método público Delete Exclui um controle criado dinamicamente do conteúdo do documento e remove a partir do ControlCollection do documento. (Herdado de ContentControlBase.)
Método público Dispose Executa tarefas de definição de aplicativo associadas liberando, liberando ou redefinindo recursos não gerenciados. (Herdado de IDisposable.)
Método público EndInit Sinaliza o objeto que a inicialização for concluída. (Herdado de ISupportInitialize.)
Método público SetPlaceholderText Exibe o texto em um BuildingBlock, um Range, ou uma seqüência de texto de espaço reservado a DatePickerContentControl.

Início

Eventos

  Nome Descrição
Evento público Added Ocorre após o controle de conteúdo é adicionado ao documento. (Herdado de ContentControlBase.)
Evento público BindingContextChanged Ocorre quando o valor da BindingContext propriedade da ContentControlBase alterações. (Herdado de ContentControlBase.)
Evento público ContentUpdating Ocorre antes de Microsoft Office o Word atualiza o texto no controle content, se o controle de conteúdo está vinculado a um componente XML personalizado. (Herdado de ContentControlBase.)
Evento público Deleting Ocorre antes do controle de conteúdo é excluído do documento. (Herdado de ContentControlBase.)
Evento público Disposed Representa o método que manipula o Disposed o evento de um componente. (Herdado de IComponent.)
Evento público Entering Ocorre quando o usuário clica no controle content, ou quando o cursor é movido para o controle de conteúdo por meio de programação. (Herdado de ContentControlBase.)
Evento público Exiting Ocorre quando o usuário clica fora do controle de conteúdo, ou quando o cursor é movido programaticamente fora do controle de conteúdo. (Herdado de ContentControlBase.)
Evento público StoreUpdating Ocorre antes de Microsoft Office o Word atualiza dados em uma parte XML personalizada vinculada ao conteúdo do controle (ou seja, depois que o texto no conteúdo de controle de alterações). (Herdado de ContentControlBase.)
Evento público Validated Ocorre quando o controle de conteúdo foi validado com êxito. (Herdado de ContentControlBase.)
Evento público Validating Ocorre quando o conteúdo do controle de conteúdo está sendo validado. (Herdado de ContentControlBase.)

Início

Comentários

A DatePickerContentControl fornece um calendário que permite aos usuários selecionar uma data. O calendário é exibido quando o usuário final clica na seta suspensa no controle.

Para especificar o formato da data que é exibido, use o DateDisplayFormat e DateDisplayLocale Propriedades. Para escolher um calendário regional, use o DateCalendarType propriedade.

ObservaçãoObservação

Esta interface é implementada pelo Visual Studio Tools for Office runtime. Ela não se destina a ser implementada em seu código. Para obter mais informações, consulte Visual Studio Tools for Office visão geral sobre o tempo de execução.

Controles de conteúdo

O DatePickerContentControl é um dos oito tipos de controles de conteúdo que você pode usar para criar documentos e modelos do Word de Microsoft Office. Conteúdo de controles possuem uma interface de usuário (UI) que foi controlada entrada como um formulário. Você pode usar controles de conteúdo para impedir que usuários editem seções protegidas do documento ou modelo, e você também pode vincular controles de conteúdo a uma fonte de dados. For more information, see Controles de conteúdo.

Usage

Esta documentação descreve a versão deste tipo que é usada em projetos do Office destinados ao .NET Framework 4. Em projetos destinados ao .NET Framework 3.5, este tipo poderá ter membros diferentes, e os exemplos de código fornecidos para o tipo talvez não funcionem. Para obter documentação sobre este tipo em projetos destinados ao .NET Framework 3.5, consulte a seguinte seção de referência na documentação do Visual Studio 2008: https://go.microsoft.com/fwlink/?LinkId=160658.

Exemplos

O exemplo de código a seguir adiciona um novo DatePickerContentControl para o início do documento. O exemplo também modifica o formato no qual o controle exibe datas.

Esta versão é para uma personalização em nível de documento. Para usar esse código, colá-lo na ThisDocument classe em seu projeto e a chamada a AddDatePickerControlAtSelection método a partir do ThisDocument_Startup método.

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";
}

Esta versão é um suplemento em nível de aplicativo. Para usar esse código, colá-lo na ThisAddIn classe em seu projeto e a chamada a AddDatePickerControlAtSelection método a partir do ThisAddIn_Startup método.

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";
}

Consulte também

Referência

Namespace Microsoft.Office.Tools.Word

Outros recursos

Controles de conteúdo

Como: Adicionar controles de conteúdo para documentos do Word

Como: Proteger partes de documentos usando os controles de conteúdo

Demonstra Passo a passo: Criando um modelo usando os controles de conteúdo