OS/2 APIs In Different NLVs

This appendix lists the differences in OS/2 APIs among DBCS NLVs.

• API's that have code-page parameter(s)

  Supported code pages are different.

• KbdCharIn and KbdPeek - CP

  • ASCII Character Code (in the character data structure)

    When the shift report bit is on, asciicharcode byte conveys NLS shift down information as follows:

    Bit

    Description
    7
    Alphanumeric key down
    6
    Katakana key down (Japanese)
    Jamo key down (Korean)
    Reserved (T-Chinese)
    5
    Hiragana key down (Japanese)
    Hangeul key down (Korean)
    TsangJye key down (T-Chinese)
    4
    Kanji key down (Japanese)
    Hanja_25 key down (Korean)
    Phonetic key down (T-Chinese)
    3
    SBCS key down
    2
    Reserved, set to zero. (Japanese and T-Chinese)
    Hanja_CSR [This is supported only for full-screen applications. ] key down (Korean)
    1-0
    Reserved, set to zero.
    -
    NLS Shift Status (in the character data structure)

    (Reserved in SBCS OS/2)

    Bit

    Description
    7
    Kana-To-Kanji Conversion Mode (Japanese)
    Hanja_25: Hangeul-to-Hanja Conversion Mode (Korean)
    Reserved (T-Chinese)
    6
    Romaji Mode (Japanese)
    Hanja_CSR: Hangeul-to-Hanja Conversion Mode (Korean)
    Reserved (T-Chinese)
    5
    Reserved
    4-3
    00
    Shift Indicator Row always visible
    01
    Shift Indicator Row always invisible
    10
    Shift Indicator Row visible only when a shift key is pressed. And it becomes invisible, depress another key.
    11
    Reserved
    2-1
    00
    Alphanumeric Mode
    01
    Katakana Mode (Japanese)
    Jamo Mode (Korean)
    Phonetic Input Mode (T-Chinese)
    10
    Hiragana Mode (Japanese)
    Hangeul Mode (Korean)
    TsangJye Input Mode (T-Chinese)
    11
    Reserved
    0
    DBCS Mode
    -
    Shift Key Status (in the character data structure)

    shiftkeystat is the same among Japanese, Korean and T-Chinese. (But bit 11 and 10 are reserved and different from SBCS OS/2. Check bit 3 or 2 instead.)

    
    KbdGetStatus and KbdSetStatus [For a Vio-windowed application, KbdSetStatus is:

    • ignored in SBCS OS/2,

    • effective but just for the NLS shift status in Japanese OS/2 1.21,

    • ignored in Japanese OS/2 1.20, Korean OS/2 1.2 or T-Chinese OS/2 1.2. ] - CP

    • NLS Shift Status (in the keyboard status structure)

      See the above.

    • Shift Key Status (in the keyboard status structure)

      See the above.

    
    WinDBCSModeControl - PM

    This is a DBCS OS/2 unique call and used to query or set the NLS shift status. The syntax is:

    WinDBCSModeControl (hab,hwndFrame,type,arg,pparm)

    hab

    (HAB) Anchor-block handle.
    hwndFrame
    (HWND) Frame-window handle.
    type
    (USHORT) Request type. comact tsize=32 compact. DBE_MCTL_QUERY
    DBE_MCTL_SET
    arg
    (USHORT) Argument. comact tsize=32 compact. DBE_MCTL_INPUTMODEREQUEST
    pparm
    (PUSHORT) NLS shift status. comact tsize=34 compact break=fit. DBE_MCTL_ALPHANUMERIC
    DBE_MCTL_SBCSCHAR
    DBE_MCTL_DBCSCHAR
    DBE_MCTL_KATAKANA
    (Japanese)
    DBE_MCTL_HIRAGANA
    (Japanese)
    DBE_MCTL_ROMAN
    (Japanese)
    DBE_MCTL_NOROMAN
    (Japanese)
    DBE_MCTL_JAMO
    (Korean)
    DBE_MCTL_HANGEUL
    (Korean)
    DBE_MCTL_TSANGJYE
    (T-Chinese)
    DBE_MCTL_PHONETIC
    (T-Chinese)
    DBE_MCTL_INHERIT_PFRAME
    See MDI (Multiple-Document Interface).
    Return Code
    (BOOL) comact tsize=32 compact break=fit. TRUE
    FALSE
    
    WinDBCSIMEControl - PM

    This is also a DBCS OS/2 unique call and used to query or set the status (enabled, disabled, on or off) of the DBCS input method. The syntax is:

    WinDBCSIMEControl (hab,hwndFrame,type,pIMEMode)
    

    hab

    (HAB) Anchor-block handle.
    hwndFrame
    (HWND) Frame-window handle.
    type
    (USHORT) Request type. comact tsize=32 compact. DBE_IMCTL_QUERY
    DBE_IMCTL_SET
    pIMEMode
    (PIMEMODE) Pointer to IMEMode structure.

    typedef struct _IMEMODE {        USHORT    lenIMEMode;
            USHORT    fIMEMode;
            USHORT    hIME;
            USHORT    hModIME;
            }  IMEMODE, FAR *PIMEMODE;
    

    comact tsize=14 compact.
    lenIMEMode
    Length of this structure.
    fIMEMode
    comact tsize=4 break=all compact.

    DBE_IMCTL_IMEENABLE

    DBE_IMCTL_IMEDISABLE
    DBE_IMCTL_IMEMODE
    (Japanese, Korean; ineffective for T-Chinese)
    DBE_IMCTL_NOTIMEMODE
    (Japanese, Korean; ineffective for T-Chinese)
    DBE_IMCTL_INHERIT_PFRAME
    hIME (**)
    Handle of the Input Method Editor (IME) that is associated with the frame window. (Ignored in a set request.)
    hModIMEM (**)
    Module handle of the IME that is associated with the frame window. (Ignored in a set request.)
    Return Code
    (BOOL) comact tsize=32 compact break=fit. TRUE
    FALSE
    
    WM_CHAR - PM

    DBCS OS/2 additionally defines the following virtual key values. comact tsize=32 compact.

    VK_DBE_ALPHANUMERIC

    VK_DBE_SBCSCHAR
    VK_DBE_DBCSCHAR
    VK_DBE_SBCSDBCSCHAR
    VK_DBE_KATAKANA
    (Japanese)
    VK_DBE_HIRAGANA
    (Japanese)
    VK_DBE_ROMAN
    (Japanese)
    VK_DBE_HANJA
    (Korean)
    VK_DBE_HANGEUL
    (Korean)
    VK_DBE_JAMO
    (Korean)
    VK_DBE_TSANGJYE
    (T-Chinese)
    VK_DBE_PHONETIC
    (T-Chinese)

    ---

    [Back: Keyboard and Input Methods in S-Chinese]
    [Next: EHLLAPI In Different NLVs]