Présentation	Documentation				L'équipe	Sérialisation
	Programmes	Objets	Libs Utilitaires	Libs Internes
	Editeur	Syntaxes	Windows	Versions

SCR/AL1 - TOME III. Les librairies utilitaires

23. Le groupe s_wddlg

23.30 WDDlgSelect (file s_wddlg.c:1470)

Syntax

WDDlgSelect(U_ch *title, U_ch **opts, char *sels, int x, int y,
                         int cx, int cy, int ntabs, int *tabs)

Description

Affiche une liste d'options dans une boîte de dialogue dynamique et permet d'en sélectionner une ou plusieurs. Cette fonction fait appel au groupe de fonctions WDDlg. La sélection s'opère dans une LISTBOX standard de Windows.

La boîte de dialogue proposée contient une LISTBOX et deux ou trois boutons : Ok, Cancel et Select All si les sélections multiples sont permises (selon la valeur de sels).

Attention aux coordonnées utilisées : la position (x, y) est exprimée en coordonées écran (pixels), tandis que la taille (cx, cy) est exprimée en coordonnées de boîte de dialogue. Ces dernières représentent la taille moyenne d'un caractère dans la police utilisée dans la boîte de dialogue divisée par 4 horizontalement, par 8 verticalement.

On peut quitter la sélection par ENTER, ESCAPE, Alt+F4, double click sur une option, click sur Ok ou Cancel.

• title (optionnel) = titre de la boîte de dialogue. Si title est nul il n'y a pas de titre dans la boîte de dialogue.
• opts = tableau de pointeurs vers les options à afficher. Les options peuvent contenir des tabulations pour organiser la LISTBOX en colonnes
• sels (optionnel) = tableau de caractères, 0 pour option non sélectionnée, 1 pour option sélectionnée. Le nombre d'éléments de sels doit correspondre à celui de opts. Si sels est nul, la sélection ne peut être multiple et la valeur de retour de la fonction indique l'option sélectionnée.
• x = position, en pixels, du coin supérieur gauche de la boîte de dialogue
• y = position, en pixels, du coin supérieur gauche de la boîte de dialogue
• cx = taille, en coordonnées de boîte de dialogue (!), de la boîte de dialogue. Prévoir 60 points minimum pour les boutons sans sélection multiple et 100 points avec sélection multiple (un bouton de plus).
• cy = taille, en coordonnées de boîte de dialogue (!), de la boîte de dialogue. Prévoir 16 points supplémentaires en hauteur pour les boutons.
• ntabs (optionnel) = nombre de tabs définis
• tabs (optionnel) = position des tabs dans la LISTBOX (exprimés en coordonnées de la boîte de dialogue). Par défaut, un tab est placé tous les 16 points (soit plus ou moins 4 caractères).

Valeur retournée

• -1 si terminé par ESCAPE, bouton "Cancel" ou Alt-F4
• 0 si sélection multiple et ENTER, bouton "Ok" ou double click
• numéro de l'option choisie si sélection simple (0, 1, etc)

Exemple

    int     nTabs[] = {50, 70, 100};
 
    MnEdit2(pg, fld_nb, opts)
    PAGE    *pg;
    int     fld_nb;
    U_ch    **opts;
    {
        int     x, y, w, h;
 
        WscrGetFldPos(pg, fld_nb, &x, &y, &w, &h);
        // La PAGE pg doit être active !! //
        return(WDDlgSelect(0L, opts, 0L, x, y + h, w/2, 140, 3, nTabs));
    }
 

Voir également

WDDlgCreate(), WDDlgEdit(), WDDlgAddListbox()