处理desktop文件的接口更多...

#include <ddesktopentry.h>

Public 类型
enum	EntryType { Unknown = 0 , Application , Link , Directory , ServiceType , Service , FSDevice }
	桌面入口文件的类型更多...

enum	ValueType { Unparsed = 0 , String , Strings , Boolean , Numeric , NotExisted = 99 }
	值的类型更多...

enum	Status { NoError = 0 , AccessError , FormatError }
	desktop文件的解析状态更多...

Public 成员函数
	DDesktopEntry (const QString &filePath) noexcept
	DDesktopEntry构造函数

bool	save () const
	将数据回写到desktop文件。更多...

Status	status () const
	Get data parse status 更多...

QStringList	keys (const QString &section="Desktop Entry") const
	根据 `section` 返回全部键值更多...

QStringList	allGroups (bool sorted=false) const
	获取desktop中所有组的列表。如果 `sorted` 设置为true, 则返回结果将保持读取desktop文件时的顺序不变。更多...

bool	contains (const QString &key, const QString &section="Desktop Entry") const
	检查desktop文件是否有给定的 `section` 包含给定的 `key` 更多...

QString	name () const
	返回“Desktop Entry”部分下的“Name”键的本地化字符串值。这等价于调用localizedValue("Name")。更多...

QString	genericName () const
	返回"Desktop Entry"部分下的"GenericName"键的本地化字符串值。它等价于调用localizedValue("GenericName")。如果是“GenericName”不存在。则不会回退到“Name”。更多...

QString	ddeDisplayName () const
	为DDE应用程序专门显示名称更多...

QString	comment () const
	返回“Desktop Entry”部分下的“Comment”键的本地化字符串值。这等价于调用localizedValue("Comment")。更多...

QString	rawValue (const QString &key, const QString &section="Desktop Entry", const QString &defaultValue=QString()) const
	返回 `section` 中与给定 `key` 关联的原始字符串值。如果desktop不包含具有该键的项, 则函数返回一个构造好的 `defaultValue`。更多...

QString	stringValue (const QString &key, const QString &section="Desktop Entry", const QString &defaultValue=QString()) const
	返回 `section` 与给定 `key` 关联的未转义字符串值。如果desktop不包含键值为0的项, 则函数返回一个构造好的 `defaultValue`。更多...

QString	localizedValue (const QString &key, const QString &localeKey="default", const QString &section="Desktop Entry", const QString &defaultValue=QString()) const
	返回与 `section` 中给定的 `key` 和 `localeKey` 相关联的本地化字符串值。更多...

QString	localizedValue (const QString &key, const QLocale &locale, const QString &section="Desktop Entry", const QString &defaultValue=QString()) const
	返回与给定的 `key` 和 `section` 中的区域设置相关联的本地化字符串值。更多...

QStringList	stringListValue (const QString &key, const QString &section="Desktop Entry") const
	返回给定 `section` 中与给定 `key` 关联的字符串的列表。如果destkop不包含为该键的项,则函数返回一个空字符串列表。更多...

bool	setRawValue (const QString &value, const QString &key, const QString &section="Desktop Entry")
	设置给定 `section` 中与给定 `key` 关联的原始字符串值。

bool	setStringValue (const QString &value, const QString &key, const QString &section="Desktop Entry")
	设置给定 `section` 中与给定 `key` 关联的字符串

bool	setLocalizedValue (const QString &value, const QString &localeKey, const QString &key, const QString &section="Desktop Entry")
	设置给定的 `key` 和 `section` 中的区域设置相关联的本地化字符串值。

bool	removeEntry (const QString &key, const QString &section="Desktop Entry")
	删除desktop中 `section` 与 `key` 对应的值

静态 Public 成员函数
static QString &	escape (QString &str)
	支持转义序列`\s`、`\n`、`\t`、`\r`和`\\`表示值更多...

static QString &	escapeExec (QString &str)
	必须将参数括在双引号之间，并对双引号字符进行转义。更多...

static QString &	unescape (QString &str, bool unescapeSemicolons=false)
	对于类型为string和localestring的值,支持转义序列`\s`、`\n`、`\t`、`\r`和`\\`,分别表示ASCII空格、换行符、制表符、回车符和反斜杠。更多...

static QString &	unescapeExec (QString &str)
	必须将参数括在双引号之间,并对双引号字符进行转义，更多...

Protected 成员函数
bool	setStatus (const Status &status)
	设置desktop文件解析状态

详细描述

处理desktop文件的接口

DDesktopEntry提供了处理XDG desktop读写的方法的接口,这个Class类似于QSettings。

有关该规范本身的更多详细信息，请参阅: https://specifications.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html

成员枚举类型说明

◆ EntryType

enum Dtk::Core::DDesktopEntry::EntryType

桌面入口文件的类型

