使用WEB服务生成代码：

进入GLAD2的WEB页面后，可按Generator（编程语言），OpenGL各API版本，如OpenGL, OpenGL ES, GLX，WGL等，选了API版本后，Extensions可按需选择，或使用ADD ALL一键加入所有扩展（推荐）

Options中有几个重要选项：

alias - 默认情况下，glad的OpenGL函数带glad_前缀，例如glEnable，需使用glad_glEnable，选中这个选项后，可直接使用glEnable，不需要带前缀

loader - 生成gladLoadXXX()这种不带参数的loader，如果不选，则需使用自己传入如glfwgetprocaddress这样的load function的版本，尤其是WGL，有大坑，这个选项非常推荐选上

点击generate后，会进入一个页面，包含include，src和glad.zip（下载后加入到项目中的代码），官方推荐的使用方式是将其中的*.h，*.c文件直接加入到自己项目中的源代码中，比如在add_execution/add_library时，如果需要编译成so/dll这样的动态链接库，需有以下几点要注意：

编译成动态链接库时，glad需定义GLAD_API_CALL_EXPORT_BUILD，否则不会导出函数，可使用target_add_definitions在CMakeLists.txt加入

使用glad动态链接库的程序，需定义GLAD_API_CALL_EXPORT，否则会链接失败，另外#include <glad/gl.h>需放在所有其它有#include <gl.h>之类包含了OpenGL的头文件之前的位置，否则会编译失败

动态链接时，程序中所有模块只需调用一次loader即可初始化OpenGL函数地址，可通过判断glad_glEnable函数指针是否为nullptr来判断是否需调用loader，WGL可通过判断相应的glad_wglXXX是否为nullptr来按需调用loader

当对一个QWidget调用winId时，默认情况下，Qt会对该窗口进行Native化，从而导致如鼠标等事件被其它原生窗口接管，表现出来的现像就是窗口不响应任何事件

解决思路：

防止Qt窗口Native化

解决办法：

第一步，在创建QApplication对象之前设置：

QApplication::setAttribute(Qt::AA_DontCreateNativeWidgetSiblings);
//注意：Qt::AA_NativeWindows受环境变量 QT_USE_NATIVE_WINDOWS控制，
//有可能环境变量被别的软件修改，所以也需要设置下
QApplication::setAttribute(Qt::AA_NativeWindows,false);

第二步，在调用winId之前对该QWidget设置：

this->setAttribute(Qt::WA_DontCreateNativeAncestors);

先通过glViewPort调整视口

void resizeGL(int w, int h) {
    glViewport(0, 0, w, h);
}

再根据窗口高宽比，计算出合适的投影矩阵，这样体现出来的样式，就是截掉了宽高比之外的内容，显示的内容不变形，正圆就是正圆，不会被拉伸成椭圆

float aspect=(float)w/h;
glm::mat4 projection;
if(aspect>=1.0f){
    projection = glm::ortho(-aspect, aspect, -1.0f, 1.0f, -0.1f, 1.0f);
}else{
    projection = glm::ortho(-1.0f, 1.0f, -1.0f/aspect, 1.0f/aspect, -0.1f, 1.0f);
}

顶点着色器就按标准方式乘以对应的矩阵

#version 330 core
layout (location = 0) in vec3 aPos;
...
uniform mat4 model;
uniform mat4 view;
uniform mat4 projection;

void main()
{
    // 注意乘法要从右向左读
    gl_Position = projection * view * model * vec4(aPos, 1.0);
    ...
}

#编译
cmake --build . --config Debug/Release
#安装，将安装到CMAKE_INSTALL_PREFIX下，默认是安装Release配置
cmake --install . --config Debug/Release

环境变量，设定好后就是全局可用，不会因为add_subdirectory而变化，在多级的子项目时尤其好用：

set(ENV{PROJ_BASE_DIR} ${CMAKE_CURRENT_SOURCE_DIR})

带缓存的PATH变量，可让Visual Studio/CMake GUI等工具有一个可选择文件夹路径的变量，并保存在缓存中，非常方便编辑：

set(OPENCV_DIR $ENV{OPENCV_ROOT} CACHE PATH "Root path of opencv")
    if(DEFINED OPENCV_DIR)
        list(APPEND CMAKE_PREFIX_PATH ${OPENCV_DIR})
    endif()

设置exe/dll/pdb文件输出路径：

