Remerciez-le!

Remerciez @Admin pour avoir partagé cet document gratuitement, de la manière la plus simple, en partageant sur les réseaux sociaux.

Les principaux composants Chaque classe et composant de la bibliothèque VCL a u

Les principaux composants Chaque classe et composant de la bibliothèque VCL a une utilité particulière. Toutefois il est possible de les classer en différentes catégories de manière à mieux comprendre leurs points communs et leurs différences. Globalement on distingue : - Les classes et composants de haut niveau qui représentent l'application et ses différentes fenêtres. - Les composants qui permettent de créer une interface évoluée ( panneau, labels, cadres, blocs notes, menus, etc. ). - Les composants chargés de réaliser des entrées et des sorties ( zone de saisie et d'affichage ) ou offrant des possibilités de choix à l'utilisateur ( case à cocher, liste, etc.). - Les composants permettant d'accéder au système.  Dans cette description, qui ne peut qu'être succincte, on laissera de coté les composants plus particulièrement conçus pour la manipulation des données et ceux destinés à la gestion du graphisme. Il est du ressort de tout utilisateur de C++ Builder de chercher à manipuler les différents composants à l'aide d'exercices qu'il s'impose ou en étudiant les, nombreux, exemples fournis. Mais attention, dans ce dernier cas les exemples sont parfois difficiles à appréhender. 10.1 : Composant du niveau application Une application C++ Builder est composée d'un nombre variable de fenêtres dont une est la fenêtre principale. Chaque fenêtre est, du point de vue de la programmation, une classe particulière dérivée de la classe TForm. Mais il existe aussi une classe spéciale, appelé TApplication, "caché" qui permet de référencer directement l'application dans son ensemble. Il n'est pas nécessaire de manipuler directement le composant, non visuel, instancié à ce type dans tous les cas mais il est bon de savoir qu'il existe, sachant qu'il a une importance capitale, et que l'on peut, par son intermédiaire, réaliser des traitements puissants. Page X.1 10. Les principaux composants Les principaux composants La structure générale d'une application est alors : L'objet Application est l'objet "parent" de tous les composants. Il est en particulier parent de tous les objets de type TForm et d'un objet spécifique, appelé TScreen, dont on explicitera le rôle. Chaque objet TForm est parent de tous les composants qu'il contient. Certains de ces composants ( comme le composant TPanel ) peuvent contenir eux même des composants dont ils sont les parents. 10.11 : La classe TForm  Ce composant ne figure pas dans les palettes de composant. Il faut l'appeler explicitement par le menu 'Fichier | Nouvelle Fiche'. Le fait de créer une nouvelle fiche implique la création automatique d'une unité. 10.111 / Description : Une fiche est constituée à partir du composant TForm. Ce composant peut contenir d'autres composants. Il est au centre des applications C++ Builder : on conçoit une application en plaçant des composants sur une ou plusieurs fiches. Les fiches peuvent être utilisées en tant que fenêtres ou en tant que boîtes de dialogue.  Une fiche représente, à l'exécution, une fenêtre distincte : en particulier, les dimensions et la position écran données à la fiche lors de la phase de conception sont, par défaut, celles de la fenêtre à l'exécution. Page X.2 TForm1 TForm2 Contrôle Contrôle Contrôle Contrôle Contrôle TPanel TPanel TApplication TForm1 TScreen TPanel1 Contrôle Contrôle Les principaux composants 10.112 / Principales propriétés : Un composant de type TForm possède un grand nombre de propriétés. En plus de celles, générales, décrites dans le chapitre précédent, il faut connaître la signification d'un certain nombre d'entre elles, spécifiques à ce composant, pour personnaliser la feuille. Propriétés Type Description ActiveControl TWinControl Désigne le composant de la fiche qui sera actif lors de l'affichage de celle-ci. AutoScroll Bool Détermine si les barres de défilement doivent apparaître dans la fiche lorsque la taille de celle-ci est insuffisante pour afficher tous ses contrôles. BordersIcons TBorderIcons Définissent la présence ou l'absence du menu système et des boutons d'agrandissement et de réduction de part et d'autre de la barre de titre. BorderStyle TFormBorderStyle Définit l'apparence et le comportement de la bordure ( redimensionnable ou non, style "boite de dialogue", etc. ). FormStyle TFormStyle Indique si la feuille sera normale ou de type MDI ou si elle pourra rester toujours au-dessus des autres feuilles. KeyPreview Bool Permet de gérer les événements clavier. Menu TMainMenu Désigne la barre des menus de la fiche. Position TPosition Permet de définir la taille et le positionnement de la fiche au démarrage. WindowsState TWindowState Permet de déterminer l'état de la fenêtre au démarrage. Lors de la phase de conception on peut initialiser la plupart des valeurs de ces propriétés.  D'autres propriétés permettent de déterminer précisément la taille et la position de la fenêtre à l'écran. Si l'on veut que la fenêtre ait la taille de l'écran il faudra que ses propriétés Height et Width correspondent à la taille de l'écran ( en tenant compte de la résolution de l'écran ). Il faut ensuite initialiser, à l'exécution, les propriétés Left et Top à 0 ( ou alors initialiser la propriété Position = poScreenCenter ).  Une fenêtre de type "boite de dialogue " ( BorderStyle = bsDialog ) ne peut afficher de menu ( même si celui-ci a été défini lors de la phase de conception).  Par défaut, la propriété Visible est initialisée à False pour toute autre fiche que celle de la fenêtre principale.  Comme le composant fiche est le parent de tous les composants qu'il contient, il n'est pas nécessaire de citer son nom logique pour accéder à ses différentes propriétés ou méthodes à partir des différents gestionnaires d'événements créés. Form1->Caption = "Fenêtre principale" ; est équivalent à : Caption = "Fenêtre principale" ; Page X.3 Les principaux composants Par contre, il sera nécessaire d'utiliser le nom de la fiche si on souhaite invoquer une de ses propriétés ou de ses méthodes à partir d'une autre fiche. 10.113 / Principales méthodes : Le composant TForm possède aussi un nombre impressionnant de méthodes. Parmi celles-ci on peut citer : Méthode Action Close ( void ) Ferme la fiche. La méthode Close appelle d'abord la méthode CloseQuery pour déterminer si la fiche peut être fermée. Si CloseQuery renvoie False, l'opération de fermeture est interrompue. CloseQuery ( void ) La méthode CloseQuery est appelée pendant le processus de fermeture déclenché par la méthode Close d'une fiche afin de savoir si cette dernière peut être effectivement fermée. CloseQuery exécute le code rattaché à l'événement OnCloseQuery. Print Imprime une image de la fiche Show ( void ) Rend visible une fiche en mettant sa propriété Visible à True et en la faisant fonctionner en mode amodal. ShowModal ( void ) Rend visible une fiche en mettant sa propriété Visible à True et en la faisant fonctionner en mode modal. 10.114 / Événements associés : Les principaux événements gérés par le composant de type TForm sont : Événement Déclenchement OnActivate Se produit lorsque la fiche devient active. OnClick Se produit lorsque l'utilisateur clique sur le composant. OnClose Se produit lors de la fermeture d'une fiche OnCloseQuery Se produit lors d'une action fermant la fiche ( lorsque la méthode Close est appelée ou lorsque l'utilisateur choisit Fermeture dans le menu système de la fiche). Il est possible d'utiliser un gestionnaire d'événement OnCloseQuery afin de demander à l'utilisateur une confirmation de la fermeture. OnCreate Permet de créer une fonction associée servant à initialiser la fiche ( valeurs initiales des propriétés et exécution de traitements spécifiques ). OnExit Se produit lorsque la focalisation passe à une autre feuille. Une fiche ne peut être fermée que si la variable globale OnClose, de type booléen, est positionnée à True. Il est donc possible de créer un gestionnaire d'événement afin d'initialiser cette variable. Quelle que soit la manière dont la fenêtre sera fermée ( par un bouton approprié, par le menu système ou par un raccourci clavier ) le gestionnaire d'événement associé à OnCloseQuery est exécuté. Il est alors possible d'y inclure certains contrôles préalables à la fermeture en bloquant celle-ci le cas échéant.  Il est intéressant d'utiliser les possibilités offertes par les différents événements amenant à la création et à l'affichage de la feuille. Certains sont systématiquement appelés lors de la procédure de création. Il s'agit, dans l'ordre, des événements : Page X.4 Les principaux composants - OnCreate : Événement appelé lors de la création de la fiche. Les différents composants de la fiche existent déjà ( on peut donc les invoquer et les initialiser ). Par contre la variable fiche elle-même n'existe pas encore. On ne peut donc pas réaliser des initialisations en l'invoquant ( mais on peut le faire en invoquant directement certaines propriétés ou méthodes ). - OnShow : Événement appelé juste avant que la fiche ne devienne visible. - OnResize : - OnActivate : Événement se produisant lorsque la fiche devient active. - OnPaint : Événement se produisant lorsque Windows demande à la fiche de se peindre quand elle reçoit la focalisation et devient visible alors qu'elle ne l'était pas avant. Tant que la fiche n'est pas visible, on ne peut donner le focus à un de ses composants ( il faut utiliser pour cela la propriété ActiveControl qui donnera uploads/Management/ ppaux-composants.pdf