Função GetTextCharsetInfo (wingdi.h)

  • Artigo

Recupera informações sobre o conjunto de caracteres da fonte que está selecionada no momento em um contexto de dispositivo especificado.

Sintaxe

int GetTextCharsetInfo(
  [in]            HDC             hdc,
  [out, optional] LPFONTSIGNATURE lpSig,
  [in]            DWORD           dwFlags
);

Parâmetros

[in] hdc

Identificador para um contexto de dispositivo. A função obtém informações sobre a fonte selecionada neste contexto de dispositivo.

[out, optional] lpSig

Ponteiro para uma estrutura de dados FONTSIGNATURE que recebe informações de assinatura de fonte.

Se uma fonte TrueType estiver selecionada no contexto do dispositivo no momento, a estrutura FONTSIGNATURE receberá informações que identificam a página de código e subranges Unicode para as quais a fonte fornece glifos.

Se uma fonte diferente de TrueType estiver selecionada no contexto do dispositivo, a estrutura FONTSIGNATURE receberá zeros. Nesse caso, o aplicativo deve usar a função TranslateCharsetInfo para obter informações genéricas de assinatura de fonte para o conjunto de caracteres.

O parâmetro lpSig especifica NULL se o aplicativo não exigir as informações FONTSIGNATURE . Nesse caso, o aplicativo também pode chamar a função GetTextCharset , que é equivalente a chamar GetTextCharsetInfo com lpSig definido como NULL.

[in] dwFlags

Reservados; deve ser definido como 0.

Retornar valor

Se tiver êxito, retornará um valor que identifica o conjunto de caracteres da fonte atualmente selecionada no contexto do dispositivo especificado. Os seguintes identificadores de conjunto de caracteres são definidos:

Se a função falhar, o valor retornado será DEFAULT_CHARSET.

Requisitos

Requisito Valor
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]
Plataforma de Destino Windows
Cabeçalho wingdi.h (inclua Windows.h)
Biblioteca Gdi32.lib
DLL Gdi32.dll

Confira também

FONTSIGNATURE

GetTextCharset

TranslateCharsetInfo

Funções unicode e conjunto de caracteres

Conjuntos de caracteres e Unicode