Ejemplo IME: muestra cómo controlar el modo IME e implementar IME de nivel 3

Actualización: noviembre 2007

El ejemplo de IME utiliza CIMEEdit, una subclase de CEdit, para crear un control de edición. CIMEEdit controla todos los caracteres de entrada y crea las cadenas de DBCS. El ejemplo tiene las siguientes características:

  • Muestra la forma de controlar el modo del IME mediante C/C++. Puede establecer el modo del IME de CIMEEdit como de entrada de idioma, forma, etc. Si desea establecer el control de edición inicialmente para que obtenga caracteres coreanos, puede agregar código como el mostrado en este ejemplo. Además, si sólo necesita inglés, puede deshabilitar el IME.

  • También muestra la forma de implementar el IME de nivel 3 en el código fuente. El IME de nivel 3 es más conveniente y eficaz para usuarios de idiomas asiáticos orientales. Puede crear con este ejemplo un control o una ventana personalizados que sea compatible con IME de nivel 3.

  • Este ejemplo determina la fuente y la página de códigos que se utilizan en la distribución de teclado para la conversión de Ansi a Unicode, de forma que se puedan probar cuatro IME distintos para todos los idiomas asiáticos orientales sin tener que cambiar la fuente ni la página de códigos. Esto es una característica de Windows 2000 y no es un requisito para la compatibilidad con un IME de nivel 3.

  • La función GetCombinedCharLength sólo admite caracteres suplentes en este ejemplo. Si necesita compatibilidad con caracteres combinados, agregue código al método.

Para utilizar funciones del IME, el programa debe incluir IMM.H y un vínculo a IMM32.LIB.

Nota de seguridad:

Este código de ejemplo se proporciona para ilustrar un concepto y no debe utilizarse en aplicaciones o sitios Web, ya que quizás no ilustre las prácticas de codificación más seguras. Microsoft no asume ninguna responsabilidad por daños incidentales o consecuentes en caso de que el código de ejemplo se utilice para propósitos distintos de aquellos para los que se concibió.

Para obtener ejemplos e instrucciones para su instalación:

  • En el menú Ayuda de Visual Studio, haga clic en Ejemplos.

    Para obtener más información, vea Localizar archivos de ejemplo.

  • La lista de ejemplos completa con la versión más reciente está disponible en línea en la página Visual Studio 2008 Samples.

  • También encontrará ejemplos en el disco duro de su equipo. De manera predeterminada, los ejemplos y el archivo Léame se copian en una carpeta bajo \Archivos de programa\Visual Studio 9.0\Samples\. Para las versiones Express de Visual Studio, todos los ejemplos están en línea.

Generar y ejecutar el ejemplo

Para generar y ejecutar este ejemplo

  1. Abra la solución PrimesStep1.sln.

  2. En el menú Generar, haga clic en Generar.

  3. En el menú Depurar, haga clic en Iniciar sin depurar.

Ejecute el ejemplo y pruebe las siguientes características.

Controlar el modo del IME

  • Puede cambiar el modo del IME activando o desactivando casillas. Si cambia opciones mediante las casillas, cambiará el estado de la ventana del IME.

  • Puede cambiar el modo del IME en la ventana del IME. Si cambia opciones en la ventana del IME, cambiarán las casillas del ejemplo.

  • Puede habilitar o deshabilitar el IME.

Implementar un IME de nivel 3

  • Si escribe caracteres de dos bytes, puede ver la forma de generar cadenas.

  • Si tiene la fuente apropiada en Windows 2000, puede ver caracteres suplentes.

Clases y palabras clave

En este ejemplo, se muestra el uso de las siguientes clases:

CEdit

En este ejemplo, se muestra el uso de las siguientes palabras clave:

CBitmap::OnPaint; CEdit::OnChar; CEdit::OnSetFocus; CEdit::OnKillFocus; CEdit::OnKeyDown; CEdit::WindowProc; ImmGetContext; ImmReleaseContext; ImmGetConversionStatus; ImmSetConversionStatus; ImmGetOpenStatus; ImmSetOpenStatus; ImmAssociateContext; ImmNotifyIME; ImmGetCompositionString; ImmGetProperty; ImmSetCandidateWIndow; ImmSetCompositionWIndow

Vea también

Otros recursos

Ejemplos de programación internacional