QMacSettingsPrivate Class Reference

Inheritance diagram for QMacSettingsPrivate:

Classes
struct	SearchDomain

Public Functions
QStringList	children (const QString &prefix, ChildSpec spec) const
void	clear ()
QString	fileName () const
void	flush ()
bool	get (const QString &key, QVariant *value) const
bool	isWritable () const
	QMacSettingsPrivate (QSettings::Scope scope, const QString &organization, const QString &application)
	QMacSettingsPrivate (CFStringRef bundleIdentifier)
void	remove (const QString &key)
void	set (const QString &key, const QVariant &value)
void	sync ()
	~QMacSettingsPrivate ()
Public Functions inherited from QSettingsPrivate
QString	actualKey (const QString &key) const
void	beginGroupOrArray (const QSettingsGroup &group)
	QSettingsPrivate (QSettings::Format format)
	QSettingsPrivate (QSettings::Format format, QSettings::Scope scope, const QString &organization, const QString &application)
void	requestUpdate ()
void	setStatus (QSettings::Status status) const
void	update ()
virtual	~QSettingsPrivate ()
Public Functions inherited from QObjectPrivate
void	_q_reregisterTimers (void *pointer)
void	addConnection (int signal, Connection *c)
void	cleanConnectionLists ()
void	connectNotify (const char *signal)
void	deleteChildren ()
void	disconnectNotify (const char *signal)
bool	isSender (const QObject *receiver, const char *signal) const
bool	isSignalConnected (uint signalIdx) const
	Returns true if the signal with index signal_index from object sender is connected. More...
void	moveToThread_helper ()
	QObjectPrivate (int version=QObjectPrivateVersion)
QObjectList	receiverList (const char *signal) const
QObjectList	senderList () const
void	setParent_helper (QObject *)
void	setThreadData_helper (QThreadData *currentData, QThreadData *targetData)
int	signalIndex (const char *signalName) const
	Returns the signal index used in the internal connectionLists vector. More...
virtual	~QObjectPrivate ()
Public Functions inherited from QObjectData
virtual	~QObjectData ()=0

Properties
QCFString	applicationId
SearchDomain	domains [6]
QCFString	hostName
int	numDomains
QCFString	suiteId

Additional Inherited Members
Public Types inherited from QSettingsPrivate
enum	{   F_Application = 0x0, F_Organization = 0x1, F_User = 0x0, F_System = 0x2,   NumConfFiles = 4 }
enum	ChildSpec { AllKeys, ChildKeys, ChildGroups }
Public Types inherited from QObjectPrivate
typedef void(*	StaticMetaCallFunction) (QObject *, QMetaObject::Call, int, void **)
Static Public Functions inherited from QSettingsPrivate
static QSettingsPrivate *	create (QSettings::Format format, QSettings::Scope scope, const QString &organization, const QString &application)
static QSettingsPrivate *	create (const QString &fileName, QSettings::Format format)
static void	iniEscapedKey (const QString &key, QByteArray &result)
static void	iniEscapedString (const QString &str, QByteArray &result, QTextCodec *codec)
static void	iniEscapedStringList (const QStringList &strs, QByteArray &result, QTextCodec *codec)
static bool	iniUnescapedKey (const QByteArray &key, int from, int to, QString &result)
static bool	iniUnescapedStringList (const QByteArray &str, int from, int to, QString &stringResult, QStringList &stringListResult, QTextCodec *codec)
static QString	normalizedKey (const QString &key)
static void	processChild (QString key, ChildSpec spec, QMap< QString, QString > &result)
static QStringList	splitArgs (const QString &s, int idx)
static QVariant	stringListToVariantList (const QStringList &l)
static QVariant	stringToVariant (const QString &s)
static QStringList	variantListToStringList (const QVariantList &l)
static QString	variantToString (const QVariant &v)
Static Public Functions inherited from QObjectPrivate
static void	clearGuards (QObject *)
static QObjectPrivate *	get (QObject *o)
static void	resetCurrentSender (QObject *receiver, Sender *currentSender, Sender *previousSender)
static Sender *	setCurrentSender (QObject *receiver, Sender *sender)
static void	signalSignature (const QMetaMethod &signal, QVarLengthArray< char > *result)
Public Variables inherited from QSettingsPrivate
QString	applicationName
QSettings::Format	format
QTextCodec *	iniCodec
QString	organizationName
QSettings::Scope	scope
Public Variables inherited from QObjectPrivate
union {
QObject *   currentChildBeingDeleted
QAbstractDeclarativeData *   declarativeData
};
quint32	connectedSignals [2]
QObjectConnectionListVector *	connectionLists
Sender *	currentSender
QList< QPointer< QObject > >	eventFilters
ExtraData *	extraData
QString	objectName
Connection *	senders
QAtomicPointer< QtSharedPointer::ExternalRefCountData >	sharedRefcount
QThreadData *	threadData
void *	unused
Public Variables inherited from QObjectData
uint	blockSig: 1
QObjectList	children
uint	hasGuards: 1
uint	inEventHandler: 1
uint	inThreadChangeEvent: 1
uint	isWidget: 1
QMetaObject *	metaObject
uint	ownObjectName: 1
QObject *	parent
uint	pendTimer: 1
int	postedEvents
QObject *	q_ptr
uint	receiveChildEvents: 1
uint	sendChildEvents: 1
uint	unused: 22
uint	wasDeleted: 1
Protected Variables inherited from QSettingsPrivate
bool	fallbacks
QString	groupPrefix
QStack< QSettingsGroup >	groupStack
bool	pendingChanges
int	spec
QSettings::Status	status

