Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

Control - Classe

Office 2013 et versions ultérieures

Cette documentation est préliminaire et peut changer.

Définit la classe de contrôle. Lorsque l'objet est sérialisé en XML, son nom complet est w:control.

Espace de noms :  DocumentFormat.OpenXml.Wordprocessing
Assembly :  DocumentFormat.OpenXml (dans DocumentFormat.OpenXml.dll)

public class Control : OpenXmlLeafElement

[ISO/IEC 29500-1 1st Edition]

contrôle (contrôle incorporé)

Cet élément spécifie que l'objet incorporé parent est une représentation d'un contrôle intégré. Cet élément doit être utilisé pour associer les propriétés et les paramètres appropriés de contrôle incorporé lorsque le document est affiché.

Si le contrôle incorporé n'est pas présent, ne peut pas être chargé en raison des paramètres de l'application ou n'est pas pris en charge, une image d'espace réservé approprié doit être utilisée pour fournir une représentation de la présence d'un contrôle incorporé à l'emplacement approprié dans le document.

[Exemple: pensez à une série de tests qui se compose d'un contrôle intégré. Cette exécution serait spécifiée en utilisant le schéma WordprocessingML suivant :

<w:r>
  <w:object>
    …    <w:control r:id="rId99" w:shapeid="10" … />
  </w:object>
</w:r>

L'élément de contrôle indique que l'objet incorporé parent est un contrôle incorporé, dont les paramètres et les propriétés est stocké sur cet élément et la cible de la relation spécifiée à l'aide de l'attribut id (facultative). exemple de fin]

Éléments parents

objet (§17.3.3.19)

Attributs

Description

ID (référence de relation de propriétés contrôle incorporé)

Espace de noms : .../officeDocument/2006/relationships

Spécifie l'ID de relation pour la relation qui contient les propriétés de ce contrôle incorporé. Ce sac de propriétés se trouve dans une partie distincte dans le package Office Open XML.

La relation ciblée de manière explicite par cet attribut doit être de type http://schemas.openxmlformats.org/officeDocument/2006/relationships/control ou si le document doit être conisdered non conforme.

Si cet attribut est omis, puis le contrôle incorporé est accordée sans sac de propriété lorsqu'il est instancié.

