axlSetCornerName

axlSetCornerName(
x_cornerHandle 
t_cornerName
) 
=> t / nil 

Description

Sets or updates the name of the given corner.

Arguments

x_cornerHandle	Handle to the corner for which the name is to be changed.
t_cornerName	New name to be set for the corner.

Value Returned

t	The corner name was set or updated.
nil	The command could not be run.

Examples

The following example shows how to update the name for a corner.

s

session = axlGetWindowSession()
=> "session0"
x_mainSDB = axlGetMainSetupDB(session)
=> 1001

;; list pre-existing corners
cadr(axlGetCorners(x_mainSDB))
=> ("C0" "C1")

;; retrieve the SDB handle for a specific corner C0
cornerHandle = axlGetCorner(x_mainSDB "C0")
=> 1234   ;; a non-zero integral handle

;; update the corner name
axlSetCornerName(cornerHandle "newName")
=> t   ;; successful modification
;; retrieve corners again to validate the name change
cadr(axlGetCorners(x_mainSDB))
=> ("newName "C1")

Return to top