DsInqObj(3D) — Kubota Pacfic Computer Inc. (\*(Dd)

NAME

DsInqObj − Return an object specified by name

SYNOPSIS

DtObject DsInqObj(object_name_type, object_name,
class_id)
DtNameType object_name_type;
DtPtr object_name;
DtInt class_id;

FORTRAN:

INTEGER∗4 DSQOI(OBJNUM, CLASID)
INTEGER∗4 OBJNUM
INTEGER∗4 CLASID
INTEGER∗4 DSQOS(OBJSTR, N, CLASID)
INTEGER∗4 N
CHARACTER∗N OBJSTR
INTEGER∗4 CLASID

DESCRIPTION

DsInqObj returns a handle to an object.

The parameter object_name specifies the name of the object. Note that objects are not named when they are created; it is the application that names them using DsSetObjName.

The parameter class_id contains an integer indicating the class (or type) of the object being queried. The integer representing a particular class can be determined using DsInqClassId(class_name) where class_name is the C name of the DoXXXXX function used to create an object. For example, DsInqClassId("DoScale") returns the integer class identification value for a scale object.

The parameter object_name_type specifies object_name’s type. Possible values for object_name_type are:

DcNameInteger <DCNINT>
An integer value name.

DcNameString <DCNSTR>
A string value name.

FORTRAN SPECIFIC

Function DSQOS queries the handle of an object when the name is of type DCNINT. OBJNUM is the integer name of the object and CLASID is an integer value indicating the class (or type) of the object being queried. The integer representing a particular class can be determined using DSQCI(CLSNME,N) where CLSNME is the C name of the DoXXXXX function used to create an object and N is the length of the C name. For example, DSQCI(’DoScale’, 7) returns the integer class value for a scale object.

Function DSQOI queries the handle of an object when the object name is of the type DCNSTR. OBJSTR is a string of N characters containing the name of the object. CLASID is an integer value indicating the class (or type) of the object being queried.

ERRORS

DsInqObj will fail if the object_name_type argument is invalid.

[WARNING - invalid parameter]

Museum