SetFont
SetFont(string family [, string style [, float size]])
Versão
1.0
Descrição
Define a fonte que será usada para imprimir os caracteres de texto. É obrigatória a chamada,
ao menos uma vez, deste método antes de imprimir o texto ou o documento resultante não será válido.
A fonte pode ser uma padrão ou uma que foi adicionada através do método AddFont(). As fontes
padrão usam codificação Windows cp1252 (Europa ocidental).
O método pode ser chamado antes que a primeira página esteja criada e a fonte será mantida
de uma página para outra.
Se você quiser mudar o tamanho da fonte atual, é mais simples chamar SetFontSize().
Nota: os arquivos de métricas de fontes devem estar acessíveis.
Eles são procurados nas seguintes localidades:
- O diretório definido pela constante FPDF_FONTPATH (se a constante estiver definida)
- O diretório de fontes localizado dentro do diretório que contém o fpdf.php (se ele existir)
- Os diretórios acessíveis pelo include()
Exemplo definindo FPDF_FONTPATH (observer que a barra no final é obrigatória):
define('FPDF_FONTPATH','/home/www/font/');
require('fpdf.php');
Se o arquivo que corresponde à fonte solicitada não existir, o erro "Could not include
font metric file" (não foi possível incluir o arquivo de fonte) é gerado.
Parâmetros
family
Família da fonte. Pode ser um tanto nome definido por AddFont() como uma das famílias padrão
(maiúsculas e minúsculas não são diferenciadas):
- Courier (largura fixa)
- Helvetica ou Arial (sinônimos; sans serif)
- Times (serif)
- Symbol (símbolos)
- ZapfDingbats (símbolos)
Também é possível passar um texto vazio. Neste caso, a família corrente é mantida.
style
Estilo da fonte. Os valores possíveis são (maiúsculas e minúsculas são diferenciadas):
- texto vazio: normal
- B: negrito
- I: itálico
- U: sublinhado
ou qualquer combinação. O valor padrão é normal.
Os estilos negrito e itálico não são aplicáveis às fontes Symbol e ZapfDingbats.
size
Tamanho da fonte em pontos.
O valor padrão é o tamanho atual. Se nenhum tamanho foi especificado desde o início do
documento, o valor usado é 12.
Exemplo
//Times normal 12
$pdf->SetFont('Times');
//Arial negrito 14
$pdf->SetFont('Arial','B',14);
//Remove negrito
$pdf->SetFont('');
//Times negrito, itálico e sublinhado 14
$pdf->SetFont('Times','BIU');
Veja também
AddFont(),
SetFontSize(),
Cell(),
MultiCell(),
Write().