$k. FolderElement

An element that can be added to a folder

Extends

Methods

deregister()

Deregisters the element. The ID will be undefined afterwards. Equivalent to setId(undefined)

See
  • setId
Throws:

jsDocNoAdminRights

Type
$k.exception.AccessDenied

id() → {string|undefined}

Returns the registered ID, or undefined if not registered.

Inherited From
Returns:
Type: 
string | undefined

name() → {string}

Returns the name of the element

Since
  • 6.1.1
Returns:
Type: 
string

parentFolders() → {Array.<$k.Folder>}

Returns the folders that contain this element

Returns:
Type: 
Array.<$k.Folder>

register(replaceScriptReferencesopt) → {string}

Registers the element with a private ID, if it has no registered ID yet.

Parameters:
NameTypeAttributesDefaultDescription
replaceScriptReferencesboolean<optional>
false

True if ID references in scripts should be replaced. Only done when the old and the new ID is not undefined.

Since
  • 6.1.1
Throws:

jsDocNoAdminRights

Type
$k.exception.AccessDenied
Returns:

The registered ID

Type: 
string

registryType() → {string}

Returns the name of the registry that contains elements of this type

Returns:
Type: 
string

remove()

Deletes the element and removes it from all containing registries and folders

Throws:

setId(id, replaceScriptReferencesopt)

Registers the element with the given ID. If the element has already been registered, the current ID will be changed to the new ID.

Deprecated option: If the given ID is undefined or null, the element will be deregistered. Use deregister() instead

Parameters:
NameTypeAttributesDefaultDescription
idstring | null

The ID to set

replaceScriptReferencesboolean<optional>
false

True if ID references in scripts should be replaced. Only done when the old and the new ID is not undefined.

See
  • deregister
Throws:

jsDocNoAdminRights

Type
$k.exception.AccessDenied

setName()

Sets the name of the element

Since
  • 6.1.1
Throws:

jsDocNoAdminRights

Type
$k.exception.AccessDenied