"

 COPYRIGHT (c) 1989 by Claus Gittinger

	      All Rights Reserved

 This software is furnished under a license and may be used

 only in accordance with the terms of that license and with the

 inclusion of the above copyright notice.   This software may not

 be provided or otherwise made available to, or used by, any

 other person.  No title to or ownership of the software is

 hereby transferred.

"

DialogBox subclass:#InfoBox

	instanceVariableNames:'formLabel textLabel'

	classVariableNames:'InfoBitmap'

	poolDictionaries:''

	category:'Views-DialogBoxes'

!

!InfoBox class methodsFor:'documentation'!

copyright

"

 COPYRIGHT (c) 1989 by Claus Gittinger

	      All Rights Reserved

 This software is furnished under a license and may be used

 only in accordance with the terms of that license and with the

 inclusion of the above copyright notice.   This software may not

 be provided or otherwise made available to, or used by, any

 other person.  No title to or ownership of the software is

 hereby transferred.

"

!

documentation

"

   Historic note:

        originally, ST/X had separate classes for the various entry methods;

        there were YesNoBox, EnterBox, InfoBox and so on.

        In the meantime, the DialogBox class (and therefore its alias: Dialog)

        is going to duplicate most funcionality found in these classes.

        In the future, those existing subclasses' functionality is going to

        be moved fully into Dialog, and the subclasses will be replaced by dummy

        delegators. (They will be kept for backward compatibility, though).

    this class implements a pop-up box to show an information message.

    It has a single ok-Button, which closes the box.

    Also entering return has (by default) the same effect as pressing

    the ok-button.

    InfoBox is a superclass of some other boxes - see WarningBox, YesNoBox etc.

    most of them simply redefine the icon shown in the upper left or

    add buttons.

    instance variables:

        formLabel        <Label>        shows a bitmap (warning, question-mark)

        textLabel        <Label>        shows the boxes text

"

!

examples

"

    InfoBoxes are created with:

    and shown with:

    or

    The default box shows 'yes' in its button; this can be changed with:

    the boxes bitmap-image can be changed with:

    Since this type of information is pretty common, a convenient information

    method has been added to Object.

    Thus, you can use:

    everwhere in your program.

    standard box:

    changing the buttons label:

    changing the icon:

    or even:

    If you plan to use boxes as in the last example, you may want to

    keep the box around for reuse (since the image magnification takes some time).

"

! !

!InfoBox class methodsFor:'instance creation'!

title:titleString

    "create a new infoBox with title, aTitleString"

    ^ (self new) title:titleString

    "

     (InfoBox title:'hello') open

    "

! !

!InfoBox class methodsFor:'defaults'!

iconBitmap

    "return the bitmap shown as icon in my instances.

     The form is cached and reused, for faster opening."

    InfoBitmap isNil ifTrue:[

	InfoBitmap := Image fromFile:'bitmaps/Information.xbm'. 

	InfoBitmap notNil ifTrue:[

	    InfoBitmap := InfoBitmap on:Display 

	]

    ].

    ^ InfoBitmap

! !

!InfoBox class methodsFor:'styles'!

updateStyleCache

    |img|

    img := StyleSheet at:'informationBoxIcon'.

    img notNil ifTrue:[InfoBitmap := img on:Display].

! !

!InfoBox methodsFor:'accessing'!

form:aFormOrImage

    "historical leftover - define a form to be displayed left of the title"

    self image:aFormOrImage

!

formLabel

    "return the formLabel = can be used to change its appearance"

    ^ formLabel

!

image:aForm

    "define a form to be displayed left of the title

     - usually left as defaulted:

	an exclamation-mark here, warn-sign in warningBox,

	others in other subclasses."

    formLabel form:aForm.

    formLabel forceResize.

    shown ifTrue:[self resize]

!

textLabel

    "return the textLabel = can be used to change its appearance"

    ^ textLabel

!

title

    "return the boxes title string"

    ^ textLabel label

!

title:aString

    "set the boxes title string"

    aString ~= textLabel label ifTrue:[

	textLabel label:aString.

	textLabel forceResize.

	shown ifTrue:[self resize]

    ]

! !

!InfoBox methodsFor:'initialization'!

initFormBitmap

    "setup the bitmap shown in the upper left -

     extracted into a separate method for easier redefinition

     in subclasses"

    formLabel form:(self class iconBitmap)

!

initFormLabel

    |mm|

    mm := ViewSpacing.

    formLabel := Label in:self.

    formLabel borderWidth:0.

    formLabel origin:(mm @ mm).

    "Created: 16.11.1995 / 18:32:32 / cg"

!

initialize

    |mm|

    super initialize.

    self addOkButton.

    label := 'Info'.

    mm := ViewSpacing.

    self initFormLabel.

    self initFormBitmap.

    textLabel := Label label:'Information' in:self.

    textLabel borderWidth:0.

    textLabel origin:[(mm + formLabel widthIncludingBorder + mm) @ mm].

    "

     |b|

     b := InfoBox new.

     b title:'hello'.

     b open

    "

    "Modified: 20.2.1996 / 20:22:43 / cg"

! !

!InfoBox methodsFor:'queries'!

preferredExtent 

    "return my preferred extent"

"/    formLabel resize.

"/    textLabel resize.

    ^ w @ h

! !

!InfoBox class methodsFor:'documentation'!

version

! !