Difference between revisions of "$VERSIONINFO"

From QB64 Wiki
Jump to navigation Jump to search
imported>Clippy
imported>SMcNeill
(style guidelines)
Line 1: Line 1:
{{DISPLAYTITLE:$VERSIONINFO}}   
{{DISPLAYTITLE:$VERSIONINFO}}   
The '''$VERSIONINFO''' GL [[Metacommand]] adds programmer text metadata to '''Windows only''' binaries for identification purposes across the OS.
The [[$VERSIONINFO]] [[Metacommand|metacommand]] adds text metadata to the resulting executable for identification purposes across the OS. Windows-only.




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




{{Parameters}}
{{Parameters}}
* Text ''keys'': '''CompanyName, FileDescription, InternalName, LegalCopyright, LegalTrademarks, OriginalFilename, ProductName, Web, Comments'''
* Text ''keys'' can be: '''CompanyName, FileDescription, InternalName, LegalCopyright, LegalTrademarks, OriginalFilename, ProductName, Web, Comments'''
* Numeric ''keys'':'''FILEVERSION#''' and '''PRODUCTVERSION#'''  
* 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).
* 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)
* Numeric key=''value'' must be 4 comma-separated numerical text values entered by programmer which usually stand for major, minor, revision and build numbers).
* Available starting with build 20170429/52 (released on April 29th 2017)
* [[Keywords_currently_not_supported_by_QB64#Keywords_Not_Supported_in_Linux_or_MAC_OSX_versions|Not available in Linux or macOS]].


==Availability==
* '''Build 20170429/52 and up'''.


Example: Adding metadata to a Windows exe compiled with QB64:
 
{{PageExamples}}
''Example:'' Adding metadata to a Windows exe compiled with QB64:
{{CodeStart}}
{{CodeStart}}
{{Cl|$VERSIONINFO}}:CompanyName=Your company name goes here
{{Cl|$VERSIONINFO}}:CompanyName=Your company name goes here
Line 28: Line 32:
{{PageSeeAlso}}
{{PageSeeAlso}}
* [[$EXEICON]]  
* [[$EXEICON]]  
* [[_ICON]]  
* [[_ICON]]
* [https://msdn.microsoft.com/library/windows/desktop/aa381058(v=vs.85).aspx VERSIONINFO resource (MSDN)]




{{PageNavigation}}
{{PageNavigation}}

Revision as of 17:34, 9 September 2017

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).
  • 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