ContentControl Interface

Définition

Contrôle de contenu spécifique. Les contrôles de contenu sont des régions liées et potentiellement étiquetées d’un document qui servent de conteneur pour des types de contenu spécifiques. Chaque contrôle de contenu peut comporter des dates, des listes ou des paragraphes de texte mis en forme. L’objet ContentControl est un membre de la ContentControls collection.

public interface class ContentControl
[System.Runtime.InteropServices.Guid("EE95AFE3-3026-4172-B078-0E79DAB5CC3D")]
public interface ContentControl
type ContentControl = interface
Public Interface ContentControl
Attributs

Remarques

Utilisez la Add(WdContentControlType, Object) méthode de la ContentControls collection pour créer un contrôle de contenu. Utilisez le Type paramètre de la méthode Add pour spécifier le type de contrôle de contenu à créer.

Utilisez la Type propriété pour remplacer le contrôle de contenu par un autre type de contrôle de contenu. Néanmoins, vous risquez de ne pas pouvoir modifier le type de tous les contrôles de contenu. En effet, la modification de certains types de contenu n’est pas autorisée. En outre, il est possible que le type d’un contrôle de contenu ne puisse pas être modifié à cause de son contenu. Par exemple, si le contrôle de contenu à modifier n’autorise pas le type de contenu figurant dans le contrôle existant, vous ne pouvez pas modifier le type du contrôle, au risque de générer une erreur d’exécution.

Utilisez la SetPlaceholderText(BuildingBlock, Range, String) méthode pour remplacer le texte d’espace réservé par défaut par une valeur plus appropriée pour le contrôle. Utilisez la Title propriété pour spécifier le texte du titre du contrôle. Celui-ci s’affiche au-dessus du contrôle lorsque le curseur est situé dans le contrôle ou lorsque le pointeur de la souris se trouve sur le contrôle.

En fonction du type de votre contrôle de contenu, certaines propriétés et méthodes de l’objet ContentControl risquent de ne pas être utilisables.

Not all content control properties apply to all the different types of content controls. The following table lists which properties apply to which types of content controls.

BuildingBlockCategory propertyBuildingBlock Gallery content controls (wdContentControlBuildingBlockGallery)
BuildingBlockType propertyBuildingBlock Gallery content controls (wdContentControlBuildingBlockGallery)
DateDisplayFormat propertyDate content controls (wdContentControlDate)
DateDisplayLocale propertyDate content controls (wdContentControlDate)
DateStorageFormat propertyDate content controls (wdContentControlDate)
DropdownListEntries propertyCombo box and drop-down list content controls (wdContentControlComboBox and wdContentControlDropdownList)
MultiLine propertyPlain text content controls (wdContentControlText)
Ungroup() methodGroup content controls (wdContentControlGroup)

Propriétés

AllowInsertDeleteSection

Obtient ou définit si les utilisateurs peuvent ajouter ou supprimer des sections dans le contrôle de contenu de section extensible spécifié à l’aide de l’interface utilisateur.

Appearance

Cette propriété renvoie ou définit l’apparence du contrôle de contenu. En lecture/écritureWdContentControlAppearance

Application

Renvoie un _Application Object qui représente l’application Microsoft Word.

BuildingBlockCategory

Cette propriété renvoie ou définit la catégorie pour un contrôle de contenu de bloc de construction. En lecture/écriture

BuildingBlockType

Cette propriété renvoie ou définit le type de bloc de construction pour un contrôle de contenu de bloc de construction. En lecture/écriture

Checked

Obtient ou définit l’état actuel (activé/désactivé) d’une case à cocher.

Color

Cette propriété renvoie ou définit la couleur du contrôle de contenu. En lecture/écriture WdColor .

Creator

Renvoie un entier 32 bits qui indique l'application dans laquelle le complément a été créé. En lecture seule.

DateCalendarType

Cette propriété renvoie ou définit le type de calendrier pour un contrôle de contenu de calendrier. En lecture/écriture

DateDisplayFormat

Cette propriété renvoie ou définit le format dans lequel les dates sont affichées. En lecture/écriture

DateDisplayLocale

