Partager via


Utilisation des fenêtres de formulaires

Lorsque vous utilisez un formulaire InfoPath par programmation, vous pouvez écrire du code pour accéder à ses fenêtres et personnaliser certains éléments qu'elles contiennent. Le modèle objet InfoPath fourni par l'espace de noms Microsoft.Office.InfoPath prend en charge l'accès aux fenêtres d'un formulaire par le biais de la classe Window associée à la classe WindowCollection.

InfoPath inclut deux types de fenêtres :

  • Fenêtre de modification utilisée lors du remplissage d'un formulaire.

  • Fenêtre de conception utilisée lors de la conception d'un modèle de formulaire par l'utilisateur.

Lorsque vous écrivez du code dans un modèle de formulaire, celui-ci représente la fenêtre d'édition qui fournit les fonctionnalités les plus utiles, car vous pouvez utiliser un objet Window qui fait référence à la fenêtre actuelle pour accéder aux différentes propriétés et méthodes qui permettent de personnaliser la mise en forme du formulaire.

Vue d'ensemble de la classe WindowsCollection

La classe WindowsCollection fournit les propriétés suivantes destinées aux développeurs de modèles pour la gestion des objets Window qu'elle contient.

Nom Description

Propriété Count

Récupère le nombre d'objets Window contenus dans la collection.

Propriété Item

Obtient une référence vers l'objet Window spécifié.

Vue d'ensemble de la classe Window

La classe Window fournit les méthodes et les propriétés suivantes destinées aux développeurs de formulaires pour interagir avec une fenêtre InfoPath. La prise en charge de ces méthodes et propriétés dépend du type de fenêtre (WindowType) que vous utilisez. Certaines méthodes et propriétés fonctionnent uniquement avec les fenêtres d'édition (WindowType.Editor). Les autres méthodes et propriétés fonctionnent à la fois avec les fenêtres d'édition et les fenêtres de création (WindowType.Designer). Par ailleurs, comme pour tous les membres de modèles objets InfoPath, la prise en charge des méthodes et propriétés varie selon le niveau de sécurité et les modalités de déploiement du formulaire lorsque cette prise en charge est invoquée à partir d'un modèle de formulaire.

Nom Description Prise en charge des types de fenêtres

Méthode Activate

Active (concentre l'affichage sur) la fenêtre.

Types Designer et Editor

Propriété Active

Obtient une valeur Boolean qui indique si la fenêtre est active actuellement.

Types Designer et Editor

Propriété Caption

Obtient ou définit le texte de légende de la fenêtre représentée par l'objet Window.

Type Editor uniquement

Méthode Close

Ferme la fenêtre et vous invite à enregistrer les modifications effectuées dans un formulaire non enregistré, ou un formulaire qui comporte des modifications non enregistrées.

Type Editor uniquement

Méthode Close

Ferme la fenêtre et force le cas échéant la fermeture sans enregistrement d'un formulaire non enregistré ou d'un formulaire qui contient des modifications non enregistrées.

Type Editor uniquement

Propriété CommandBars

Obtient une référence à la collection Microsoft Office CommandBars qui est associée à la fenêtre.

Types Designer et Editor

Propriété Height

Obtient ou définit la hauteur de la fenêtre, mesurée en points.

Types Designer et Editor

Propriété Left

Obtient ou définit la position horizontale de la fenêtre, mesurée en points.

Types Designer et Editor

Propriété MailEnvelope

Obtient une référence à la classe MailEnvelope.

Type Editor uniquement

Propriété TaskPanes

Obtient une référence à la collection TaskPaneCollection.

Types Designer et Editor

Propriété Top

Obtient ou définit la position verticale de la fenêtre, mesurée en points.

Types Designer et Editor

Propriété Width

Obtient ou définit la largeur de la fenêtre, mesurée en points.

Types Designer et Editor

Propriété WindowState

Obtient ou définit l'état de la fenêtre sous la forme d'une valeur WindowState.

Types Designer et Editor

Propriété WindowType

Obtient le type de la fenêtre sous la forme d'une valeur d'énumération WindowType.

Types Designer et Editor

Propriété XmlForm

Retourne une référence à l'objet XmlForm associé à la fenêtre.

Type Editor uniquement

Utilisation des classes WindowsCollection et Window

La classe WindowsCollection est accessible par le biais de la propriété Windows de la classe Application. Lorsque vous utilisez la classe WindowsCollection pour accéder aux fenêtres d'un formulaire, vous utilisez un indexeur (pour Visual C#) ou passez un entier long à la propriété Item (pour Visual Basic) afin qu'elle retourne une référence à une instance de l'objet Window. Par exemple, le code suivant définit une référence au premier objet Window contenu dans la collection WindowsCollection de la session InfoPath active.

Window myWindow = this.Application.Windows[0];
Dim myWindow As Window = Me.Application.Windows(0)

Vous pouvez accéder directement à la fenêtre actuellement ouverte à l'aide de la propriété ActiveWindow de la classe Application, sans passer par la collection WindowsCollection, comme le représente la ligne de code suivante.

Window myWindow = this.Application.ActiveWindow;
Dim myWindow As Window = Me.Application.ActiveWindow

Un objet Window est également accessible à l'aide de la propriété Window de la classe View qui représente l'affichage actuellement utilisé pour travailler sur le document XML sous-jacent du formulaire. La propriété CurrentView de la classe XmlForm permet d'accéder à un objet View qui représente l'affichage actuel. Par exemple, le code suivant définit une référence à l'élément Window qui est associé à l'affichage actuel.

Window myWindow = this.CurrentView.Window;
Dim myWindow As Window = Me.CurrentView.Window
Remarque

Certaines propriétés et méthodes de la classe Window concernent uniquement le type de la fenêtre d'édition. Elles retournent une erreur si elles sont utilisées avec le type de la fenêtre de conception. Les propriétés et les méthodes prises en charge pour chaque type de fenêtre sont répertoriées dans le tableau plus haut dans cette rubrique. Vous pouvez utiliser la propriété WindowType dans le code pour déterminer le type de fenêtre que vous utilisez.