Compartilhar via

Método IFont::Clone (ocidl.h)

  • Artigo

Cria um objeto de fonte duplicado com um estado idêntico à fonte atual.

Sintaxe

HRESULT Clone(
  [out] IFont **ppFont
);

Parâmetros

[out] ppFont

Endereço da variável de ponteiro IFont que recebe o ponteiro de interface para o novo objeto de fonte. O chamador deve chamar IFont::Release quando esse novo objeto de fonte não for mais necessário.

Retornar valor

O método dá suporte aos valores retornados padrão E_UNEXPECTED e E_OUTOFMEMORY, bem como aos valores a seguir.

Código de retorno Descrição
S_OK
 O novo objeto de fonte foi criado com êxito.
E_NOTIMPL
 Esse objeto de fonte não dá suporte à clonagem.
E_POINTER
 O endereço em ppfont não é válido. Por exemplo, pode ser NULL.

Comentários

Anotações para chamadores

O novo objeto de fonte é totalmente independente do primeiro. O chamador é responsável por liberar esse novo objeto quando ele não é mais necessário. Esse método não afeta a contagem de referência da fonte que está sendo clonada.

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 ocidl.h

Confira também

Ifont