[Exemple: pensez à la balise suivante de WordprocessingML pour un contrôle incorporé dans un document :

<w:control r:id="rId5" w:name="CheckBox1" w:shapeid="_x0000_s1027" />

L'attribut id dans l'espace de noms de référence de relation spécifie que la relation avec l' ID de relation rId5 doit contenir les données de propriété pour ce contrôle incorporé. exemple de fin]

Les valeurs possibles pour cet attribut sont définies par le type simple ST_RelationshipId (§22.8.2.1).

nom (nom Unique de contrôle incorporé)

Spécifie un nom unique pour ce contrôle incorporé. Ce nom doit être unique pour tous les contrôles dans ce document.

[Exemple: pensez à la balise suivante de WordprocessingML pour un contrôle incorporé dans un document :

<w:control r:id="rId5" w:name="CheckBox1" w:shapeid="_x0000_s1027" />

L'attribut name spécifie que le nom unique pour ce contrôle doit être CheckBox1. exemple de fin]

Les valeurs possibles pour cet attribut sont définies par le type simple ST_String (§22.9.2.13).

ShapeID (référence de la forme)

Spécifie l'ID de la forme d'une forme qui doit être utilisée pour définir la présentation et l'emplacement de ce contrôle incorporé dans le document si le contrôle est flottant à l'aide de la syntaxe DrawingML.

[Remarque: ces données de positionnement sont suffisantes pour afficher le contrôle dans tous les cas où :

  • Le contrôle incorporé n'est pas sur l'ordinateur actuel

  • Les contrôles imbriqués sont désactivées.

  • Les contrôles imbriqués de ce type de contrôle ne sont pas pris en charge.

fin de la Remarque]

Cette référence d'ID de forme est résolue en recherchant un objet DrawingML dont l'attribut id correspond à la valeur spécifiée dans cet attribut. Si aucune forme n'existe, puis le contrôle doit être rendu inline dans le contenu du document à l'emplacement du contenu exécution en cours.

Si cet attribut est omis, ce contrôle incorporé doit être affiché en ligne à l'emplacement actuel dans l'objet parent s'exécutent.

[Exemple: pensez à la balise suivante de WordprocessingML pour un contrôle incorporé dans un document :

<w:control r:id="rId5" w:name="CheckBox1" w:shapeid="10" />

L'attribut shapeid Spécifie que l'objet DrawingML avec une valeur d'attribut id 10 doit contenir les données de positionnement pour ce contrôle incorporé. exemple de fin]

Les valeurs possibles pour cet attribut sont définies par le type simple ST_String (§22.9.2.13).

[Remarque: le W3C XML Schema definition de cet élément modèle de contenu (CT_Control) se trouve dans §A.1. fin de la Remarque]

[ISO/IEC 29500-1 1st Edition]

contrôle (contrôle incorporé flottante)

Cet élément spécifie que l'objet VML parent est une représentation d'un contrôle incorporé à l'emplacement actuel dans le document. Cet élément doit être utilisé pour associer les données VML avec les propriétés et les paramètres appropriés de contrôle incorporé lorsque le document est affiché.

Si le contrôle incorporé n'est pas présent, ne peut pas être chargé en raison des paramètres de l'application ou n'est pas pris en charge, les données VML doivent être utilisées pour fournir une représentation image du contrôle à l'emplacement approprié dans le document.

[Exemple: pensez à une série de tests qui se compose d'un contrôle intégré. Cette exécution serait spécifiée en utilisant le schéma WordprocessingML suivant :

<w:r>
  <w:pict>
    …    <w:control r:id="rId99" w:shapeid="shape01" … />
  </w:pict>
</w:r>

L'élément de contrôle indique que l'objet VML parent contienne la positionnement et la dernière image connue représentation sous forme d'un contrôle incorporé, dont les paramètres et les propriétés est stockée sur cet élément. exemple de fin]

Éléments parents

PICT (§9.2.2.2) ; PICT (§9.5.1)

Attributs

Description

ID (référence de relation de propriétés contrôle incorporé)

Espace de noms : .../officeDocument/2006/relationships

Spécifie l'ID de relation pour la relation qui contient les propriétés de ce contrôle incorporé. Ce sac de propriétés se trouve dans une partie distincte dans le package Office Open XML.

La relation ciblée de manière explicite par cet attribut doit être de type http://schemas.openxmlformats.org/officeDocument/2006/relationships/control ou si le document doit être conisdered non conforme.

Si cet attribut est omis, puis le contrôle incorporé est accordée sans sac de propriété lorsqu'il est instancié.

[Exemple: pensez à la balise suivante de WordprocessingML pour un contrôle incorporé dans un document :

<w:control r:id="rId5" w:name="CheckBox1" w:shapeid="_x0000_s1027" />

L'attribut id dans l'espace de noms de référence de relation spécifie que la relation avec l' ID de relation rId5 doit contenir les données de propriété pour ce contrôle incorporé. exemple de fin]

Les valeurs possibles pour cet attribut sont définies par le type simple ST_RelationshipId (partie 1, §22.8.2.1).

nom (nom Unique de contrôle incorporé)

Spécifie un nom unique pour ce contrôle incorporé. Ce nom doit être unique pour tous les contrôles dans ce document.

[Exemple: pensez à la balise suivante de WordprocessingML pour un contrôle incorporé dans un document :

<w:control r:id="rId5" w:name="CheckBox1" w:shapeid="_x0000_s1027" />

L'attribut name spécifie que le nom unique pour ce contrôle doit être CheckBox1. exemple de fin]

Les valeurs possibles pour cet attribut sont définies par le type simple ST_String (partie 1, §22.9.2.13).

ShapeID (référence de la forme)

Spécifie l'ID de la forme d'une forme qui doit être utilisée pour définir la présentation et l'emplacement de ce contrôle incorporé dans le document si le contrôle est flottant à l'aide de la syntaxe DrawingML.

[Remarque: ces données de positionnement sont suffisantes pour afficher le contrôle dans tous les cas où :

  • Le contrôle incorporé n'est pas sur l'ordinateur actuel

  • Les contrôles imbriqués sont désactivées.

  • Les contrôles imbriqués de ce type de contrôle ne sont pas pris en charge.

fin de la Remarque]

Cette référence d'ID de forme est résolue en recherchant un objet DrawingML dont l'attribut id correspond à la valeur spécifiée dans cet attribut. Si aucune forme n'existe, puis le contrôle doit être rendu inline dans le contenu du document à l'emplacement du contenu exécution en cours.

Si cet attribut est omis, ce contrôle incorporé doit être affiché en ligne à l'emplacement actuel dans l'objet parent s'exécutent.

[Exemple: pensez à la balise suivante de WordprocessingML pour un contrôle incorporé dans un document :

<w:control r:id="rId5" w:name="CheckBox1" w:shapeid="10" />

L'attribut shapeid Spécifie que l'objet DrawingML avec une valeur d'attribut id 10 doit contenir les données de positionnement pour ce contrôle incorporé. exemple de fin]

Les valeurs possibles pour cet attribut sont définies par le type simple ST_String (partie 1, §22.9.2.13).

[Remarque: le W3C XML Schema definition de cet élément modèle de contenu (CT_Control) se trouve dans §A.1. fin de la Remarque]

© ISO/IEC29500: 2008.

Tous les membres statique (Partagé dans Visual Basic)s publics de ce type sont thread-safe. Cela n’est pas garanti pour les membres d’instance.
Afficher: