Ad5001/MixedMenu
1
1
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Editing README

Browse source
This commit is contained in:
Ad5001 2021-07-12 14:50:23 +02:00
parent bcae0ab456
commit 092a101d2d
Signed by: Ad5001
GPG key ID: EF45F9C6AFE20160
1 changed files with 28 additions and 9 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

37
README.md
View file

@ -1,15 +1,34 @@
# MixedMenu
Simple library for QML allowing the mixed use of Native Menus and QtQuick ones.
---
It provides near drop-in replacements for QtQuick.Controls 2 menus making use of the platform native ones on supported platforms like MacOSX.
It can be used for MenuBars, as well as context menus.
It provides near drop-in replacements for QtQuick.Controls2 menus allowing to use the platform native ones on supported platforms like MacOSX.
Only required change:
# Switching from QtQuick.Controls 2
|QtQuick.Controls2/Qt.labs| > |eu.ad5001.MixedMenu |
|-------------------------|---|--------------------------------------------------------|
|`icon.name: ...` | > |`iconName: ...` |
|`icon.source: ...` | > |`iconSource: ...` |
|`icon.color: ...` | > |`iconColor: ...` |
|`menuBar: MenuBar {}` | > |`MenuBar { id: appMenu }`<br>`menuBar: appMenu.trueItem`|
## Add MixedMenu as QML module
The first thing you need to do is to add MixedMenu to your QML Import Path.
To do so, follow these steps:
1. Go into a QML Import path directory in your project (or Qt's main QML import path).
2. Create an "eu" directory, within an "ad5001" directory should be created.
3. Go into the "ad5001" folder
4. Install MixedMenu there.
- If you're using Git as version control, you can use `git submodule add https://git.ad5001.eu/Ad5001/MixedMenu`.
- Otherwise, simply clone the repository using `git clone https://git.ad5001.eu/Ad5001/MixedMenu`.
- Or download the archive from [here](https://git.ad5001.eu/Ad5001/MixedMenu/archive/main.zip).
Requires Qt version >5.12
## Code changes
When switching from QtQuick.Controls 2 to MixedMenu, the following changes need to be made to your Menu code:
|QtQuick.Controls2/Qt.labs | > |eu.ad5001.MixedMenu |
|-------------------------------------|---|--------------------------------------------------------|
|`import import QtQuick.Controls 2.12`| > |`import eu.ad5001.MixedMenu 1.0` |
|`icon.name: ...` | > |`iconName: ...` |
|`icon.source: ...` | > |`iconSource: ...` |
|`icon.color: ...` | > |`iconColor: ...` |
|`menuBar: MenuBar {}` | > |`MenuBar { id: appMenu }`<br>`menuBar: appMenu.trueItem`|
## Requirements
MixedMenu requires Qt version >5.12 with QML support enabled.