Compartilhar via


Estrutura RECONVERTSTRING (imm.h)

Define as cadeias de caracteres para a reconversão do IME. É o primeiro item em um bloco de memória que contém as cadeias de caracteres para reconversão.

Sintaxe

typedef struct tagRECONVERTSTRING {
  DWORD dwSize;
  DWORD dwVersion;
  DWORD dwStrLen;
  DWORD dwStrOffset;
  DWORD dwCompStrLen;
  DWORD dwCompStrOffset;
  DWORD dwTargetStrLen;
  DWORD dwTargetStrOffset;
} RECONVERTSTRING, *PRECONVERTSTRING, *NPRECONVERTSTRING, *LPRECONVERTSTRING;

Membros

dwSize

Tamanho dessa estrutura e o bloco de memória que ela dirige.

dwVersion

Número da versão. Deve ser 0.

dwStrLen

Comprimento da cadeia de caracteres que contém a cadeia de caracteres de composição.

dwStrOffset

Deslocamento da posição inicial dessa estrutura.

dwCompStrLen

Comprimento da cadeia de caracteres que será a cadeia de caracteres de composição.

dwCompStrOffset

Deslocamento da cadeia de caracteres que será a cadeia de caracteres de composição.

dwTargetStrLen

Comprimento da cadeia de caracteres relacionada à cláusula de destino na cadeia de caracteres de composição.

dwTargetStrOffset

Deslocamento da cadeia de caracteres de destino.

Comentários

Os membros dwCompStrOffset e dwTargetOffset são as posições relativas em dwStrOffset. Para um IME Unicode, dwStrLen, dwCompStrLen e dwTargetStrLen são valores TCHAR, ou seja, contagens de caracteres. Os membros dwStrOffset, dwCompStrOffset e dwTargetStrOffset especificam contagens de bytes.

Se um aplicativo iniciar o processo de reconversão chamando ImmSetCompositionString com SCS_SETRECONVERTSTRING e SCS_QUERYRECONVERTSTRING, o aplicativo deverá alocar a memória necessária para a estrutura RECONVERTSTRING , bem como o buffer de cadeia de caracteres de composição. O IME não deve usar essa memória mais tarde. Se o IME iniciar o processo, o IME deverá alocar a memória necessária para a estrutura e o buffer de cadeia de caracteres de composição.

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho imm.h (inclua Immdev.h, Windows.h)

Confira também

IMR_CONFIRMRECONVERTSTRING

IMR_RECONVERTSTRING

ImmSetCompositionString

Gerenciador de Métodos de Entrada

Estruturas do Gerenciador de Métodos de Entrada