Quick links: Tutorial - Examples - Files - Symbols.
Classes: Hierarchy - Index - List - Members.
Namespaces: Index - base - cs - display.

Public Types | Public Member Functions | List of all members
cogitantdisplay::DialogHandler Class Referenceabstract

Classe offrant l'accès aux fonctionnalités d'édition de propriétés, mais aussi l'affichage de boîtes de dialogue. More...

#include "cogitant/display/dialog.h"

Inheritance diagram for cogitantdisplay::DialogHandler:
cogitantdisplay::OperationHandler cogitantdisplay::DialogHandler_Java cogitantdisplay::DialogHandler_Wx

Public Types

enum  DialogType {
  NONE, INFO, QUESTION, WARNING,
  ERROR_DIALOG
}
 Type de la boîte de dialogue standard. More...
 
enum  DialogButtons { YES_NO, YES_NO_CANCEL, OK_CANCEL, JUST_OK }
 Boutons de la boîte de dialogue. More...
 
enum  DialogAnswer { YES, NO, OK, CANCEL }
 Réponse de la boîte de dialogue. More...
 

Public Member Functions

 DialogHandler ()
 Constructeur par défaut. More...
 
Gestion des propriétés.
void addOperation (OperationPropertyDialog *ope)
 Ajout d'une opération aux opérations gérées. More...
 
void deleteOperation (OperationPropertyDialog *ope)
 Suppression d'une opération. More...
 
OperationPropertyDialogfindOperation (Editor &editor, Drawing const &drawing, std::list< Drawing::Element > const &el) const
 Accès à l'opération pouvant gérer l'élément. More...
 
bool run (Editor &ed, std::list< Drawing::Element > const &el, Clipping &cl) const
 Edition des propriétés. More...
 
bool ok () const
 Le dernier appel s'est-il terminé par un confirmer ou un annuler ?
 
Boîtes de dialogue d'avertissement et de choix de fichier.
virtual DialogAnswer runStandard (Editor const &ed, std::string const &msg, DialogType dt, DialogButtons buttons)=0
 Affichage d'une boîte de dialogue standard. More...
 
virtual bool runFileChooser (Editor &ed, std::string const &msg, bool save, std::vector< std::vector< std::string > > const &ext, std::vector< std::string > const &extnames, std::string const &filename, std::string &choice)=0
 Affichage d'une boîte de dialogue de choix de fichier. More...
 
- Public Member Functions inherited from cogitantdisplay::OperationHandler
 OperationHandler ()
 Constructeur par défaut. More...
 
virtual ~OperationHandler ()
 Destructeur. More...
 
std::vector< Operation * > const & operations () const
 Accès aux opérations. More...
 

Additional Inherited Members

- Protected Member Functions inherited from cogitantdisplay::OperationHandler
Operationfind (Context const &context, Drawing const &drawing, Drawing::Element const *el=NULL) const
 Accès à l'opération pouvant gérer l'élément. More...
 
void deleteOp (Operation *op)
 Suppression d'une opération. More...
 
- Protected Attributes inherited from cogitantdisplay::OperationHandler
std::vector< Operation * > m_operations
 Les opérations gérées par l'OperationHandler. More...
 
- Static Protected Attributes inherited from cogitantdisplay::OperationHandler
static unsigned int s_nb
 Nombre handlers actuellement en mémoire.
 

Detailed Description

Classe offrant l'accès aux fonctionnalités d'édition de propriétés, mais aussi l'affichage de boîtes de dialogue.

Cette classe se charge de l'affichage de boîtes de dialogue associées à un éditeur. La principale boîte de dialogue utilisée est celle permettant l'édition des propriétés d'éléments. Pour cela, la classe gère un ensemble d'OperationPropertyDialog, et choisit à chaque appel à run() la l'opération qui convient en fonction du type des éléments sélectionnés. Mais cette classe permet aussi d'afficher des boîtes de dialogue standard telles que des messages d'information ou de sélection d'un fichier.

