FX::FXRegistry Class Reference

The registry maintains a database of persistent settings for an application. More...

#include <FXRegistry.h>

Inheritance diagram for FX::FXRegistry:

List of all members.

Public Member Functions
	FXRegistry (const FXString &akey=FXString::null, const FXString &vkey=FXString::null)
FXbool	read ()
FXbool	write ()
const FXString &	getAppKey () const
const FXString &	getVendorKey () const
void	setAsciiMode (FXbool asciiMode)
FXbool	getAsciiMode () const

---

Detailed Description

The registry maintains a database of persistent settings for an application.

The settings database is organized in two groups of three layers each. The system-wide settings group contains settings information pertaining to all users on a system. The per-user settings group contains settings affecting that user only. Each settings group contains a desktop layer, which comprises the settings which affect all FOX programs, a vendor layer which holds settings that affect all applications from that vendor (e.g. a application-suite), and an application layer which holds settings only for a single application. The vendor-key and application-key determine which files these layers come from, while the "Desktop" key is used for all FOX applications. Settings in the system-wide group are overwritten by the per-user group, and settings from the "Desktop" layer are overwritten by the vendor-layer; vendor-layer settings are overwritten by the application-layer settings. Only the per-user, per-application settings ever gets written; the layers in the system-group only get written during installation and configuration of the application. The registry is read when FXApp::init() is called, and written back to the system when FXApp::exit() is called.

---

Constructor & Destructor Documentation

FX::FXRegistry::FXRegistry (  const FXString &  akey = FXString::null, const FXString &  vkey = FXString::null )

Construct registry object; akey and vkey must be string constants. Regular applications SHOULD set a vendor key!

---

Member Function Documentation

FXbool FX::FXRegistry::read (   )

Read registry.

FXbool FX::FXRegistry::write (   )

Write registry.

const FXString& FX::FXRegistry::getAppKey (   )  const [inline]

Return application key.

const FXString& FX::FXRegistry::getVendorKey (   )  const [inline]

Return vendor key.

void FX::FXRegistry::setAsciiMode (  FXbool  asciiMode  )  [inline]

Set ASCII mode; under MS-Windows, this will switch the system to a file-based registry system, instead of using the System Registry API.

FXbool FX::FXRegistry::getAsciiMode (   )  const [inline]

Get ASCII mode.

Copyright © 1997-2005 Jeroen van der Zijp