set(CMAKE_RUNTIME_OUTPUT_DIRECTORY $ENV{PROJ_OUTPUT_DIR}/out)
set(CMAKE_LIBRARY_OUTPUT_DIRECTORY $ENV{PROJ_OUTPUT_DIR}/out)
set(CMAKE_PDB_OUTPUT_DIRECTORY $ENV{PROJ_OUTPUT_DIR}/pdbs)

使用file命令的GLOB_RECURSE，子目录下的源文件也能一并扫描出来：

file(GLOB_RECURSE SRC_CPP ${PROJECT_SOURCE_DIR} *cpp)

使用target_compile_definitions给代码定义#define，子项目的DLL和EXE区别对待，其中，PRIVATE只应用于编译本项目时有效，PUBLIC应用于全局（所有子项目共享）：

#For DLL
target_compile_definitions(foo PRIVATE API_EXPORT_BUILD)
#For EXE
target_compile_definitions(bar PRIVATE API_EXPORT)

cmake对qt moc有如下几个函数封装：

qt_wrap_ui([输出]MOC后的源文件列表 [输入]MOC前的.ui文件)

qt_wrap_cpp([输出]MOC后的源文件列表 [输入]MOC前的源文件，通常是包含了Q_OBJECT的.hpp)

qt_add_resources([输出]MOC后的源文件列表 [输入]MOC前的.qrc文件)

经过这三步后，就可以将moc后在源文件add_exectuable/add_library了

示例代码：

#让cmake能找到qt，防止find_package无法使用
list(APPEND CMAKE_PREFIX_PATH ${QT5_DIR})