Detailed Description

Definition at line 348 of file qsettings_mac.cpp.

Constructors and Destructors

QMacSettingsPrivate() [1/2]

QMacSettingsPrivate::QMacSettingsPrivate	(	QSettings::Scope	scope,
		const QString &	organization,
		const QString &	application
	)

Definition at line 380 of file qsettings_mac.cpp.

Referenced by QSettingsPrivate::create().

    : QSettingsPrivate(QSettings::NativeFormat, scope, organization, application)
{
    QString javaPackageName;
    int curPos = 0;
    int nextDot;

    QString domainName = comify(organization);
    if (domainName.isEmpty()) {
        setStatus(QSettings::AccessError);
        domainName = QLatin1String("unknown-organization.trolltech.com");
    }

    while ((nextDot = domainName.indexOf(QLatin1Char('.'), curPos)) != -1) {
        javaPackageName.prepend(domainName.mid(curPos, nextDot - curPos));
        javaPackageName.prepend(QLatin1Char('.'));
        curPos = nextDot + 1;
    }
    javaPackageName.prepend(domainName.mid(curPos));
    javaPackageName = javaPackageName.toLower();
    if (curPos == 0)
        javaPackageName.prepend(QLatin1String("com."));
    suiteId = javaPackageName;

    if (scope == QSettings::SystemScope)
        spec |= F_System;

    if (application.isEmpty()) {
        spec |= F_Organization;
    } else {
        javaPackageName += QLatin1Char('.');
        javaPackageName += application;
        applicationId = javaPackageName;
    }

    numDomains = 0;
    for (int i = (spec & F_System) ? 1 : 0; i < 2; ++i) {
        for (int j = (spec & F_Organization) ? 1 : 0; j < 3; ++j) {
            SearchDomain &domain = domains[numDomains++];
            domain.userName = (i == 0) ? kCFPreferencesCurrentUser : kCFPreferencesAnyUser;
            if (j == 0)
                domain.applicationOrSuiteId = applicationId;
            else if (j == 1)
                domain.applicationOrSuiteId = suiteId;
            else
                domain.applicationOrSuiteId = kCFPreferencesAnyApplication;
        }
    }

    hostName = (scope == QSettings::SystemScope) ? kCFPreferencesCurrentHost : kCFPreferencesAnyHost;
    sync();
}

QMacSettingsPrivate() [2/2]

QMacSettingsPrivate::QMacSettingsPrivate

(

CFStringRef

bundleIdentifier

)

