Empress Software GUI C API
Empress v8.62
May 2006

(Unix only)

© 1983, 2006 Empress Software Inc.

All rights reserved. Reproduction of this document in whole or part, by electronic or any other means, is prohibited without written consent from Empress Software Inc.

RESTRICTED RIGHTS LEGEND

Use, duplication, or disclosure by the Government is subject to restrictions as set forth in
subparagraph (c) (1) (ii) of the Rights in Technical Data and Computer Software clause at 52.227-7013.

05/06


This manual is a complete reference to the functions provided in the C application programming interface for the Empress GUI Builder.


Table of Contents

CHAPTER 1: Introduction

1.1 Overview
1.2 Summary of Functions

CHAPTER 2: Using the C API

2.1 C Actions
2.2 The Action Table
2.3 Steps for C Actions
2.4 The C Routines
2.5 Compiling with empguicc

CHAPTER 3: Objects

3.1 Introduction
3.2 Accessing Objects in C API

3.2.1 Initialization
3.2.2 Accessing Bins & Windows
3.2.3 Accessing Component Objects

3.3 Properties of Objects

3.3.1 General Property Routines
3.3.2 Property Data Types

3.3.2.1 TYPE_ADDRESS
3.3.2.2 TYPE_BOOLEAN
3.3.2.3 TYPE_BULK
3.3.2.4 TYPE_CHAR
3.3.2.5 TYPE_INTEGER
3.3.2.6 TYPE_SELECTION
3.3.2.7 TYPE_STRING
3.3.2.8 TYPE_STRING_ARRAY

3.4 Special Property Functions
3.5 Objects and Properties

3.5.1 Audio Field
3.5.2 Bin
3.5.3 Cascade Button
3.5.4 Field
3.5.5 Hypertext Field
3.5.6 Image Field
3.5.7 Label
3.5.8 List
3.5.9 Multilist
3.5.10 Option Menu
3.5.11 Push Button
3.5.12 Radio Box
3.5.13 Scale Object
3.5.14 Separator
3.5.15 Toggle Button
3.5.16 User Defined Object
3.5.17 Window
3.5.18 Property Errors

CHAPTER 4: Dialogs

4.1 Introduction
4.2 Characteristics of Dialogs

4.2.1 Style
4.2.2 Title
4.2.3 Position
4.2.4 Default Button

4.3 Error Dialog
4.4 File Selection Dialog
4.5 Info Dialog
4.6 Prompt Dialog
4.7 Question Dialog
4.8 Warning Dialog
4.9 Working Dialog

CHAPTER 5: Lists

5.1 Introduction to Lists
5.2 Automatic Scrolling
5.3 User Controlled Scrolling

CHAPTER 6: User-Defined Objects

6.1 Introduction
6.2 Using the Drawing Area Widget

6.2.1 Init Action
6.2.2 Clean Action
6.2.3 Guidelines
6.2.4 User Data

CHAPTER 7: Examples

7.1 Overview
7.2 Creating the Example Database
7.3 Compiling and Running the Examples
7.4 The ex_actab.c File
7.5 Example 1: SimpleApp
7.6 Example 2: Images_c_api
7.7 Example 3: ListApp
7.8 Example 4: ExamResults
7.9 Example 5: FlatFileApp

CHAPTER 8: Function Reference