Vue d'ensemble des contrôles Windows Forms dans les documents Office
Mise à jour : Juillet 2008
S'applique à |
---|
Les informations de cette rubrique s'appliquent uniquement aux projets Visual Studio Tools pour Office et versions de Microsoft Office spécifiés. Projets au niveau du document
Projets au niveau de l'application
Pour plus d'informations, consultez Fonctionnalités disponibles par type d'application et de projet. |
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 programme au moment de l'exécution. À compter de Visual Studio 2008 Service Pack 1 (SP1), vous pouvez ajouter par programme ces contrôles à tout document ou feuille de calcul ouvert au moment de l'exécution dans un complément d'application pour Excel 2007 ou Word 2007.
Pour plus d'informations, consultez Comment : ajouter des contrôles Windows Forms à des documents 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 programme
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 fournit des méthodes d'assistance qui permettent d'ajouter les 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. Visual Studio Tools pour Office 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 ; Visual Studio Tools pour Office ne peut pas dériver d'une classe sealed.
La valeur true doit être affectée à l'attribut ComVisibleAttribute des contrôles utilisateur. Cet attribut des contrôles utilisateur créés à l'intérieur d'un projet Visual Studio Tools pour Office est défini par défaut sur la valeur true. Cette valeur ne peut par contre pas être affectée à l'attribut des contrôles utilisateur qui font partie de projets extérieurs.
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. 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. De même, si l'utilisateur ouvre le classeur sur un ordinateur sur lequel le runtime de Visual Studio Tools pour Office 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 affichée. 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 ou composants ne sont pas visibles sur le document et sont, à la place, affichés dans une barre d'état de composants. Visual Studio Tools pour Office fournit une barre d'état de 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
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
Vue d'ensemble du volet Actions
Limitations des contrôles Windows Forms dans les documents Office
Référence
Autres ressources
Contrôles sur des documents Office
Historique des modifications
Date |
Historique |
Raison |
---|---|---|
Juillet 2008 |
Ajout d'informations relatives à l'ajout de contrôles Windows Forms dans des documents à l'aide de compléments d'application. |
Modifications de fonctionnalités dans le SP1. |