Partager via


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 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 modifier le texte de l’espace réservé de la chaîne par défaut en quelque chose de plus approprié 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.

Toutes les propriétés de contrôles de contenu ne s'appliquent pas à tous leurs types. Le tableau suivant indique quelles propriétés sont applicables aux types de contrôles de contenu.

BuildingBlockCategory PropriétéContrôles de contenu BuildingBlock Gallery (wdContentControlBuildingBlockGallery)
BuildingBlockType PropriétéContrôles de contenu BuildingBlock Gallery (wdContentControlBuildingBlockGallery)
DateDisplayFormat PropriétéContrôles de contenu de date (wdContentControlDate)
DateDisplayLocale PropriétéContrôles de contenu de date (wdContentControlDate)
DateStorageFormat PropriétéContrôles de contenu de date (wdContentControlDate)
DropdownListEntries PropriétéContrôles de contenu de zone de liste déroulante et de liste déroulante (wdContentControlComboBox et wdContentControlDropdownList)
MultiLine PropriétéContrôles de contenu de texte brut (wdContentControlText)
Ungroup() MéthodeContrôles de contenu de groupe (wdContentControlGroup)

Propriétés

AllowInsertDeleteSection

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

Appearance

Renvoie ou définit l’apparence du contrôle de contenu. Lecture/écriture WdContentControlAppearance

Application

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

BuildingBlockCategory

Renvoie ou définit la catégorie d’un contrôle de contenu de bloc de construction. Lecture-écriture.

BuildingBlockType

Renvoie ou définit le type de bloc de construction d’un contrôle de contenu de bloc de construction. Lecture-écriture.

Checked

Obtient ou définit l’état actuel (activé/décoché) d’une case case activée.

Color

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

Renvoie ou définit le type de calendrier pour un contrôle de contenu de calendrier. Lecture-écriture.

DateDisplayFormat

Renvoie ou définit le format dans lequel les dates sont affichées. Lecture-écriture.

DateDisplayLocale

Renvoie un format de langue pour la date affichée dans un contrôle de contenu de date. Lecture-écriture.

DateStorageFormat

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. Lecture-écriture.

DefaultTextStyle

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. Lecture-écriture.

DropdownListEntries

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

ID

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

Level

Retourne 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 inline. 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. 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. Lecture-écriture.

MultiLine

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

Parent

Renvoie un qui représente l’objet parent de l’objet spécifié ContentControl .

ParentContentControl

Retourne le contrôle de contenu parent pour un contrôle de contenu imbriqué à l’intérieur d’un contrôle de texte enrichi ou d’un contrôle de groupe. En lecture seule.

PlaceholderText

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

Range

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

RepeatingSectionItems

Retourne la collection d’éléments de section répétitifs dans le contrôle de contenu de section répétitif spécifié. En lecture seule.

RepeatingSectionItemTitle

Renvoie ou définit le nom des éléments de section répétitifs utilisés dans le menu contextuel associé au contrôle de contenu de section répétitif spécifié. 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

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. Lecture-écriture.

Title

Renvoie ou définit le titre d’un contrôle de contenu. En lecture/écriture

Type

Renvoie ou définit le type d’un contrôle de contenu. En lecture/écriture

XMLMapping

Retourne le mappage d’un contrôle de contenu à des données XML dans le magasin 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 à