#将使用Designer编辑好的.ui文件处理为C++源文件
file(GLOB UI_SRC ui/*.ui)
qt_wrap_ui(MOC_UI_SRC ${UI_SRC})

#将带有如Q_OBJECT等Meta-Object的头文件处理为moc后的C++头/源文件
file(GLOB FORM_SRC include/ui/*.hpp)
qt_wrap_cpp(MOC_FORM_SRC ${FORM_SRC})

#将Qt资源文件(*.qrc)编译为C++源文件
file(GLOB FORM_QRC ui/*.qrc)
qt_add_resources(MOC_FORM_QRC ${FORM_QRC})

#正确使用find_package
find_package(Qt5 COMPONENTS Core Widgets REQUIRED)

#处理完后的源码作为exe/lib的输入
add_exectuable(example ${MOC_UI_SRC}
${MOC_FORM_SRC}
${FORM_QRC})

#链接Qt库，该命令会自动将Qt5对应的的include目录加入至include directories
target_link_libraries(example PRIVATE Qt5::Widgets)

在Add完所有控件后，调用wxSizer的SetSizeHints (wxWindow *window)方法，window参数传入窗口指针

namespace TrayThem {
class TrayIcon : public wxTaskBarIcon {
protected:
  virtual wxMenu *CreatePopupMenu();

public:
  explicit TrayIcon(wxTaskBarIconType iconType = wxTBI_DEFAULT_TYPE);
  ~TrayIcon();
};
};

然后，重载它的CreatePopupMenu方法，每次对它点击右键时，就会调用这个方法返回的wxMenu指针，菜单关闭时，这个wxMenu对象就会被销毁

示例代码如下：

wxMenu *TrayThem::TrayIcon::CreatePopupMenu() {
  wxMenu *cm = new wxMenu();
  wxMenuItem *menuShow = cm->Append(wxID_ANY, "Show Program");
  this->Bind(wxEVT_MENU, &TrayThem::TrayIcon::OnMenuShow, this,
             menuShow->GetId());
  wxMenu *mp = new wxMenu();
  cm->AppendSubMenu(mp, "Programs");
  BizBus::GetInstance()->TraverseProgram(
      [](void *opaque, std::shared_ptr<ProgramInfo> info, bool isRunning) {
        wxMenu *mp = static_cast<wxMenu *>(opaque);
        wxMenuItem *item = mp->AppendCheckItem(wxID_ANY, info->program_name);
        item->Check(isRunning);
      },
      mp);
  cm->AppendSeparator();
  wxMenuItem *menuExit = cm->Append(wxID_ANY, "Exit");
  this->Bind(wxEVT_MENU, &TrayThem::TrayIcon::OnMenuExit, this,
             menuExit->GetId());
  return cm;
}

注意，由于每次使用右键菜单后，菜单就会被销毁，因此菜单项的选中状态不会保存，需要自己另外存储，下次创建菜单时，再调用Check方法选中

// Example uses fictive class "Item" and fictive getters to access them. Adapt for your needs

class MyFrame : public wxFrame
{
    wxListCtrl* m_item_list;

public:
    MyFrame() : wxFrame(NULL, wxID_ANY,  wxT("Hello wxWidgets"), wxPoint(50,50), wxSize(800,600))
    {
        wxPanel* mainPane = new wxPanel(this);
        wxBoxSizer* sizer = new wxBoxSizer(wxHORIZONTAL);

        m_item_list = new wxListCtrl(mainPane, wxID_ANY, wxDefaultPosition, wxDefaultSize, wxLC_REPORT);

        // Add first column       
        wxListItem col0;
        col0.SetId(0);
        col0.SetText( _("Foo") );
        col0.SetWidth(50);
        m_item_list->InsertColumn(0, col0);

        // Add second column
        wxListItem col1;
        col1.SetId(1);
        col1.SetText( _("Name") );
        m_item_list->InsertColumn(1, col1);

        // Add third column     
        wxListItem col2;
        col2.SetId(2);
        col2.SetText( _("Comments") );
        m_item_list->InsertColumn(2, col2);


        const int item_amount = getItemAmount();
        for (int n=0; n<item_amount; n++)
        {
            Item* curritem = getItem(n);

            wxListItem item;
            item.SetId(n);
            item.SetText( curritem->getName() );

            m_item_list->InsertItem( item );

            // set value in first column
            if (!curritem->isFoo())
            {
                m_item_list->SetItem(n, 0, wxT("Foo"));
            }
            else
            {
                m_item_list->SetItem(n, 0, wxT("Bar"));
            }

            // set value in second column
            m_item_list->SetItem(n, 1, curritem->getName());

            // set value in third column
            m_item_list->SetItem(n, 2, curritem->getDescription());

        }

        sizer->Add(m_item_list,1, wxEXPAND | wxALL, 10);
        mainPane->SetSizer(sizer);
    }
};

class MyApp: public wxApp
{
    wxFrame* m_frame;
public:

    bool OnInit()
    {
        m_frame = new MyFrame();
        m_frame->Show();
        return true;
    } 

};

IMPLEMENT_APP(MyApp)

由于官方的API文档描述的比较简单，整理一下使用时的注意事项：

• 要使用带表头的多列List，初始化时，需有wxLC_REPORT的flag（注意不同flag会有冲突）

• 使用ClearAll清除表格时，表头（Columns）也会一起被清除，需要重新添加

• 添加表头有两种方式：

1. AppendColumn，简单方便

2. 构造一个wxListItem后，再InsertColumn（官方Minimal Example的方式）

• 添加数据的方式有点奇怪，需分为两步：

1. 先获取到索引（可用GetItemCount方法取当前Item的数量作为index），再使用InsertItem插入一个Item，这个方法会返回新Item的index，作为下一步使用

2. 插入Item后，使用SetItem(index,column,label,imageIndex=-1)方法，给刚才的Item设置各列显示的数据，如需设置自定义数据、图片、字体等高级功能，可用wxListItem的重载版本

新增Item的示例代码如下：

int TrayThem::MainWidget::cbReloadPrograms(void *argument, int argc,
                                           char **argv, char **azColName) {
  if (argument == nullptr) {
    return -1;
  }
  auto mw = static_cast<TrayThem::MainWidget *>(argument);
  auto programs = mw->m_lvPrograms;
  int index = programs->GetItemCount();
  programs->InsertItem(index, "");
  for (int i = 0; i < argc; i++) {
    programs->SetItem(index, i, argv[i] == nullptr ? "" : argv[i]);
  }
  return 0;
}

关于事件，常用的事件主要有wxEVT_LIST_ITEM_SELECTED和wxEVT_LIST_ITEM_DESELECTED，分别对应选中和取消选中Item，对应的事件处理函数原型为：

void handler(wxListEvent &event);

其中，event.GetItem可取到选中的Item，GetText可取到对应的Label，如果是单行选择模式的List（初始化时，设置了wxLC_SINGLE_SEL的flag），则GetText会返回第一列的Label

获取同一行中其它列的Text，可使用GetItemLabel方法，示例代码如下：

void TrayThem::MainWidget::OnProgramSelected(wxListEvent &event) {
  wxListItem item = event.GetItem();
  this->m_SelectedId = item.GetText();
  this->m_SelectedProgram.program_id = this->m_SelectedId;
  int col = item.GetColumn();
  this->m_SelectedProgram.running_status =
      this->m_lvPrograms->GetItemText(item, ++col);
  this->m_SelectedProgram.program_name =
      this->m_lvPrograms->GetItemText(item, ++col);
  this->m_SelectedProgram.autostart =
      this->m_lvPrograms->GetItemText(item, ++col) == "1" ? true : false;
  this->m_SelectedProgram.execution =
      this->m_lvPrograms->GetItemText(item, ++col);
  this->m_SelectedProgram.working_directory =
      this->m_lvPrograms->GetItemText(item, ++col);
  this->m_SelectedProgram.parameters =
      this->m_lvPrograms->GetItemText(item, ++col);
}

假设我们要开发一个库example.so，但又不想把某结构体的内容开放到SDK的头文件中，那么可以这样处理：

1. 准备三个文件：example.h（SDK的头文件），example_internal.h（不开放，存放了结构体的真实定义），example.c

2. 各文件内容如下：

   example.h:

    /* opaque types */
    struct example_struct;
    /* helper functions */
    __declspec( dllexport ) struct example_struct* create_example(const int id,const float rate);
    __declspec( dllexport ) const int get_example_id(struct example_struct *example);
    __declspec( dllexport ) const float get_example_rate(struct example_struct *example);
    __declspec( dllexport ) void free_example(struct example_struct *example);
   

   example_internal.h:

    /* The real structure */
    struct example_struct {
    int id;
    float rate;
    int hiddenInt;
    float hiddenRate;
    };
   

   example.c:

    #include "example.h"
    #include "example_internal.h"
    struct example_struct* create_example(const int id,const float rate){
        struct example_struct *example=(struct example_struct*)malloc(sizeof(struct example_struct));
        return example;
    }
   
    const int get_example_id(struct example_struct *example){
        if(!example){
            return 0;
        }
        return example->id;
    }
   
    /* Ohter helper functions ... */
   

3. 生成好库后，只需要把example.so和example.h打包进SDK里就可以被用来开发了

C++实现隐藏类成员的方法：

还是以example.so为例：

1. 在头文件中定义一个不透明结构体/类，实际的内容放在实现文件中，注意：由于编译时，不能明确知道它的构造及析构函孙，因此无法使用智能指针

   example.hpp

    __declspec( dllexport ) class example {
    public:
    const int getId() const;
    const float getRate() const;
    private:
    class exampleImpl;
    //opaque pointer;
    exampleImpl *m_impl;
    };
   

   example.cpp

2.    #include "example.hpp"
      class exampleImpl {
      public:
       int m_id;
       float m_rate;
       int m_hideId;
       float m_hideRate;
      };
   
      const int example::getId() const{
          return this->m_impl->m_id;
      }
      const float getRate() const{
          return this->m_impl->m_rate;
      }
   

class Test {
public:
 void doConst() const {
//
}
void doNoConst() {
//
}
};

int main(int argc,char **argv){
Test t;
const &ct=t;
//error: passing xxx as 'this' argument of xxx discards qualifiers [-fpermissive]
ct.doNoConst();

//Correct;
ct.doConst();

return 0;
}

代码说明：

• const引用的值不可改变（废话）

• 只有声明为const的成员函数才能被const对象调用（重要，上面代码报错的原因）

解决方法：

1. 将虚拟内存（分页文件大小）从默认的”系统管理的大小“设置为固定的大小，最大和最小大小保持一致

2. 关闭且禁用Sysmain服务（过去叫superfetch）

使用管理员权限打开CMD（或用services.msc打开服务管理器关闭后禁用Sysmain）：

sc stop "SysMain" & sc config "SysMain" start=disabled

3. 禁用Edge更新

需禁用的服务有：

• MicrosoftEdgeElevationService

• edgeupdate

• edgeupdatem

需禁用的计划任务有：

• MicrosoftEdgeUpdateTaskMachineCore

• MicrosoftEdgeUpdateTaskMachineUA

4. 可以考虑禁用Windows Update服务

操作系统： Windows 11 Home 22H2

编译器：Visual Studio 2022 Community

CPU：Intel Core i7-12700 @ 2.10GHz

内存：16GB

参考官方文档： https://wiki.qt.io/Building_Qt_6_from_Git https://doc.qt.io/qt-6.5/qtwebengine-platform-notes.html#windows https://wiki.qt.io/QtWebEngine/Qt6Build

准备工作及依赖

编译Qt6所需依赖：

• Git (>= 1.6.x)

• CMake (>= 3.16, >= 3.18.4 for Ninja Multi-Config, >= 3.19 for WebEngine, >= 3.21.1 for static Qt builds in Qt 6.2+, or builds for Apple platforms in Qt 6.6+)

• Ninja

• C++ compiler supporting C++ 17

• Perl (>=5.14, optional for Qt >= 6.5)

• Python (>=2.6.x)

• libclang (>=10, optional when QDoc should be built, prebuilt versions for each OS can be downloaded here or installed through the libclang-dev package on Linux)

• Visual Studio 2022, Visual Studio 2019, MinGW 11.2

• 如果需要 Make 本地文档，则需要安装 LLVM ，而且需要的是 Qt Company 预构建的 LLVM 。LLVM Qt Prebuilt: https://download.qt.io/development_releases/prebuilt/libclang/qt/ 编译WebEngine所需依赖：

• CMake 3.19 or newer

• Python 3 with html5lib library，由于使用了imp库的关系不支持3.12，最高可用3.11

• Bison, Flex，偷懒的话，可以从qt5的源码中copy，自己下的话记得要手动处理libiconv和libintl的依赖，确保命令行下不报错就行

• GPerf

• Node.js version 12 or later，用最后的12.x版本即可

• OpenSSL，可从源代码安装

perl Configure VC-WIN64A --prefix=D:\Libraries\OpenSSL\3.0.12
nmake
nmake install

我自己写了个bat把环境变量都设置好，放在解压后的源码目录运行即可：

set _ROOT=%cd%
set PATH=%_ROOT%/qtbase/bin;%PATH%
set PATH=%PATH%;D:/Tools/bison-2.4.1-bin/bin
set PATH=%PATH%;D:/Tools/flex-2.5.4a-1-bin/bin
set PATH=%PATH%;D:/Tools/gperf-3.0.1-bin/bin
SET PATH=%_ROOT%/qtrepotools/bin;%PATH%
SET PATH=%PATH%;C:/Strawberry/perl/bin
set LLVM_INSTALL_DIR="C:/Program Files/LLVM/bin"
set OPENSSL_ROOT_DIR=D:/Libraries/OpenSSL/3.0.12

开始编译

必须使用x64 Native Tools Command Prompt for Visual Studio 2012运行以下命令 运行env.bat设置path后，使用以下配置： 注意事项：

• 需使用chcp 65001切换至utf-8 code page开始编译，否则后续webengine中的python脚本会报错

• 需提前将OpenSSL的两个DLL复制到qtbase/bin中，后续过程有依赖

• Qt6无法同时编译debug和release版本，需删除CMakeCache.txt后，再重新configure 编译debug版本：

configure -opensource -confirm-license -verbose -debug -webengine-proprietary-codecs -nomake tests -nomake examples -prefix D:/Libraries/Qt/6.5.3/msvc2022_x64 -mp -opengl dynamic -openssl-linked OPENSSL_PREFIX=D:/Libraries/OpenSSL/3.0.12 -I D:/Libraries/OpenSSL/3.0.12/include -L D:/Libraries/OpenSSL/3.0.12/lib OPENSSL_LIBS="-lUser32 -lAdvapi32 -lGdi32 -llibcrypto -llibssl"

编译release版本：

configure -opensource -confirm-license -verbose -release -webengine-proprietary-codecs -nomake tests -nomake examples -prefix D:/Libraries/Qt/6.5.3/msvc2022_x64 -mp -opengl dynamic -openssl-linked OPENSSL_PREFIX=D:/Libraries/OpenSSL/3.0.12 -I D:/Libraries/OpenSSL/3.0.12/include -L D:/Libraries/OpenSSL/3.0.12/lib OPENSSL_LIBS="-lUser32 -lAdvapi32 -lGdi32 -llibcrypto -llibssl"

如果之前编译过不支持ssl的版本，需要把文件删掉重新编译 使用cmake进行并行编译（实际调用的ninja）：

cmake --build . --parallel

时间主要花在编译webengine上 在生成文档前，必须先安装，记得将OpenSSL的几个DLL复制到qt安装的路径的bin目录下

ninja install

或者使用cmake方式安装

cmake --install .

生成文档，此操作需先install后，再将qdoc的路径加入至PATH，可先单独运行一下qdoc看是否报错，如报错，需将libclang.dll复制到qt安装的路径的bin目录下

cmake --build . --target docs

安装文档

cmake --build . --target install_docs

整个过程很长很痛苦，主要是webengine要编译一个完整的chromium，太久了

操作系统： Windows 10 Professional 22H2

编译器：Visual Studio 2019 Community CPU：Intel Core i5-8300H @ 2.3GHz

内存：16GB

参考官方文档： https://doc.qt.io/qt-5/windows-building.html https://doc.qt.io/qt-6/qtwebengine-platform-notes.html

准备工作及依赖

编译Qt5.15.8依赖现在基本都包含在源代码里了：

• 在qtbase\bin和gnuwin32\bin中

• CMake需要自己另行安装，并加入至path环境变量中

• 如果需要 Make 本地文档，则需要安装 LLVM WebEngine所需依赖：

• Python 2.7.5，不支持Python3，此处有坑，不支持2.7.10以上版本，最好就用Python2.7.5，另外，如果path里有python3 ,要去掉。版本正确，还找不到python2的话，copy一份python.exe为python2.exe

• Bison, Flex，已经在源码自带的gnuwin32\bin中

• GPerf，需自行安装

• Node.js version 8 or later (version 12 or later is recommended)，就用12.x就好，太新的不要

• OpenSSL 3.0.x 更高版本的不行

perl Configure VC-WIN64A --prefix=D:\Libraries\OpenSSL\3.0.9
nmake
nmake install

我自己写了个bat把环境变量都设置好，放在解压后的源码目录运行即可：

set _ROOT=%cd%
set PATH=%_ROOT%\qtbase\bin;%_ROOT%\gnuwin32\bin;%PATH%
set PATH=%PATH%;C:\Python27
set PYTHONPATH=C:\Python27\DLLs
set PATH=%PATH%;D:\Tools\win_flex_bison
set PATH=%PATH%;D:\Tools\gperf\bin
set PATH=%PATH%;D:\Tools\nasm
set PATH=%PATH%;D:\Tools\ruby-1.9.3-p551-i386-mingw32\bin
set OPENSSL_PREFIX=D:\Libraries\OpenSSL\3.0.9
set PATH=%PATH%;%OPENSSL_PREFIX%\bin
set INCLUDE=%INCLUDE%;%OPENSSL_PREFIX%\include
set LIB=%LIB%;%OPENSSL_DIR%\lib
SET PATH=%_ROOT%\qtrepotools\bin;%PATH%
set LLVM_INSTALL_DIR=C:\Program Files\LLVM

开始编译

必须使用x64 Native Tools Command Prompt for Visual Studio 2019运行以下命令 运行env.bat设置path后，使用以下配置：

configure -recheck-all -opensource -confirm-license -verbose -debug-and-release -webengine-proprietary-codecs -nomake tests -nomake examples -prefix D:\Libraries\Qt\5.15.9\msvc2019_x64 -mp -opengl dynamic -openssl-linked OPENSSL_PREFIX=D:\Libraries\OpenSSL\3.0.9 -I D:\Libraries\OpenSSL\3.0.9\include -L D:\Libraries\OpenSSL\3.0.9\lib OPENSSL_LIBS="-lUser32 -lAdvapi32 -lGdi32 -llibcrypto -llibssl"

如果之前编译过不支持ssl的版本，需要把文件删掉重新编译 使用jom代替nmake进行并行编译：

jom -j16

整个过程大约10小时，主要花在编译webengine上 在生成文档前，必须先安装，记得将OpenSSL的几个DLL复制到qt安装的路径的bin目录下

jom install

生成文档，此操作需先install后，再将qdoc的路径加入至PATH，可先单独运行一下qdoc看是否报错，如报错，需将libclang.dll复制到qt安装的路径的bin目录下

jom docs

安装文档

jom install_docs

整个过程很长很痛苦，主要是webengine要编译一个完整的chromium，太久了

emit beginResetModel();
emit endResetModel();

注意reset model需要成对使用。

QTextEdit *textEditor = new QTextEdit(0);
QTextDocumentFragment fragment;
fragment = QTextDocumentFragment::fromHtml("");
textEditor->textCursor().insertFragment(fragment);
textEditor->setVisible(true);

2. Using QTextDocument's resource

QString file = QFileDialog::getOpenFileName(this, tr("Select an image"),
".", tr("Bitmap Files (*.bmp)
"
"JPEG (*.jpg *jpeg)
"
"GIF (*.gif)
"
"PNG (*.png)
"));
QUrl Uri ( file );
QImage image = QImageReader ( file ).read();
QTextDocument * textDocument = m_textEdit->document();
textDocument->addResource( QTextDocument::ImageResource, Uri, QVariant ( image ) );
QTextCursor cursor = m_textEdit->textCursor();
QTextImageFormat imageFormat;
imageFormat.setWidth( image.width() );
imageFormat.setHeight( image.height() );
imageFormat.setName( Uri.toString() );
cursor.insertImage(imageFormat);

3. Subclass QTextEdit (The example below also enabled drag & drop)

class TextEdit : public QTextEdit {
public:
    bool canInsertFromMimeData( const QMimeData* source ) const
    {
        return(source->hasImage() );
    }


    void insertFromMimeData( const QMimeData* source )
    {
        if ( source->hasImage() )
        {
            static int    i = 1;
            QUrl        url( QString( "dropped_image_%1" ).arg( i++ ) );
            dropImage( url, qvariant_cast( source->imageData() ) );
        } else if ( source->hasUrls() )
        {
            foreach( QUrl url, source->urls() )
            {
                QFileInfo info( url.toLocalFile() );
                if ( QImageReader::supportedImageFormats().contains( info.suffix().toLower().toLatin1() ) )
                {
                    dropImage( url, QImage( info.filePath() ) );
                }else  {
                    dropTextFile( url );
                }
            }
        }else  {
            QTextEdit::insertFromMimeData( source );
        }
    }
}

private:
void dropImage( const QUrl & url, const QImage & image )
{
    if ( !image.isNull() )
    {
        document()->addResource( QTextDocument::ImageResource, url, image );
        textCursor().insertImage( url.toString() );
    }
}


void dropTextFile( const QUrl & url )
{
    textCursor().insertText( file.readAll() );
}
};

包含关系为QTextDocument QTextBlock QTextFragment

一般一个控件（如QTextEdit）只包含一个QTextDocument，文档对象可以很容易的保存为HTML或者ODF文件。

其中，QTextBlock是以换行符分隔的，遇到一个换行符就新建一个QTextBlock，因此，一行内容就是一个QTextBlock。

而QTextBlock中包含了一个或多个QTextFragment，这些fragment可以是文字，图片或其他多媒体元素，fragment以内容的类型区分。

例如如下内容：

[文本][图片][文本]

上面的内容生成了一个block，这个block包含了3个fragment。

而内容：

[文本]

[图片]

[文本]

则生成了3个block，因为一行内容生成一个block。

这个概念在使用网络发送图文混排的内容时尤其重要，如果不能正确理解document/block/fragment的组织方式，则会丢失原始格式。

QMovie*movie=newQMovie(this);
movie->setFileName(img_path);
movie->setCacheMode(QMovie::CacheNone);
connect(movie,SIGNAL(frameChanged(int)),this,SLOT(frameChanged(int)));
movie->start();

槽函数:

voidMyObject::frameChanged(intframeNumber)
if(frameNumber==-1)
return;

QMovie*movie=(QMovie*)this->sender();
QStringname=movie->fileName().toUtf8().toBase64();
ui->view->document()->addResource(QTextDocument::ImageResource,
name,
QVariant(movie->currentPixmap()));
ui->view->setLineWrapColumnOrWidth(ui->view->lineWrapColumnOrWidth());

关键点：

QMovie对象在播放gif动画时发送frameChanged信号至槽，此处使用QOjbect::sender()方法来得到具体的对象指针，然后调用document的addResource方法更新当前的帧到其图像资源，最后调用setLineWrapColumnOrWidth来刷新显示。这样就实现了gif图片的不断刷新。

SHOW OPEN TABLES WHERE in_use>0;

查Process List

SHOW FULL PROCESSLIST;

查Transactions

SELECT * FROM INFORMATION_SCHEMA.INNODB_TRX;

杀死进程

KILL process_ID/transaction_process_ID;