Class: CharacterSetView

• Inheritance
• Description
• Class protocol
  • instance creation
  • startup
• Instance protocol
  • accessing
  • change & update
  • drawing
  • event handling
  • initialization & release
  • queries
• Examples

Inheritance:

   Object
   |
   +--GraphicsMedium
      |
      +--DisplaySurface
         |
         +--SimpleView
            |
            +--View
               |
               +--CharacterSetView

Package:

stx:libwidg2

Category:

Views-Special

Version:

rev: 1.68 date: 2024/04/22 17:06:09

user: stefan

file: CharacterSetView.st directory: libwidg2

module: stx stc-classLibrary: libwidg2

Description:

Can be used both as an informative display of a font's characters
(opened via the fontPanel's-preview-popUpMenu)
or to insert characters into a textView 
(opened by a textEditor's misc-specialCharacters menu).

Author:
    Claus Gittinger

copyright
COPYRIGHT (c) 2004 by eXept Software AG
             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.

Class protocol:

 new

(comment from inherited method)
create a new drawable - take the current display as
its device (for now, this may be changed until the view is
physically created)

 open

open as a top view

Usage example(s):

self open

 openAsInputFor: aView label: viewLabel clickLabel: clickLabel

open as a top view

 openOn: aFont

open as a top view

Usage example(s):

self openOn:(View defaultFont).

 openOn: aFont in: aTopView label: viewLabel clickLabel: clickLabel asInputFor: aConsumingView encoder: aCharacterEncoderOrNilArg

show aFont inside aTopView

Usage example(s):

self openOn:(View defaultFont). self openOn:(Font family:'courier' face:'medium' style:'roman' size:12 encoding:'iso10646-1').

 openOn: aFont label: viewLabel clickLabel: clickLabel

open as a top view

 openOn: aFont label: viewLabel clickLabel: clickLabel asInputFor: aView

open as a top view

Usage example(s):

self openOn:(View defaultFont). self openOn:(Font family:'courier' face:'medium' style:'roman' size:12 encoding:'iso10646-1').

 openOn: aFont label: viewLabel clickLabel: clickLabel asInputFor: aConsumingView encoder: aCharacterEncoderOrNil

open as a top view as a virtual keyboard

Usage example(s):

self openOn:(View defaultFont). self openOn:(Font family:'courier' face:'medium' style:'roman' size:12 encoding:'iso10646-1').

 openOn: aFont select: aCharacterOrCodePointOrNil

open as a top view

Usage example(s):

self openOn:(View defaultFont) select:$a. self openOn:(View defaultFont) select:95. self openOn:(View defaultFont) select:0x2211. self openOn:(View defaultFont) select:nil.

Instance protocol:

 codePage

the page (code // 256) being shown

 codePage: pageNr

the page (code // 256) being shown

 codePageHolder

holdes on the page (code // 256) being shown

 consumingView

the view I will send key-events to when clicked

 consumingView: aView

the view I will send key-events to when clicked

 encoder: aCharacterEncoder

 select: aCharacterOrCodePointOrNil

 selectedCodePoint

the codepoint of the selected character (highlighted)

 selectedCodePoint: anInteger

the codepoint of the selected character (highlighted)

 selectedCodePointHolder

holds on the codepoint of the selected character (highlighted)

 useSameFontAs: aView

 codePageChanged

self clear.

 selectedCodePointChanged

 update: something with: aParameter from: changedObject

 redraw

(self extent:300@600) open

 sizeChanged: how from: oldExtentOrNil

my view has changed the size (not the contents)

 buttonPress: button x: x y: y

(comment from inherited method)
button was pressed - check my components for a hit.

 keyPress: key x: x y: y

others are forwarded to the controlled view

 destroy

(comment from inherited method)
unmap & destroy - make me invisible, destroy subviews then
make me unknown to the device

 initialize

Modified (format): / 08-01-2019 / 14:26:23 / Claus Gittinger

 computePreferredExtent

(comment from inherited method)
return my computed preferred extent - this is the minimum size I would like to have.
If there are any components, a rectangle enclosing them
is returned. Otherwise, the actual extent is returned.

Examples:

CharacterSetView openOn:(Button defaultFont).


CharacterSetView 
    openAsInputFor:Transcript
    label:'Input to Transcript'
    clickLabel:'Click to input character'