Função GetTextFaceA (wingdi.h)

Artigo
08/27/2023

A função GetTextFace recupera o nome da face de tipo da fonte selecionada no contexto do dispositivo especificado.

Sintaxe

int GetTextFaceA(
  [in]  HDC   hdc,
  [in]  int   c,
  [out] LPSTR lpName
);

Parâmetros

[in] hdc

Um identificador para o contexto do dispositivo.

[in] c

O comprimento do buffer apontado por lpFaceName. Para a função ANSI, é uma contagem byte e para a função Unicode é uma contagem de WORD. Observe que, para a função ANSI, os caracteres nas páginas de código SBCS recebem um byte cada, enquanto a maioria dos caracteres nas páginas de código DBCS leva dois bytes; para a função Unicode, os caracteres Unicode definidos no momento (aqueles no Plano Multilíngue Básico (BMP)) são um WORD, enquanto os substitutos Unicode são dois WORDs.

[out] lpName

Um ponteiro para o buffer que recebe o nome da face de tipo. Se esse parâmetro for NULL, a função retornará o número de caracteres no nome, incluindo o caractere nulo de terminação.

Valor retornado

Se a função for bem-sucedida, o valor retornado será o número de caracteres copiados para o buffer.

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

Comentários

O nome da face de tipo é copiado como uma cadeia de caracteres terminada em nulo.

Se o nome for maior que o número de caracteres especificado pelo parâmetro nCount , o nome será truncado.

Observação

O cabeçalho wingdi.h define GetTextFace como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de funçã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]
Plataforma de Destino	Windows
Cabeçalho	wingdi.h (inclua Windows.h)
Biblioteca	Gdi32.lib
DLL	Gdi32.dll