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.