Definition at line 434 of file qsettings_mac.cpp.

    : QSettingsPrivate(QSettings::NativeFormat, QSettings::UserScope, QString(), QString())
{
    // applicationId and suiteId are QCFStrings and take ownership, retain to prevent double deletes.
    CFRetain(bundleIdentifier);
    applicationId = bundleIdentifier;
    CFRetain(bundleIdentifier);
    suiteId = bundleIdentifier;

    numDomains = 1;
    domains[0].userName = kCFPreferencesCurrentUser;
    domains[0].applicationOrSuiteId = bundleIdentifier;
    hostName = kCFPreferencesAnyHost;
    sync();
}

~QMacSettingsPrivate()

QMacSettingsPrivate::~QMacSettingsPrivate

(

)

Definition at line 450 of file qsettings_mac.cpp.

{
}

Functions

children()

QStringList QMacSettingsPrivate::children ( const QString &  prefix, ChildSpec  spec  ) const

virtual

Implements QSettingsPrivate.

Definition at line 497 of file qsettings_mac.cpp.

Referenced by remove().

{
    QMap<QString, QString> result;
    int startPos = prefix.size();

    for (int i = 0; i < numDomains; ++i) {
        for (int j = 0; j < numHostNames; ++j) {
            QCFType<CFArrayRef> cfarray = CFPreferencesCopyKeyList(domains[i].applicationOrSuiteId,
                                                                   domains[i].userName,
                                                                   hostNames[j]);
            if (cfarray) {
                CFIndex size = CFArrayGetCount(cfarray);
                for (CFIndex k = 0; k < size; ++k) {
                    QString currentKey =
                            qtKey(static_cast<CFStringRef>(CFArrayGetValueAtIndex(cfarray, k)));
                    if (currentKey.startsWith(prefix))
                        processChild(currentKey.mid(startPos), spec, result);
                }
            }
        }

        if (!fallbacks)
            break;
    }
    return result.keys();
}

clear()

void QMacSettingsPrivate::clear ( )

virtual

Implements QSettingsPrivate.

Definition at line 524 of file qsettings_mac.cpp.

{
    QCFType<CFArrayRef> cfarray = CFPreferencesCopyKeyList(domains[0].applicationOrSuiteId,
                                                           domains[0].userName, hostName);
    CFPreferencesSetMultiple(0, cfarray, domains[0].applicationOrSuiteId, domains[0].userName,
                             hostName);
}

fileName()

QString QMacSettingsPrivate::fileName ( ) const

virtual

Implements QSettingsPrivate.

Definition at line 590 of file qsettings_mac.cpp.

{
    QString result;
    if ((spec & F_System) == 0)
        result = QDir::homePath();
    result += QLatin1String("/Library/Preferences/");
    result += QCFString::toQString(domains[0].applicationOrSuiteId);
    result += QLatin1String(".plist");
    return result;
}

flush()

void QMacSettingsPrivate::flush ( )

virtual

Implements QSettingsPrivate.

Definition at line 567 of file qsettings_mac.cpp.

{
    sync();
}

get()

bool QMacSettingsPrivate::get ( const QString &  key, QVariant *  value  ) const

virtual

Implements QSettingsPrivate.

Definition at line 476 of file qsettings_mac.cpp.

Referenced by isWritable().

{
    QCFString k = macKey(key);
    for (int i = 0; i < numDomains; ++i) {
        for (int j = 0; j < numHostNames; ++j) {
            QCFType<CFPropertyListRef> ret =
                    CFPreferencesCopyValue(k, domains[i].applicationOrSuiteId, domains[i].userName,
                                           hostNames[j]);
            if (ret) {
                if (value)
                    *value = qtValue(ret);
                return true;
            }
        }

        if (!fallbacks)
            break;
    }
    return false;
}

isWritable()

bool QMacSettingsPrivate::isWritable ( ) const

virtual

Implements QSettingsPrivate.

Definition at line 572 of file qsettings_mac.cpp.

