Hide Checkbox Example
Using components' package.xml files to hide checkboxes for items.
Hide Checkbox illustrates how to hide the checkbox for an item.
Configuring the Example Installer
The installer configuration file, config.xml, in the config
directory specifies the text and default values used in the installer:
- The
<Name>
element specifies the application name that is added to the page name and introduction text. - The
<Version>
element specifies the application version number. - The
<Title>
element specifies the installer name displayed on the title bar. - The
<Publisher>
element specifies the publisher of the software (as shown in the Windows Control Panel, for example). - The
<StartMenuDir>
element specifies the name of the default program group for the product in the Windows Start menu. - The
<TargetDir>
element specifies that the default target directory is located in theIfwExamples
directory in the home directory of the current user (because the predefined variable@HomeDir@
is used as a part of the value). For more information, see Predefined Variables.
<?xml version="1.0" encoding="UTF-8"?> <Installer> <Name>Hide item checkbox</Name> <Version>1.0.0</Version> <Title>Hide checkbox</Title> <Publisher>The Qt Company</Publisher> <StartMenuDir>Qt IFW Examples</StartMenuDir> <TargetDir>@HomeDir@/IfwExamples/hidecheckbox</TargetDir> </Installer>
Creating the Example Package Information File
The installer package information file, package.xml, in the meta
directory specifies the components that are available for installation:
- The
<DisplayName>
element specifies the human-readable name of the component. - The
<Description>
element specifies the human-readable description of the component. - The
<Version>
element specifies the version number of the component. - The
<ReleaseDate>
element specifies the date when this component version was released.
- The
<Checkable>
element specifies whether a checkbox is displayed next to an item. Set tofalse
to hide the checkbox for the item.
This example attempts to install three components, so we create a package.xml file in each component directory: componentF, componentF.subcomponent1, and componentF.subcomponent1.subcomponent1. We also specify the component name and description in each of them. The top level item, componentF, has <Checkable>
set to false
, so it cannot be selected.
<?xml version="1.0"?> <Package> <DisplayName>Uncheckable component</DisplayName> <Description>This component is uncheckable.</Description> <Version>1.0.0</Version> <ReleaseDate>2015-12-01</ReleaseDate> <SortingPriority>40</SortingPriority> <Checkable>false</Checkable> </Package>
Generating the Example Installer
To create the example installer, switch to the example source directory on the command line and enter the following command:
- On Windows:
..\..\bin\binarycreator.exe -c config\config.xml -p packages installer.exe
- On Linux or macOS:
../../bin/binarycreator -c config/config.xml -p packages installer
The installer is created in the current directory.
Files:
- hidecheckbox/config/config.xml
- hidecheckbox/hidecheckbox.pro
- hidecheckbox/packages/componentF.subcomponent1.subsubcomponent1/data/testF_sub1_sub1.txt
- hidecheckbox/packages/componentF.subcomponent1.subsubcomponent1/meta/package.xml
- hidecheckbox/packages/componentF.subcomponent1/data/testF_sub1.txt
- hidecheckbox/packages/componentF.subcomponent1/meta/package.xml
- hidecheckbox/packages/componentF/data/testF.txt
- hidecheckbox/packages/componentF/meta/package.xml