Version Info Dialog Box

Use this dialog box to enter version information for your application. Click the Version Info button in the Target Settings dialog box for DLLs or executables to open the Version Info dialog box.

LabWindows/CVI saves the version information you enter in this dialog box as a standard Windows version resource. You can obtain this information from your application by using the Windows SDK functions GetFileVersionInfo and GetFileVersionInfoSize.

In the Numeric Information section of the Version Info dialog box, File Version and Product Version must be in the following form:

n.n.n.n

where n is a number from 0 to 65535.

LabWindows/CVI auto-increments fields in which you add a + character. For example, if you specify 1.0+.0.0+, the next version string is 1.0.0.0, and LabWindows/CVI increments the version string to 1.1+.0.1+. Auto-incrementing causes LabWindows/CVI to rebuild projects in Release configurations. LabWindows/CVI increments fields only for successful builds of a Release configuration.

Note Note  When n reaches 65536, auto-incrementing resets the number to 0.

You can access the File Version and Product Version values programmatically using the _TARGET_FILE_VERSION_ and _TARGET_PRODUCT_VERSION_ predefined macros.

Enter the appropriate details in the Text Information section. You can use the following symbolic items in the Text Information section:

  • %company—The company name that you entered during the LabWindows/CVI installation.
  • %application—The Application title you specified in the Target Settings dialog box, or the file basename if the target is a DLL.
  • %basename—The target filename, without the dot and file extension.
  • %filename—The target filename.
  • %user—The Windows username of the current user.
  • %configname—The name of the configuration. This is the name that appears in the Configuration submenu.
  • %rel_dbg—The configuration (release or debug) of the application.
  • %arch—The bitness (x86 or x64) of the application.
  • %f1—The first field of the numeric file version, for example 1 if the version is 1.2.3.4.
  • %f2—The second field of the numeric file version, for example 2 if the version is 1.2.3.4.
  • %f3—The third field of the numeric file version, for example, 3 if the version is 1.2.3.4.
  • %f4—The fourth field of the numeric file version, for example, 4 if the version is 1.2.3.4.
  • %p1—The first field of the numeric product version, for example, 1 if the version is 1.2.3.4.
  • %p2—The second field of the numeric product version, for example, 2 if the version is 1.2.3.4.
  • %p3—The third field of the numeric product version, for example, 3 if the version is 1.2.3.4.
  • %p4—The fourth field of the numeric product version, for example, 4 if the version is 1.2.3.4.
  • %cvi_year—The year-based version of LabWindows/CVI used to build the project.
  • %cvi_ver—The numerical version of LabWindows/CVI used to build the project.

You also can specify any of the absolute date/time specifiers supported by the FormatDateTimeString function. LabWindows/CVI replaces those specifiers based on the time when you build the target.

Note Note  Consider using a string such as Built by %user on %m/%d/%Y at %H:%M:%S in the Comments field to automatically include information in your application about when and by whom the file was created.

LabWindows/CVI replaces all of the symbolic items you specify with corresponding strings when you build the application. To see the corresponding strings for the symbolic items, check Preview Substitutions.

WAS THIS ARTICLE HELPFUL?

Not Helpful