{
    QMacSettingsPrivate *that = const_cast<QMacSettingsPrivate *>(this);
    QString impossibleKey(QLatin1String("qt_internal/"));

    QSettings::Status oldStatus = that->status;
    that->status = QSettings::NoError;

    that->set(impossibleKey, QVariant());
    that->sync();
    bool writable = (status == QSettings::NoError) && that->get(impossibleKey, 0);
    that->remove(impossibleKey);
    that->sync();

    that->status = oldStatus;
    return writable;
}

remove()

void QMacSettingsPrivate::remove ( const QString &  key )

virtual

Implements QSettingsPrivate.

Definition at line 454 of file qsettings_mac.cpp.

Referenced by isWritable().

{
    QStringList keys = children(key + QLatin1Char('/'), AllKeys);

    // If i == -1, then delete "key" itself.
    for (int i = -1; i < keys.size(); ++i) {
        QString subKey = key;
        if (i >= 0) {
            subKey += QLatin1Char('/');
            subKey += keys.at(i);
        }
        CFPreferencesSetValue(macKey(subKey), 0, domains[0].applicationOrSuiteId,
                              domains[0].userName, hostName);
    }
}

set()

void QMacSettingsPrivate::set ( const QString &  key, const QVariant &  value  )

virtual

Implements QSettingsPrivate.

Definition at line 470 of file qsettings_mac.cpp.

Referenced by isWritable().

{
    CFPreferencesSetValue(macKey(key), macValue(value), domains[0].applicationOrSuiteId,
                          domains[0].userName, hostName);
}

sync()

void QMacSettingsPrivate::sync ( )

virtual

Implements QSettingsPrivate.

Definition at line 532 of file qsettings_mac.cpp.

Referenced by flush(), isWritable(), and QMacSettingsPrivate().

{
    for (int i = 0; i < numDomains; ++i) {
        for (int j = 0; j < numHostNames; ++j) {
            Boolean ok = CFPreferencesSynchronize(domains[i].applicationOrSuiteId,
                                                  domains[i].userName, hostNames[j]);
            // only report failures for the primary file (the one we write to)
            if (!ok && i == 0 && hostNames[j] == hostName && status == QSettings::NoError) {
#if 1
                // work around what seems to be a bug in CFPreferences:
                // don't report an error if there are no preferences for the application
                QCFType<CFArrayRef> appIds = CFPreferencesCopyApplicationList(domains[i].userName,
                                                                              hostNames[j]);

                // iterate through all the applications and see if we're there
                CFIndex size = CFArrayGetCount(appIds);
                for (CFIndex k = 0; k < size; ++k) {
                    const void *cfvalue = CFArrayGetValueAtIndex(appIds, k);
                    if (CFGetTypeID(cfvalue) == CFStringGetTypeID()) {
                        if (CFStringCompare(static_cast<CFStringRef>(cfvalue),
                                            domains[i].applicationOrSuiteId,
                                            kCFCompareCaseInsensitive) == kCFCompareEqualTo) {
                            setStatus(QSettings::AccessError);
                            break;
                        }
                    }
                }
#else
                setStatus(QSettings::AccessError);
#endif
            }
        }
    }
}

Properties

applicationId

QCFString QMacSettingsPrivate::applicationId

private

Definition at line 373 of file qsettings_mac.cpp.

Referenced by QMacSettingsPrivate().

domains

SearchDomain QMacSettingsPrivate::domains[6]

private

Definition at line 376 of file qsettings_mac.cpp.

Referenced by children(), clear(), fileName(), get(), QMacSettingsPrivate(), remove(), set(), and sync().

hostName

QCFString QMacSettingsPrivate::hostName

private

Definition at line 375 of file qsettings_mac.cpp.

Referenced by clear(), QMacSettingsPrivate(), remove(), set(), and sync().

numDomains

int QMacSettingsPrivate::numDomains

private

Definition at line 377 of file qsettings_mac.cpp.

Referenced by children(), get(), QMacSettingsPrivate(), and sync().

suiteId

QCFString QMacSettingsPrivate::suiteId

private

Definition at line 374 of file qsettings_mac.cpp.

Referenced by QMacSettingsPrivate().

---

The documentation for this class was generated from the following file:

• /src/corelib/io/qsettings_mac.cpp