Hex Artifact Content

Artifact 128d0bd1378ffe92a0262a15a8524e09c80e3ae7:


0000: 44 65 73 69 67 6e 20 6f 66 20 61 6e 20 69 6d 6d  Design of an imm
0010: 65 64 69 61 74 65 20 67 72 61 70 68 69 63 61 6c  ediate graphical
0020: 20 75 73 65 72 20 69 6e 74 65 72 66 61 63 65 20   user interface 
0030: 61 70 69 20 77 69 74 68 20 6d 61 6e 61 67 65 64  api with managed
0040: 20 6c 61 79 6f 75 74 73 0a 0a 54 65 72 6d 73 3a   layouts..Terms:
0050: 0a 0a 31 2e 20 43 61 6e 76 61 73 20 2d 20 61 20  ..1. Canvas - a 
0060: 64 72 61 77 69 6e 67 20 61 72 65 61 20 77 69 74  drawing area wit
0070: 68 20 61 20 6d 61 6e 61 67 65 64 20 6c 61 79 6f  h a managed layo
0080: 75 74 0a 0a 55 73 65 72 20 73 74 6f 72 69 65 73  ut..User stories
0090: 0a 0a 31 2e 20 49 20 77 6f 75 6c 64 20 6c 69 6b  ..1. I would lik
00a0: 65 20 74 6f 20 63 61 6c 6c 20 55 49 2d 72 65 6e  e to call UI-ren
00b0: 64 65 72 69 6e 67 20 66 75 6e 63 74 69 6f 6e 73  dering functions
00c0: 20 77 69 74 68 6f 75 74 20 73 70 65 63 69 66 79   without specify
00d0: 69 6e 67 20 64 69 6d 65 6e 73 69 6f 6e 73 20 61  ing dimensions a
00e0: 6e 64 20 6c 6f 63 61 74 69 6f 6e 73 0a 32 2e 20  nd locations.2. 
00f0: 49 20 77 6f 75 6c 64 20 6c 69 6b 65 20 74 6f 20  I would like to 
0100: 63 61 6c 6c 20 63 75 73 74 6f 6d 20 55 49 2d 72  call custom UI-r
0110: 65 6e 64 65 72 69 6e 67 20 66 75 6e 63 74 69 6f  endering functio
0120: 6e 73 20 77 68 69 6c 65 20 73 70 65 63 69 66 79  ns while specify
0130: 69 6e 67 20 64 69 6d 65 6e 73 69 6f 6e 73 20 61  ing dimensions a
0140: 6e 64 20 6c 6f 63 61 74 69 6f 6e 73 0a 0a 53 74  nd locations..St
0150: 6f 72 79 20 32 20 6e 65 65 64 73 20 61 20 77 61  ory 2 needs a wa
0160: 79 20 74 6f 20 67 65 74 20 61 20 70 72 6f 70 65  y to get a prope
0170: 72 20 73 74 61 72 74 69 6e 67 20 6c 6f 63 61 74  r starting locat
0180: 69 6f 6e 20 6f 72 20 61 20 62 6f 75 6e 64 69 6e  ion or a boundin
0190: 67 20 62 6f 78 20 49 66 20 31 20 69 73 20 69 6e  g box If 1 is in
01a0: 20 70 6c 61 63 65 2e 0a 0a 43 6f 6e 73 69 64 65   place...Conside
01b0: 72 20 74 68 65 20 73 69 6e 67 6c 65 20 6d 65 74  r the single met
01c0: 68 6f 64 20 4c 61 79 6f 75 74 20 69 6e 74 65 72  hod Layout inter
01d0: 66 61 63 65 3a 0a 0a 74 79 70 65 20 4c 61 79 6f  face:..type Layo
01e0: 75 74 20 69 6e 74 65 72 66 61 63 65 20 7b 0a 09  ut interface {..
01f0: 2f 2f 20 41 64 76 61 6e 63 65 73 20 74 68 65 20  // Advances the 
0200: 6c 61 79 6f 75 74 20 61 6e 64 20 72 65 74 75 72  layout and retur
0210: 6e 73 20 61 20 73 74 61 72 74 69 6e 67 20 70 6f  ns a starting po
0220: 69 6e 74 0a 09 2f 2f 20 66 6f 72 20 61 6e 20 65  int..// for an e
0230: 6c 65 6d 65 6e 74 20 62 61 73 65 64 20 6f 6e 20  lement based on 
0240: 74 68 65 20 6c 61 73 74 20 65 6e 64 69 6e 67 20  the last ending 
0250: 70 6f 69 6e 74 2e 0a 09 4e 65 78 74 28 50 6f 69  point...Next(Poi
0260: 6e 74 29 20 50 6f 69 6e 74 0a 7d 0a 0a 53 74 6f  nt) Point.}..Sto
0270: 72 79 20 31 20 6e 65 63 65 73 73 69 74 61 74 65  ry 1 necessitate
0280: 73 20 74 68 61 74 20 6c 69 62 72 61 72 79 2d 61  s that library-a
0290: 77 61 72 65 20 55 49 2d 72 65 6e 64 65 72 69 6e  ware UI-renderin
02a0: 67 20 66 75 6e 63 74 69 6f 6e 73 20 61 63 71 75  g functions acqu
02b0: 69 72 65 20 74 68 65 69 72 20 73 74 61 72 74 69  ire their starti
02c0: 6e 67 20 6c 6f 63 61 74 69 6f 6e 73 0a 6f 6e 20  ng locations.on 
02d0: 74 68 65 69 72 20 6f 77 6e 2e 20 54 68 69 73 20  their own. This 
02e0: 61 6c 6c 6f 77 73 20 66 6f 72 20 74 68 65 20 66  allows for the f
02f0: 6f 6c 6c 6f 77 69 6e 67 20 74 77 6f 20 61 70 70  ollowing two app
0300: 72 6f 61 63 68 65 73 20 28 6d 6f 72 65 20 61 72  roaches (more ar
0310: 65 20 70 6f 73 73 69 62 6c 65 20 6f 66 20 63 6f  e possible of co
0320: 75 72 73 65 29 0a 0a 2a 20 53 74 6f 72 65 20 74  urse)..* Store t
0330: 68 65 20 65 6e 64 69 6e 67 20 70 6f 69 6e 74 20  he ending point 
0340: 6f 66 20 74 68 65 20 6c 61 73 74 20 65 6c 65 6d  of the last elem
0350: 65 6e 74 2e 20 4e 65 77 20 63 61 6c 6c 73 20 63  ent. New calls c
0360: 61 6e 20 67 65 74 20 69 74 20 61 6e 64 20 70 61  an get it and pa
0370: 73 73 20 69 74 20 74 6f 20 74 68 65 20 6c 61 79  ss it to the lay
0380: 6f 75 74 0a 20 20 2b 20 64 6f 65 73 20 6e 6f 74  out.  + does not
0390: 20 61 64 76 61 6e 63 65 20 74 68 65 20 6c 61 79   advance the lay
03a0: 6f 75 74 20 75 6e 6c 65 73 73 20 72 65 71 75 69  out unless requi
03b0: 72 65 64 2c 20 73 61 76 69 6e 67 20 63 70 75 0a  red, saving cpu.
03c0: 0a 2a 20 53 74 6f 72 65 20 74 68 65 20 6e 65 78  .* Store the nex
03d0: 74 20 73 74 61 72 74 69 6e 67 20 70 6f 69 6e 74  t starting point
03e0: 20 62 79 20 63 61 6c 6c 69 6e 67 20 4e 65 78 74   by calling Next
03f0: 28 29 20 61 74 20 74 68 65 20 65 6e 64 20 6f 66  () at the end of
0400: 20 74 68 65 20 65 6c 65 6d 65 6e 74 20 64 72 61   the element dra
0410: 77 69 6e 67 20 72 6f 75 74 69 6e 65 2e 0a 54 68  wing routine..Th
0420: 65 20 6e 65 78 74 20 64 72 61 77 69 6e 67 20 63  e next drawing c
0430: 61 6e 20 63 6f 6e 74 69 6e 75 65 20 66 72 6f 6d  an continue from
0440: 20 69 74 2e 0a 20 20 2d 20 61 64 76 61 6e 63 69   it..  - advanci
0450: 6e 67 20 74 68 65 20 6c 61 79 6f 75 74 20 63 6f  ng the layout co
0460: 73 74 73 20 63 70 75 0a 20 20 2d 20 74 68 65 20  sts cpu.  - the 
0470: 75 73 65 72 20 6d 69 67 68 74 20 77 61 6e 74 20  user might want 
0480: 61 6e 20 6f 75 74 20 6f 66 20 6c 61 79 65 72 20  an out of layer 
0490: 72 65 6e 64 65 72 0a 0a                          render..