| GUI C API Empress v8.62 January 2003 (Unix only)
--- | ---

  © 1983, 2003 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.

  01/03

  Part #: 001-03-G1-110

  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