Member Enumeration Documentation

◆ DialogAnswer

Réponse de la boîte de dialogue.

Enumerator
YES 

Oui.

NO 

Non.

OK 

Confirmer.

CANCEL 

Annuler.

◆ DialogButtons

Boutons de la boîte de dialogue.

Enumerator
YES_NO 

Oui / non.

YES_NO_CANCEL 

Oui / non / annuler.

OK_CANCEL 

Confirmer / annuler.

JUST_OK 

OK.

◆ DialogType

Type de la boîte de dialogue standard.

Habituellement, ce type est utilisé pour afficher une icône dans la boîte.

Enumerator
NONE 

Type non précisé. (pas d'icône)

INFO 

Information.

QUESTION 

Question.

WARNING 

Avertissement.

ERROR_DIALOG 

Erreur.

Constructor & Destructor Documentation

◆ DialogHandler()

cogitantdisplay::DialogHandler::DialogHandler ( )

Constructeur par défaut.

Member Function Documentation

◆ addOperation()

void cogitantdisplay::DialogHandler::addOperation ( OperationPropertyDialog ope)

Ajout d'une opération aux opérations gérées.

Parameters
opeOpération à ajouter. Après l'ajout, cette opération ne doit plus être détruite.

◆ deleteOperation()

void cogitantdisplay::DialogHandler::deleteOperation ( OperationPropertyDialog ope)

Suppression d'une opération.

Parameters
opeOpération à supprimer. L'opération est supprimée de la liste des opérations gérées, puis elle est détruite.

◆ findOperation()

OperationPropertyDialog* cogitantdisplay::DialogHandler::findOperation ( Editor editor,
Drawing const &  drawing,
std::list< Drawing::Element > const &  el 
) const

Accès à l'opération pouvant gérer l'élément.

Parameters
editoréditeur à l'origine de la recherche.
drawingdessin
eléléments de dessin à gérer.

◆ run()

bool cogitantdisplay::DialogHandler::run ( Editor ed,
std::list< Drawing::Element > const &  el,
Clipping cl 
) const

Edition des propriétés.

Returns
true si les propriétés ont été correctement éditées (éventuellement sans aucune modification) ou false si aucune opération n'a été trouvée.

◆ runFileChooser()

virtual bool cogitantdisplay::DialogHandler::runFileChooser ( Editor ed,
std::string const &  msg,
bool  save,
std::vector< std::vector< std::string > > const &  ext,
std::vector< std::string > const &  extnames,
std::string const &  filename,
std::string &  choice 
)
pure virtual

Affichage d'une boîte de dialogue de choix de fichier.

Parameters
edéditeur à l'origine de l'affichage de la boîte de dialogue.
msgmessage affiché (en titre, habituellement) dans la boîte.
savetrue boîte de sauvegarde, false boîte de chargement.
extextensions sélectionnées (si tableau vide, aucune sélection n'est effectuée, et tous les fichiers sont affichés).
extnamesnoms des formats associés aux extensions.
filenamenom du fichier par défaut.
choice(R) nom du fichier choisi par l'utilisateur.
Returns
true ssi l'utilisateur a choisi de confirmer son choix.

Implemented in cogitantdisplay::DialogHandler_Wx, and cogitantdisplay::DialogHandler_Java.

◆ runStandard()

virtual DialogAnswer cogitantdisplay::DialogHandler::runStandard ( Editor const &  ed,
std::string const &  msg,
DialogType  dt,
DialogButtons  buttons 
)
pure virtual

Affichage d'une boîte de dialogue standard.

Parameters
edéditeur à l'origine de l'affichage de la boîte de dialogue.
msgmessage affiché dans la boîte.
dttype de la boîte de dialogue (cf. DialogType).
buttonsboutons de la boîte.
Returns
choix de l'utilisateur.

Implemented in cogitantdisplay::DialogHandler_Wx, and cogitantdisplay::DialogHandler_Java.