Microsoft Foundation Classes (mfc.hlp) (
Table of Contents;
Topic list)
Important Notice
The pages on this site contain documentation for very old MS-DOS software,
purely for historical purposes.
If you're looking for up-to-date documentation, particularly for programming,
you should not rely on the information found here, as it will be woefully
out of date.
CWnd::OnDeadChar
◄CWnd► ◄Up► ◄Contents► ◄Index► ◄Back►
──Microsoft Foundation Classes──────────────────────────────────────────────
afx_msg void OnDeadChar( UINT nChar, UINT nRepCnt, UINT nFlags );
Parameter Description
<nChar> Specifies the dead-key character value.
<nRepCnt> Specifies the repeat count.
<nFlags> Specifies the scan code, key-transition code, previous key
state, and context code, as shown in the following list:
Value Description
0-7 Scan code (OEM-dependent value). Low byte of
high-order word.
8 Extended key, such as a function key or a key on the
numeric keypad (1 if it is an extended key, 0
otherwise).
9-10 Not used.
11-12 Used internally by Windows.
13 Context code (1 if the ALT key is held down while
the key is pressed, 0 otherwise).
14 Previous key state (1 if the key is down before the
call, 0 if the key is up).
15 Transition state (1 if the key is being released, 0
if the key is being pressed).
Remarks
Called when the ◄OnKeyUp► member function and the ◄OnKeyDown► member
functions are called. This member function can be used to specify the
character value of a dead key. A dead key is a key, such as the umlaut
(double-dot) character, that is combined with other characters to form a
composite character. For example, the umlaut-O character consists of the
dead key, umlaut, and the O key.
An application typically uses OnDeadChar to give the user feedback about
each key pressed. For example, an application can display the accent in
the current character position without moving the caret.
Since there is not necessarily a one-to-one correspondence between keys
pressed and OnDeadChar calls, the information in <nFlags> is generally
not useful to applications. The information in <nFlags> applies only to
the most recent call to the ◄OnKeyUp► member function or the
◄OnKeyDown► member function that precedes the OnDeadChar call.
For IBM Enhanced 101- and 102-key keyboards, enhanced keys are the right
ALT and the right CONTROL keys on the main section of the keyboard; the
INS, DEL, HOME, END, PAGE UP, PAGE DOWN, and ARROW keys in the clusters
to the left of the numeric keypad; and the slash (/) and ENTER keys in
the numeric keypad. Some other keyboards may support the extended-key
bit in <nFlags>.
This message-handler member function calls the ◄Default► member
function. Override this member function in your derived class to handle
the ◄WM_DEADCHAR► message.
See Also
◄CWnd::Default►, ◄WM_DEADCHAR►
-♦-