ReplaceText  ResetArgElements

Chapter 10: PowerScript Functions

Reset

Clears data from a control or object. The syntax you choose depends on the target object.

For syntax for DataWindows and DataStores see the Reset method for DataWindows in the DataWindow Reference or the online Help.

To

Use

Delete all items from a list

Syntax 1 For list boxes

Delete all the data (and optionally the series and categories) from a graph

Syntax 2 For graphs

Return to the beginning of a trace file

Syntax 3 For trace files


Syntax 1 For list boxes

Description

Deletes all the items from a list.

Applies to

ListBox, DropDownListBox, PictureListBox, and DropDownPictureListBox controls

Syntax

listboxname.Reset ( )

Argument

Description

listboxname

The name of the ListBox control from which to delete all items

Returns

Integer. Returns 1 if it succeeds and -1 if an error occurs. If listboxname is null, Reset returns null. The return value is usually not used.

Examples

Example 1

This statement deletes all items in the ListBox portion of ddlb_Actions:

ddlb_Actions.Reset()

See also


Syntax 2 For graphs

Description

Deletes the data, the categories, or the series from a graph.

Applies to

Graph controls in windows and user objects and graphs within a DataWindow object with an external data source.

Does not apply to other graphs within DataWindow objects because their data comes directly from the DataWindow.

Syntax

controlname.Reset ( graphresettype )

Argument

Description

controlname

The name of the graph object in which you want to delete all the data values or all series and all data values

graphresettype

A value of the grResetType enumerated datatype specifying whether you want to delete only data values or all series and all data values:

  • All! — Delete all series, categories, and data in controlname

  • Category! — Delete categories and data in controlname

  • Data! — Delete data in controlname

  • Series! — Delete the series and data in controlname

Returns

Integer. Returns 1 if it succeeds and -1 if an error occurs. If any argument’s value is null, Reset returns null. The return value is usually not used.

Usage

Use Reset to clear the data in a graph before you add new data.

Examples

Example 2

This statement deletes the series and data, but leaves the categories, in the graph gr_product_data:

gr_product_data.Reset(Series!)

See also


Syntax 3 For trace files

Description

Goes back to the beginning of the trace file so you can begin rereading the file contents.

Applies to

TraceFile objects

Syntax

instancename.Reset ( )

Returns

ErrorReturn. Returns one of the following values:





Copyright © 2004. Sybase Inc. All rights reserved. ResetArgElements

View this book as PDF