CParameterOperate类 参考

操作参数接口。仅在插件内有效。 更多...

#include <ParameterOperate.h>

类 CParameterOperate 继承关系图:

CParameterOperate 的协作图:

信号
void	sigSetPluginParameters ()
	仅由此类使用
void	sigNameChanged (const QString &name=QString())
信号 继承自 CParameter
void	sigChanged ()
	当参数改变时，触发 通常如果需要，则相应的参数会对应一个改变事件。

Public 成员函数
	CParameterOperate (QObject *parent, const QString &szPrefix=QString())
CParameterPlugin *	GetPluginParameters ()
	Get CParameterPlugin
int	SetPluginParameters (CParameterPlugin *p)
const QString	GetName () const
void	SetName (const QString &szName)
int	LoadPassword (const QString &szTitle, const QString &szKey, QString &password, QSettings &set)
	Restore password
int	SavePassword (const QString &szKey, const QString &password, QSettings &set, bool bSave=false)
Public 成员函数 继承自 CParameter
	CParameter (QObject *parent, const QString &szPrefix=QString())
virtual int	Load (QString szFile=QString())
	Load from file
virtual int	Save (QString szFile=QString(), bool bForce=true)
	Save to file
virtual int	Load (QSettings &set)
	Load from QSettings
virtual int	Save (QSettings &set, bool bForce=true)
	Save to QSettings
virtual bool	CheckValidity ()
	检查参数是否有效，以决定是否使用或者保存参数。 派生类一般只要重载 OnCheckValidity() ，用于检查参数。

Protected 槽
virtual void	slotSetPluginParameters ()
	设置 CParameterPlugin 后调用，用于初始化与 CParameterPlugin 有关的操作。

Protected 成员函数
QByteArray	PasswordSum (const std::string &password, const std::string &key)
virtual int	OnLoad (QSettings &set) override
virtual int	OnSave (QSettings &set) override
Protected 成员函数 继承自 CParameter
virtual bool	OnCheckValidity ()
	检查参数是否有效
int	SetModified (bool bModified=true)
	在设置参数时，如果有修改，则调用。
bool	GetModified ()
	参数是否有修改

Private 属性
CParameterOperate *	m_Parent
CParameterPlugin *	m_pParameterPlugin
QString	m_szName

额外继承的成员函数
属性 继承自 CParameter
bool	Modified

详细描述

操作参数接口。仅在插件内有效。

注解

• 仅在插件中实现和使用
• 应用程序不能访问，只能通过 COperate::OpenDialogSettings 进行设置。
• 插件通过 COperateDesktop::GetParameter()、COperateTerminal::GetParameter()　等访问操作参数
• 使用远程桌面基础参数
• 需要访问插件的全局参数 (CParameterPlugin) 的分类，需要从此类派生。 通过调用 CParameterOperate::GetPluginParameters() 访问全局参数 (CParameterPlugin)

设置和得到插件的全局参数。需要操作插件的全局参数的参数应该从此类派生。

使用插件的全局参数(CParameterPlugin)

为操作参数(CParameterOperate 或其派生类)设置全局参数(CParameterPlugin)

