OpenTAP 9.25
API Reference
Public Types | Public Member Functions | Properties | List of all members
OpenTap.Package.PackageManagerSettings Class Reference

Settings class containing plugin package manager settings More...

Inheritance diagram for OpenTap.Package.PackageManagerSettings:
OpenTap.ComponentSettings< PackageManagerSettings > OpenTap.ValidatingObject OpenTap.IComponentSettings OpenTap.IValidatingObject OpenTap.ITapPlugin

Public Types

enum  PackageSort { Version , Date }
 Specifies how a UI should order a list of different version of the same package name. Can be either by version or build date. More...
 

Public Member Functions

 PackageManagerSettings ()
 Creates a new PackageManagerSettings. User code should use PackageManagerSettings.Current to access the singleton instead of constructing a new object.
 
- Public Member Functions inherited from OpenTap.ComponentSettings< PackageManagerSettings >
void Save ()
 Saves the settings held by this class to an XML file in the ComponentSettings.SetSettingsProfile(string, string).
 
void Invalidate ()
 Invalidates the cache of this type of component setting.
 
void Reload ()
 Forces the reload of this type of component setting from the XML file the next time the setting is used.
 
virtual void Initialize ()
 Called if a new ComponentSettings is instantiated and there are no corresponding settings XML.
 
- Public Member Functions inherited from OpenTap.ValidatingObject
void OnPropertyChanged (string propertyName)
 Triggers the PropertyChanged event. More...
 

Properties

bool UseLocalPackageCache [getset]
 When true a packages cached in the user-wide package cache (shared accross installations, but not accross users) is used when in addition to the repositories specified in Repositories.
 
bool ShowIncompatiblePackages [getset]
 When true a package management UI should also list packages that are not compatible with the current installation.
 
bool CheckForUpdates = true [getset]
 Determines whether tap.exe will run an update check against configured repositories at startup.
 
PackageSort Sort [getset]
 Specifies how a UI should order a list of different version of the same package name. Can be either by version or build date.
 
List< RepositorySettingEntryRepositories [getset]
 List of servers from where new plugin packages can be discovered and downloaded.
 
- Properties inherited from OpenTap.ComponentSettings< PackageManagerSettings >
static T Current [get]
 Get the currently loaded ComponentSettings instance for this class.
 
string? GroupName [get]
 Settings group of this settings class.
 
static string SettingsDirectoryRoot [getset]
 Where settings files are located. Usually this is at "[Executable location]\Settings", but it can be set to different locations. Setting this will invalidate loaded settings.
 
- Properties inherited from OpenTap.ValidatingObject
ValidationRuleCollection Rules [get]
 All the validation rules. Add new rules to this in order to get runtime value validation.
 
string Error [get]
 Gets the error messages for each invalid rule and joins them with a newline.
 
- Properties inherited from OpenTap.IValidatingObject
ValidationRuleCollection Rules [get]
 A collection of all the currently defined validation rules. Add new rules here in order to get runtime value validation.
 

Additional Inherited Members

- Static Public Member Functions inherited from OpenTap.ComponentSettings< PackageManagerSettings >
static ComponentSettings GetCurrent (Type settingsType)
 Gets current settings for a specified component. This is either an instance of the settings class previously loaded, or a new instance loaded from the associated file. More...
 
static ComponentSettings GetCurrent (ITypeData settingsType)
 Gets current settings for a specified component. This is either an instance of the settings class previously loaded, or a new instance loaded from the associated file. More...
 
static string GetSettingsDirectory (string groupName, bool isProfile=true)
 The directory where the settings are loaded from / saved to. More...
 
static void EnsureSettingsDirectoryExists (string groupName, bool isProfile=true)
 Ensures that the Settings directory exists and that the specified groupName sub directory exists. This might throw an exception if the settings directory was configured to something invalid. Like 'AUX', 'NUL', .... More...
 
static void SetSettingsProfile (string groupName, string profileName)
 Sets the directory in which settings groups are loaded from / saved to. More...
 
static void SaveAllCurrentSettings ()
 Saves all ComponentSettings objects that have been loaded.
 
static string GetSaveFilePath (Type type)
 Gets the current file location where a ComponentSettings type is saved. More...
 
static void SetCurrent (Stream xmlFileStream)
 Sets current settings for a component setting based on a stream of the file contents of a ComponentSettings XML file. More...
 
static void SetCurrent (Stream xmlFileStream, out IEnumerable< XmlError > errors)
 Sets current settings for a component setting based on a stream of the file contents of a ComponentSettings XML file. More...
 
static ComponentSettings GetCurrentFromCache (Type settingsType)
 Gets current settings for a specified component from cache. More...
 
- Static Public Attributes inherited from OpenTap.ComponentSettings< PackageManagerSettings >
static bool PersistSettingGroups
 Gets or sets if settings groups should be persisted between processes.
 
- Protected Member Functions inherited from OpenTap.ValidatingObject
virtual string GetError (string propertyName=null)
 Return the error for a given property
 
void ThrowOnValidationError (bool ignoreDisabledProperties)
 Checks all validation rules on this object (Rules) and throws an AggregateException on errors. More...
 
- Events inherited from OpenTap.ComponentSettings< PackageManagerSettings >
EventHandler CacheInvalidated
 Invokes when the cache for this settings item is invalidated for this item. The way to handle it is usually to fetch the new instance using ComponentSettings.GetCurrent(sender.GetType()).
 
- Events inherited from OpenTap.ValidatingObject
PropertyChangedEventHandler PropertyChanged
 Standard PropertyChanged event object.
 

Detailed Description

Settings class containing plugin package manager settings

Member Enumeration Documentation

◆ PackageSort

Specifies how a UI should order a list of different version of the same package name. Can be either by version or build date.

Enumerator
Version 

Sort packages by version number.

Date 

Sort packages by build date.

OpenTAP 9.25 API built Tue Aug 6 2024 07:49:25