Download - CAD Magazine

MicroStationExtra informatie voor gebruikerHelpteksten en –bestanden in MVBADoor: Johan VreedeDeze keer een onderwerp dat niet zo vaak aanbod komt bij programmeren: helpteksten enhelpbestanden. Dit onderdeel wordt vaak vergetenof overgeslagen. Het mag bekend zijn dat veelinformatie over de precieze werking van een routineen vooral over de volgorde van handelingen juist inde helpbestanden is ondergebracht. Wat dat betreftis het niet meer dat terecht dat hieraan ook wataandacht besteed wordt.Afbeelding 1.Bij helpmeldingen in MicroStation kunnen we drie soortenonderscheiden. De eerste is een melding in het scherm opeen specifieke plaats, zoals statusmeldingen en foutmeldingen.Daarnaast zijn er meldingen in het scherm bij het puntvan aandacht – meestal de cursor. Deze korte meldingenheten tooltip-teksten en komen meestal voor bij buttons inmenu’s. De derde melding is uitleg in helpbestanden,waarbij zowel sprake kan zijn van het oproepen van hettotale helpbestand, met inhoudsopgave en zoekmogelijkheden,als van het oproepen van contextgevoelige helpSchermmeldingenMeldingen in het scherm bij MicroStation V8 verschijnen inprincipe op twee plaatsen:Linksonder in beeld, hier aangeduid als statusgebied, zieafbeelding 1, of midden onder in beeld, hier aangeduid alsmessagegebied. Het verschijnen van meldingen in hetstatusgebied wordt vooral gestuurd door de statements:ShowPrompt, ShowError, ShowStatus en ShowCommand.De statements ShowMessage en ShowTempMessagehebben vooral invloed op het messagegebied. De syntaxvoor een melding is als volgt:Application.ShowPromptDe verschillend statements kunnen licht afwijkenderesultaten hebben.• ShowPrompt toont een meldtekst linksonder in beelden is bedoeld om tijdens de uitvoering van de routineinstructies of informatie over de voortgang te geven.• ShowError toont ook een meldtekst linksonder inbeeld, maar deze tekst verdwijnt als in het statusgebiedwordt geklikt waarna de vorige meldtekst weerverschijnt.• ShowCommand verandert de commandtekst-promptin het statusgebied, het deel voor het groter-dan-teken.• ShowStatus toont een meldtekst in het statusveld,midden onder.• ShowTempMessage heeft drie parameters: locatie,melding, detailtekst. Het toont een melding in hetstatusgebied of in het message-gebied, afhankelijk vande waarde van de eerste parameter, 15 of 16, en toonteen meer gedetailleerde tekst in het detailgebied vanhet Message Center, zie beneden.• ShowMessage heeft vier parameters: melding, detailtekst,icon en alertbox. Het toont een melding in hetmessagegebied, een meer gedetailleerde tekst in hetdetailgebied van het Message Center, zie beneden, eenicon, info/warning/error met nummers 10,11,12, eneventueel een dialoogbox met deze melding.In de voorbeeldroutine zijn de verschillende mogelijkhedente bekijken. De keuze-dialoogbox is via het meegeleverdemenu op te roepen.Message CenterSinds versie V8kent MicroStationhet zogehetenMessage Centervoor het tonen vanmeldingen. Middenin de statusregelonder in hetscherm, tussen statusgebieden messagegebied,hetvakje waarin eventueeleen icoontjeAfbeelding 2.verschijnt, bevindt zich een vakje dat de mogelijkheidbiedt de dialoogbox van het Message Center te openen.In dat dialoogvenster is het mogelijk de laatste melding eneen aantal voorgaande meldingen terug te lezen.Bovendien bevat het onderste deel van die dialoogboxeventueel extra beschrijvende tekst bij de melding.Tooltips en teksten bij menuknoppenEen andere mogelijkheid voor het tonen van melding isde zogeheten tooltip-tekst. Dit is een korte tekst die in eengeelgekleurd vakje verschijnt naast het element waarbovende cursor zweeft. Dit is vaak een menuknop. Bij het aanmakenvan menuopties, zie afbeelding 2, kunnen zowelteksten voor ‘tooltip’ als voor ‘description’ worden ingevuld.De eerste melding verschijnt in het genoemde geelgekleurdevakje, de tweede verschijnt in het statusgebied.HelpbestandenWindows kent voor het weergeven van helpbestanden eenspeciaal bestandsformaat, waarbij de bestanden de extensie58CADMagazine April/Mei 2006-3