Vue d'ensemble des contrôles Windows Forms dans les documents Office

Article
03/04/2013

Les contrôles Windows Forms sont des objets qui permettent aux utilisateurs d'entrer ou de manipuler des données.Dans les projets au niveau du document pour Microsoft Office Excel et Microsoft Office Word, vous pouvez ajouter des contrôles Windows Forms au document ou classeur de votre projet au moment du design, ou par programmation au moment de l'exécution.Dans un complément d'application pour Excel ou Word, vous pouvez ajouter par programmation des contrôles à tout document ou feuille de calcul ouverte au moment de l'exécution.

Pour plus d’informations, consultez Comment : ajouter des contrôles Windows Forms à des documents Office.

S'applique à : Les informations contenues dans cette rubrique s'appliquent aux projets de niveau document et de niveau application pour les applications suivantes : Excel 2013, Excel 2010, Word 2013 et Word 2010. Pour en savoir plus, consultez Fonctionnalités disponibles par type d'application et de projet Office.

Utilisation de contrôles Windows Forms

Vous pouvez ajouter des contrôles Windows Forms aux documents et aux éléments personnalisables de l'interface utilisateur, notamment les volets Actions, les volets de tâches personnalisés et les Windows Forms.Les contrôles Windows Forms adoptent généralement le même comportement dans les documents que dans ces autres éléments d'interface, mais il existe certaines différences.Pour plus d'informations, consultez Limitations des contrôles Windows Forms dans les documents Office.

L'ajout ou non de contrôles Windows Forms à un document ou à un autre élément d'interface dépend de plusieurs facteurs.Lorsque vous concevez l'interface utilisateur de votre solution, vous pouvez utiliser les contrôles Windows Forms comme décrit dans le tableau suivant.

Dans un document
- Lorsque vous souhaitez afficher les contrôles en permanence.
- Lorsque vous souhaitez que les utilisateurs puissent entrer directement des données dans le document, par exemple, dans des formulaires où la surface d'édition est verrouillée.
- Lorsque vous souhaitez que les contrôles s'affichent alignés sur les données dans le document.Par exemple, si vous ajoutez des boutons à chaque ligne d'un objet de liste, vous voudrez qu'ils soient alignés sur chaque élément de liste.
Dans le volet Actions ou un volet de tâches personnalisé
- Lorsque vous souhaitez fournir des informations contextuelles à l'utilisateur.
- Si vous voulez que seuls les résultats apparaissent dans le document et pas les contrôles de requête ni les données.
- Lorsque vous souhaitez vous assurer que les contrôles ne sont pas imprimés avec le document.
- Lorsque vous souhaitez vous assurer que les contrôles n'interfèreront pas avec l'affichage du document.
Dans un Windows Form
- Lorsque vous souhaitez contrôler la taille de l'interface utilisateur.
- Lorsque vous voulez empêcher des utilisateurs de masquer ou de supprimer les contrôles.
- Lorsque vous souhaitez obtenir des informations de l'utilisateur et empêcher celui-ci d'agir sur le document tant que vous n'avez pas reçu les informations requises.

Ajout de contrôles Windows Forms par programmation

Vous pouvez ajouter des contrôles Windows Forms aux documents Word et aux feuilles de calcul Excel au moment de l'exécution.Visual Studio Tools pour Office Runtime fournit des méthodes d'assistance pour l'ajout des contrôles Windows Forms les plus courants.Ces méthodes d'assistance vous permettent d'ajouter rapidement des contrôles à votre document Office et d'accéder aux fonctionnalités de contrôle Windows Forms combinées et aux fonctionnalités Office de ces contrôles.

Pour plus d’informations, consultez Ajout de contrôles à des documents Office au moment de l'exécution.

Utilisation de contrôles Windows Forms dans des projets au niveau du document

Certains aspects de l'utilisation de contrôles Windows Forms dans les documents sont uniques aux projets au niveau du document, qui vous permettent de concevoir l'interface utilisateur de votre document en utilisant le concepteur Visual Studio.

Création de contrôles utilisateur personnalisés

Vous pouvez ajouter un contrôle utilisateur à votre projet, puis l'ajouter à la Boîte à outils.Vous pouvez ensuite faire glisser le contrôle utilisateur directement vers votre document de la même façon que si vous ajoutiez un contrôle Windows Forms à votre document.Gardez les points suivants à l'esprit lorsque vous créez des contrôles utilisateur :

Ne créez pas de contrôle utilisateur sealed.Lorsque vous faites glisser le contrôle vers votre document, Visual Studio génère une classe wrapper dérivée du contrôle utilisateur pour l'étendre et prendre en charge son utilisation dans le document.Si le contrôle utilisateur est sealed, Visual Studio ne peut pas générer la classe wrapper.
La valeur true doit être affectée à l'attribut ComVisibleAttribute des contrôles utilisateur.L'attribut des contrôles utilisateur créés à l'intérieur d'un projet Office a la valeur true par défaut, mais l'attribut des contrôles utilisateur faisant partie de projets extérieurs peuvent ne pas avoir la valeur true.
Après avoir ajouté un contrôle utilisateur au document, vous ne devez pas renommer ou supprimer la classe UserControl du projet.Si vous devez changer le nom d'un contrôle utilisateur, vous devez d'abord le supprimer du document, puis le rajouter après avoir modifié le nom.

Disposition des contrôles au moment du design

