Interface IFont (ocidl.h)
Fornece um wrapper em torno de um objeto de fonte do Windows. O objeto de fonte COM dá suporte a várias propriedades de leitura/gravação, bem como a um conjunto de métodos por meio de sua interface IFont . Ele dá suporte ao mesmo conjunto de propriedades (mas não aos métodos) por meio da interface de expedição IFontDisp, que é derivada de IDispatch para fornecer acesso às propriedades da fonte por meio da Automação. O sistema fornece uma implementação padrão do objeto font com ambas as interfaces.
O objeto font também dá suporte à interface de saída IPropertyNotifySink para que um cliente possa determinar quando as propriedades da fonte são alteradas. Como o objeto font dá suporte a pelo menos uma interface de saída, ele também implementa IConnectionPointContainer e interfaces relacionadas para essa finalidade.
O objeto font fornece uma propriedade hFont, que é um identificador de fonte do Windows que está em conformidade com os outros atributos especificados para a fonte. O objeto font atrasa a realização desse objeto hFont quando possível, portanto, definir consecutivamente duas propriedades em uma fonte não fará com que uma fonte intermediária seja realizada. Além disso, como uma otimização, o objeto de fonte implementado pelo sistema mantém um cache de identificadores de fonte. Dois objetos de fonte no mesmo processo que têm propriedades idênticas retornarão o mesmo identificador de fonte. O objeto font pode remover identificadores de fonte desse cache à vontade, o que apresenta considerações especiais para clientes que usam a propriedade hFont.
O objeto font também dá suporte a IPersistStream para que ele possa salvar e carregar a si mesmo de uma instância do IStream. Um objeto que usa um objeto de fonte internamente normalmente salvaria e carregaria a fonte como parte do tratamento de persistência do próprio objeto.
Além disso, o objeto font dá suporte a IDataObject, que pode renderizar um conjunto de propriedades que contém os atributos da fonte, permitindo que um cliente salve essas propriedades como texto.
Herança
A interface IFont herda da interface IUnknown . O IFont também tem estes tipos de membros:
Métodos
A interface IFont tem esses métodos.
| IFont::AddRefHfont Notifica o objeto de fonte de que a fonte realizada anteriormente identificada com hFont deve permanecer válida até que ReleaseHfont seja chamado ou o próprio objeto de fonte seja liberado completamente. |
| IFont::Clone Cria um objeto de fonte duplicado. |
| IFont::get_Bold Obtém a propriedade Bold atual da fonte. |
| IFont::get_Charset Recupera o conjunto de caracteres usado na fonte. |
| IFont::get_hFont Recupera um identificador para a fonte descrita por este objeto de fonte. |
| IFont::get_Italic Obtém a propriedade Itálico atual da fonte. |
| IFont::get_Name Recupera o nome da família de fontes. |
| IFont::get_Size Recupera o tamanho do ponto da fonte. |
| IFont::get_Strikethrough Obtém a propriedade Strikethrough atual da fonte. |
| IFont::get_Underline Obtém a propriedade Underline atual da fonte. |
| IFont::get_Weight Obtém a propriedade Weight atual da fonte. |
| IFont::IsEqual Compara esse objeto de fonte com outro para equivalência. |
| IFont::p ut_Bold Define a propriedade Bold da fonte. |
| IFont::p ut_Charset Define o conjunto de caracteres da fonte. |
| IFont::p ut_Italic Define a propriedade Itálico da fonte. |
| IFont::p ut_Name Especifica um novo nome para a família de fontes. |
| IFont::p ut_Size Define o tamanho do ponto da fonte. |
| IFont::p ut_Strikethrough Define a propriedade Strikethrough da fonte. |
| IFont::p ut_Underline Define a propriedade Underline da fonte. |
| IFont::p ut_Weight Define a propriedade Weight da fonte. |
| IFont::QueryTextMetrics Preenche uma estrutura alocada pelo chamador com informações sobre a fonte. |
| IFont::ReleaseHfont Notifica o objeto de fonte de que o chamador que bloqueou anteriormente essa fonte no cache com IFont::AddRefHfont não requer mais o bloqueio. |
| IFont::SetHdc Fornece um contexto de dispositivo para a fonte que descreve o modo de mapeamento lógico. |
| IFont::SetRatio Converte o fator de dimensionamento dessa fonte entre unidades lógicas e unidades HIMETRIC. |
Comentários
Cada propriedade na interface IFont inclui um método get_PropertyName se a propriedade der suporte ao acesso de leitura e a um método put_PropertyName se a propriedade der suporte ao acesso de gravação. A maioria dessas propriedades dá suporte ao acesso de leitura e gravação.
| Propriedade | Type | Método Read Access | Método Write Access | Descrição |
|---|---|---|---|---|
| Nome | BSTR | get_Name | put_Name | O nome da face da fonte, por exemplo, Arial. |
| Tamanho | CY | get_Size | put_Size | O tamanho do ponto da fonte, expresso em um tipo CY para permitir tamanhos de ponto fracionários. |
| Negrito | BOOL | get_Bold | put_Bold | Indica se a fonte está em negrito. |
| Itálico | BOOL | get_Italic | put_Italic | Indica se a fonte está em itálico. |
| Sublinhar | BOOL | get_Underline | put_Underline | Indica se a fonte está sublinhada. |
| Tachado | BOOL | get_Strikethrough | put_Strikethrough | Indica se a fonte é tachada. |
| Weight | short | get_Weight | put_Weight | A negrito da fonte. |
| Charset | short | get_Charset | put_Charset | O conjunto de caracteres usado na fonte, como ANSI_CHARSET, DEFAULT_CHARSET ou SYMBOL_CHARSET. |
| Hfont | HFONT | get_hFont | O identificador de fonte do Windows que pode ser selecionado em um contexto de dispositivo para renderização. |
Implementação de OLE
O sistema fornece uma implementação padrão de um objeto de fonte com a interface IFont sobre o suporte à fonte do sistema subjacente. Um objeto de fonte é criado por meio da função OleCreateFontIndirect. Um objeto de fonte dá suporte a várias propriedades de leitura/gravação, bem como um conjunto de métodos por meio de sua interface IFont e dá suporte ao mesmo conjunto de propriedades (mas não aos métodos) por meio de uma interface de expedição IFontDisp que é derivada de IDispatch para fornecer acesso às propriedades da fonte por meio da Automação. A implementação do sistema do objeto de fonte fornece ambas as interfaces.Requisitos
| Cliente mínimo com suporte | Windows 2000 Professional [aplicativos da área de trabalho | Aplicativos UWP] |
| Servidor mínimo com suporte | Windows 2000 Server [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | ocidl.h |