Propriétés de VI (ActiveX)
- Mise à jour2025-07-30
- Temps de lecture : 9 minute(s)
Un objet VirtualInstrument exporte des propriétés qui affectent un VI donné. Une instance d'un objet VirtualInstrument est créée en appelant la fonction GetVIReference sur l’objet Application.
Dans les rubriques suivantes, un astérisque (*) après le nom du type de données indique que la propriété est un pointeur. Les paramètres de propriétés suivis de [] sont facultatifs pour cette propriété.
Reportez-vous aux Énumérations ActiveX pour obtenir des informations complémentaires sur les énumérations utilisées dans les différentes propriétés.
Propriétés
| Propriété | Description |
|---|---|
| AllowDebugging | Si ce paramètre est défini à VRAI, vous pouvez utiliser les outils de mise au point sur le VI. Définissez cette propriété à FAUX pour minimiser les besoins de mémoire et améliorer légèrement les performances du VI. |
| BDModificationBitSet | Indique les modifications apportées au diagramme depuis que le VI a été enregistré ou ouvert, en fonction de la dernière opération. Si cette valeur est zéro, aucun changement n'a été effectué. Si cette valeur n'est pas zéro, des changements ont été effectués. Cette propriété est en lecture seule. |
| BDSize | Taille du diagramme LabVIEW en octets. Cette propriété est en lecture seule. |
| Callers | Renvoie la liste de tous les VIs chargés qui appellent le VI référencé. Cette propriété est en lecture seule. |
| CloneName | Nom du VI clone. Renvoie une erreur si le VI n'est pas un clone. |
| CloseFPAfterCall | Indique si la face-avant LabVIEW doit être fermée après exécution du VI. |
| CodeSize | Quantité de mémoire utilisée pour le code du VI en octets. Cette propriété est en lecture seule. |
| DataSize | Quantité de mémoire allouée aux données en octets. Vous ne pouvez pas lire cette propriété si le VI est en cours d'exécution. Cette propriété est en lecture seule. |
| Description | Description du VI qui apparaît dans la fenêtre d'Aide contextuelle LabVIEW lorsque vous placez le curseur sur l'icône du VI ainsi que dans toute la documentation du VI que vous générez. |
| EditMode | Si cette option est définie à VRAI, le VI s'ouvre en mode édition. Si elle est définie à FAUX, le VI s'ouvre en mode exécution et la barre de titre, la barre de menus et la barre d'outils ne s'affichent pas. |
| ExecInlining | Spécifie s'il faut incorporer le code du sous-VI dans ses VIs appelants. |
| ExecIsInlineable | Renvoie VRAI si vous pouvez incorporer le code de ce sous-VI dans ses VIs appelants. |
| ExecPriority | Indique la priorité du VI lorsqu'il s'exécute en parallèle avec d'autres tâches. |
| ExecState | Indique l'état d'exécution du VI. |
| ExpandWhenDroppedAsSubVI | Se développe pour afficher les terminaux s'il est déposé comme sous-VI. |
| FPAllowRTPopup | Indique si les menus locaux doivent s'afficher ou non pour les objets de la face-avant LabVIEW pendant l'exécution du VI. Si vous n'affichez pas les menus locaux d'exécution par défaut, vous pouvez continuer à inclure des menus locaux personnalisés. |
| FPBehavior | Définit le comportement de la fenêtre de la face-avant LabVIEW. Les valeurs valides comprennent 0 ( Invalid ), 1 (Default ), 2 (Floating ), 3 (Floating/Auto-Hide ), et 4 (Modal ). |
| FPHiliteReturnButton | Indique si les commandes booléennes qui ont le raccourci clavier <Entrée> doivent être mises en surbrillance. |
| FPKeepWinProps | Spécifie si la fenêtre de la face-avant LabVIEW ajuste sa taille proportionnellement à un changement de résolution de l'écran. La fenêtre change de taille de manière à couvrir le même pourcentage de l'écran qu'avec la résolution initiale. |
| FPMinimizable | Indique si l'utilisateur peut minimiser la fenêtre de la face-avant LabVIEW pendant l'exécution du VI. |
| FPModificationBitSet | Indique si des modifications ont été apportées à la face-avant LabVIEW depuis le dernier enregistrement du VI. Si cette valeur est zéro, aucun changement n'a été effectué. Si cette valeur n'est pas zéro, des changements ont été effectués. |
| FPMonitor | Le moniteur sur lequel la fenêtre de la face-avant LabVIEW apparaît, si vous avez plusieurs moniteurs. La valeur 0 correspond au moniteur principal. |
| FPResizable | Indique si l'utilisateur peut redimensionner la face-avant LabVIEW pendant l'exécution du VI. |
| FPRunTransparently | Paramètre le VI pour qu'il s'exécute en transparence. |
| FPShowMenuBar | Indique si la barre de menus de la face-avant LabVIEW doit être affichée pendant l'exécution du VI. |
| FPSize | Taille de la face-avant LabVIEW en octets. Cette propriété est en lecture seule. |
| FPState | État actuel de la fenêtre de la face-avant LabVIEW. Les valeurs valides comprennent 0 ( Invalid ), 1 (Standard ), 2 (Closed ), 3 (Hidden ), 4 (Minimized ), et 5 (Maximized ).
Un état de Standard ou Maximized indique que la fenêtre de la face-avant est visible à l'utilisateur.
Si vous essayez de définir cette propriété pour une face-avant qui n'est pas ouverte, la propriété renvoie une erreur. |
| FPTitleBarVisible | Indique si la barre de titre doit être visible sur la face-avant LabVIEW pendant l'exécution du VI. |
| FPTransparency | Définit le niveau de transparence de la fenêtre du VI. Le niveau de transparence est exprimé en pourcentage ; la fenêtre est opaque à 0 et invisible à 100. Cette propriété renvoie une erreur si vous spécifiez une valeur hors de la gamme de 0 à 100. Si vous configurez FPRunTransparently à Faux, les modifications apportées à cette propriété sont sans effet. |
| FPWinBounds | Les quatre éléments du cluster sont les valeurs des limites haute, gauche, basse et droite de la fenêtre de face-avant LabVIEW, y compris la zone interne, les barres de défilement, de titre, de menus et d'outils. Ce sont des coordonnées globales à l'écran, c'est-à-dire que les valeurs sont relatives aux coordonnées de l'écran lui-même et non pas celles de la fenêtre ouverte. Cette propriété ne peut être définie que pour les VIs dotés de faces-avant ouvertes. Si vous ne voulez pas que le VI pour lequel vous voulez définir cette propriété apparaisse aux utilisateurs, utilisez la commande Hidden valeur de FPStateEnum type de données pour FPState pour masquer la face-avant du VI. |
| FPWinClosable | Indique si le bouton Fermer de la barre de titre est désactivé et si l'élément Fermer du menu Fichier LabVIEW est désactivé. |
| FPWinCustomTitle | Indique si le VI a une chaîne de titre personnalisée. Sélectionnez FAUX pour supprimer la chaîne de titre personnalisé. |
| FPWinIsFrontMost | Si vous écrivez VRAI à cette valeur, la fenêtre de la face-avant passe au premier plan. Cette propriété s'applique uniquement dans l'instance d'application du VI appelant. Si vous écrivez FAUX à cette valeur n'a aucun effet. Si vous utilisez cette propriété en lecture, elle indique si la fenêtre de la face-avant doit être au premier plan (sans tenir compte des fenêtres flottantes). |
| FPWinPanelBounds | Les quatre éléments du cluster sont les valeurs des limites supérieure, gauche, inférieure et droite pour la zone intérieure de la face-avant LabVIEW, sans inclure les barres de défilement, de titre, de menus et d'outils. Les éléments de cluster sont exprimés en coordonnées globales à l'écran, c'est-à-dire que les valeurs sont relatives aux coordonnées de l'écran-même et non pas celles de la fenêtre ouverte. Cette propriété ne peut être définie que pour les VIs dotés de faces-avant ouvertes. Si vous ne voulez pas que le VI pour lequel vous voulez définir cette propriété apparaisse aux utilisateurs, utilisez la commande Hidden valeur de FPStateEnum type de données pour FPState pour masquer la face-avant du VI. |
| FPWinTitle | Chaîne qui apparaît dans la barre de titre LabVIEW. Cette chaîne ne doit pas obligatoirement correspondre au nom de fichier du VI. |
| HelpDocumentPath | Chemin vers un fichier HTML (.htm ou .html) ou vers un fichier d'aide compilé (.chm ou .hlp) auquel le VI est associé. Si le chemin mène à un fichier d'aide compilé, utilisez HelpDocumentTag pour déterminer la rubrique spécifique de ce fichier d'aide. |
| HelpDocumentTag | Mot-clé d'index ou nom de fichier HTML d'une rubrique du fichier d'aide compilé auquel est associé le VI. Pour établir un lien avec un signet dans un fichier HTML, ajoutez # puis le nom du signet à la fin du nom de fichier. N'utilisez cette propriété que si HelpDocumentPath est le chemin d'un fichier d'aide compilé (.chm ou .hlp). Pour des fichiers .chm, cette propriété peut être un nom de fichier HTML ou un mot-clé d'index. Pour des fichiers .hlp, cette propriété peut être un mot-clé d'index. |
| HelpDocumentUrl | URL de la rubrique d'aide Web qui doit être associée à un VI à partir du lien Aide détaillée de la fenêtre d'Aide contextuelle. |
| HelpUseOnline | Indique s'il faut lier un fichier d'aide Web à partir du lien Aide détaillée de la fenêtre d'Aide contextuelle d'un VI. |
| HistAddCommentsAtSave | Indique s'il faut ajouter un commentaire à l'historique du VI chaque fois que le VI est enregistré. |
| HistPromptAtClose | Indique si l'ajout d'un commentaire sur l'historique du VI doit être proposé lorsque ce dernier se ferme. |
| HistPromptForCommentsAtSave | Indique si l'ajout d'un commentaire sur l'historique des révisions du VI doit être proposé lorsque ce dernier est enregistré. |
| HistRecordAppComments | Indique si des commentaires doivent être ajoutés à l'historique du VI lorsque certains événements surviennent, comme une conversion vers une nouvelle version de LabVIEW, des modifications dans des sous-VIs et des changements apportés au nom ou au chemin du VI. |
| HistUseDefaults | Indique s'il faut utiliser l'historique par défaut global ou les valeurs entrées dans les autres propriétés d'historique. |
| HistoryText | Renvoie tout le texte ajouté à l'historique des révisions du VI. Cette propriété est en lecture seule. |
| IsCloneVI | Renvoie VRAI si le VI est un VI clone. |
| IsProbe | Renvoie VRAI si le VI s'exécute comme sonde et que le VI sonde est ouvert. |
| IsReentrant | Indique si un VI peut être réentrant. |
| Library | Renvoie le nom de la bibliothèque de projet LabVIEW, de la commandeX ou de la classe LabVIEW propriétaire du VI. Si aucune bibliothèque, commandeX ou classe n'est propriétaire du VI, la propriété renvoie NULL. |
| LogAtFinish | Indique si les valeurs de la face-avant LabVIEW doivent être écrites dans un fichier journal LabVIEW après l'exécution du VI. |
| LogFilePath | Chemin du fichier journal LabVIEW dans lequel les données de la face-avant LabVIEW et un horodatage sont écrits. |
| Name | Nom de fichier du VI. Vous ne pouvez utiliser cette propriété en écriture que si le VI n'a pas été enregistré sur disque. Si une bibliothèque de projet LabVIEW est propriétaire du VI, la propriété renvoie le nom qualifié du VI, qui inclut le nom de fichier de la bibliothèque de projet. |
| OwningApp | Renvoie une référence à l'application propriétaire de ce VI. Fermez cette référence quand vous avez terminé de l'utiliser. |
| Path | Chemin vers le fichier du VI. Cette propriété est en lecture seule. |
| PreferredExecSystem | Indique le système d'exécution dans lequel s'exécute le VI. |
| PrintHeaderDatePrint | Si cette propriété est définie à VRAI, LabVIEW inclut la date d'impression dans les en-têtes de ce VI. Utilisez le bouton PrintingHeaders pour définir si LabVIEW imprime les en-têtes du VI. |
| PrintHeaderModifyDate | Si cette propriété est définie à VRAI, LabVIEW inclut la date de la toute dernière modification dans les en-têtes du VI. Utilisez le bouton PrintingHeaders pour définir si LabVIEW imprime les en-têtes du VI. |
| PrintHeaderPageNumber | Si cette propriété est définie à VRAI, LabVIEW inclut les numéros de page dans les en-têtes de ce VI. Utilisez le bouton PrintingHeaders pour définir si LabVIEW imprime les en-têtes du VI. |
| PrintHeaderVIIcon | Si cette propriété est définie à VRAI, LabVIEW inclut l'icône du VI dans les en-têtes de ce VI. Utilisez le bouton PrintingHeaders pour définir si LabVIEW imprime les en-têtes du VI. |
| PrintHeaderVIName | Si cette option est définie à VRAI, LabVIEW inclut le nom du VI dans les en-têtes du VI. Utilisez le bouton PrintingHeaders pour définir si LabVIEW imprime les en-têtes du VI. |
| PrintLogFileAtFinish | Indique s'il faut imprimer la face-avant LabVIEW après exécution du VI. |
| PrintMargins | Obtient ou définit les marges de page à utiliser pour l'impression du VI, en pouces ou en centimètres. |
| PrintingBDScaling | Si cette option est définie à VRAI, LabVIEW met à l'échelle le diagramme de sorte qu'il tienne sur la page imprimée. |
| PrintingFPScaling | Si cette option est définie à VRAI, LabVIEW met à l'échelle la face-avant de sorte qu'elle tienne sur la page imprimée. |
| PrintingHeaderVIPath | Si cette propriété est définie à VRAI, LabVIEW inclut le chemin du VI dans les en-têtes de ce VI. Utilisez le bouton PrintingHeaders pour définir si LabVIEW imprime les en-têtes du VI. |
| PrintingHeaders | Si cette option est définie à VRAI, LabVIEW imprime des en-têtes pour le VI. Utilisez les propriétés PrintHeader de cette classe pour personnaliser le contenu des en-têtes. |
| PrintingOrientation | Obtient ou définit l'orientation de page à utiliser pour l'impression du VI. |
| ReentrancyType | Indique quel type de réentrance LabVIEW utilise pour un VI réentrant. Cette propriété est similaire aux options de la page Exécution de la boîte de dialogue Propriétés du VI. |
| RevisionNumber | Le numéro de révision actuel du VI. |
| RunOnOpen | Indique si le VI doit être exécuté lorsqu'il est ouvert. |
| RunTimeMenuPath | En lecture, cette propriété renvoie le chemin du menu d'exécution du VI. En écriture, elle met à jour le chemin du menu d'exécution du VI. Si le VI est en cours d'exécution lors de la définition de cette propriété, le menu est mis à jour avec les données du nouveau chemin. |
| ShowFPOnCall | Indique si LabVIEW doit afficher la face-avant lorsque le VI est appelé. |
| ShowFPOnLoad | Indique si LabVIEW doit afficher la face-avant lorsque le VI est chargé. |
| SuspendOnCall | Indique si le VI doit être suspendu lorsqu'il est appelé en tant que sous-VI. Soyez prudent si vous utilisez cette propriété avec des VIs réentrants. |
| TBShowAbortButton | Indique si le bouton Abandonner l'exécution doit être visible dans la barre d'outils LabVIEW pendant l'exécution du VI. |
| TBShowFreeRunButton | Indique si le bouton Exécuter en continu doit être visible dans la barre d'outils LabVIEW pendant l'exécution du VI. |
| TBShowRunButton | Indique si le bouton Exécuter doit être visible dans la barre d'outils LabVIEW pendant l'exécution du VI. |
| TBVisible | Indique s'il faut afficher la barre d'outils LabVIEW pendant l'exécution du VI. |
| VIType | Indique le type du VI. |