Vue d'ensemble des contrôles Windows Forms dans les documents Office
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 2007, Excel 2010, Word 2007 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
Notes
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. Pour plus d'informations, consultez Utilisation de contrôles Windows Forms sur des documents Word.
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.
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
Tâches
Comment : ajouter des contrôles Windows Forms à des documents Office
Comment : redimensionner des contrôles dans des cellules de feuille de calcul
Comment : masquer des contrôles sur des feuilles de calcul lors de l'impression
Procédure pas à pas : modification de la mise en forme d'un document à l'aide de contrôles CheckBox
Procédure pas à pas : affichage de texte dans une zone de texte d'un document à l'aide d'un bouton
Référence
Concepts
Utilisation de contrôles Windows Forms sur des documents Word
Utilisation de contrôles Windows Forms sur des feuilles de calcul Excel
Ajout de contrôles à des documents Office au moment de l'exécution
Vue d'ensemble des éléments hôtes et des contrôles hôtes
Limitations des contrôles Windows Forms dans les documents Office
Autres ressources
Contrôles sur des documents Office