值	序号	含义
Unknown	0	未知的桌面文件类型。可能是无效的
Application	1	该文件描述应用程序
Link	2	该文件描述URL
Directory	3	该文件描述目录设置
ServiceType	4	KDE特定类型。规范中提到过, 所以这里也列出了
Service	5	KDE特定类型。规范中提到过, 所以这里也列出了
FSDevice	6	KDE特定类型。规范中提到过, 所以这里也列出了

◆ Status

enum Dtk::Core::DDesktopEntry::Status

desktop文件的解析状态

值	序号	含义
NoError	0	没有错误发生
AccessError	1	发生访问错误(例如, 试图写入只读文件)
FormatError	2	发生格式错误(例如, 加载格式错误的desktop文件)

◆ ValueType

enum Dtk::Core::DDesktopEntry::ValueType

值的类型

值	序号	含义
Unparsed	0	可能没有用，考虑删除它
String	1	字符串
Strings	2	字符串数组
Boolean	3	布尔值
Numeric	4	数字
NotExisted	5	不存在

成员函数说明

◆ allGroups()

QStringList Dtk::Core::DDesktopEntry::allGroups ( bool sorted = false ) const

获取desktop中所有组的列表。如果 sorted 设置为true, 则返回结果将保持读取desktop文件时的顺序不变。

返回: 返回所有的组.

◆ comment()

QString Dtk::Core::DDesktopEntry::comment ( ) const

返回“Desktop Entry”部分下的“Comment”键的本地化字符串值。这等价于调用localizedValue("Comment")。

返回: 返回“Desktop Entry”部分下的“Comment”键的本地化字符串值。

参见: localizedValue()

◆ contains()

bool Dtk::Core::DDesktopEntry::contains	(	const QString &	key,
		const QString &	section = `"Desktop Entry"`
	)		const

检查desktop文件是否有给定的 section 包含给定的 key

返回: 如果desktop在 section 包含 key 返回true; 否则返回false。

◆ ddeDisplayName()

QString Dtk::Core::DDesktopEntry::ddeDisplayName ( ) const

为DDE应用程序专门显示名称

这将检查“X-Deepin-Vendor”,并将返回本地化的字符串值“GenericName” "X-Deepin-Vendor"是"deepin"，否则它将返回"Name"的本地化字符串值。

返回: 返回专门用于DDE应用程序的显示名称

参见: localizedValue(), name(), genericName()

◆ escape()

static QString & Dtk::Core::DDesktopEntry::escape ( QString & str )

static

支持转义序列\s、\n、\t、\r和\\表示值

string和localestring类型的值支持转义序列\s、\n、\t、\r和\\,分别表示ASCII空格、换行符、制表符、回车和反斜杠。

◆ escapeExec()

static QString & Dtk::Core::DDesktopEntry::escapeExec ( QString & str )

static

必须将参数括在双引号之间，并对双引号字符进行转义。

原字符	转义后
`	"`"
$	"$"
\	"\"

在它前面加上一个额外的反斜杠字符。实现必须在扩展字段代码之前和之前撤销引用,将参数传递给可执行程序。

注解: 类型为string的值的通用转义规则规定,反斜杠字符也可以转义为("\\")和这个转义规则应用在引用规则之前。<br> 因此,要明确地表示在desktop文件中,引号参数中的文字反斜杠字符 <br> 要求使用四个连续的反斜杠字符("\\")。同样，在桌面入口文件中引用参数中的美元符号表示为("\$")。

◆ genericName()

QString Dtk::Core::DDesktopEntry::genericName ( ) const

返回"Desktop Entry"部分下的"GenericName"键的本地化字符串值。它等价于调用localizedValue("GenericName")。如果是“GenericName”不存在。则不会回退到“Name”。

返回: 返回"Desktop Entry"部分下的"GenericName"键的本地化字符串值。

参见: localizedValue(), name(), ddeDisplayName()

◆ keys()

QStringList Dtk::Core::DDesktopEntry::keys ( const QString & section = "Desktop Entry" ) const

根据 section 返回全部键值

返回: 返回所有的键值

◆ localizedValue() [1/2]

QString Dtk::Core::DDesktopEntry::localizedValue	(	const QString &	key,
		const QLocale &	locale,
		const QString &	section = `"Desktop Entry"`,
		const QString &	defaultValue = `QString()`
	)		const

返回与给定的 key 和 section 中的区域设置相关联的本地化字符串值。

如果找不到给定的 localeKey ,它将回退到"C",如果仍然找不到,将回退 key 没有localeKey部分。如果destkop不包含 key 值为0的项,则函数返回一个构造好的 defaultValue。

返回: 返回 section中与给定的 key 和 locale 设置相关联的本地化字符串值。

参见: rawValue() stringValue() stringListValue()

◆ localizedValue() [2/2]

QString Dtk::Core::DDesktopEntry::localizedValue	(	const QString &	key,
		const QString &	localeKey = `"default"`,
		const QString &	section = `"Desktop Entry"`,
		const QString &	defaultValue = `QString()`
	)		const

返回与 section 中给定的 key 和 localeKey 相关联的本地化字符串值。

