Customizing Builder Xcessory

Copyright © 1998 Integrated Computer Solutions, Inc.

Customizing Builder Xcessory^TM is copyrighted by Integrated Computer Solutions, Inc., with all rights reserved. No part of this book may be reproduced, transcribed, stored in a retrieval system, or transmitted in any form or by any means electronic, mechanical, photocopying, recording, or otherwise, without the prior written consent of Integrated Computer Solutions, Inc.

Integrated Computer Solutions, Inc.

201 Broadway, Cambridge, MA 02139

Tel: 617.621.0060

Fax: 617.621.9555

E-mail: info@ics.com

WWW: http://www.ics.com

Trademarks

Builder Xcessory, BX, BX/Ada, Builder Xcessory PRO, BX PRO, BX/Win Software Development Kit, BX/Win SDK, Database Xcessory, DX, DatabasePak, DBPak, EnhancementPak, EPak, ViewKit ObjectPak, VKit, and ICS Motif are trademarks of Integrated Computer Solutions, Inc.

All other trademarks are properties of their respective owners.

First printing

June 1998

How to Use This Manual

Extending Builder Xcessory

Ensuring Availability of Data to Builder Xcessory

Telling Builder Xcessory How to Handle Data

Builder Xcessory Object Packager

Adding Widgets

User-defined Widgets

Information Sources

How Builder Xcessory Searches for a Library

Specifying the Widget Creation Function

Adding Widgets Using the bx.o File

Example

Generating Files

Modifying WML Files

Adding C++ Components

Creating a Component (CreationFunction)

Abstract Components

Methods For Setting Resources

Subclasses

Editing a Component (AttributeFunction)

Example Edit Method

Set Mode

Get Mode

Obtaining the Parent for Children (ChildParentFunction)

Adding A Child To The Component (ChildFunction)

Editing Child Constraint Resources (ConstraintFunction)

Adding Resource Type Editors

Example

Entry points

Widget Hierarchy Generated in the Creation Function

Creation Function Prototype

Simple Editor Creation Function

Allowing Builder Xcessory to Update Internal Structures

EditorUpdateFunc Function Prototype

Example

RegisterResourceEditor Function Prototype

Compiling to a Shared Library

Relinking Builder Xcessory

Adding Predefined Callbacks

Adding a Callback to Predefined Function List

Example

Builder Xcessory Functions

Using the BX Object Packager

Menubar

Toolbar

Catalog Editor

Message Area

BX Object Packager Edit Menu

Loading Data From Widget Libraries

Modifying the WML File

Object Class Diagram

Class Attributes

Class Definitions

Creating Other Control Files

Catalog File Format

Item Attributes

Groups Attributes

Catalog Attributes

Conditions

Using Custom Objects

Index