Renvoie un format de langue pour la date affichée dans un contrôle de contenu de date. En lecture/écriture

DateStorageFormat

Cette propriété renvoie ou définit le format de stockage et de récupération des dates lorsqu’un contrôle de contenu de date est lié au magasin de données XML du document actif. En lecture/écriture

DefaultTextStyle

Cette propriété renvoie ou définit le nom du style de caractère à utiliser pour mettre en forme le texte dans un contrôle de contenu de texte. En lecture/écriture

DropdownListEntries

Renvoie les éléments d’un contrôle de contenu de liste déroulante ou de zone de liste déroulante. En lecture seule.

ID

Renvoie l’identification d’un contrôle de contenu. En lecture seule.

Level

Renvoie le niveau du contrôle de contenu, que le contrôle de contenu entoure du texte, des paragraphes, des cellules de tableau ou des lignes de tableau ; ou s’il est incorporé. En lecture seule WdContentControlLevel .

LockContentControl

Cette propriété renvoie ou définit un type Boolean qui indique si l'utilisateur peut supprimer un contrôle de contenu à partir du document actif. En lecture/écriture

LockContents

Cette propriété renvoie ou définit un type Boolean qui indique si l'utilisateur peut modifier le contenu d'un contrôle de contenu. En lecture-écriture.

MultiLine

Renvoie un type Boolean qui indique si un contrôle de contenu de texte autorise plusieurs lignes de texte. En lecture-écriture.

Parent

Renvoie une valeur qui représente l’objet parent de l' ContentControl objet spécifié.

ParentContentControl

Renvoie le contrôle de contenu parent pour un contrôle de contenu qui est imbriqué dans un contrôle de texte enrichi ou un contrôle de groupe. En lecture seule.

PlaceholderText

Renvoie un BuildingBlock Object qui représente le texte de l’espace réservé pour un contrôle de contenu. En lecture seule.

Range

Renvoie un Range qui représente le contenu du contrôle de contenu dans le document actif. En lecture seule.

RepeatingSectionItems

Renvoie la collection d’éléments de section extensible dans le contrôle de contenu de section extensible spécifié. En lecture seule.

RepeatingSectionItemTitle

Cette propriété renvoie ou définit le nom des éléments de section extensible utilisés dans le menu contextuel associé au contrôle de contenu de section extensible spécifié. En lecture/écriture

ShowingPlaceholderText

Renvoie un type Boolean qui indique si le texte d'espace réservé pour le contrôle de contenu est affiché. En lecture seule.

Tag

Cette propriété renvoie ou définit une valeur pour identifier un contrôle de contenu. En lecture/écriture

Temporary

Cette propriété renvoie ou définit un type Boolean qui indique s'il faut supprimer un contrôle de contenu à partir du document actif lorsque l'utilisateur modifie le contenu du contrôle. En lecture-écriture.

Title

Cette propriété renvoie ou définit le titre d’un contrôle de contenu. En lecture/écriture

Type

Cette propriété renvoie ou définit le type d’un contrôle de contenu. En lecture/écriture

XMLMapping

Renvoie le mappage d’un contrôle de contenu sur des données XML dans la Banque de données d’un document. En lecture seule.

Méthodes

Copy()

Copie le contrôle de contenu du document actif dans le Presse-papiers.

Cut()

Supprime le contrôle de contenu du document actif et le place dans le Presse-papiers.

Delete(Boolean)

Supprime le contrôle de contenu spécifié et son contenu.

SetCheckedSymbol(Int32, String)

Définit le symbole utilisé pour représenter l'état activé d'un contrôle de contenu de case à cocher.

SetPlaceholderText(BuildingBlock, Range, String)

Définit le texte de l'espace réservé qui s'affiche dans le contrôle de contenu jusqu'à ce qu'un utilisateur entre son propre texte.

SetUncheckedSymbol(Int32, String)

Définit le symbole utilisé pour représenter l'état désactivé d'un contrôle de contenu de case à cocher.

Ungroup()

Supprime un contrôle de contenu de groupe dans un document pour que ses contrôles enfants ne soient plus imbriqués et pour autoriser leur modification.

S’applique à