Difference between revisions of "$VERSIONINFO"

From QB64 Wiki
Jump to navigation Jump to search
imported>Clippy
(Created page with '{{DISPLAYTITLE:$VERSIONINFO}} {{PageSyntax}} {{Parameters}} {{PageDescription}} {{PageErrors}} Example: {{CodeStart}} {{CodeEnd}} {{PageSeeAlso}} {{PageNavigati…')
 
 
(6 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{DISPLAYTITLE:$VERSIONINFO}}   
{{DISPLAYTITLE:$VERSIONINFO}}   
 
The [[$VERSIONINFO]] [[Metacommand|metacommand]] adds text metadata to the resulting executable for identification purposes across the OS. Windows-only.




{{PageSyntax}}
{{PageSyntax}}
: [[$VERSIONINFO]]:{{Parameter|key}}={{Parameter|value}}




{{Parameters}}
{{PageParameters}}
* Text ''keys'' can be: '''CompanyName, FileDescription, InternalName, LegalCopyright, LegalTrademarks, OriginalFilename, ProductName, Web, Comments'''
* Numeric {{Parameter|keys}} can be:'''FILEVERSION#''' and '''PRODUCTVERSION#'''




{{PageDescription}}
{{PageDescription}}
* Text and numerical values are string literals without quotes entered by programmer. '''No variables are accepted.''' (variable names would be interpreted as literals).
* Numeric key=''value'' must be 4 comma-separated numerical text values entered by programmer which usually stand for major, minor, revision and build numbers).
* A manifest file is automatically embedded into the resulting .exe file so that Common Controls v6.0 gets linked at runtime, if required.
* [[Keywords_currently_not_supported_by_QB64#Keywords_Not_Supported_in_Linux_or_MAC_OSX_versions|Not available in Linux or macOS]].




{{PageErrors}}
{{PageAvailability}}
* Build 20170429/52 and up.


Example:
 
{{PageExamples}}
''Example:'' Adding metadata to a Windows exe compiled with QB64:
{{CodeStart}}
{{CodeStart}}
{{Cl|$VERSIONINFO}}:CompanyName=Your company name goes here
{{Cl|$VERSIONINFO}}:FILEVERSION#=1,0,0,0
{{Cl|$VERSIONINFO}}:PRODUCTVERSION#=1,0,0,0
{{CodeEnd}}  
{{CodeEnd}}  




{{PageSeeAlso}}
{{PageSeeAlso}}
* [[$EXEICON]]
* [[_ICON]]
* [https://msdn.microsoft.com/library/windows/desktop/aa381058(v=vs.85).aspx VERSIONINFO resource (MSDN)]
 


{{PageNavigation}}
{{PageNavigation}}

Latest revision as of 15:55, 9 October 2021

The $VERSIONINFO metacommand adds text metadata to the resulting executable for identification purposes across the OS. Windows-only.


Syntax

$VERSIONINFO:key=value


Parameters

  • Text keys can be: CompanyName, FileDescription, InternalName, LegalCopyright, LegalTrademarks, OriginalFilename, ProductName, Web, Comments
  • Numeric keys can be:FILEVERSION# and PRODUCTVERSION#


Description

  • Text and numerical values are string literals without quotes entered by programmer. No variables are accepted. (variable names would be interpreted as literals).
  • Numeric key=value must be 4 comma-separated numerical text values entered by programmer which usually stand for major, minor, revision and build numbers).
  • A manifest file is automatically embedded into the resulting .exe file so that Common Controls v6.0 gets linked at runtime, if required.
  • Not available in Linux or macOS.


Availability

  • Build 20170429/52 and up.


Examples

Example: Adding metadata to a Windows exe compiled with QB64:

$VERSIONINFO:CompanyName=Your company name goes here $VERSIONINFO:FILEVERSION#=1,0,0,0 $VERSIONINFO:PRODUCTVERSION#=1,0,0,0


See also



Navigation:
Keyword Reference - Alphabetical
Keyword Reference - By Usage
Main Wiki Page