# zqt5

**Repository Path**: bbqz007/zqt5

## Basic Information

- **Project Name**: zqt5
- **Description**: zqt5     .
- **Primary Language**: C++
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: http://www.cnblogs.com/bbqzsl
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2022-03-01
- **Last Updated**: 2024-09-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

### concepts
Forget about APIs, don't waste time trying to memorize them.

there are two core operators only, the `( )` and `[ ]`.
* `( )` begin with a layout or an element.
* `[ ]` any properties or fired events.
* [just like](#just-like) `(new element)[prop1][prop2][onclick=lambda]`, like a html `<tag prop1 prop2 onclick=js_func() />`
  
#### easy syntax to write qt5 window base on QWidgets.
![img](https://github.com/bbqz007/KTL/blob/master/resources/GIF_KTL_QT_TOOL2_EDIT.gif)
[if you want this easy syntax apply to WxWidgets, click here](github.com/bbqz007/zhelper-wxWidgets).



## try
you do not need to depoly any compiler platform and sdks.

goto my another project [if you are goinng to try, click KTL](https://github.com/bbqz007/KTL). download the newest app, size of 71M only.

you can use KTL app to program qt window and run it for fun, regardless of any huge hard deployment.

## how to use

* 1. run moc zqt_helper.h > zqt_helper_moc.h

* 2. include zqt_helper.h on your project's source code.

* 3. switch on c++14.

## how to write layouts?

* 1. begin with calling **layout::begin**(somelayout)

* 2. add elements(layout or widget) to layout, by calling **operator ()** (widget)

* 3. configure your latest added elements, by calling **operator []** (prop)

* 4. end with calling operator () **(layout::end)**

### just like 
```c++
layout::begin(somelayout)   // begin to write a layout
    [prop]              // configure layout properties of somelayout
    (new element)           // add a element to somelayout
        [prop]              // configure layout properties of new element
        [onclick = ...]     // configure onclick function associated with new element
        [onchar = ...]      // configure onchar function associated with new element
    (layout::end)           // end up writing a layout
```
as easy like writing a html
```html
<div id='0'>
    <div id='1'>
        <input type="button" onclick="handler()">
    </div>
    <div id='2'>
        <input type="button" onclick="handler()">
    </div>
    <div id='3'>
        <input type="button" onclick="handler()">
    </div>
    <div id='4'>
        <input type="button" onclick="handler()">
    </div>
</div>
```

### you can easily write menus like this
```c++
Frame* frame = new Frame;
Delegate* delegate = new Delegate(frame);
menu::begin(new MenuBar)
    ("File", 
         menu::begin(new Menu)
            (ID_OPEN, "open")
                [onclick = [=] (event& e) {
                    delegate->handle(e);
                }]
            (ID_NEW,  "new")  
                [onclick, [=] (event& e) {
                    delegate->handle(e);
                }]
            (menu::end))
     ("About",
          menu::begin(new Menu)
            (ID_HELP,   "help")
                [onclick, [=] (event&)  {   }]
            (menu::end))
     (menu::end,   
        [=] (MenuBar* mb) {
            frame->SetMenuBar(mb);
        });
```

### you can easily write windows like this as well:
```c++
Frame* frame = new Frame;
layout::begin(new layout)
    (layout::begin(new layout)
        [layout_flags]
        (new textctrl)
            [layout_flags]
            [ ondropfiles = [] (event&) {} ]
            [ onchar = [] (event&) {} ]
        (new button) 
            [layout_flags]
            [ onclick = [] (event&) {} ]
        (layout::end))
    (layout::begin(new layout)
        [layout_flags]
        (new textctrl)
            [layout_flags]
        (new button) 
            [layout_flags]
            [ onclick = [] (event&) {} ]
        (layout::end))
    (layout::begin(new layout)
        (new button) 
            [ onclick = [] (event&) {} ]
        (layout::end))
    (layout::begin(new layout)
        (new button) 
            [ onclick = [] (event&) {} ]
        (layout::end))
    (layout::end, 
     layout::oncomplete = [=] (layout& layout) {
         frame->SetLayout(layout);
     });
```


## how to use?

just include the header and use c++11.

## how to write layouts?

* 1. begin with calling **layout::begin**(somelayout)

* 2. add elements(layout or widget) to layout, by calling **operator ()** (widget)

* 3. configure your latest added elements, by calling **operator []** (prop)

* 4. end with calling operator () **(layout::end)**

### just like 
```c++
layout::begin(somelayout)   // begin to write a layout
    [prop]              // configure layout properties of somelayout
    (new element)           // add a element to somelayout
        [prop]              // configure layout properties of new element
        [onclick = ...]     // configure onclick function associated with new element
        [onchar = ...]      // configure onchar function associated with new element
    (layout::end)           // end up writing a layout
```


#### 1. easy way to write QTableWidget headers (columns)
```c++
QTableWidget* p = new QTableWidget;
using namespace zhelper::qt5Widgets::tblwdgthlp;
column::begin(p)
  ("col 1") [ font ] [ color ] [ length ]
  ("col 2") [ font ] [ color ] [ length ]
  (column::end)
```

#### 2. easy way to append rows into wxListCtrl
```c++
row::begin(p)
  ("row 1_col 1") [ font ] [ color ]
  ("row 1_col 2") [ font ] [ color ]
  (row::another)
  ("row 2_col 1") [ font ] [ color ]
  ("row 2_col 2") [ font ] [ color ]
  (row::end)
```

#### 3. easy way to modify cell of wxListCtrl
```c++
cell::begin(p)
  (1, 1)    // row 2 , col 2
    [ "change value" ] [ change_font ] [ change_color ]
  (0, 1)    // row 1 , col 2
    [ "change value" ] [ change_font ] [ change_color ]
   (cell:end)
```