Unit 'Intuition' Package
[Overview][Constants][Types][Procedures and functions][Variables][Index] [#aros]

NewObjectA

Create an object from a class.

Declaration

Source position: intuition.pas line 3293

function NewObjectA(

  ClassPtr: PIClass;

  ClassID: PChar;

  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().

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