Window Framework for UI Toolkit v2.0.x
GWG.WindowFramework.Theming.PlayerThemeNaming Class Reference

Portable Windows-safe theme folder naming shared by UI and direct export callers. More...

Static Public Member Functions

static bool IsAvailable (string name, ISet< string > names, out string error)
 Validates syntax and checks a cached repository snapshot.
static HashSet< string > ReadNames (string root)
 Reads a bounded case-insensitive snapshot; includes file collisions, not just theme folders.
static string Suggest (string name, ISet< string > names)
 Returns a conventional Name (x) suggestion for direct callers; never commits or renames automatically.
static bool Validate (string name, out string error)
 Validates one literal folder/display name without silently sanitizing it.

Detailed Description

Portable Windows-safe theme folder naming shared by UI and direct export callers.

Member Function Documentation

◆ IsAvailable()

bool GWG.WindowFramework.Theming.PlayerThemeNaming.IsAvailable ( string name,
ISet< string > names,
out string error )
inlinestatic

Validates syntax and checks a cached repository snapshot.

Parameters
nameLiteral candidate; not normalized or renamed by this method.
namesExisting snapshot, preferably ReadNames' ordinal-ignore-case set; null skips collisions.
errorSafe naming/collision explanation, null on success.
Returns
True if syntax and the supplied set accept the name.

Uses the provided set's comparer and does not reread/reserve storage. Exporter rechecks current names before commit. Do not supply a stale case-sensitive set as proof that a Windows portable name is safely available.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ ReadNames()

HashSet< string > GWG.WindowFramework.Theming.PlayerThemeNaming.ReadNames ( string root)
inlinestatic

Reads a bounded case-insensitive snapshot; includes file collisions, not just theme folders.

Does not create storage. Refresh on dialog open or explicit repository refresh, not each keystroke.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ Suggest()

string GWG.WindowFramework.Theming.PlayerThemeNaming.Suggest ( string name,
ISet< string > names )
inlinestatic

Returns a conventional Name (x) suggestion for direct callers; never commits or renames automatically.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ Validate()

bool GWG.WindowFramework.Theming.PlayerThemeNaming.Validate ( string name,
out string error )
inlinestatic

Validates one literal folder/display name without silently sanitizing it.

Parameters
nameLiteral NFC name, one to eighty characters, not a path.
errorSyntax/reserved-name explanation on failure; null on success.
Returns
True for portable syntax; does not inspect disk or reserve the name.
Here is the caller graph for this function: