FENETRES ET MENUS

1 FENETRES ET MENUS 1

FENETRES ET MENUS _______________________________________________________________ 1 1.1 Les Fenêtres _____________________________________________________________________ 2 1.1.1 Création _____________________________________________________________________ 2 1.1.2 Les types de fenêtres ___________________________________________________________ 2 1.1.3 Les propriétés des fenêtres ______________________________________________________ 4 1.1.4 Les instructions d'ouverture de fenêtre _____________________________________________ 6 1.1.5 Fermeture des fenêtres _________________________________________________________ 8 1.1.6 Arrangement des fenêtres ______________________________________________________ 10 1.2 Les Menus ______________________________________________________________________ 11 1.2.1 Création du menu ____________________________________________________________ 11 1.2.2 Ecran de conception d'un menu__________________________________________________ 12 1.2.3 Propriétés des menus__________________________________________________________ 13 1.2.4 Les menus flottants ___________________________________________________________ 14 1.3 Créer et utiliser un menu générique pour les MDI _______________________________________ 15

PowerBuilder – Les fenêtres et les menus

1.1 LES FENETRES C'est le type d'application (d'interface) qui va déterminer le type des fenêtres à utiliser. Il existe deux grand types d'application : les SDI (Single Document Interface) et les MDI (Multiple Document Interface) . Word, PowerBuilder sont de type MDI. Calc, Notepad sont des SDI.

1.1.1 Création Nous avons déjà vu que l'on crée une fenêtre en cliquant sur le bouton New, en sélectionnant PB Object et en double-cliquant sur Window.

1.1.2 Les types de fenêtres Type Main Mdi MdiHelp Child Popup Response

Définition Fenêtre Principale Cadre MDI Cadre Mdi avec barre d'état Fenêtre enfant (d'une MDI) Fenêtre volante Fenêtre modale

Les fenêtres Main sont à la base des applications SDI. Les MDI et MDIHelp sont à la base des applications MDI. Les fenêtres CHILD sont les fenêtres ouvertes dans les cadres MDI. © Pascal Buguet

Imprimé le 19 août 2004

Page 2


Les POPUP et les RESPONSE sont utilisées dans les deux types d'application. Les Popup pour des fenêtres d'informations ou de détails. Les Response pour des fenêtres d'alerte ou de saisies obligatoires. Elles sont modales.

© Pascal Buguet


Page 3


1.1.3 Les propriétés des fenêtres Général

1.1.3.1

Scroll

Toolbar

Other

Général

Propriétés qui déterminent l'aspect général. Ces propriétés sont actives ou inactives à la conception selon le type de fenêtre choisi. Il s'agit surtout de la barre de titre, des boutons ControlMenu, MinBox, MaxBox et de la propriété Resizable. ClientEdge ajoute un bord à la fenêtre.

1.1.3.2

Scroll

Les cases à cocher permettent de déterminer la présence ou l'absence de barres de défilement. Les valeurs ( pour les Units) spécifie le nombre d'unités PowerBuilder de déplacement lorsque l'utilisateur clique sur les boutons de défilement. Les valeurs ( Pour les PerPage ) spécifie le nombre d'unités PowerBuilder ( x 100) de déplacement lorsque l'utilisateur clique dans les barres de défilement.

© Pascal Buguet


Page 4


1.1.3.3

Toolbar

Position de la barre d'outils (En haut, en bas,…, Flottante) Si la barre d'outils est flottante vous pouvez la positionner et la dimensionner avec les propriétés ToolBarX, ToolBarY, …..

1.1.3.4

Other

Position, largeur, hauteur de la fenêtre et forme du pointeur.

© Pascal Buguet


Page 5


1.1.4 Les instructions d'ouverture de fenêtre •

Ouverture d'une Main ou d'une MDI

•

Syntaxe

Open(nom_de_fenêtre [, parent]) Parent pour une Popup

•

Exemple

Open(W_mdi) Open(W_sle_proprietes)

•

Ouverture d'une fenêtre Child

•

Syntaxe

OpenSheet ( Nom_de_la_fenêtre , Nom_de_la_fenêtre_parent )

•

Exemple

OpenSheet ( w_sle_proprietes , parentwindow )

•