Si vous ajoutez plusieurs contrôles à vos documents Word et Excel au moment du design, vous pouvez rapidement définir l'alignement de tous les contrôles sélectionnés à l'aide des barres d'outils Microsoft Office Word et Microsoft Office Excel dans Visual Studio.Ces barres d'outils sont disponibles uniquement lorsqu'une feuille de calcul ou un document est ouvert dans le concepteur.

Lorsque vous sélectionnez plusieurs contrôles dans le concepteur, vous pouvez utiliser les boutons de barres d'outils suivants pour réorganiser les contrôles :

Aligner les côtés gauches
Aligner les centres
Aligner les côtés droits
Aligner les sommets
Aligner les milieux
Aligner les bases
Égaliser l'espacement horizontal
Égaliser l'espacement vertical

[!REMARQUE]

Dans les projets Word, ces boutons sont activés uniquement si les contrôles sélectionnés ne sont pas alignés par rapport au texte.Par défaut, les contrôles que vous ajoutez au document au moment du design sont alignés par rapport au texte.

Empêcher des données anciennes d'apparaître dans les classeurs Excel pendant le chargement

Lorsque vous ajoutez des contrôles Windows Forms à des documents ou à des feuilles de calcul au moment du design, ces contrôles restent dans le document lorsque l'utilisateur le ferme.Les contrôles ajoutés au moment du design sont également appelés des contrôles statiques.

Lorsque vous ouvrez un classeur Excel qui contient des contrôles statiques, le classeur affiche une bitmap du contrôle dans un contrôle ActiveX jusqu'à ce que le code de la personnalisation s'exécute et charge le contrôle à proprement parler.Excel crée cette bitmap et l'enregistre dans le classeur quand celui-ci est enregistré.La bitmap affiche le contrôle tel qu'il était lors du dernier enregistrement du classeur, y compris toutes les données affichées par le contrôle.Pour plus d'informations sur le contrôle ActiveX contenant des contrôles Windows Forms et des bitmaps, consultez Limitations des contrôles Windows Forms dans les documents Office.

Dans certains cas, par exemple lorsque l'utilisateur ouvre le classeur en mode Design, le code n'est pas chargé et seule la bitmap est affichée.Si l'utilisateur ouvre le classeur sur un ordinateur sur lequel Visual Studio Tools pour Office Runtime n'est pas installé, la personnalisation ne peut pas s'exécuter et charger les contrôles, par conséquent, seule la bitmap du contrôle est visible.Veillez à toujours supprimer les informations personnelles des contrôles sur les classeurs avant d'enregistrer le classeur et de l'envoyer à un autre utilisateur afin que vos informations personnelles ne soient pas involontairement divulguées.

Taille de contrôle correspondant à la taille des cellules dans une feuille de calcul Excel

Vous pouvez définir le contrôle pour qu'il soit automatiquement redimensionné lorsque la taille de la cellule parente est modifiée.Pour plus d’informations, consultez Comment : redimensionner des contrôles dans des cellules de feuille de calcul.

Ajout de composants partagés par toutes les feuilles de calcul

Vous pouvez ajouter des composants à partager entre toutes les feuilles de calcul (un DataSet, par exemple) au Concepteur de classeurs plutôt qu'aux feuilles de calcul.Ils apparaîtront dans la barre d'état des composants.

Formule pour inclure des contrôles sur une feuille de calcul Excel

Lorsque vous sélectionnez un contrôle dans Excel, vous voyez =EMBED("WinForms.Control.Host","") dans la Barre de formule.Ce texte est nécessaire et ne doit pas être supprimé.

Style de disposition des contrôles sur un document Word

Lorsque vous ajoutez un contrôle au document Word dans un projet au niveau du document en utilisant le concepteur Visual Studio, le contrôle est aligné sur le texte.Pour modifier le style de disposition du contrôle, cliquez avec le bouton droit sur le contrôle puis cliquez sur Format de contrôle.Sélectionnez un style d'habillage sur la page Mise en page de la boîte de dialogue Format de l'objet.

Lorsque vous ajoutez un contrôle à un document Word au moment de l'exécution, vous pouvez spécifier le style de disposition du nouveau contrôle en utilisant différentes surcharges de méthode Add<classe de contrôle> de la classe Microsoft.Office.Tools.Word.ControlCollection:

Pour ajouter le contrôle et l'aligner sur le texte, utilisez une surcharge qui accepte un Range qui spécifie l'emplacement du contrôle.
Pour ajouter le contrôle comme une forme flottante, utilisez une surcharge qui accepte les coordonnées gauche et supérieure du contrôle.

Pour plus d’informations, consultez Ajout de contrôles à des documents Office au moment de l'exécution.

Si vous ouvrez un modèle Word dans le concepteur de Visual Studio, des contrôles non alignés sur le modèle peuvent ne pas être visibles car Visual Studio ouvre le modèle dans une vue Normale.Pour voir les contrôles, modifiez la vue en mode Page.

Contrôles à l'extérieur de le corps du document principal

Les contrôles Windows Forms ne sont pris en charge ni à l'intérieur d'un en-tête ou d'un pied de page ni dans un sous-document.

Ajout de composants au moment du design

Certains contrôles et composants n'apparaissent pas dans le document mais dans une barre d'état des composants.Visual Studio fournit une barre d'état des composants pour chaque fenêtre de document.La barre d'état des composants n'apparaît à l'écran que si le document comporte des composants.

Voir aussi

Partager via