如果找不到给定的 localeKey ,它将回退到"C",如果仍然找不到,将回退 key 没有localeKey部分。。如果destkop不包含 key 值为0的项,则函数返回一个构造好的 defaultValue。

返回: 返回 section 中与给定的 key 和 localeKey 关联的本地化字符串值。

参见: rawValue() stringValue() stringListValue()

◆ name()

QString Dtk::Core::DDesktopEntry::name ( ) const

返回“Desktop Entry”部分下的“Name”键的本地化字符串值。这等价于调用localizedValue("Name")。

返回: 返回“Desktop Entry”部分下的“Name”键的本地化字符串值。

参见: localizedValue(), genericName(), ddeDisplayName()

◆ rawValue()

QString Dtk::Core::DDesktopEntry::rawValue	(	const QString &	key,
		const QString &	section = `"Desktop Entry"`,
		const QString &	defaultValue = `QString()`
	)		const

返回 section 中与给定 key 关联的原始字符串值。如果desktop不包含具有该键的项, 则函数返回一个构造好的 defaultValue。

返回: 返回 section 中与给定 key 相关联的原始字符串值。

参见: stringValue() localizedValue() stringListValue()

◆ save()

bool Dtk::Core::DDesktopEntry::save ( ) const

将数据回写到desktop文件。

返回: true表示写成功; 否则返回false

◆ status()

Status Dtk::Core::DDesktopEntry::status ( ) const

Get data parse status

返回: 返回一个状态码, 表示DDesktopEntry遇到的第一个错误, 如果没有错误发生, 则返回QSettings::NoError。请注意, DDesktopEntry会延迟执行某些操作。

◆ stringListValue()

QStringList Dtk::Core::DDesktopEntry::stringListValue	(	const QString &	key,
		const QString &	section = `"Desktop Entry"`
	)		const

返回给定 section 中与给定 key 关联的字符串的列表。如果destkop不包含为该键的项,则函数返回一个空字符串列表。

返回: 返回给定 section 中与给定 key 关联的字符串的列表。

参见: rawValue() stringValue() localizedValue()

◆ stringValue()

QString Dtk::Core::DDesktopEntry::stringValue	(	const QString &	key,
		const QString &	section = `"Desktop Entry"`,
		const QString &	defaultValue = `QString()`
	)		const

返回 section 与给定 key 关联的未转义字符串值。如果desktop不包含键值为0的项, 则函数返回一个构造好的 defaultValue。

返回: 返回 section 中与给定 key 相关联的未转义字符串值。

参见: rawValue() localizedValue() stringListValue()

◆ unescape()

static QString & Dtk::Core::DDesktopEntry::unescape	(	QString &	str,
		bool	unescapeSemicolons = `false`
	)

static

对于类型为string和localestring的值,支持转义序列\s、\n、\t、\r和\\,分别表示ASCII空格、换行符、制表符、回车符和反斜杠。

有些键可以有多个值。这种情况下，key 的值被指定为复数形式: 例如，字符串。多个值应该用分号分隔，key 的值可以选择以分号结尾。空字符串必须以分号结尾。这些值中的分号需要使用\;转义。

有关该规范本身的更多详细信息，请参阅: https://specifications.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html#value-types

◆ unescapeExec()

static QString & Dtk::Core::DDesktopEntry::unescapeExec ( QString & str )

static

必须将参数括在双引号之间,并对双引号字符进行转义，

原字符	转义后
`	"`"
$	"$"
\	"\"

在它前面加上一个额外的反斜杠字符。实现必须在扩展字段代码之前和之前撤销引用,将参数传递给可执行程序。

保留字符：

功能	字符
space	" "
tab
newline
double quote
single quote	"'"
backslash character	"\"
greater-than sign	">"
less-than sign	"<"
tilde	"~"
vertical bar	\|
ampersand	"&"
semicolon	";"
dollar sign	"$"
asterisk	"*"
question mark	"?"
hash mark	"#"
parenthesis	"(" 和 ")"
backtick character	"`"

注解: 类型为string的值的通用转义规则规定
反斜杠字符也可以转义为("\\"),而且转义规则在引号规则之前应用。<br> 因此,要在desktop文件的引号参数中明确表示字面上的反斜杠字符,需要使用四个连续的反斜杠字符(“\\\\”)。<br> 同样,在desktop文件中,引号参数中的美元符号可以明确地表示为("\$")。

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

include/global/ddesktopentry.h
docs/global/ddesktopentry.zh_CN.dox

Public 类型

Public 成员函数

静态 Public 成员函数

Protected 成员函数

详细描述

成员枚举类型说明

◆ EntryType

◆ Status

◆ ValueType

成员函数说明

◆ allGroups()

◆ comment()

◆ contains()

◆ ddeDisplayName()

◆ escape()

◆ escapeExec()

◆ genericName()

◆ keys()

◆ localizedValue() [1/2]

◆ localizedValue() [2/2]

◆ name()

◆ rawValue()

◆ save()

◆ status()

◆ stringListValue()

◆ stringValue()

◆ unescape()

◆ unescapeExec()