Ouverture d'une fenêtre Child en passant un paramètre

•

Syntaxe

OpenSheetWithParm ( Nom_de_la_fenêtre , paramètre , Nom_de_la_fenêtre_parent )

•

Exemple

© Pascal Buguet


Page 6


OpenSheetWithParm ( w_villes , sle_cp.text , parentwindow )

•

Syntaxes complètes

OpenSheet (Variable_fenêtre [, Type_fenêtre ], Mdi [, position [,Arrangement] ] ) OpenSheetWithParm ( Variable_fenêtre, paramètre [,Type_fenêtre], Mdi[, position [, Arrangement ] ] )

Où Variable_fenêtre est soit un nom de fenêtre de la bibliothèque soit une variable du type d'une fenêtre. Paramètre est un paramètre (Variable, propriété, constante) Type fenêtre est un type de fenêtre (String) Mdi est un cadre MDI Position est la position du menu dans la barre de menus où sera référencée la fenêtre. Arrangement est un enumerated (Enuméré) : Cascaded!, Layered!, Original! •

Exemples

opensheet(w_sle_proprietes,parentwindow,1,Layered!)

ouvre une fenêtre, le parent est le parent du menu dans lequel se trouve cet instruction, la référence vers la fenêtre se trouvera à la fin du premier menu et cette fenêtre est ouverte en plein écran. W_sle_proprietes Lw_sle Opensheet(lw_sle,"w_sle_proprietes",w_mdi,1,Original!)

Cette syntaxe permet d'ouvrir plusieurs instances de la même fenêtre.

© Pascal Buguet


Page 7


1.1.5 Fermeture des fenêtres 1.1.5.1 •

Fermeture d'une fenêtre

Syntaxe

Close ( Nom_de_la_fenêtre )

•

Exemple

Close(w_sle)

1.1.5.2

Fermeture de la fenêtre active

Nous utilisons la méthode GetActiveSheet() applicable à une Mdi pour récupérer la fenêtre active et la fermer. •

Syntaxe

mdi.GetActiveSheet()

•

Exemple

window lw_active lw_active = w_mdi.GetActiveSheet() Close(lw_active)

1.1.5.3

Fermeture de toutes les fenêtres enfant

Nous utilisons le même principe mais dans une boucle.

© Pascal Buguet


Page 8

PowerBuilder – Les fenêtres et les menus La fonction IsValid renvoie vrai si la variable pointe sur un objet valide, une instance correcte d'objet. window lw_active lw_active = w_mdi.Getactivesheet() do while isvalid(lw_active) close(lw_active) lw_active = w_mdi.Getactivesheet() loop

© Pascal Buguet


Page 9


1.1.6 Arrangement des fenêtres Les fenêtres peuvent être présentées en cascade, en mosaïque,…. Elles doivent être de type Child, ouvertes avec un OpenSheet et RESIZABLE.

C'est la méthode ArrangeSheets appliquée à un objet MDI qui permet cet arrangement. •

Syntaxe

Cadre_MDI.ArrangeSheets ( Mode )

Où Mode prend les valeurs suivantes (Enumerated!) : TileHorizontal! , Tile! , Cascade! , Layer! , Icons! Pour Mosaïque Horizontale, Mosaïque Verticale, Cascade, Plein Ecran, Réorganiser les icônes. •

Exemples

w_mdi.arrangesheets(TileHorizontal!) w_mdi.arrangesheets(Tile!) w_mdi.arrangesheets(Cascade!)

© Pascal Buguet


Page 10


1.2 LES MENUS Ce que l'on voit apparaître en premier c'est la Barre de menus. Une barre de menus est composée de Menus Un menu est composé d'options de menu ou Items de menus Une option de menu peut être un menu en cascade. Ce sont les options de menus qui sont codés. Les actions sont exécutés lorsque l'utilisateur clique sur l'item ou l'atteint via un raccourci directe (du type Ctrl/S) ou une fois le menu ouvert (Lettre) – le menu ayant été ouvert éventuellement via un raccourci du type ALT / N) ou bien encore grâce à un bouton dans une barre de boutons.

1.2.1 Création du menu Pour créer un menu : File / New / Pb Object / Menu

© Pascal Buguet


