Jump to content

ProjectItem class: Difference between revisions

From LabVIEW Wiki
Started page
 
Added Detail
 
(6 intermediate revisions by the same user not shown)
Line 1: Line 1:
{| class="wikitable"
{{VIServerClass|74}}
|-
|<[[VI Server Class Hierarchy]]
|}
 
The '''ProjectItem class''' is a class in the [[VI Server Class Hierarchy]], (see also [[VI Server]]).  The ProjectItem class is the top-level class for most of the objects that are used on the Items tab of the [[Project Explorer]] window.
{{TOCright}}
{{TOCright}}
{| class="wikitable"
The '''ProjectItem class''' is a class in the [[VI Server Class Hierarchy]], (see also [[VI Server]]).  The '''ProjectItem''' class allows you to inspect and modify items that appear in the [[Project Explorer]] window, such as [[VI]]s, [[Virtual Folder]]s, [[Class (object-oriented programming)|classes]], [[Library|libraries]], etc.
! colspan="2"|Legend
|-
|R/W
| Readable/Writable {R = Read Only, W = Write Only, R/W = Read/Write}
|-
|RTE
| Available in the [[Run-Time Engine]]
|- style="background-color:#FFFFCC;"
|colspan="2"|[[VI Server#Basic Development Environment|Basic Development Environment]]
|-style="background-color:#CCFFFF;"
|colspan="2"|[[VI Server#VI Scripting|VI Scripting]]
|-style="background-color:#D1BB80;"
|colspan="2"|[[VI Server#Private|Private]]
|-style="background-color:#FFAAAA;"
|colspan="2"|[[VI Server#Deprecated|Deprecated]]
|}
 
==Properties==
<span class="mw-customtoggle-propertiestable">Show/Hide Application Properties Table</span>
<div class="mw-collapsible" id="mw-customcollapsible-propertiestable">
{| class="wikitable sortable"
|+ Application Properties Table
! Property ID
! Short Name (English)
! Description
! R/W
! RTE
|- style="background-color:#D1BB80;"
|35B53C31
| [[ProjectItem class/Can Be Removed? property|Can Be Removed?]]
|
|R
|
|- style="background-color:#D1BB80;"
|35B53C30
| [[ProjectItem class/Can Be Renamed? property|Can Be Renamed?]]
|
|R
|
|- style="background-color:#FFFFCC;"
|35B53C2D
| [[ProjectItem class/Can Be Replaced property|Can Be Replaced]]
|
|R
|X
|- style="background-color:#D1BB80;"
|35B53C37
| [[ProjectItem class/CanContainVariable property|CanContainVariable]]
|
|R
|X
|- style="background-color:#D1BB80;"
|35B53C10
| [[ProjectItem class/CanGetVIReference property|CanGetVIReference]]
|
|R
|
|- style="background-color:#FFFFCC;"
|35B53C2B
| [[ProjectItem class/Contains Conflicts? property|Contains Conflicts?]]
|Returns TRUE if this item or items beneath this item in the project tree are in conflict.
|R
|X
|- style="background-color:#FFFFCC;"
|35B53C0D
| [[ProjectItem class/DisplayName property|DisplayName]]
|Gets as a string the name of the project item as the name appears in the Project Explorer window.
 
<b>Note</b>  The LabVIEW Datalogging and Supervisory Control Module supports this property in the Run-Time Engine.
|R
|X
|- style="background-color:#FFFFCC;"
|35B53C21
| [[ProjectItem class/Enabled property|Enabled]]
|Applicable in IIO only.  Tasks and program VIs can be set to Enabled, in which case they will be deployed and run on the Controller.
|R/W
|
|- style="background-color:#D1BB80;"
|35B53C2E
| [[ProjectItem class/Faceplate Path property|Faceplate Path]]
|
|R/W
|X
|- style="background-color:#D1BB80;"
|35B53C32
| [[ProjectItem class/Files View Item property|Files View Item]]
|
|R/W
|X
|- style="background-color:#FFFFCC;"
|35B53C26
| [[ProjectItem class/Find Callers property|Find Callers]]
|Returns an array of references to all project items that reference the project item you select.
 
This property is similar to the <b>Find&#187;Callers</b> item on the shortcut menu of a project item.
|R
|
|- style="background-color:#FFFFCC;"
|35B53C33
| [[ProjectItem class/Find Children property|Find Children]]
|Returns an array of references to all project items that are children of the project item you select.
|R
|
|- style="background-color:#FFFFCC;"
|35B53C29
| [[ProjectItem class/Find Conflicts property|Find Conflicts]]
|Returns an array of references to all project items that are in conflict with the project item you select.
 
This property is similar to the <b>Find&#187;Conflicts</b> item on the shortcut menu of a project item.
|R
|
|- style="background-color:#FFFFCC;"
|35B53C34
| [[ProjectItem class/Find Friends property|Find Friends]]
|Returns an array of references to all project items that are friends of the project item you select.
|R
|
|- style="background-color:#FFFFCC;"
|35B53C3B
| [[ProjectItem class/Find Items Incorrectly Claimed by Library property|Find Items Incorrectly Claimed by Library]]
|Returns an array of references to all items within a project that are claimed by a library but do not reciprocate the claim.
|R
|
|- style="background-color:#FFFFCC;"
|35B53C35
| [[ProjectItem class/Find Items that Make This a Dependency property|Find Items that Make This a Dependency]]
|Returns an array of references to all project items under the target that are not under dependencies but cause this item to be under dependencies.
|R
|
|- style="background-color:#FFFFCC;"
|35B53C28
| [[ProjectItem class/Find Items with No Callers property|Find Items with No Callers]]
|Returns an array of references to all top-level project items that call no other project items.
 
This property is similar to the <b>Find&#187;Items with No Callers</b> item on the shortcut menu of a project item.
|R
|
|- style="background-color:#FFFFCC;"
|35B53C24
| [[ProjectItem class/Find Missing Items property|Find Missing Items]]
|Returns all project items that have a path but do not exist on disk.
|R
|
|- style="background-color:#FFFFCC;"
|35B53C27
| [[ProjectItem class/Find SubVIs property|Find SubVIs]]
|Returns an array of references to all project items that are subVIs of the item you select.
 
This property is similar to the <b>Find&#187;SubVIs</b> item on the shortcut menu of a project item.
|R
|
|- style="background-color:#FFFFCC;"
|35B53C38
| [[ProjectItem class/Find Variable Callers property|Find Variable Callers]]
|Returns an array of references to all project VIs that reference the shared variable project item you specify.
|R
|
|- style="background-color:#D1BB80;"
|35B53C1B
| [[ProjectItem class/Found? property|Found?]]
|
|R
|X
|- style="background-color:#FFFFCC;"
|35B53C1E
| [[ProjectItem class/Auto-Populating Path property|Auto-Populating Path]]
|Returns the path on disk this auto-populating folder is connected to.
|R
|X
|- style="background-color:#D1BB80;"
|35B53C20
| [[ProjectItem class/HiddenLibrary property|HiddenLibrary]]
|
|R/W
|X
|- style="background-color:#FFFFCC;"
|35B53C1C
| [[ProjectItem class/Hyperlink Address property|Hyperlink Address]]
|Gets or sets the address of a hyperlink item.
 
This property is similar to the options available in the Hyperlink Properties dialog box.
|R/W
|X
|- style="background-color:#FFFFCC;"
|35B53C03
| [[ProjectItem class/Icon property|Icon]]
|Gets the icon of the project item in the Project Explorer window using the <b>Icon</b> cluster, which limits size and color depth.
 
<b>Note</b>  The LabVIEW Datalogging and Supervisory Control Module supports this property in the Run-Time Engine.
Elements
 
Name
Description
 
Image Type
Reserved for future use.
 
Image Depth
Specifies the color depth of the image, which is the number of bits to use to describe the color of each pixel in the image. Valid values include 1, 4, 8, and 24 bits per pixel. Image Depth affects how LabVIEW interprets the values of Image and Colors.
 
Image
A 1-D array of bytes that describes the color of each pixel in the image in raster order. The value of Image Depth determines how LabVIEW interprets the value of this input.<br><br>
If Image Depth is 24, each pixel has three bytes to describe its color. The first byte for each pixel describes the red value, the second byte describes the green value, and the third byte describes the blue value.<br><br>
If Image Depth is 8, each pixel has one byte to describe its color. The value of each bit corresponds to an element in Colors, which stores 32-bit RGB values where the most-significant byte is zero, followed in order by red, green, and blue values. Valid values include 0 through 255.<br><br>
If Image Depth is 4, the behavior is similar to when Image Depth is 8 except valid values in image include 0 through 15.<br><br>
If Image Depth is 1, any value of zero in Image corresponds to element 0 in Colors. All other values correspond to element 1 in Colors.
 
Mask
An array of bytes in which each bit describes mask information for a pixel. The first byte describes the first eight pixels, the second byte describes the next eight pixels, and so on. If a bit is zero, LabVIEW draws the corresponding pixel as transparent. If the array is empty, LabVIEW draws all pixels without transparency. If the array does not contain a bit for each pixel in the image, LabVIEW draws any pixels missing from the array without transparency.
 
Colors
An array of RGB color values that correspond to the values in image. The value of Image Depth determines how LabVIEW interprets the value of this input.<br><br>
If Image Depth is 24, LabVIEW ignores this input.<br><br>
If Image Depth is 8, the array can have 256 elements.<br><br>
If Image Depth is 4, the array can have 16 elements.<br><br>
If Image Depth is 1, the array can have 2 elements.
 
 
Rectangle
A cluster that contains coordinates that describe the bounding rectangle in which you want to draw the image. The VI clips the image to the width and height of the rectangle. The bottom and right edges of the rectangle bounds do not contain image pixels. Horizontal coordinates increase to the right, and vertical coordinates increase to the bottom.
 
Left&#8212;The horizontal coordinate of the left edge of the rectangle.
Top&#8212;The vertical coordinate of the top edge of the rectangle.
Right&#8212;The horizontal coordinate of the right edge of the rectangle.
Bottom&#8212;The vertical coordinate of the bottom edge of the rectangle.
|R
|X
|- style="background-color:#FFFFCC;"
|35B53C2A
| [[ProjectItem class/In Conflict? property|In Conflict?]]
|Returns TRUE if this item conflicts with another item with a different path under the same target.
|R
|X
|- style="background-color:#FFFFCC;"
|35B53C39
| [[ProjectItem class/IsInPackedLibrary property|IsInPackedLibrary]]
|Returns TRUE if a packed project library contains the project item.
|R
|X
|- style="background-color:#D1BB80;"
|35B53C3C
| [[ProjectItem class/IsInPackedLibraryAndNotExported property|IsInPackedLibraryAndNotExported]]
|
|R
|X
|- style="background-color:#D1BB80;"
|35B53C3D
| [[ProjectItem class/IsPackedLibrary property|IsPackedLibrary]]
|
|R
|X
|- style="background-color:#D1BB80;"
|35B53C14
| [[ProjectItem class/IsProviderBound property|IsProviderBound]]
|
|R
|
|- style="background-color:#D1BB80;"
|35B53C3E
| [[ProjectItem class/IsVarNamespace? property|IsVarNamespace?]]
|
|R
|
|- style="background-color:#D1BB80;"
|35B53C0E
| [[ProjectItem class/IsVisible property|IsVisible]]
|
|R
|
|- style="background-color:#FFFFCC;"
|35B53C06
| [[ProjectItem class/ItemID property|ItemID]]
|Gets the item ID of the referenced project item as a string. You can use this item ID to uniquely identify the referenced item even if the path, name, or location in the Project Explorer window changes.
 
<b>Note</b>  The LabVIEW Datalogging and Supervisory Control Module supports this property in the Run-Time Engine.
|R
|X
|- style="background-color:#FFFFCC;"
|35B53C13
| [[ProjectItem class/LibraryItemTypeString property|LibraryItemTypeString]]
|Returns the type of the project item as it exists in the project library as a string. This property returns an error if the project item is not part of a library. Use the Library Item:Type property to return the type as a GUID.
 
<b>Note</b>  The LabVIEW Datalogging and Supervisory Control Module supports this property in the Run-Time Engine.
|R
|X
|- style="background-color:#FFFFCC;"
|35B53C12
| [[ProjectItem class/LibraryItemType property|LibraryItemType]]
|Gets the type of the project item as it exists in the project library as a GUID string. If the item is not part of a library, this property returns an error. Use the Library Item Type:String property to return the type as a human-readable string.
 
<b>Note</b>  The LabVIEW Datalogging and Supervisory Control Module supports this property in the Run-Time Engine.
|R
|X
|- style="background-color:#D1BB80;"
|35B53C2C
| [[ProjectItem class/ Locked for Edits property| Locked for Edits]]
|
|R
|X
|- style="background-color:#D1BB80;"
|35B53C36
| [[ProjectItem class/Missing? property|Missing?]]
|
|R
|X
|- style="background-color:#D1BB80;"
|35B53C0B
| [[ProjectItem class/NIIM property|NIIM]]
|
|R
|
|- style="background-color:#FFFFCC;"
|35B53C01
| [[ProjectItem class/Name property|Name]]
|Gets the name of the referenced project item as it is saved in the file.
 
Use the Display Name property to get the name as it appears in the Project Explorer window.
 
<b>Note</b>  The LabVIEW Datalogging and Supervisory Control Module supports this property in the Run-Time Engine.
|R
|X
|- style="background-color:#FFFFCC;"
|35B53C08
| [[ProjectItem class/OwnedItems() property|OwnedItems()]]
|Returns an array of references to the contents of the referenced project item. You can use these references with the ProjectItem properties.
 
<b>Note</b>  The LabVIEW Datalogging and Supervisory Control Module supports this property in the Run-Time Engine. Example
|R
|X
|- style="background-color:#FFFFCC;"
|35B53C09
| [[ProjectItem class/Owner property|Owner]]
|Returns a reference to the project item that contains the referenced project item in the Project Explorer window. You can use this reference with the ProjectItem properties.
 
<b>Note</b>  The LabVIEW Datalogging and Supervisory Control Module supports this property in the Run-Time Engine.
|R
|X
|- style="background-color:#D1BB80;"
|35B53C3A
| [[ProjectItem class/PackedLibrary property|PackedLibrary]]
|
|R
|X
|- style="background-color:#FFFFCC;"
|35B53C02
| [[ProjectItem class/Path property|Path]]
|Gets the path of the referenced project item.
 
<b>Note</b>  The LabVIEW Datalogging and Supervisory Control Module supports this property in the Run-Time Engine.
|R
|X
|- style="background-color:#D1BB80;"
|35B53C0F
| [[ProjectItem class/PossibleChildTypes() property|PossibleChildTypes()]]
|
|R
|
|- style="background-color:#D1BB80;"
|35B53C18
| [[ProjectItem class/PossibleDialogChildTypes() property|PossibleDialogChildTypes()]]
|
|R
|
|- style="background-color:#D1BB80;"
|35B53C17
| [[ProjectItem class/PossibleMenuChildTypes()  property|PossibleMenuChildTypes() ]]
|
|R
|
|- style="background-color:#FFFFCC;"
|35B53C05
| [[ProjectItem class/Project property|Project]]
|Returns a reference to the LabVIEW project to which the referenced project item belongs. You can use this reference with the Project properties.
 
<b>Note</b>  The LabVIEW Datalogging and Supervisory Control Module supports this property in the Run-Time Engine.
|R
|X
|- style="background-color:#D1BB80;"
|35B53C1F
| [[ProjectItem class/SourceID property|SourceID]]
|
|R/W
|X
|- style="background-color:#D1BB80;"
|35B53C1A
| [[ProjectItem class/SpecialDependencyDescendents property|SpecialDependencyDescendents]]
|
|R
|
|- style="background-color:#D1BB80;"
|35B53C19
| [[ProjectItem class/SuppressChangeNotifications property|SuppressChangeNotifications]]
|
|R/W
|
|- style="background-color:#D1BB80;"
|35B53C2F
| [[ProjectItem class/TagSet property|TagSet]]
|
|R
|X
|- style="background-color:#FFFFCC;"
|35B53C16
| [[ProjectItem class/Target property|Target]]
|Returns a reference to the target that contains the referenced project item. You can use this reference with the TargetItem properties.
 
<b>Note</b>  The LabVIEW Datalogging and Supervisory Control Module supports this property in the Run-Time Engine.
|R
|X
|- style="background-color:#FFFFCC;"
|35B53C00
| [[ProjectItem class/Type property|Type]]
|Gets the type of the project item as a GUID string. Use the Type String property to return the type as a string.
 
<b>Note</b> The LabVIEW Datalogging and Supervisory Control Module supports this property in the Run-Time Engine.
|R
|X
|- style="background-color:#FFFFCC;"
|35B53C11
| [[ProjectItem class/TypeString property|TypeString]]
|Gets the type of the project item as a string. Use the Type GUID property to return the type as a GUID.
 
<b>Note</b>  The LabVIEW Datalogging and Supervisory Control Module supports this property in the Run-Time Engine.
|R
|X
|- style="background-color:#FFFFCC;"
|35B53C07
| [[ProjectItem class/VIReference property|VIReference]]
|If the project item refers to a VI, this property returns a reference to the VI. Otherwise, this property returns Not a Refnum. You can use this reference with the VI properties.
 
<b>Note</b>  The VI Reference does not record changes to the VI. If you use this reference for editing the VI, you will not be prompted to save when the reference closes.
<b>Note</b>  The LabVIEW Datalogging and Supervisory Control Module supports this property in the Run-Time Engine.
|R
|X
|- style="background-color:#FFFFCC;"
|35B53C1D
| [[ProjectItem class/VIReferenceNoLoad property|VIReferenceNoLoad]]
|If the project item refers to a VI in memory, this property returns a reference to the VI. If the project item refers to a VI not in memory or to something that is not a VI, this property returns Not a Refnum. You can use this reference with the VI properties.
|R
|X
|- style="background-color:#FFFFCC;"
|35B53C0C
| [[ProjectItem class/VariableReference property|VariableReference]]
|Returns a reference to the variable the referenced project item references. If the referenced project item is not a variable item, this property returns Not a Refnum. You can use this reference with the Variable properties to configure shared variables programmatically.
 
<b>Note</b>  You can create, configure, and host shared variables only on Windows or RT targets with the LabVIEW Real Time Module. You can use the DataSocket VI and functions to read or write shared variables from other platforms.
<b>Note</b>  The LabVIEW Datalogging and Supervisory Control Module supports this property in the Run-Time Engine.
|R
|X
|- style="background-color:#FFFFCC;"
|35B53C04
| [[ProjectItem class/VisibleInTree property|VisibleInTree]]
|If TRUE, indicates that the Project Explorer window is visible and ancestors of the project item are expanded in the Project Explorer window up to the root of the project item.
 
<b>Note</b>  The LabVIEW Datalogging and Supervisory Control Module supports this property in the Run-Time Engine.
|R
|
|}
</div>
 
==Methods==
<span class="mw-customtoggle-methodstable">Show/Hide Application Methods Table</span>
<div class="mw-collapsible" id="mw-customcollapsible-methodstable">
{| class="wikitable sortable"
|+ Application Methods Table
! Method ID
! Short Name (English)
! Description
! RTE
|- style="background-color:#FFFFCC;"
|35B53800
| [[ProjectItem class/AddFile method|AddFile]]
|Adds a file at the specified path to the LabVIEW project with the referenced project item as the parent. You also can use the Project Explorer window to add a file to a project.
 
<b>Note</b>  The LabVIEW Datalogging and Supervisory Control Module supports this method in the Run-Time Engine. Example
|
|- style="background-color:#FFFFCC;"
|35B53801
| [[ProjectItem class/AddItem method|AddItem]]
|Adds a new project item of the specified type to the LabVIEW project with the referenced item as the parent. You also can use the Project Explorer window to add an item to a project.
 
This method returns an error if the specified type cannot be created under the current item. The method also returns an error when you try to add a shared variable to a library that is not opened in a project.
 
<b>Note</b>  The LabVIEW Datalogging and Supervisory Control Module supports this method in the Run-Time Engine. Example
|
|- style="background-color:#FFFFCC;"
|35B53824
| [[ProjectItem class/AddItemFromMemory method|AddItemFromMemory]]
|Adds an item that exists in memory to the LabVIEW project with the referenced project item as the parent.
 
<b>Note</b>  The LabVIEW Datalogging and Supervisory Control Module supports this method in the Run-Time Engine.
|
|- style="background-color:#D1BB80;"
|35B53835
| [[ProjectItem class/AddItemFromMemoryPrivately method|AddItemFromMemoryPrivately]]
|
|
|- style="background-color:#D1BB80;"
|35B53831
| [[ProjectItem class/AddMultipleItems method|AddMultipleItems]]
|
|X
|- style="background-color:#D1BB80;"
|35B53827
| [[ProjectItem class/Arrange By method|Arrange By]]
|
|
|- style="background-color:#D1BB80;"
|35B53833
| [[ProjectItem class/Bounds method|Bounds]]
|
|X
|- style="background-color:#D1BB80;"
|35B53830
| [[ProjectItem class/Choose Substitute method|Choose Substitute]]
|
|X
|- style="background-color:#D1BB80;"
|35B53809
| [[ProjectItem class/CloseRefee method|CloseRefee]]
|
|
|- style="background-color:#FFFFCC;"
|35B53819
| [[ProjectItem class/Collapse method|Collapse]]
|Hides the contents of an expandable project item in the <b>Project Explorer</b> window. Expandable project items include folders, project libraries, LabVIEW classes, and XControls.
|
|- style="background-color:#FFFFCC;"
|35B5382B
| [[ProjectItem class/Convert to Auto-populating Folder method|Convert to Auto-populating Folder]]
|Connect this project item to a folder on disk.
 
This property is similar to the Convert to Auto-populating Folder item on the shortcut menu of a virtual folder in the project.
|
|- style="background-color:#D1BB80;"
|35B5380B
| [[ProjectItem class/Debug Bind To Children method|Debug Bind To Children]]
|
|
|- style="background-color:#D1BB80;"
|35B5380A
| [[ProjectItem class/Debug Bind To Item method|Debug Bind To Item]]
|
|
|- style="background-color:#FFFFCC;"
|35B53803
| [[ProjectItem class/Delete method|Delete]]
|Removes the referenced project item from the LabVIEW project. If the item has children, the children also are deleted. You also can use the Project Explorer window to remove items from the project.
 
<b>Note</b>  The LabVIEW Datalogging and Supervisory Control Module supports this method in the Run-Time Engine.
|
|- style="background-color:#D1BB80;"
|35B5382D
| [[ProjectItem class/Delete On Disk method|Delete On Disk]]
|
|X
|- style="background-color:#D1BB80;"
|35B53821
| [[ProjectItem class/Delete Privately method|Delete Privately]]
|
|
|- style="background-color:#FFFFCC;"
|35B53826
| [[ProjectItem class/Expand method|Expand]]
|Displays the contents of an expandable project item in the <b>Project Explorer</b> window. Expandable project items include folders, project libraries, LabVIEW classes, and XControls.
|
|- style="background-color:#D1BB80;"
|35B53832
| [[ProjectItem class/ForceDelete method|ForceDelete]]
|
|X
|- style="background-color:#FFFFCC;"
|35B53810
| [[ProjectItem class/Get All Descendents method|Get All Descendents]]
|Recursively returns project items that appear under the referenced item in the project tree. For example, if you call this method on project library A that contains an inner project library B, the method returns items owned both by library A and library B.
 
For this method, the term descendents does not refer to children classes of the referenced project item.
|X
|- style="background-color:#D1BB80;"
|35B53829
| [[ProjectItem class/Get All Descendents2 method|Get All Descendents2]]
|
|X
|- style="background-color:#D1BB80;"
|35B53836
| [[ProjectItem class/Get Library Access Scope method|Get Library Access Scope]]
|
|
|- style="background-color:#D1BB80;"
|35B53834
| [[ProjectItem class/GetVariableURLs method|GetVariableURLs]]
|
|
|- style="background-color:#D1BB80;"
|35B5382A
| [[ProjectItem class/GetFindResults method|GetFindResults]]
|
|X
|- style="background-color:#D1BB80;"
|35B5382E
| [[ProjectItem class/ListOfReferProjItems method|ListOfReferProjItems]]
|
|X
|- style="background-color:#D1BB80;"
|35B53811
| [[ProjectItem class/Make Item Visible in Tree method|Make Item Visible in Tree]]
|
|
|- style="background-color:#D1BB80;"
|35B53820
| [[ProjectItem class/Move method|Move]]
|
|
|- style="background-color:#D1BB80;"
|35B5381B
| [[ProjectItem class/New from Template method|New from Template]]
|
|
|- style="background-color:#D1BB80;"
|35B53825
| [[ProjectItem class/NotifyItemChanged method|NotifyItemChanged]]
|
|
|- style="background-color:#D1BB80;"
|35B5381F
| [[ProjectItem class/Query Behavior method|Query Behavior]]
|
|
|- style="background-color:#D1BB80;"
|35B5381A
| [[ProjectItem class/Rename method|Rename]]
|
|
|- style="background-color:#FFFFCC;"
|35B53837
| [[ProjectItem class/Replace Item With method|Replace Item With]]
|
|
|- style="background-color:#D1BB80;"
|35B5382F
| [[ProjectItem class/ReplaceWithProjItem method|ReplaceWithProjItem]]
|
|X
|- style="background-color:#D1BB80;"
|35B5381E
| [[ProjectItem class/SCC Get Info method|SCC Get Info]]
|
|
|- style="background-color:#D1BB80;"
|35B53812
| [[ProjectItem class/SelectItem method|SelectItem]]
|
|
|- style="background-color:#D1BB80;"
|35B53828
| [[ProjectItem class/SetUrl method|SetUrl]]
|
|
|- style="background-color:#D1BB80;"
|35B53814
| [[ProjectItem class/Simulate Copy method|Simulate Copy]]
|
|
|- style="background-color:#D1BB80;"
|35B53818
| [[ProjectItem class/Simulate Drag From Paths method|Simulate Drag From Paths]]
|
|
|- style="background-color:#D1BB80;"
|35B53813
| [[ProjectItem class/SimulateDragSelection method|SimulateDragSelection]]
|
|
|- style="background-color:#D1BB80;"
|35B53816
| [[ProjectItem class/Simulate Drag To VI method|Simulate Drag To VI]]
|
|
|- style="background-color:#D1BB80;"
|35B5381D
| [[ProjectItem class/SimulateNotify method|SimulateNotify]]
|
|
|- style="background-color:#D1BB80;"
|35B53815
| [[ProjectItem class/Simulate Paste method|Simulate Paste]]
|
|
|- style="background-color:#D1BB80;"
|35B53817
| [[ProjectItem class/Simulate Paste To VI method|Simulate Paste To VI]]
|
|
|- style="background-color:#FFFFCC;"
|35B5382C
| [[ProjectItem class/Stop Auto-populating method|Stop Auto-populating]]
|Disconnect this folder from a folder on disk.
 
This property is similar to the Stop Auto-populating  item on the shortcut menu of an auto-populating folder in the project.
|
|- style="background-color:#D1BB80;"
|35B5381C
| [[ProjectItem class/Suppress Project Dlgs method|Suppress Project Dlgs]]
|
|
|- style="background-color:#FFFFCC;"
|35B5380E
| [[ProjectItem class/Delete Tag method|Delete Tag]]
|Removes the named tag from the LabVIEW project item.
 
<b>Note</b>  The LabVIEW Datalogging and Supervisory Control Module supports this method in the Run-Time Engine.
|
|- style="background-color:#FFFFCC;"
|35B5380F
| [[ProjectItem class/Get Tag Names method|Get Tag Names]]
|Returns an array of tag names of all tags on the referenced project item.
 
<b>Note</b>  The LabVIEW Datalogging and Supervisory Control Module supports this method in the Run-Time Engine.
|X
|- style="background-color:#FFFFCC;"
|35B5380C
| [[ProjectItem class/Get Tag method|Get Tag]]
|Returns a tag value associated with the project item.
 
<b>Note</b>  The LabVIEW Datalogging and Supervisory Control Module supports this method in the Run-Time Engine.
|X
|- style="background-color:#FFFFCC;"
|35B53822
| [[ProjectItem class/Get XML Tag method|Get XML Tag]]
|Returns the value in an XML tag.
 
Use the Tag:Set XML Tag method to set the value in an XML tag.
 
<b>Note</b>  The LabVIEW Datalogging and Supervisory Control Module supports this method in the Run-Time Engine.
|X
|- style="background-color:#FFFFCC;"
|35B5380D
| [[ProjectItem class/Set Tag method|Set Tag]]
|Sets a tag value associated with the LabVIEW project.
 
<b>Note</b>  The LabVIEW Datalogging and Supervisory Control Module supports this method in the Run-Time Engine.
|
|- style="background-color:#FFFFCC;"
|35B53823
| [[ProjectItem class/Set XML Tag method|Set XML Tag]]
|Sets the value of an XML tag associated with the LabVIEW project.
 
<b>Note</b>  The LabVIEW Datalogging and Supervisory Control Module supports this method in the Run-Time Engine.
|
|}
</div>


==Events==
<!--Edit Properties, Methods, or Events in the appropriate table in one on the VI Server Templates-->
''No Events for this Class''
{{VIServerClassTables|74}}


== History ==
== History ==
{{ambox|text=History information is needed.  What changes have occured over previous versions?}}
{{ambox|text=History information is needed.  What changes have occurred over previous versions?}}
{| class="wikitable"
{| class="wikitable"
! Version
! Version
Line 775: Line 19:
*[[VI Server Class Hierarchy]]
*[[VI Server Class Hierarchy]]
*[[VI Server]]
*[[VI Server]]
*[[VI Scripting]]


[[Category:VI Server]]
[[Category:VI Server Class]]
[[Category:VI Server Class]]

Latest revision as of 19:08, 13 May 2020

VI Server Class Information
Return to VI Server Class Hierarchy
Class Name ProjectItem class
Class ID 74
Scope Basic Development Environment
Class Inheritance

This class is a top-level class.

Class Children

The ProjectItem class is a class in the VI Server Class Hierarchy, (see also VI Server). The ProjectItem class allows you to inspect and modify items that appear in the Project Explorer window, such as VIs, Virtual Folders, classes, libraries, etc.

Properties

Show/Hide ProjectItem Properties Table

Legend
R/WReadable/Writable Permissions
RTEAvailable in the Run-Time Engine
Basic Development Environment
VI Scripting
Private
Deprecated
ProjectItem Properties Table
Property ID Long Name (English) Description R/W RTE
35B53C00Type GUIDGets the type of the project item as a GUID string. Use the Type String property to return the type as a string.Read OnlyYes
35B53C01NameGets the name of the referenced project item as it is saved in the file.Read OnlyYes
35B53C02PathGets the path of the referenced project item.Read OnlyYes
35B53C03IconGets the icon of the project item in the Project Explorer window using the Icon cluster, which limits size and color depth.Read OnlyYes
35B53C04Visible In TreeIf TRUE, indicates that the Project Explorer window is visible and ancestors of the project item are expanded in the Project Explorer window up to the root of the project item.Read OnlyNo
35B53C05ProjectReturns a reference to the LabVIEW project to which the referenced project item belongs. You can use this reference with the Project properties.Read OnlyYes
35B53C06Item IDGets the item ID of the referenced project item as a string. You can use this item ID to uniquely identify the referenced item even if the path, name, or location in the Project Explorer window changes.Read OnlyYes
35B53C07VI ReferenceIf the project item refers to a VI, this property returns a reference to the VI. Otherwise, this property returns Not a Refnum. You can use this reference with the VI properties.Read OnlyYes
35B53C08Owned Items[]Returns an array of references to the contents of the referenced project item. You can use these references with the ProjectItem properties.Read OnlyYes
35B53C09OwnerReturns a reference to the project item that contains the referenced project item in the Project Explorer window. You can use this reference with the ProjectItem properties.Read OnlyYes
35B53C0BNIIMRead OnlyNo
35B53C0CVariable ReferenceReturns a reference to the variable the referenced project item references. If the referenced project item is not a variable item, this property returns Not a Refnum. You can use this reference with the Variable properties to configure shared variables programmatically.Read OnlyYes
35B53C0DDisplay NameGets as a string the name of the project item as the name appears in the Project Explorer window.Read OnlyYes
35B53C0EIs VisibleRead OnlyNo
35B53C0FPossible Child Types:AllRead OnlyNo
35B53C10Can Get VIReferenceRead OnlyNo
35B53C11Type StringGets the type of the project item as a string. Use the Type GUID property to return the type as a GUID.Read OnlyYes
35B53C12Library Item:TypeGets the type of the project item as it exists in the project library as a GUID string. If the item is not part of a library, this property returns an error. Use the Library Item Type:String property to return the type as a human-readable string.Read OnlyYes
35B53C13Library Item Type:StringReturns the type of the project item as it exists in the project library as a string. This property returns an error if the project item is not part of a library. Use the Library Item:Type property to return the type as a GUID.Read OnlyYes
35B53C14Is Provider BoundRead OnlyNo
35B53C16TargetReturns a reference to the target that contains the referenced project item. You can use this reference with the TargetItem properties.Read OnlyYes
35B53C17Possible Child Types:MenuRead OnlyNo
35B53C18Possible Child Types:DialogRead OnlyNo
35B53C19Suppress Change NotificationsRead/WriteNo
35B53C1ASpecial Dependency DescendentsRead OnlyNo
35B53C1BFound?Read OnlyYes
35B53C1CHyperLink AddressGets or sets the address of a hyperlink item.Read/WriteYes (Read Only)
35B53C1DVI Reference No LoadIf the project item refers to a VI in memory, this property returns a reference to the VI. If the project item refers to a VI not in memory or to something that is not a VI, this property returns Not a Refnum. You can use this reference with the VI properties.Read OnlyYes
35B53C1EGet Auto-populating Folder PathReturns the path on disk this auto-populating folder is connected to.Read OnlyYes
35B53C1FSource IDRead/WriteYes
35B53C20Hidden LibraryRead/WriteYes
35B53C21EnabledApplicable in IIO only. Tasks and program VIs can be set to Enabled, in which case they will be deployed and run on the Controller.Read/WriteNo
35B53C24Find:Missing ItemsReturns all project items that have a path but do not exist on disk.Read OnlyNo
35B53C26Find:CallersReturns an array of references to all project items that reference the project item you select.Read OnlyNo
35B53C27Find:SubVIsReturns an array of references to all project items that are subVIs of the item you select.Read OnlyNo
35B53C28Find:Items with No CallersReturns an array of references to all top-level project items that call no other project items.Read OnlyNo
35B53C29Find:ConflictsReturns an array of references to all project items that are in conflict with the project item you select.Read OnlyNo
35B53C2AIn Conflict?Returns TRUE if this item conflicts with another item with a different path under the same target.Read OnlyYes
35B53C2BContains Conflicts?Returns TRUE if this item or items beneath this item in the project tree are in conflict.Read OnlyYes
35B53C2CLocked for EditsRead OnlyYes
35B53C2DCan Be ReplacedRead OnlyYes
35B53C2EFaceplate PathRead/WriteYes
35B53C2FTagSetRead OnlyYes
35B53C30Can Be Renamed?Read OnlyNo
35B53C31Can Be Removed?Read OnlyNo
35B53C32Files View ItemRead/WriteYes
35B53C33Find:ChildrenReturns an array of references to all project items that are children of the project item you select.Read OnlyNo
35B53C34Find:FriendsReturns an array of references to all project items that are friends of the project item you select.Read OnlyNo
35B53C35Find:Items that make this a dependencyReturns an array of references to all project items under the target that are not under dependencies but cause this item to be under dependencies.Read OnlyNo
35B53C36Missing?Read OnlyYes
35B53C37Can Contain VariableRead OnlyYes
35B53C38Find:Variable CallersReturns an array of references to all project VIs that reference the shared variable project item you specify.Read OnlyNo
35B53C39Is In Packed LibraryReturns TRUE if a packed project library contains the project item.Read OnlyYes
35B53C3APacked LibraryRead OnlyYes
35B53C3BFind:Items Incorrectly Claimed by a LibraryReturns an array of references to all items within a project that are claimed by a library but do not reciprocate the claim.Read OnlyNo
35B53C3CIs In Packed Library And Not ExportedRead OnlyYes
35B53C3DIs Packed LibraryRead OnlyYes
35B53C3EIs Variable Namespace?Read OnlyNo

Methods

Show/Hide ProjectItem Properties Table

Legend
RTEAvailable in the Run-Time Engine
Basic Development Environment
VI Scripting
Private
Deprecated
ProjectItem Methods Table
Method ID Long Name (English) Description RTE
35B53800Add FileAdds a file at the specified path to the LabVIEW project with the referenced project item as the parent. You also can use the Project Explorer window to add a file to a project.No
35B53801Add ItemAdds a new project item of the specified type to the LabVIEW project with the referenced item as the parent. You also can use the Project Explorer window to add an item to a project.No
35B53803DeleteRemoves the referenced project item from the LabVIEW project. If the item has children, the children also are deleted. You also can use the Project Explorer window to remove items from the project.No
35B53809Close RefeeNo
35B5380ADebug Bind:To ItemNo
35B5380BDebug Bind:To ChildrenNo
35B5380CTag:Get TagReturns a tag value associated with the project item.Yes (Read/Write)
35B5380DTag:Set TagSets a tag value associated with the LabVIEW project.No
35B5380ETag:DeleteRemoves the named tag from the LabVIEW project item.No
35B5380FTag:Get NamesReturns an array of tag names of all tags on the referenced project item.Yes (Read/Write)
35B53810Get All DescendentsRecursively returns project items that appear under the referenced item in the project tree. For example, if you call this method on project library A that contains an inner project library B, the method returns items owned both by library A and library B.Yes (Read/Write)
35B53811Make Item Visible in TreeNo
35B53812Select ItemNo
35B53813Simulate:Drag SelectionNo
35B53814Simulate:CopyNo
35B53815Simulate:PasteNo
35B53816Simulate:Drag To VINo
35B53817Simulate:Paste To VINo
35B53818Simulate:Drag From PathsNo
35B53819CollapseHides the contents of an expandable project item in the Project Explorer window. Expandable project items include folders, project libraries, LabVIEW classes, and XControls.No
35B5381ARenameNo
35B5381BNew from TemplateNo
35B5381CSuppress Project DialogsNo
35B5381DSimulate:NotifyNo
35B5381ESCC Get InfoNo
35B5381FQuery BehaviorNo
35B53820MoveNo
35B53821Delete Privately (tell no outsiders)No
35B53822Tag:Get XML TagReturns the value in an XML tag.Yes (Read/Write)
35B53823Tag:Set XML TagSets the value of an XML tag associated with the LabVIEW project.No
35B53824Add Item From MemoryAdds an item that exists in memory to the LabVIEW project with the referenced project item as the parent.No
35B53825Notify Item ChangedNo
35B53826ExpandDisplays the contents of an expandable project item in the Project Explorer window. Expandable project items include folders, project libraries, LabVIEW classes, and XControls.No
35B53827Arrange ByNo
35B53828Set UrlNo
35B53829Get All Descendents2Yes
35B5382AGetFindResultsYes
35B5382BConvert to Auto-populating FolderConnect this project item to a folder on disk.No
35B5382CStop Auto-populatingDisconnect this folder from a folder on disk.No
35B5382DDelete On DiskYes
35B5382EList of Refer ProjectItemsYes
35B5382FReplace With Item in ProjectYes
35B53830Choose SubstituteYes
35B53831AddMultipleItemsYes
35B53832ForceDeleteYes
35B53833BoundsYes
35B53834Get Variable URLsNo
35B53835Add Item From Memory PrivatelyNo
35B53836Get Library Access ScopeNo
35B53837Replace Item WithNo

Events

This class has no events.


History

Version Change(s)
LabVIEW 2018 More info to come.

See Also