Unit 'intuition' Package
[Overview][Constants][Types][Procedures and functions][Variables][Index] [#amunits]

NewObjectA

Create an object from a class.

Declaration

Source position: intuition.pas line 4131

function NewObjectA(

  classPtr: pIClass;

  const classID: pCHAR;

  const tagList: pTagItem

):POINTER;

function NewObjectA(

  classPtr: pIClass;

  const classID: string;

  const tagList: pTagItem

):POINTER;

Arguments

classPtr

  

An abstract pointer to a boopsi class gotten via MakeClass().

classID

  

The name/ID string of a public class. This parameter is only used if class is nil.

tagList

  

A pointer to array of TTagItems containing attribute/value pairs to be applied to the object being created

Function result

A boopsi object, which may be used in different contexts such as a gadget or image, and may be manipulated by generic functions. You eventually free the object using DisposeObject().

Arguments

classPtr

  

An abstract pointer to a boopsi class gotten via MakeClass().

classID

  

The name/ID string of a public class. This parameter is only used if class is nil.

tagList

  

A pointer to array of TTagItems containing attribute/value pairs to be applied to the object being created

Description

This is the general method of creating objects from 'boopsi' classes. ('Boopsi' stands for "basic object-oriented programming system for Intuition".)

You specify a class either as a pointer (for a private class) or by its ID string (for public classes). If the class pointer is nil, then the classID is used.

You further specify initial "create-time" attributes for the object via a TagItem list, and they are applied to the resulting generic data object that is returned. The attributes, their meanings, attributes applied only at create-time, and required attributes are all defined and documented on a class-by-class basis.

This functions send OM_NEW to the dispatcher of the class.

See also

NewObject

  

Varargs version of NewObjectA()

DisposeObject

  

Deletes a 'boopsi' object.

SetAttrs

  

Varargs Version of SetAttrsA()

GetAttr

  

Inquire the value of some attribute of an object.

MakeClass

  

Create and initialize a boopsi class.


Documentation generated on: 2021-07-30