/usr/share/GNUstep/Documentation/GDL2Intro

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html401/loose.dtd">
<html>
<!-- C2006 Free Software Foundation

Permission is granted to make and distribute verbatim copies of
this manual provided the copyright notice and this permission notice
are preserved on all copies.

Permission is granted to copy and distribute modified versions of this
manual under the conditions for verbatim copying, provided also that
the entire resulting derived work is distributed under the terms of a
permission notice identical to this one.

Permission is granted to copy and distribute translations of this manual
into another language, under the above conditions for modified versions.
 -->
<!-- Created on May 20, 2013 by texi2html 1.82
texi2html was written by: 
            Lionel Cons <Lionel.Cons@cern.ch> (original author)
            Karl Berry  <karl@freefriends.org>
            Olaf Bachmann <obachman@mathematik.uni-kl.de>
            and many others.
Maintained by: Many creative people.
Send bugs and suggestions to <texi2html-bug@nongnu.org>
-->
<head>
<title>GNUstep Database Library Introduction 0.1: 10. EOInterface</title>

<meta name="description" content="GNUstep Database Library Introduction 0.1: 10. EOInterface">
<meta name="keywords" content="GNUstep Database Library Introduction 0.1: 10. EOInterface">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="texi2html 1.82">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.smallquotation {font-size: smaller}
pre.display {font-family: serif}
pre.format {font-family: serif}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
pre.smalldisplay {font-family: serif; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: serif; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.roman {font-family:serif; font-weight:normal;}
span.sansserif {font-family:sans-serif; font-weight:normal;}
ul.toc {list-style: none}
-->
</style>


</head>

<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">

<a name="EOInterface"></a>
<table cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="GDL2Intro_9.html#Working-with-relationships" title="Previous section in reading order"> &lt; </a>]</td>
<td valign="middle" align="left">[<a href="#Introduction" title="Next section in reading order"> &gt; </a>]</td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left">[<a href="GDL2Intro_9.html#Working-with-data" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
<td valign="middle" align="left">[<a href="GDL2Intro.html#Top" title="Up section"> Up </a>]</td>
<td valign="middle" align="left">[<a href="GDL2Intro_11.html#Index" title="Next chapter"> &gt;&gt; </a>]</td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left">[<a href="GDL2Intro.html#Top" title="Cover (top) of document">Top</a>]</td>
<td valign="middle" align="left">[<a href="GDL2Intro_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
<td valign="middle" align="left">[<a href="GDL2Intro_11.html#Index" title="Index">Index</a>]</td>
<td valign="middle" align="left">[<a href="GDL2Intro_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
<a name="EOInterface-1"></a>
<h1 class="chapter">10. EOInterface</h1>
<hr size="6">
<a name="Introduction"></a>
<table cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#EOInterface" title="Previous section in reading order"> &lt; </a>]</td>
<td valign="middle" align="left">[<a href="#EODisplayGroup-class" title="Next section in reading order"> &gt; </a>]</td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left">[<a href="#EOInterface" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
<td valign="middle" align="left">[<a href="#EOInterface" title="Up section"> Up </a>]</td>
<td valign="middle" align="left">[<a href="GDL2Intro_11.html#Index" title="Next chapter"> &gt;&gt; </a>]</td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left">[<a href="GDL2Intro.html#Top" title="Cover (top) of document">Top</a>]</td>
<td valign="middle" align="left">[<a href="GDL2Intro_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
<td valign="middle" align="left">[<a href="GDL2Intro_11.html#Index" title="Index">Index</a>]</td>
<td valign="middle" align="left">[<a href="GDL2Intro_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
<h2 class="section">10.1 Introduction</h2>
<p>With GDL2 and EOInterface you can develop graphical applications using the
gnustep gui libraries. It provides the ability to create connections
between records from the database, and graphical controls.
</p>
<p>Once a connection has been made between the graphical control and the record,
EOInterface will update the record when the data changes in the control,
and update the control when the data or the selection changes.
EOInterface is composed of the EODisplayGroup class and EOAssociation
subclasses. 
</p>
<p>EODisplayGroup contains the records and manages the selection,
and notifies EOAssociations when the selection or selected record changes.
</p>
<p>EOAssociation subclasses, associate graphical controls to the display group
displaying the data in the display group, and updating the display group when
the control changes the data.  Multi-record associations such as table views can
change the display groups selection.
</p>
<hr size="6">
<a name="EODisplayGroup-class"></a>
<table cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#Introduction" title="Previous section in reading order"> &lt; </a>]</td>
<td valign="middle" align="left">[<a href="#EOAssociation-class" title="Next section in reading order"> &gt; </a>]</td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left">[<a href="#EOInterface" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
<td valign="middle" align="left">[<a href="#EOInterface" title="Up section"> Up </a>]</td>
<td valign="middle" align="left">[<a href="GDL2Intro_11.html#Index" title="Next chapter"> &gt;&gt; </a>]</td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left">[<a href="GDL2Intro.html#Top" title="Cover (top) of document">Top</a>]</td>
<td valign="middle" align="left">[<a href="GDL2Intro_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
<td valign="middle" align="left">[<a href="GDL2Intro_11.html#Index" title="Index">Index</a>]</td>
<td valign="middle" align="left">[<a href="GDL2Intro_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
<h2 class="section">10.2 EODisplayGroup class</h2>
<p>EODisplayGroup has an EODataSource, and can fetch and create objects, manage the
selection, filter the objects for display with qualifiers, and sort them with
EOSortOrderings. 
</p>
<p>If you have loaded the GDL2Palette into Gorm you can create an EODisplayGroup
by dragging an entity or a relationship from the outline view in DBModeler,
to the document window in Gorm the display group will be associated with an
EODataSource and will be encoded/decoded to and from the .gorm file. It will be a top level object, visible in the &rsquo;Objects&rsquo; view of the gorm document.
With the name of the entity or relationship dropped.
</p>
<p>You can create connections from controls directly to the display group,
for example you could connect a button or menu item to EODisplayGroups
-selectNext: action by: 
Selecting the control and control-drag from the control to the display
group. In the connect inspector, select -selectNext: and click &rsquo;connect&rsquo;.
</p>
<p>Available actions for EODisplayGroup:
</p><ol>
<li>
-fetch:
</li><li>
-selectNext:
</li><li>
-selectPrevious:
</li><li>
-delete:
</li><li>
-insert:
</li></ol>

<p>Manual creation of a EODisplayGroup by initializing the display group and
setting its dataSource:
</p><table><tr><td>&nbsp;</td><td><pre class="example">EODisplayGroup *dg;
EODataSource *dataSource;

dg = [[EODisplayGroup alloc] init];
[dg setDataSource:dataSource];
</pre></td></tr></table>

<hr size="6">
<a name="EOAssociation-class"></a>
<table cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#EODisplayGroup-class" title="Previous section in reading order"> &lt; </a>]</td>
<td valign="middle" align="left">[<a href="GDL2Intro_11.html#Index" title="Next section in reading order"> &gt; </a>]</td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left">[<a href="#EOInterface" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
<td valign="middle" align="left">[<a href="#EOInterface" title="Up section"> Up </a>]</td>
<td valign="middle" align="left">[<a href="GDL2Intro_11.html#Index" title="Next chapter"> &gt;&gt; </a>]</td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left">[<a href="GDL2Intro.html#Top" title="Cover (top) of document">Top</a>]</td>
<td valign="middle" align="left">[<a href="GDL2Intro_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
<td valign="middle" align="left">[<a href="GDL2Intro_11.html#Index" title="Index">Index</a>]</td>
<td valign="middle" align="left">[<a href="GDL2Intro_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
<h2 class="section">10.3 EOAssociation class</h2>
<p>An EOAssociation is an abstract base class.
Subclasses of EOAssociation can be created to connect properties of an object
in an EODisplayGroup to graphical controls. EOControls contain aspects,
objects, and keys, and display groups.
</p>
<p>Where the object is a graphical control, the key, being a key appropriate for 
KVC on an enterprise object, and the aspect is a string describing the
use for the key.  Each association has their own set of aspects and the aspects supported may vary between different association classes.
</p>
<p>Manual creation of an EOControlAssocation:
</p><table><tr><td>&nbsp;</td><td><pre class="verbatim">EOAssociation *association;
EODisplayGroup *authorDG;
NSTextField *nameField;

association = [[EOControlAssociation alloc] initWithObject:nameField];
[association bindAspect:@&quot;value&quot; displayGroup:authorDG key:@&quot;name&quot;];
[association establishConnection];
[association release];
</pre></td></tr></table>

<p>A few things of note, You can bind multiple aspects to an association.
When the connection is broken the association will be 
released.  When &rsquo;nameField&rsquo; is deallocated, the connection will automatically
be broken.
</p>
<p>EOAssociations can be created transparently by Gorm with the GDL2Palette.
To create an association with Gorm, Select a control and control-drag from a
control to an EODisplayGroup.  
</p>
<p>In the connect inspector there is a pop up button which contains a list of the
association classes which are usable with the control. Select an association
class and the first column in the browser changes to a list of the aspects
available.  Selecting an aspect in the browser and the second column in the
browser will list the available class properties connectable to the aspect.
</p>
<p>Unfortunately while not all association classes and aspects are
implemented.  They will unfortunately show up in the connect inspector.
</p>
<hr size="6">
<table cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#EOInterface" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
<td valign="middle" align="left">[<a href="GDL2Intro_11.html#Index" title="Next chapter"> &gt;&gt; </a>]</td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left">[<a href="GDL2Intro.html#Top" title="Cover (top) of document">Top</a>]</td>
<td valign="middle" align="left">[<a href="GDL2Intro_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
<td valign="middle" align="left">[<a href="GDL2Intro_11.html#Index" title="Index">Index</a>]</td>
<td valign="middle" align="left">[<a href="GDL2Intro_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
<p>
 <font size="-1">
  This document was generated by <em>root</em> on <em>May 20, 2013</em> using <a href="http://www.nongnu.org/texi2html/"><em>texi2html 1.82</em></a>.
 </font>
 <br>

</p>
</body>
</html>
gnustep-dl2 0.12.0-10 / usr / share / GNUstep / Documentation / GDL2Intro_10.html
