DatePickerContentControl, interface
Représente un contrôle de sélecteur de dates dans un document.
Espace de noms : Microsoft.Office.Tools.Word
Assembly : Microsoft.Office.Tools.Word (dans Microsoft.Office.Tools.Word.dll)
Syntaxe
'Déclaration
<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
Le type DatePickerContentControl expose les membres suivants.
Propriétés
Nom | Description | |
---|---|---|
Application | Obtient une Microsoft.Office.Interop.Word.Application qui représente l'instance actuelle de Microsoft Office Word. | |
BindingContext | Obtient ou définit la collection de gestionnaires de devise pour IBindableComponent. (Hérité de IBindableComponent.) | |
Container | Infrastructure. (Hérité de ContentControlBase.) | |
ContainerComponent | Infrastructure. (Hérité de ContentControlBase.) | |
Creator | Obtient un entier 32 bits qui indique l'application dans laquelle le DatePickerContentControl a été créé. | |
DataBindings | Obtient la collection d'objets de liaison de données pour ce IBindableComponent. (Hérité de IBindableComponent.) | |
DateCalendarType | Obtient ou définit le type de calendrier affiché dans le DatePickerContentControl. | |
DateDisplayFormat | Obtient ou définit une chaîne qui spécifie le format dans lequel le DatePickerContentControl affiche les dates. | |
DateDisplayLocale | Obtient ou définit le format de langage de la date affichée dans le DatePickerContentControl. | |
DateStorageFormat | Obtient ou définit le format dans lequel le DatePickerContentControl enregistre les dates dans une partie XML personnalisée. | |
DefaultDataSourceUpdateMode | Obtient ou définit la valeur DataSourceUpdateMode par défaut de ContentControlBase. (Hérité de ContentControlBase.) | |
DefaultTextStyle | Obtient le nom du style de caractère utilisé pour mettre en forme le texte dans le DatePickerContentControl. | |
ID | Obtient un nombre unique qui identifie le contrôle de contenu. (Hérité de ContentControlBase.) | |
InnerObject | Obtient l'objet Microsoft.Office.Interop.Word.ContentControl sous-jacent de Microsoft.Office.Tools.Word.ContentControlBase. (Hérité de ContentControlBase.) | |
LockContentControl | Obtient ou définit une valeur qui spécifie si le DatePickerContentControl peut être supprimé du document. | |
LockContents | Obtient ou définit une valeur qui spécifie si le contenu de DatePickerContentControl peut être modifié. | |
MultiLine | Obtient ou définit une valeur qui spécifie si le DatePickerContentControl peut contenir des sauts de ligne. | |
Parent | Définit le parent du DatePickerContentControl. | |
ParentContentControl | Obtient le contrôle de contenu parent d'un DatePickerContentControl imbriqué dans un autre contrôle de contenu. | |
PlaceholderText | Obtient ou définit le texte affiché dans le DatePickerContentControl jusqu'à ce que le texte soit modifié par une action utilisateur ou une autre opération. | |
Range | Obtient un Range qui représente le contenu du DatePickerContentControl. | |
ShowingPlaceholderText | Obtient une valeur qui indique si le DatePickerContentControl affiche actuellement le texte de l'espace réservé. | |
Site | Obtient ou définit le ISite associé à IComponent. (Hérité de IComponent.) | |
Tag | Obtient ou définit une chaîne à associer au DatePickerContentControl. | |
Temporary | Obtient ou définit une valeur qui spécifie si le DatePickerContentControl est supprimé automatiquement du document lorsque le contrôle est modifié. | |
Text | Obtient ou définit le texte dans le DatePickerContentControl. | |
Title | Obtient ou définit le titre de la DatePickerContentControl. | |
XMLMapping | Obtient un XMLMapping qui représente la liaison entre le DatePickerContentControl et un élément dans une partie XML personnalisée. |
Début
Méthodes
Nom | Description | |
---|---|---|
BeginInit | Signale à l'objet que l'initialisation démarre. (Hérité de ISupportInitialize.) | |
Copy | Copie le DatePickerContentControl du document vers le Presse-papiers. | |
Cut | Supprime le DatePickerContentControl du document et l'ajoute au Presse-papiers. | |
Delete | Supprime un contrôle de contenu créé dynamiquement du document et le retire de ControlCollection dans le document. (Hérité de ContentControlBase.) | |
Dispose | Exécute les tâches définies par l'application associées à la libération ou à la redéfinition des ressources non managées. (Hérité de IDisposable.) | |
EndInit | Signale à l'objet que l'initialisation est terminée. (Hérité de ISupportInitialize.) | |
SetPlaceholderText | Affiche le texte qui se trouve dans BuildingBlock, Range ou une chaîne sous forme de texte d'espace réservé dans DatePickerContentControl. |
Début
Événements
Nom | Description | |
---|---|---|
Added | Se produit après l'ajout du contrôle de contenu au document. (Hérité de ContentControlBase.) | |
BindingContextChanged | Se produit lorsque la valeur de la propriété BindingContext de ContentControlBase est modifiée. (Hérité de ContentControlBase.) | |
ContentUpdating | Se produit juste avant que Microsoft Office Word mette à jour le texte dans le contrôle de contenu, si ce dernier est lié à une partie XML personnalisée. (Hérité de ContentControlBase.) | |
Deleting | Se produit juste avant que le contrôle de contenu soit supprimé du document. (Hérité de ContentControlBase.) | |
Disposed | Représente la méthode qui gère l'événement Disposed d'un composant. (Hérité de IComponent.) | |
Entering | Se produit lorsque l'utilisateur clique dans le contrôle de contenu ou lorsque le curseur est amené par programme dans le contrôle de contenu. (Hérité de ContentControlBase.) | |
Exiting | Se produit lorsque l'utilisateur clique en dehors du contrôle de contenu, ou lorsque le curseur quitte le contrôle de contenu par programme. (Hérité de ContentControlBase.) | |
StoreUpdating | Se produit juste avant que Microsoft Office Word mette à jour les données dans une partie XML personnalisée liée au contrôle de contenu (à savoir, après la modification du texte dans le contrôle de contenu). (Hérité de ContentControlBase.) | |
Validated | Se produit lorsque le contrôle de contenu a été validé. (Hérité de ContentControlBase.) | |
Validating | Se produit lorsque le contenu du contrôle est validé. (Hérité de ContentControlBase.) |
Début
Notes
Un DatePickerContentControl fournit un calendrier qui permet aux utilisateurs de sélectionner une date. Le calendrier apparaît lorsque l'utilisateur final clique sur la flèche de liste déroulante dans le contrôle.
Pour spécifier le format de la date affichée, utilisez les propriétés DateDisplayFormat et DateDisplayLocale. Pour choisir un calendrier régional, utilisez la propriété DateCalendarType.
Notes
Cette interface est implémentée par Visual Studio Tools pour Office Runtime. Elle n'est pas destinée à être implémentée dans votre code. Pour plus d'informations, consultez Vue d'ensemble de Visual Studio Tools pour Office Runtime.
Contrôles de contenu
Le DatePickerContentControl est l'un des huit types de contrôles de contenu que vous pouvez utiliser pour créer des documents et des modèles dans Microsoft Office Word. Les contrôles de contenu ont une interface utilisateur (IU) dont les entrées sont contrôlées comme dans le cas d'un formulaire. Vous pouvez utiliser des contrôles de contenu pour empêcher les utilisateurs de modifier des sections protégées du document ou du modèle et vous pouvez également lier des contrôles de contenu à une source de données. Pour plus d'informations, consultez Contrôles de contenu.
Utilisation
Cette documentation décrit la version de ce type utilisée dans les projets Office qui ciblent .NET Framework 4 et .NET Framework 4.5. Dans les projets qui ciblent .NET Framework 3.5, ce type peut contenir d'autres membres, et les exemples de code qui y figurent sont susceptibles de ne pas fonctionner. Pour obtenir de la documentation sur ce type dans les projets ciblant .NET Framework 3.5, consultez la section de référence suivante dans la documentation Visual Studio 2008 : https://go.microsoft.com/fwlink/?LinkId=160658.
Exemples
L'exemple de code suivant ajoute un nouveau DatePickerContentControl au début du document. L'exemple modifie également le format dans lequel le contrôle affiche les dates.
Cette version est destinée à une personnalisation au niveau du document. Pour utiliser ce code, collez-le dans la classe ThisDocument de votre projet, puis appelez la méthode AddDatePickerControlAtSelection à partir de la méthode ThisDocument_Startup.
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";
}
Cette version est destinée à un complément d'application. Pour utiliser ce code, collez-le dans la classe ThisAddIn de votre projet, puis appelez la méthode AddDatePickerControlAtSelection à partir de la méthode ThisAddIn_Startup.
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";
}
Voir aussi
Référence
Microsoft.Office.Tools.Word, espace de noms
Autres ressources
Comment : ajouter des contrôles de contenu à des documents Word
Comment : protéger des parties de documents à l'aide de contrôles de contenu
Procédure pas à pas : création d'un modèle à l'aide de contrôles de contenu