poI3DViewCtrl RenameView

Renames an existing memory view with a new name.

Syntax

poI3DViewCtrl_handle RenameView old_view_name new_view_name

Application

HyperView Tcl Modify

Description

This command renames an existing memorized view with a new name.
Note: The new view name must be unique.

Inputs

old_view_name
The name of the existing/old view.
new_view_name
The name of the new view.

Example

To rename an existing memory view:
hwi OpenStack
hwi GetSessionHandle session_handle
session_handle GetProjectHandle project_handle
project_handle GetPageHandle page_handle [project_handle GetActivePage]
page_handle GetWindowHandle window_handle [page_handle GetActiveWindow]
window_handle GetClientHandle client_handle
window_handle GetViewControlHandle viewctrl_handle
viewctrl_handle RenameView "old view name" "new view name"
puts "Current View: [viewctrl_handle GetCurrentView]"

hwi CloseStack

Errors

Returns an error if the view control handle is invalid, or if the memorized/old view name could not be found, or if the new view name is not unique.