Page 11


1.2.2 Ecran de conception d'un menu

•

Première étape : Création du premier menu de la barre

Vous cliquez droit sur le seul nœud puis vous cliquez Insert Submenu Item

Vous saisissez le texte du menu : Les &Contrôles ; le nom du menu est automatiquement généré : m_les_controles. •

Deuxième étape : Création des items de menu

Pour créer des Items vous cliquez droit sur le menu puis sur Insert SubMenuItem

© Pascal Buguet


Page 12

PowerBuilder – Les fenêtres et les menus Ensuite – selon que vous soyez sur un menu ou un item vous cliquez sur l'option adéquate pour créer un nouvel item de menu.

1.2.3 Propriétés des menus Propriétés des menus Général ToolBar

Dans les propriétés la première page d'onglet ( General ) règle un certain nombre de propriétés (Nom, Texte, Aide de la barre d'état, accessibilité, raccourcis,… La deuxième page d'onglet ( ToolBar ) règle surtout la barre d'outils : infobulle, icône, …

© Pascal Buguet


Page 13


1.2.4 Les menus flottants 1.2.4.1 Les menus flottants existant dans la barre de menus présente à l'écran •

Syntaxe

Barre_de_menu.Nom_menu.PopMenu ( PositionX , PositionY )

•

Exemple

Soit un menu m_edit dans le barre de menus m_mdi m_mdi.m_edit.popmenu(this.pointerX(),this.pointerY())

1.2.4.2 Les menus flottants d'une barre de menus non présente à l'écran •

Principe

Puisque la barre de menus n'est pas présente à l'écran il faut l'instancier avant de l'afficher. Une fois instanciée on affiche le menu avec la méthode PopMenu comme précédemment en précisant le nom du menu. On instancie un objet avec l'instruction Create et on libère la mémoire avec l'instruction Destroy. •

Exemple

// Déclaration d'une variable menu du type du menu à afficher m_flottant lm_flottant lm_flottant = create m_flottant lm_flottant.m_edit.popmenu(this.pointerX(),this.pointerY()) if isvalid(lm_flottant) then destroy lm_flottant

© Pascal Buguet


Page 14


1.3 CREER ET UTILISER UN MENU GENERIQUE POUR LES MDI 1.3.1 Objectif Créer un menu qui soit réutilisable. Parce que toutes les barres de menus des applications MDI possède les menus Fichier (avec les items Imprimer, Fermer, Fermer tout, Quitter,…), Edit (avec Couper, Copier,…), Fenêtres (avec les items Mosaïque, Cascade,…) et Aide.

1.3.2 Démarche •

Création du WorkSpace générique

Vous créez, si ne la possédez pas encore, une application "générique" dans un nouveau workspace (ws_generique par exemple). •

Création de la barre de menus

Vous créez un nouvel objet Menu (donc une barre de menus) dans Menu Painter avec tous les menus et tous les items standards. Pour tous les menus qui doivent être dans tous les cas à droite dans la barre de menus vous cochez la case à cocher Shift To Right dans la fenêtre des propriétés du menu en question. Menus

© Pascal Buguet

Propriétés


Page 15

PowerBuilder – Les fenêtres et les menus •

Création de menu héritant

Vous vous placez dans votre workspace applicatif. Vous allez sur les propriétés de la cible (Target) en cliquant droit sur l'objet target. Vous sélectionnez l'onglet Library List puis après avoir cliqué sur le bouton Browse vous sélectionnez et validez sur la bibliothèque (Library) générique Avant

Pendant

Après

© Pascal Buguet


Page 16


Votre deuxième bibliothèque apparaît dans l'arborescence de votre workspace. Vous sélectionnez l'objet Menu (m_mdi_generique), vous cliquez droit et vous cliquez sur l'option Inherit. Vous pourrez ainsi modifier la nouvelle barre de menus en insérant un ou plusieurs menus. Vérifiez la propriété Shift to Right de chaque nouveau menu. Si le nouveau menu doit se trouver au centre cette propriété doit être décochée. Si le nouveau menu doit se trouver à la droite de tous les menus cette propriété doit être cochée. Avant (Générique)

© Pascal Buguet


Après (Spécifique)

Page 17