Merge pull request MicrosoftDocs#1713 from msebolt/resource-file-consolidation-pr26

resource file consolidation pr26

Author: Ja-Dunn

.openpublishing.redirection.json

@@ -7630,6 +7630,26 @@
             "redirect_url": "/cpp/windows/creating-moving-and-editing-toolbar-buttons",
             "redirect_document_id": false
         },
+        {
+            "source_path": "docs/windows/editing-a-string-in-a-version-information-resource.md",
+            "redirect_url": "/cpp/windows/version-information-editor",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "docs/windows/adding-version-information-for-another-language.md",
+            "redirect_url": "/cpp/windows/version-information-editor",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "docs/windows/deleting-a-version-information-block.md",
+            "redirect_url": "/cpp/windows/version-information-editor",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "docs/windows/accessing-version-information-from-within-your-program.md",
+            "redirect_url": "/cpp/windows/version-information-editor",
+            "redirect_document_id": false
+        },
         {
             "source_path": "docs/windows/activationfactory-activationfactory-constructor.md",
             "redirect_url": "/cpp/windows/activationfactory-class#activationfactory",

docs/windows/TOC.md

@@ -141,10 +141,6 @@
 ##### [Creating, Moving, and Editing Toolbar Buttons](creating-moving-and-editing-toolbar-buttons.md)
 ##### [Creating a Tool Tip for a Toolbar Button](creating-a-tool-tip-for-a-toolbar-button.md)
 #### [Version Information Editor](version-information-editor.md)
-##### [Editing a String in a Version Information Resource](editing-a-string-in-a-version-information-resource.md)
-##### [Adding Version Information for Another Language](adding-version-information-for-another-language.md)
-##### [Deleting a Version Information Block](deleting-a-version-information-block.md)
-##### [Accessing Version Information from Within Your Program](accessing-version-information-from-within-your-program.md)
 # [Active Template Library (ATL)](../atl/TOC.md)
 # [Microsoft Foundation Classes (MFC)](../mfc/TOC.md)
 # [ATL and MFC Shared Classes](../atl-mfc-shared/TOC.md)

docs/windows/accessing-version-information-from-within-your-program.md

@@ -1,39 +1,73 @@
 ---
 title: "Version Information Editor (C++)"
 ms.date: "11/04/2016"
-f1_keywords: ["vc.editors.version.F1"]
-helpviewer_keywords: ["Version Information editor [C++], about Version Information editor", "editors, Version Information", "resource editors [C++], Version Information editor"]
+f1_keywords: ["vc.editors.version.F1", "vc.editors.version"]
+helpviewer_keywords: ["Version Information editor [C++], about Version Information editor", "editors, Version Information", "resource editors [C++], Version Information editor", "version information resources [C++]", "resources [C++], editing version information", "languages, version information", "New Version Info Block", "blocks, adding", "resources [C++], adding version information", "version information, adding for languages", "blocks, deleting", "version information, deleting blocks", "resources [C++], deleting version information", "VerQueryValue", "version information, accessing from within programs", "GetFileVersionInfo", "version information"]
 ms.assetid: 772e6f19-f765-4cec-9521-0ad3eeb99f9b
 ---
 # Version Information Editor (C++)
 
-Version information consists of company and product identification, a product release number, and copyright and trademark notification. With the **Version Information** editor, you create and maintain this data, which is stored in the version information resource. The version information resource is not required by an application, but it is a useful place to collect information that identifies the application. Version information is also used by setup APIs.
+Version information consists of company and product identification, a product release number, and copyright and trademark notification. With the **Version Information** editor, you create and maintain this data, which is stored in the version information resource. The version information resource is not required by an application, but it's a useful place to collect information that identifies the application. Version information is also used by setup APIs.
 
 A version information resource has an upper block and one or more lower blocks: a single fixed-information block at the top and one or more version information blocks at the bottom (for other languages and/or character sets). The top block has both editable numeric boxes and selectable drop-down lists. The lower blocks have only editable text boxes.
 
 > [!NOTE]
 > The Windows standard is to have only one version resource, named VS_VERSION_INFO.
 
-The **Version Information** editor enables you to:
+For information on adding resources to managed projects, see [Resources in Desktop Apps](/dotnet/framework/resources/index) in the *.NET Framework Developer's Guide*. For information on manually adding resource files to managed projects, accessing resources, displaying static resources, and assigning resource strings to properties, see [Creating Resource Files for Desktop Apps](/dotnet/framework/resources/creating-resource-files-for-desktop-apps). For information on globalization and localization of resources in managed apps, see [Globalizing and Localizing .NET Framework Applications](/dotnet/standard/globalization-localization/index).
 
-- [Edit a string in a version information resource](../windows/editing-a-string-in-a-version-information-resource.md)
+The **Version Information** editor enables you:
 
-- [Add version information for another language (new version info block)](../windows/adding-version-information-for-another-language.md)
+## To edit a string in a version information resource
 
-- [Delete a version information block](../windows/deleting-a-version-information-block.md)
+Select the item once to choose it, then again to begin editing it. Make the changes directly in the **Version Information** table or in the [Properties window](/visualstudio/ide/reference/properties-window). The changes you make will be reflected in both places.
 
-- [Access version information from within your program](../windows/accessing-version-information-from-within-your-program.md)
+   > [!NOTE]
+   > When editing the `FILEFLAGS` key in the **Version Information** editor, you'll notice you cannot set the **Debug**, **Private Build**, or **Special Build** properties (in the **Properties** window) for .rc files:
+
+   - The **Version Information** editor sets the **Debug** property with a `#ifdef` in the resource script, based on the `_DEBUG` build flag.
+
+   - If the `Private Build` key has a **Value** set in the **Version Information** table, the corresponding **Private Build** property (in the **Properties** window) for the `FILEFLAGS` key will be **True**. If the **Value** is empty, the property will be **False**. Likewise, the **Special Build** key (in the **Version Information** table) is tied to the **Special Build** property for the `FILEFLAGS` key.
+
+You can sort the information sequence of the string block by clicking either the **Key** or the **Value** column headings. These headings automatically rearrange the information into the selected sequence.
+
+## To add version information for another language (new version info block)
+
+1. Open a version information resource by double-clicking it in [Resource View](../windows/resource-view-window.md).
+
+   > [!NOTE]
+   > If your project doesn't already contain an .rc file, please see [Creating a New Resource Script File](../windows/how-to-create-a-resource-script-file.md).
+
+1. Right-click within the version information table and choose **New Version Info Block** from the shortcut menu.
+
+   This command adds an additional information block to the current version information resource and opens its corresponding properties in the [Properties window](/visualstudio/ide/reference/properties-window).
+
+1. In the **Properties** window, choose the appropriate language and character set for your new block.
+
+## To delete a version information block
+
+1. Open the version information resource by double-clicking its icon in [Resource View](../windows/resource-view-window.md).
 
    > [!NOTE]
-   > While using the **Version Information** editor, in many instances you can right-click to display a shortcut menu of resource-specific commands. For example, if you click while pointing to a block header entry, the shortcut menu shows the **New Version Block Info** and **Delete Version Block Info** commands.
+   > If your project doesn't already contain an .rc file, please see [Creating a New Resource Script File](../windows/how-to-create-a-resource-script-file.md).
+
+1. Right-click the block header you wish to delete then choose **Delete Version Info Block** from the shortcut menu.
 
-For information on adding resources to managed projects, please see [Resources in Desktop Apps](/dotnet/framework/resources/index) in the *.NET Framework Developer's Guide*. For information on manually adding resource files to managed projects, accessing resources, displaying static resources, and assigning resource strings to properties, see [Creating Resource Files for Desktop Apps](/dotnet/framework/resources/creating-resource-files-for-desktop-apps). For information on globalization and localization of resources in managed apps, see [Globalizing and Localizing .NET Framework Applications](/dotnet/standard/globalization-localization/index).
+   This command deletes the selected header and leaves the rest of the version information intact. You can't undo the action.
+
+## To access version information from within your program
+
+If you want to access the version information from within your program, use the [GetFileVersionInfo](/windows/desktop/api/winver/nf-winver-getfileversioninfoa) function and the [VerQueryValue](/windows/desktop/api/winver/nf-winver-verqueryvaluea) function.
+
+   > [!NOTE]
+   > While using the **Version Information** editor, in many instances you can right-click to display a shortcut menu of resource-specific commands. For example, if you select while pointing to a block header entry, the shortcut menu shows the **New Version Block Info** and **Delete Version Block Info** commands.
 
 ## Requirements
 
 Win32
 
-## See Also
+## See also
 
 [Resource Editors](../windows/resource-editors.md)<br/>
-[Menus and Other Resources](https://msdn.microsoft.com/library/windows/desktop/ms632583.aspx)
+[Menus and Other Resources](https://msdn.microsoft.com/library/windows/desktop/ms632583.aspx)<br/>
+[Version Information (Windows)](https://msdn.microsoft.com/library/windows/desktop/ms646981.aspx)