Faudrait que je me motive un jour  amliorer la documentation, faire un fichier .hlp
(ce serait mieux que ce petit .txt)

-==-
NOTE: Ce composant fait partie du projet OpenSource "Judonux" et en partage la mme licence.
Rsum de la licence Judonux:
La licence fournit les droits de copier, 
distribuer et modifier le prsent logiciel  quiconque dsire le faire.
Par contre, les noms de toutes les personnes et/ou organismes dj prsents
tant dans le logiciel que dans le code source doivent toujours tre prsents.
Il est strictement interdit de vendre ce composant o toute partie de Judonux.
Il doit rester GRATUIT et libre d'utilisation. 

Comment utiliser le composant AutoBdGraphique?

C'est simple!

Pour faire une fiche tout en couleur, placez AutoBdEditeur sur votre fiche. (il est dans l'onglet AutoBDGraphique)

Ensuite, configurez l'objet. Vous devez  configurer les proprits DataBaseName et TableName.
La liste des tables et des bases de donnes ne s'affichant pas, vous devrez aller dans le menu -> Base de donns | explorateur si vous avez oubli les noms exacts. Quand vous aurez donne une valeurs au deux champs, le composant essayra d'accder  la base de donnes. En cas de russite, la liste des lments contenu dans la table s'affichera  gauche. Il y un autre moyen de se relier a une base de donnes, mais je n'en parlerais pas ici, c'est pas pour les dbutants.

Ensuite, vous devez vrifier les valeurs de deux proprits importante: clPrimaire et ChampPrincipal. Le composant  essayer de deviner ces valeurs. Si elle ne sont pas correcte, il est trs important de les corrigs. 
ClPrimaire: Doit correspondre  la vrai cl primaire dans la base de donnes
ChampPrincipal: Permet de choisir quels champs apparatront dans la liste de slection  gauche. 
	Sparer les champs par des virgules ou des espaces. 
	Le sparateur que vous utilisez sera recopi tel quel lors de l'affichage.
	Par exemple, si vous sparer vos champs par des espaces,
	ils seront aussi spar par des espaces dans la liste de gauche.
	C'est vagues? Essayez et vous comprendrez!
NOTE: Le composant ne devineles valeurs de ces champs que lorsqu'ils sont vide. Donc, si vous modifiez la table o la base de donnes, vous devrez aussi changer la valeur de ces champs.


*********************************************************
AutoBDGraphique est capable de grer la suppression et l'archivage rcursif, il suffit de le configurer convenablement.
Jetez un coup d'oeil a ces proprits:

ErreurDependanceExite: 	c'est le message d'erreur affich quand un enregistrement ne peut tre supprimer parce qu'il possde
			des dpendances

PermettreArchivage:	L'archivage n'est prit en compte que si ce champ vos vrai

ArchivageRecursif:	Cette proprit dtermine si
			le systme doit archiver rcursivement
			Si vous le mettez  vrai, vous devez configurer la liste des
			tables dpendantes dans le compsant.
			Vrifiez aussi la valeur de TableArchive

TableArchive:		C'est le nom de la table d'archive.
			Quand vous affectez la proprit
			tableName, cette proprit
			obtient automatiquement la valeur
			'A_' + tableName si elle  une valeur nulle.
			Je vous conseille fortement d'utiliser
			la valeur automatique pour les tables d'archives.
			Utiliser d'autre nom de table archive que 
			'A_' + tablename entraine des bugs.

Dependance:		Cette proprit est utilis pour dterminer
			quel sont les tables relis. 
			C'est que je ne suis pas capable d'extraire
			ces donnes de la base de donnes.
			Prsentement, ces donnes sont stockes dans
			un fichier de configuration gnrale.
			En modifiant cette proprit, vous modifiez
			en mme temps le fichier de configuration.
			Je vous conseille de ne pas modifi cette
			proprit et d'aller directement dans le fichier
			Truc: lisez le fichier de documentation:
				"Fichier dpendance"


==================================================================
Les autres proprit seront utile pour donner un meilleur aspect visuel

OrdreTri: 	C'est l'ordre dans lequel les enregistrements sont tri,
		rien de vraiment compliqu. 
		Inscrivez le champs qui va servir pour le tri

BoutonEspacement:C'est l'espacement entre les boutons du composant

DoubleBuffered:	Si activ, le composant est dessin en mmoire avant d'tre affich
		Si le dgrad est actif, laissez cette proprit active aussi
		(le dgrad est lent sans DoubleBuffering)

DegradeActif:	Permet de dsactiver le dgrad. 
		Alors, le composant se colorie avec
		les attribut Delphi par dfaut

Les options suivantes contrlent le dgrad

CouleurBas:	C'est la couleur au coin haut-gauche

CouleurHaut:	C'est la couleur au coin bas-Gauche

VariationLatrale:	C'est la variation latrale de couleur. Pour obtenir le coin droit,
 			additionner ce chiffre au coin gauche.
			Mettre une mauvais valeur de variation latrale donne 
			des effets de couleurs amusants.


//--------------- Les sous-objets --------------------
Le composant autoBDGraphique utilise des sous composants. Les proprits de ces objets peuvent tre modifi via "LesBoutons"  et "Selecteur"

- LesBoutons -
 Contrle l'apparence des boutons
 Objet de type tJudoBouton pouvant tre utilis seul
 Les proprits suivantes sont nouvelles
	Espacement: Espace entre les boutons (Dfaut 0)
	HauteurBtn: Hauteur des bouton (dfaut mme valeur que Height)

-Selecteur-
 Contrle la liste de slection  gauche
 Objet de type tDegradeListBD pouvant tre utilis seul
 NOTE:	toutes les proprits ne sont pas  modifier...
	Vous verrez ce que a donne
	AutoHeight: Laissez cet option dsactiv. 
		L'activ  pour effet de redimentionn la
		liste selon le nombre d'lment, ce qui
		ne fonctionne pas quand selecteur est un
		sous-composant
	ChampSource: contrle le champs qui est affich
		n'y touch pas, autoBDGraphique s'en
		charge parfaitement.
	DataBaseName et TableName:
		Quand tDegradeListBD est utilis seul,
		permet de choisir la base de donnes
		dont les lments vont tre list
		Ne pas changez ces valeurs dans le composant 
		inclut dans tAutoBDGraphique
	DegradeActif, CouleurBas, CouleurHaut, VariationLatrale:
		Mme effet que prcdemment, contrle
		l'apparence de liste de gauche.
		Peut tre modifi sans problme.
		Les valeurs de ces propirts sont 
		indpendante du parent
	Inverse: Fonctionne en combinaison avec AutoHeight
		Fait que la hauteur est ajust par le dessus
		au lieu de par le bas
	ItemIndex: Correspond  l'lment slectionn
		dans la liste. Vous pouvez le lire,
		mais soyez prudent lorsque vous le changez.
		NOTE: Dpendemment du mode, 
		cette valeurs risque de changer frquemment
	OrdreTri: Utilisez quand le composant est seul. 
		Dans le cas contraire, utilisez la proprit OrdreTri
		de AutoBDGraphique elle  le mme effet.
	VerrouillerSurClique:
		Une autre proprit  ne pas touch. Si vaux vrai, 
		l'utilisateur ne pourra plus chang la slection
		Aprs avoir cliqu. Normalement, autoBDGraphique
		Gre cette proprit.

	

=== ////// *********** /////// =========
=== ////// *********** /////// =========
=== ////// *********** /////// =========
=== ////// *********** /////// =========

Si vous dsirez ajout des objets non gr par mon systme, vous devrez utilisez les vnements
pour grer vos objets au bon moment

OnChangementEtat: 	est appel dans la procdure ChangementEtat qui sert
			principalement pour mettre  mettre`a jour les boutons.

OnClePrimaireExisteDeja	Si vous dsirez grer diffremment l'existance
			d'un enregistrement ayant la mme cl primaire

OnExecuteRequete	Si vous placez une procdure pour cette vnement, vous serez responsable
			de l'excution des requtes modification. Oui, cette vnement reoi
			en paramtre la requte  excuter

OnFermer		Quand l'utilisateur clique sur le bouton fermer
			Ne pas placer d'vnement ici fait que le bouton fermer ne fonctionne pas

OnInsererEnregistrement, OnModifierEnregistrement
			Ces deux evnements vous permettent
			de placer un systme diffrent de
			cration de requte. Si vous placer
			une procdure, vous serez
			totalement responsable de faire
			les reqtes pour les ajout et
			enregistrement. Heureusement, vous
			n'avez pas  excuter les requtes
			Les crer est suffisant. 
			Conseil:si possible, utilisez 
				la place OnRegroupeValeur

OnRegroupeValeur	Vous permet de modifier les donnes de base avant la construction de la requte
			Vous permet d'ajout des champs  enregistrer.
			Trs utiles si vous dsirez placer des contrles autres que le filtreBDEdit.
			


			
///////////////////////////////////////////////////////////////////////////

Il ne vous reste plus ensuite qu' ajouter des tFiltreBdEdit . Si vous placez les tFiltreBDEdits dans le tAutoBDEditeur, ils seront configur automatiquement. Notez que cette configuration n'est effectu que si l'objet tFiltreBDEdit n'est pas configur. Ce que je veux dire, c'est que si vous changez les proprits du conteneur tAutoBDEditeur, la configuration automatique ne sera effectu que sur les objets non configurs. 

Les tFiltreBDEdit ont plusieurs proprit intressante:
DataSource:	C'est l'endroit d'ou proviennent les donnes
filtre		Toute les donnes entres devront obir  ce filtre
PasNgatif	Si vaus vrai, aucun "-" ne sera accept
NextTab		Vous permet, si vous le vouler, de choisir quel contrle aura le focus ensuite
		si l'utilisateur appuie sur ENTRER

PS: Vous pouvez placez des panels, des groupBox et des PageControls pour regrouper vos champs. La configuration automatique s'effectura quant-mme, pourvu que tous ces objets soit dans le tAutoBDEditeur.

Bonne chance!

Pour plus de renseignements, consult les autres fichiers d'aide. Je vous conseille aussi de jeter un coup d'oeil au code source. Vous pouvez aussi me contacter, je serais heureux de dcouvrir que mon composant est utis par quelqu'un:

programmationtommy.briere@laposte.net

vous pouvez aussi visiter mon site internet  une des deux adresses suivantes:
	programmationtommy.iquebec.com/
	www.angelfire.com/ok2/interessent/			

Tommy Brire, 13 Septembre 2003