Função GetTextFaceA (wingdi.h)
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 levam um byte cada, enquanto a maioria dos caracteres nas páginas de código DBCS leva dois bytes; para a função Unicode, a maioria dos 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 de retorno
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.
Observações
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.
Nota
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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| servidor com suporte mínimo | Windows 2000 Server [somente aplicativos da área de trabalho] |
| da Plataforma de Destino |
Windows |
| cabeçalho | wingdi.h (inclua Windows.h) |
| biblioteca | Gdi32.lib |
| de DLL |
Gdi32.dll |
Consulte também
getTextMetrics