RAD Studio (Common)
Copyright(C) 2008 Embarcadero Technologies, Inc. All Rights Reserved.
RAD Studio (Common)
Table of Contents Concepts Compiling, Building, and Running Applications
1 2
Compiling, Building, and Running Applications
3
MSBuild Overview
4
Build Configurations Overview
6
Option Sets Overview
7
Targets files
9
Precompiled Headers Overview
10
Unicode in RAD Studio
10
Debugging Applications
18
Overview of Debugging
18
Overview of Remote Debugging
20
Wait Chain Traversal Overview
21
General Concepts
23
Managing the Development Cycle Overview
23
Designing User Interfaces
24
Using Source Control
25
Localizing Applications
27
Deploying Applications
28
Getting Started What Was New in Past Releases
30 31
What's New in RAD Studio (C++Builder 2007)
32
What's New in RAD Studio (Delphi for Microsoft .NET 2007)
36
What's New in RAD Studio (Delphi for Win32 2007)
40
What's New in Delphi and C++Builder 2009
42
What is RAD Studio?
53
Tour of the IDE
54
IDE on Windows Vista
59
Tools Overview
60
Code Editor
61
Form Designer
65
Starting a Project
66
Template Libraries
68
Overview of Virtual Folders
68 iii
RAD Studio (Common) Help on Help
69
Code Completion
71
Class Explorer Overview
72
Testing Applications Unit Testing Overview
74
DUnit Overview
75
UML Modeling Getting Started with Modeling
78 80
About Modeling
80
UML 2.0 Sample Project
81
Code Visualization Overview
84
UML Modeling
85
UML Modeling Projects
86
Namespaces and Packages
86
Modeling Diagram
86
Supported UML Specifications
87
Model Element
88
Model Annotation
88
Model Shortcut
88
Diagram Layout
89
Hyperlinking in UML Models
89
Synchronization Between Models and Source Code
90
Transformation to Source Code
91
OCL Support
91
Patterns
92
Refactoring
94
Quality Assurance Facilities
95
Documentation Generation Facility
96
Importing and Exporting UML Models
97
Code Visualization Overview
98
Refactoring Applications
iv
74
100
Refactoring Overview
101
Symbol Rename Overview (Delphi, C++)
102
Extract Method Overview (Delphi)
103
Extract Resource String (Delphi)
104
Declare Variable and Declare Field Overview (Delphi)
104
Find References Overview (Delphi, C++)
106
Change Parameters Overview (Delphi)
107
RAD Studio (Common) Sync Edit Mode (Delphi, C++)
107
Undoing a Refactoring (Delphi)
108
Procedures Compiling and Building Procedures
109 110
Activating a Build Configuration for a Project
111
Building Packages
111
Compiling C++ Design-Time Packages That Contain Delphi Source
112
Creating Build Events
112
Creating and Modifying Build Configurations
113
Building a Project Using an MSBuild Command
114
Using Targets Files
115
Installing More Computer Languages
116
Previewing and Applying Refactoring Operations
116
Renaming a Symbol
117
Option Sets: Creating, Applying, Editing, and Deleting
118
Enabling Applications for Unicode
119
Using Unicode in the Command Console
127
Linking C++ Library and Object Files
127
Debugging Procedures
128
Adding a Watch
130
Using the CPU View
130
Displaying Expanded Watch Information
131
Attaching to a Running Process
131
Setting and Modifying Breakpoints
132
Using Tooltips During Debugging
135
Inspecting and Changing the Value of Data Elements
136
Modifying Variable Expressions
137
Preparing a Project for Debugging
138
Remote Debugging: Metaprocedure
138
Installing, Starting, and Stopping the Remote Debug Server
138
Installing a Debugger on a Remote Machine
139
Establishing a Connection for Remote Debugging
140
Preparing Files for Remote Debugging
141
Setting the Search Order for Debug Symbol Tables
142
Resolving Internal Errors
143
Editing Code Procedures
146
Using Code Folding
147 v
RAD Studio (Common) Creating Live Templates
148
Creating Template Libraries
148
Customizing Code Editor
151
Finding References
151
Finding Units (Delphi)
152
Recording a Keystroke Macro
152
Refactoring Code
153
Using Bookmarks
155
Using Class Completion
155
Using Code Insight
156
Using Live Templates
158
Using the History Manager
159
Using Sync Edit
160
Getting Started Procedures
vi
161
Adding Components to a Form
162
Class Explorer Procedures
163
Activating Different Modes of Viewing the Inheritance Hierarchy in the Class Explorer
163
Viewing Members Declared in Classes and Interfaces with the Class Explorer
164
Locating Declarations of Classes, Interfaces, and Types with the Class Explorer
164
Locating Declarations of Members with the Class Explorer
165
Locating Definitions of Methods with the Class Explorer
165
Locating Definitions of Properties’ Access Specifiers with the Class Explorer
165
Automating the Creation of Fields with the Class Explorer
166
Automating the Creation of Methods with the Class Explorer
166
Creating a Method - Example
167
Automating the Creation of Properties with the Class Explorer
167
Viewing Hierarchy of Classes, Interfaces, and Types in the Class Explorer
168
Adding References
169
Adding and Removing Files
169
Adding Templates to the Object Repository
169
Copying References to a Local Path
170
Creating a Component Template
170
Creating a Project
171
Customizing the Form
171
Customizing the Tool Palette
172
Customizing Toolbars
172
Disabling Themes in the IDE and in Your Application
173
Docking Tool Windows
173
Finding Items on the Tool Palette
174
RAD Studio (Common) Exploring Assembly Metadata Using the Reflection Viewer
174
Exploring Windows Type Libraries
175
Renaming Files Using the Project Manager
176
Saving Desktop Layouts
176
Setting Component Properties
176
Setting Project Options
177
Setting Project Options
178
Setting Properties and Events
178
Setting The IDE To Mimic Delphi 7
179
Setting Tool Preferences
179
Using Design Guidelines with VCL Components
179
Using the File Browser
180
Using To-Do Lists
180
Using Virtual Folders
181
Writing Event Handlers
182
Localization Procedures
184
Adding Languages to a Project
184
Editing Resource Files in the Translation Manager
185
Setting the Active Language for a Project
186
Setting Up the External Translation Manager
187
Updating Resource Modules
188
Using the External Translation Manager
188
Managing Memory
190
Configuring the Memory Manager
190
Increasing the Memory Address Space
191
Monitoring Memory Usage
192
Registering Memory Leaks
193
Sharing Memory
193
Unit Test Procedures
195
Developing Tests Modeling Procedures
195 198
Configuring UML Modeling
198
Refactoring Procedures
199
Refactoring: Changing Parameters
199
Refactoring: Extracting Interfaces
200
Refactoring: Extracting Method
200
Refactoring: Extracting Superclass
201
vii
RAD Studio (Common) Refactoring: Creating Inline Variables
201
Refactoring: Introducing Fields
202
Refactoring: Introducing Variables
202
Refactoring: Moving Members
203
Refactoring: “Pull Members Up" and “Push Members Down”
203
Refactoring: Renaming Elements
204
Refactoring: "Safe Delete"
204
Opening the UML 2.0 Sample Project
205
UML Diagram Procedures
205
Annotating a Diagram
206
Customizing Diagram Appearance Procedures
206
Creating a Diagram
208
Editing Diagram Procedures
209
Creating Elements, Links, and Shortcuts on Diagrams
218
Exporting a Diagram to an Image
221
Locating Model Elements
221
Printing a Diagram
223
UML 1.5 Diagram Procedures
223
UML 2.0 Diagram Procedures
232
Viewing UML Diagram Procedures
248
Common Procedures
250
Documentation Generation Procedures Configuring the Documentation Generation Facility
265
Generating Project Documentation
266
Working with a Namespace or a Package
266
Object Constraint Language (OCL) Procedures
267
Creating an OCL Constraint
267
Editing an OCL Expression
268
Showing and Hiding an OCL Constraint
268
Modeling Pattern Procedures
269
Adding Participants to the Patterns as First Class Citizens
269
Applying Pattern Procedures
270
Creating a Pattern
272
Exporting and Sharing Patterns
273
Deleting Patterns as First Class Citizens from the Model
274
Using Pattern Organizer
274
Using the Pattern Registry
279
Modeling Project Procedures Activating UML Modeling Support for Projects viii
265
279 280
RAD Studio (Common) Creating a Project
281
Exporting a Project to XMI Format
281
Importing a Project in IBM Rational Rose (MDL) Format
282
Importing a Project in XMI Format
282
Opening an Existing Project for UML Modeling
283
Synchronizing the Model View, Diagram View, and Source Code
283
Transforming a Design Project to Source Code
284
Troubleshooting a Model
285
Working with a Referenced Project
286
Modeling Quality Assurance Procedures
287
Working with Audits
287
Working with Metrics
291
Modeling Procedures
294
Exporting a Code Visualization Diagram to an Image
294
Importing and Exporting a Model Using XML Metadata Interchange (XMI)
295
Using the Model View Window and Code Visualization Diagram
296
Using the Overview Window
297
Reference Delphi Reference
299 300
Delphi Compiler Directives (List)
300
Delphi compiler directives
302
Align fields (Delphi)
303
Application type (Delphi)
303
Assert directives (Delphi)
304
Boolean short-circuit evaluation (Delphi compiler directive)
304
Conditional compilation (Delphi)
304
Debug information (Delphi)
306
DEFINE directive (Delphi)
306
DENYPACKAGEUNIT directive (Delphi)
306
Description (Delphi)
307
DESIGNONLY directive (Delphi)
307
ELSE (Delphi)
307
ELSEIF (Delphi)
308
ENDIF directive
308
Executable extension (Delphi)
308
Export symbols (Delphi)
309
Extended syntax (Delphi)
309
ix
RAD Studio (Common)
x
External Symbols (Delphi)
309
Floating Point Exception Checking (Delphi)
310
Hints (Delphi)
310
HPP emit (Delphi)
311
IFDEF directive (Delphi)
311
IF directive (Delphi)
311
IFEND directive (Delphi)
312
IFNDEF directive (Delphi)
313
IFOPT directive (Delphi)
313
Image base address
313
Implicit Build (Delphi)
314
Imported data
314
Include file (Delphi)
314
Input output checking (Delphi)
315
Compiler directives for libraries or shared objects (Delphi)
315
Link object file (Delphi)
316
Local symbol information (Delphi)
316
Long strings (Delphi)
317
Memory allocation sizes (Delphi)
317
MESSAGE directive (Delphi)
318
METHODINFO directive (Delphi)
318
Minimum enumeration size (Delphi)
318
Open String Parameters (Delphi)
319
Optimization (Delphi)
319
Overflow checking (Delphi)
320
Pentium-safe FDIV operations (Delphi)
320
NODEFINE
321
NOINCLUDE (Delphi)
321
Range checking
321
Real48 compatibility (Delphi)
321
Regions
322
Resource file (Delphi)
322
RUNONLY directive (Delphi)
323
Runtime type information (Delphi)
323
Symbol declaration and cross-reference information (Delphi)
324
Type-checked pointers (Delphi)
324
UNDEF directive (Delphi)
325
Var-string checking (Delphi)
325
Warning messages (Delphi)
325
RAD Studio (Common) Warnings (Delphi)
326
Weak packaging
326
Stack frames (Delphi)
327
Writeable typed constants (Delphi)
328
PE (portable executable) header flags (Delphi)
328
Reserved address space for resources (Delphi)
329
Pointer Math (Delphi)
329
HIGHCHARUNICODE directive (Delphi)
331
Scoped Enums (Delphi)
332
Delphi Compiler Errors
332
Error Messages
333
Delphi Runtime Errors
528
I/O Errors
529
Fatal errors
529
Operating system errors
531
Delphi Language Guide
531
Classes and Objects
532
Data Types, Variables, and Constants
568
Generics
608
Inline Assembly Code (Win32 Only)
622
Object Interfaces
638
Libraries and Packages
648
Memory Management
657
Delphi Overview
665
Procedures and Functions
671
Program Control
694
Programs and Units
698
Standard Routines and I/O
707
Fundamental Syntactic Elements
715
RAD Studio Dialogs and Commands Code Visualization
745 745
Code Visualization Diagram
745
Export Diagram to Image
746
Component
747
Create Component Template
747
Import Component Wizard
748
Install Packages
750
New VCL Component Wizard
750
Database
752 xi
RAD Studio (Common) Add Fields
753
Assign Local Data
753
Command Text Editor
754
Connection String Editor (ADO)
754
Database Editor
754
Dataset Properties
755
Driver Settings
755
Field Link Designer
756
Fields Editor
756
Foreign Key Constraint
757
New Connection
757
New Field
757
Rename Connection
758
SQL Monitor
758
Sort Fields Editor
759
IBDatabase Editor dialog box
759
IBTransaction Editor dialog box
760
IBUpdateSQL and IBDataSet Editor dialog box
761
Edit Alignment
763
Creation Order
763
Edit Tab Order
764
Scale
764
Size
764
Align to Grid
765
Bring to Front
765
Copy
765
Cut
765
Delete
765
Flip Children
765
Lock Controls
766
Paste
766
Select All
766
Send to Back
766
Undo
766
Redo
766
Select All Controls
767
Error Messages Data Breakpoint is set on a stack location xii
762
767 769
RAD Studio (Common) Misaligned Data Breakpoint
769
Error address not found
770
Another file named
is already on the search path
770
Could not stop due to hard mode
770
Error creating process: ()
770
A component class named already exists
770
A field or method named already exists
770
The project already contains a form or module named
770
Incorrect field declaration in class
771
Field does not have a corresponding component. Remove the declaration?
771
Field should be of type but is declared as . Correct the declaration?
771
Declaration of class is missing or incorrect
771
Module header is missing or incorrect
772
IMPLEMENTATION part is missing or incorrect
772
Insufficient memory to run
772
Breakpoint is set on line that contains no code or debug information. Run anyway?
772
is not a valid identifier
772
is already loaded, probably as a result of an incorrect program termination. Your system may be unstable and you should exit and restart Windows now.
772
Incorrect method declaration in class
773
Cannot find implementation of method
773
The method referenced by