The programming interface syntax for Microsoft® Visual FoxPro® developers, страница 3

TaskList::saveState Method (protected)

Saves engine state information to the resource file.

Visual FoxPro Syntax

void = TaskList.saveState()

Parameters

None

Returns

void

Remarks

saveState is used to save order and column filter information.

TaskList::setOrderBy Method (public)

Sets the task order.

Visual FoxPro Syntax

void = TaskList.setOrderBy( cField, tcType )

Parameters

cField

A field in the task database that can support an order.

cType

                     The type of the field to order by

Returns

void

Remarks

Use setOrderBy to change the order in which the tasks are loaded.

TaskList::showUI Method (public)

Shows the user-interface

Visual FoxPro Syntax

void = TaskList.showUI()

Parameters

None

Returns

void

Remarks

Use showUI to show the default user-interface.

TaskList::typesAreCompatible Method (protected)

Determines if two types are interchangable

Visual FoxPro Syntax

lCompatible = TaskList.typesAreCompatible( cType1, cType2 )

Parameters

cType1

Character representation of a type. Valid values are anything returned by the TYPE function

cType2

Character representation of a type. Valid values are anything returned by the TYPE function

Returns

True if the types are compatible, false if not.

Remarks

typesAreCompatible is used during update and insertion of tasks. Because properties are variant, and table fields are strongly typed, the engine must be certain that two types are compatible before trying an update.

TaskList::updateTask Method (public)

Updates an existing task

Visual FoxPro Syntax

void = TaskList.updateTask( oTask )

Parameters

oTask

A Task object containing the new information.

Returns

void

Remarks

Use updateTask to make changes to the data of an existing task. A task can be retrieved by calling getTask. Use addTask to insert new tasks.

TaskListUI Interface

          TaskListUI Properties

editState

Determines the state of editing in the UI.

TaskList

Pointer to the task list this UI is representing

          TaskListUI Methods

activate

Triggered when the ui gets focus

addColumn

Adds a column to the grid

columnHit

Determines which column was hit with a mouse click

deactivate

Triggered when the ui loses focus

destroy

Triggered when the ui is released

getColumnPosition

Returns the current column position of the passed field.

getPriorityText

Returns the text of a priority setting

init

Triggered on ui creation

load

Triggered on ui creation

loadColumns

Loads saved column information from FOXUSER

loadDefaultColumns

Loads a set of default columns in case Foxuser is inaccessible

loadFormInfo

Loads form information saved to FOXUSER

loadImageLists

Loads the ActiveX image list controls and loads an image array for faster UI performance.

removeColumn

Removes a column from the display

requeryData

Reloads the data from its TaskList object source

resize

Triggered when the size of the form changes

rowHit

Returns the row hit by a mouse click

saveColumns

Saves column information to FOXUSER

saveFormInfo

Saves form information to FOXUSER

showContextMenu

Shows the context menu associated with the selected object (or row inside the grid)

showEdit

Positions the proper ActiveX control above the grid for the selected cell in the grid to simulate editing.

task Interface

          task Properties

[data fields]

Data fields will be added at run-time. This will allow the end user to add, edit or delete fields from the task database. These fields are extracted from the dataSource and childDataSource tables.

TaskList

Pointer to the TaskList object that owns this task

          task Methods

destroy

Destroys the task and releases any live pointers

init

Sets up the task

loadFields

Adds properties for each data field

getProperty

Returns the value of a given property

getPropertyType

Returns the data type of a property

setProperty

Sets the value of a property