• 如果操作参数 ( CParameterOperate 或其派生类 ) 需要插件的全局参数 (CParameterPlugin) 。
  • 请在 COperate 派生类的构造函数中实例化操作参数。例如：

        CParameterFreeRDP m_ParameterFreeRdp;

  • 调用 COperateDesktop::SetParameter 设置参数指针。例如：

    int COperateFreeRDP::Initial()
    {
        qDebug(log) << Q_FUNC_INFO;
        int nRet = 0;
        nRet = COperateDesktop::Initial();
        if(nRet) return nRet;
        nRet = SetParameter(&m_ParameterFreeRdp);
        return nRet;
    }

  • 默认会自动为操作参数设置 CParameterPlugin 。详见: CPlugin::CreateOperate 。

    COperate* CPlugin::CreateOperate(
        const QString &szId, CParameterPlugin* para)
    {
        COperate* p = OnCreateOperate(szId);
        if(p) {
            int nRet = 0;
            //nRet = p->Initial();
            bool bRet = QMetaObject::invokeMethod(
                p,
                "Initial",
                Qt::DirectConnection,
                Q_RETURN_ARG(int, nRet));
            if(!bRet) {
                qCritical(log) << "Call p->Initial() fail.";
                return nullptr;
            }
            if(nRet) {
                qCritical(log) << "Operate initial fail" << nRet;
                DeleteOperate(p);
                return nullptr;
            }
            //nRet = p->SetPluginParameters(para);
            bRet = QMetaObject::invokeMethod(
                p,
                "SetPluginParameters",
                Qt::DirectConnection,
                Q_RETURN_ARG(int, nRet),
                Q_ARG(CParameterPlugin*, para));
            if(!bRet) {
                qCritical(log) << "Call p->SetParameterClient(para) fail.";
                return nullptr;
            }
            if(nRet) {
                qCritical(log) << "SetParameterClient fail" << nRet;
                DeleteOperate(p);
                return nullptr;
            }
        }
        return p;
    }

  • 如果参数不需要 CParameterPlugin ， 那请在 COperate 派生类重载 COperate::SetPluginParameters 不设置它。

在操作参数 ( CParameterOperate 或其派生类 ) 中使用全局参数 (CParameterPlugin)

• 在操作参数 ( CParameterOperate 或其派生类 ) 使用 CParameterOperate::GetPluginParameters() 来得到全局参数 (CParameterPlugin) 。
• 操作参数 ( CParameterOperate 或其派生类 ) 使用插件的全局参数 (CParameterPlugin) 的值做为其初始值。 请重载 CParameterOperate::slotSetPluginParameters 并在其中初始化相关的值。
  例如：是否保存密码以 CParameterPlugin 的成员值做为其初始化值。

  void CParameterUser::slotSetPluginParameters()
  {
      if(!GetPluginParameters()) {
          QString szErr = "The CParameterClient is null";
          qCritical(log) << szErr;
          Q_ASSERT_X(false, "CParameterUser", szErr.toStdString().c_str());
          return;
      }
      
      if(GetPluginParameters())
      {
          if(GetPluginParameters()->GetEnableSystemUserToUser())
              SetUser(RabbitCommon::CTools::GetCurrentUser());
          SetSavePassword(GetPluginParameters()->GetSavePassword());
          SetSavePassphrase(GetPluginParameters()->GetSavePassword());
      }
      
      return;
  }

操作参数分类使用

因为可能会有很多参数，所以需要按参数类型分类。每个分类可以从此类派生出一个单独的类。
因为操作参数都有一些基本的参数（例如网络地址等），所以这些基本参数放入 CParameterDesktop 。 而每个分类做为它的成员变量。

例如：
操作参数包括以下几种类型：

• 基本参数

  class CParameterDesktop : public CParameterOperate

• 用户参数

  class CParameterUser : public CParameterOperate

• 视频参数

  class CParameterVideo : public CParameter

• 音频参数

  class CParameterAudio : public CParameter

其中 CParameterDesktop ， CParameterUser 它需要插件的全局参数， 所以必须从 CParameterOperate 派生。 其它的类型则不需要插件的全局参数的，从 CParameter 派生。

那么操作参数可以是以上类型的集合：

class CParameterDesktop : public CParameterOperate
{
public:
    explicit CParameterDesktop(CParameterOperate *parent = nullptr);
 
    CParameterUser m_User;
    CParameterVideo m_Video;
    CParameterAudio m_Audio;
};
 
CParameterDesktop::CParameterDesktop(CParameterOperate *parent = nullptr)
 : CParameterOperate(parent),
   m_User(this, "Host"),
   m_Video(this),
   m_Audio(this)
{}

注解

• 需要插件的全局参数的操作参数必须从 CParameterOperate 派生，否则可以从 CParameter 派生
• 当成员实例化时
  • CParameterUser 必须设置构造函数的参数 parent 为 CParameterOperate 的实例（一般设置为 this）。
  • m_Video ， m_Audio 必须设置构造函数的参数 parent 为 CParameter 或其派生类的实例（一般设置为 this）。
