pmsdk/samples/pmcomm/pmcomm.doc - annotate

Return to pmcomm.doc CVS log

Up to [OS/2 SDKs] / pmsdk / samples / pmcomm

Annotation of pmsdk/samples/pmcomm/pmcomm.doc, revision 1.1.1.1

1.1 root 1: PMCOMM is a small port of the TERMINAL application found in the
2: OS/2 1.02 SDK. It turns out that only about 5% of the code was
3: ported. Modem support was commented out. For a person who wants
4: to do more with this, all they have to do is bring in the MODEM.C
5: file found with the TERMINAL sources and update it to the latest
6: os/2 release.
7:
8: This program was made to reflect the following items in a PM
9: application.
10: o use of a thread to read a Comm Port.
11: o how to display and hide the scroll bars on the Window FRAME.
12: o how to set the menu attributes in one section of your code.
13: o use of changing the caption bar.
14: o use of accelerator keys.
15: o use of button controls in a dialog box.
16: o use of the WinQueryQueueStatus fucntion to check the queue
17: for interesting messages.
18: o use of the peek message function
19: o changing the cursor
20:
21: Due to time constraints here is a TO DO / WISH list.
22: A lot more needs to be added to make it more functional.
23: ------------------------
24: Make the write fucntion a separate thread.
25: Move the WM_BLAST routine to another thread or put at the bottom
26: of the urrent read thread.
27: Allow for making the code more modual so that everything does not
28: need to be resident when running.
29: Allow for clipboard - both ways.
30: Allow a dialog for the desired display buffer size.
31: It is now set by #define MAXWIDTH and MAXLINES.
32: Make the Settings dialog more robust.
33: Fix pause scrolling.
34: Make the paint routine smarter. I keep the line length so that
35: an offset can be provided. The array of pointers for the display,
36: pStartLine is not necessary due to the fact that each line is a
37: fixed length from the start.
38: Also see if you can scroll two or three lines at a time.
39: Any more than three might be too much of a flicker.
40: Scroll bar ranges are not correct.
41:
42: Time and consideration was provided for adding more functionality.
43: That is why you will see flags and variables saved that are not used.
44:
45: Here is the flow of PMCOMM.
46:
47: MAIN
48: --------------------------------
49: Creates a window.
50:
51: WM_CREATE message:
52: Gets font metrics
53: Gets handles to scroll bars.
54: Hides scroll bars.
55: Creates the ReadComm thread.
56:
57: Checks to see if an *.INI file was supplied.
58: Calls ReadINIFile.
59: Reads the supplied or default INI file.
60: Builds the caption bar with the current file name.
61: Goes into normal Windows message loop.
62:
63:
64: MENU ITEMS follow:
65: --------------------------------
66: SETTINGS:
67: Dialog comes up to prompt the user for comm settings.
68:
69: START:
70: InitBuffers();
71: Initializes all necessary flags to be used.
72: Initializes all buffers.
73: InitCommPort();
74: Opens comm port with settings provided.
75: (Should I flush the queses at this poing also?)
76: Clears ReadComm thread.
77: Sets the focus to the window.
78: Enables and disables correct menu items.
79:
80: CAPTURE:
81: Sets a flag to pass all characters to a file.
82: Displays a simple dialog asking for a file name
83: to append to.
84: Sets the "c" in the caption bar.
85:
86: PAUSE:
87: Enables and disables:
88: arrow keys
89: menu item
90: scroll bars are made in/visible.
91:
92: TEST:
93: Dumps current contents of display buffer to a file.
94: Displays the characters in a MessageBox as they come in.
95:
96: BREAK:
97: Sends a BREAK character to the host.
98:
99: ECHO:
100: Enables and disables echo to local terminal.
101:
102: STOP:
103: Flushes and then closes the comm port.
104: Enables and disables correct menu items.
105: If any changes were made to the Comm Settings
106: the user is asked if they wish to save
107: the changes.
108:
109:
110: READ THREAD
111: --------------------------------
112: Checks the buffer to determine the # of characters to read.
113: DosReads the comm port with the # of characters from previous step.
114: After read, sets Read Semiphore not to read.
115: Posts a message, WM_BLAST,
116:
117: OTHER EVENTS
118: --------------------------------
119: WM_CHAR:
120: These are passed to the WriteCommPort().
121:
122: WM_INITMENU:
123: This message is sent before a menu is displayed.
124: This provides an easy way to set the menu items
125: in one place depending on flags you set up.
126:
127: WM_SIZE:
128: Determines displayable area and calls WM_PAINT routine.
129:
130: WM_PAINT:
131: Determines displayable area and displays from a circular
132: display buffer.
133:
134: WM_BLAST: does the following:
135: Formats the characters into a display buffer.
136: Displays the characters to the screen.
137: Clears Read Semiphore.
138:

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.