solemnwarning/wxwidgets
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 4

Add support for XRC "feature" attribute

Browse source 
This is a generalization of the existing "platform" attribute and allows
to only include some XRC elements if and only if an arbitrary "feature"
is enabled by the application before loading the XRC document.
This commit is contained in:
Vadim Zeitlin 2023-01-29 00:53:11 +00:00
parent 8139d8d3b7
commit 3fdebc96cd
5 changed files with 121 additions and 3 deletions
Download patch file Download diff file Expand all files Collapse all files

48
docs/doxygen/overviews/xrc_format.h
View file

@ -2853,6 +2853,54 @@ Examples:
@endcode
@section overview_xrcformat_features Feature-specific Content
Similarly to the platform-specific features, but even more flexibly, XRC
elements can use @c feature attribute. Just as above, the value of this
attribute is a |-separated list of strings but, unlike platforms, these strings
don't have any intrinsic meaning and the program must call
wxXmlResource::EnableFeature() to indicate which features should be considered
to be enabled.
Any element using the @c feature attribute not including any enabled features
is ignored when loading the XRC document. Because by default all features are
disabled, this means that all elements with this attribute are discarded if
wxXmlResource::EnableFeature() is not called at all.
For example, an educational program might exist in several builds targeting
different subjects and enable or disable different features in them:
@code
<object class="wxNotebook">
<object class="notebookpage"> <!-- No feature, so always present -->
<label>Overview</label>
...
</object>
<object class="notebookpage" feature="humanities">
<label>History</label>
...
</object>
<object class="notebookpage" feature="science">
<label>Physics</label>
...
</object>
<object class="notebookpage" feature="science">
<label>Chemistry</label>
...
</object>
<object class="notebookpage" feature="science|humanities">
<label>Economics</label>
...
</object>
</object>
@endcode
By calling
@code
wxXmlResource::Get()->EnableFeature("humanities");
@endcode
before loading the XRC document, the program would request loading the first
two and the last pages only.
@section overview_xrcformat_idranges ID Ranges