• 为操作参数(CParameterOperate 或其派生类)设置全局参数(CParameterPlugin)

参见

CParameterOperate CParameterPlugin CManager::CreateOperate CPlugin::CreateOperate COperate::SetPluginParameters COperateDesktop::SetParameter CParameterOperate::GetPluginParameters

在文件 ParameterOperate.h 第 209 行定义.

构造及析构函数说明

CParameterOperate()

CParameterOperate::CParameterOperate ( QObject * parent, const QString & szPrefix = QString() )

explicit

参见

CParameter::CParameter

成员函数说明

GetName()

const QString CParameterOperate::GetName

(

)

const

在文件 ParameterOperate.cpp 第 212 行定义.

GetPluginParameters()

CParameterPlugin * CParameterOperate::GetPluginParameters

(

)

Get CParameterPlugin

在文件 ParameterOperate.cpp 第 33 行定义.

LoadPassword()

int CParameterOperate::LoadPassword	(	const QString &	szTitle,
		const QString &	szKey,
		QString &	password,
		QSettings &	set )

Restore password

if the encryption key is incorrect, Password is set to empty. it proceeds to the normal password entry. flow chart:

参见

https://github.com/KangLin/RabbitRemoteControl/issues/79

在文件 ParameterOperate.cpp 第 82 行定义.

OnLoad()

int CParameterOperate::OnLoad ( QSettings & set )

overrideprotectedvirtual

实现了 CParameter.

被 CParameterNet , 以及 CParameterWakeOnLan 重载.

在文件 ParameterOperate.cpp 第 226 行定义.

OnSave()

int CParameterOperate::OnSave ( QSettings & set )

overrideprotectedvirtual

实现了 CParameter.

在文件 ParameterOperate.cpp 第 232 行定义.

PasswordSum()

QByteArray CParameterOperate::PasswordSum ( const std::string & password, const std::string & key )

protected

在文件 ParameterOperate.cpp 第 52 行定义.

SavePassword()

int CParameterOperate::SavePassword	(	const QString &	szKey,
		const QString &	password,
		QSettings &	set,
		bool	bSave = false )

在文件 ParameterOperate.cpp 第 144 行定义.

SetName()

void CParameterOperate::SetName

(

const QString &

szName

)

在文件 ParameterOperate.cpp 第 217 行定义.

SetPluginParameters()

int CParameterOperate::SetPluginParameters

(

CParameterPlugin *

p

)

在文件 ParameterOperate.cpp 第 39 行定义.

sigSetPluginParameters

void CParameterOperate::sigSetPluginParameters ( )

signal

仅由此类使用

参见

slotSetPluginParameters

slotSetPluginParameters

void CParameterOperate::slotSetPluginParameters ( )

protectedvirtualslot

设置 CParameterPlugin 后调用，用于初始化与 CParameterPlugin 有关的操作。

在操作参数 ( CParameterOperate 或其派生类 ) 中使用全局参数 (CParameterPlugin)

被 CParameterDesktop 重载.

在文件 ParameterOperate.cpp 第 47 行定义.

类成员变量说明

m_Parent

CParameterOperate* CParameterOperate::m_Parent

private

在文件 ParameterOperate.h 第 260 行定义.

m_pParameterPlugin

CParameterPlugin* CParameterOperate::m_pParameterPlugin

private

参见

CManager::CreateConnecter COperate::SetPluginParameters

在文件 ParameterOperate.h 第 264 行定义.

m_szName

QString CParameterOperate::m_szName

private

在文件 ParameterOperate.h 第 266 行定义.

---

该类的文档由以下文件生成:

• /home/runner/work/RabbitRemoteControl/RabbitRemoteControl/Src/ParameterOperate.h
• /home/runner/work/RabbitRemoteControl/RabbitRemoteControl/Src/ParameterOperate.cpp