Condividi tramite


Interfaccia IFont (ocidl.h)

Fornisce un wrapper intorno a un oggetto carattere di Windows. L'oggetto carattere COM supporta diverse proprietà di lettura/scrittura, nonché un set di metodi tramite l'interfaccia IFont . Supporta lo stesso set di proprietà (ma non i metodi) tramite l'interfaccia dispatch IFontDisp, derivato da IDispatch per fornire l'accesso alle proprietà del tipo di carattere tramite Automazione. Il sistema fornisce un'implementazione standard dell'oggetto carattere con entrambe le interfacce.

L'oggetto font supporta anche l'interfaccia in uscita IPropertyNotifySink in modo che un client possa determinare quando le proprietà del tipo di carattere cambiano. Poiché l'oggetto carattere supporta almeno un'interfaccia in uscita, implementa anche IConnectionPointContainer e le interfacce correlate a questo scopo.

L'oggetto font fornisce una proprietà hFont, ovvero un handle di carattere di Windows conforme agli altri attributi specificati per il tipo di carattere. L'oggetto carattere ritarda la realizzazione di questo oggetto hFont quando possibile, pertanto l'impostazione consecutiva di due proprietà su un tipo di carattere non comporterà la realizzazione di un tipo di carattere intermedio. Inoltre, come ottimizzazione, l'oggetto carattere implementato dal sistema gestisce una cache di handle di carattere. Due oggetti carattere nello stesso processo con proprietà identiche restituiranno lo stesso handle di carattere. L'oggetto font può rimuovere gli handle di carattere da questa cache in modo che introduca considerazioni speciali per i client che usano la proprietà hFont.

L'oggetto font supporta anche IPersistStream in modo che possa salvare e caricare se stesso da un'istanza di IStream. Un oggetto che usa un oggetto font internamente salva e carica il tipo di carattere come parte della gestione della persistenza dell'oggetto.

Inoltre, l'oggetto font supporta IDataObject, che può eseguire il rendering di un set di proprietà contenente gli attributi del tipo di carattere, consentendo a un client di salvare queste proprietà come testo.

Ereditarietà

L'interfaccia IFont eredita dall'interfaccia IUnknown . IFont ha anche questi tipi di membri:

Metodi

L'interfaccia IFont include questi metodi.

 
IFont::AddRefHfont

Notifica all'oggetto carattere che il tipo di carattere identificato in precedenza con hFont deve rimanere valido fino a quando ReleaseHfont non viene chiamato o l'oggetto carattere stesso viene rilasciato completamente.
IFont::Clone

Crea un oggetto carattere duplicato.
IFont::get_Bold

Ottiene la proprietà Grassetto corrente del tipo di carattere.
IFont::get_Charset

Recupera il set di caratteri utilizzato nel tipo di carattere.
IFont::get_hFont

Recupera un handle per il tipo di carattere descritto da questo oggetto tipo di carattere.
IFont::get_Italic

Ottiene la proprietà Italic corrente del tipo di carattere.
IFont::get_Name

Recupera il nome della famiglia di caratteri.
IFont::get_Size

Recupera la dimensione del punto del tipo di carattere.
IFont::get_Strikethrough

Ottiene la proprietà Strikethrough corrente del tipo di carattere.
IFont::get_Underline

Ottiene la proprietà Underline corrente del tipo di carattere.
IFont::get_Weight

Ottiene la proprietà Weight corrente del tipo di carattere.
IFont::IsEqual

Confronta questo oggetto carattere con un altro oggetto per verificarne l'equivalenza.
IFont::p ut_Bold

Imposta la proprietà Bold del tipo di carattere.
IFont::p ut_Charset

Imposta il set di caratteri del tipo di carattere.
IFont::p ut_Italic

Imposta la proprietà Italic del tipo di carattere.
IFont::p ut_Name

Specifica un nuovo nome per la famiglia di caratteri.
IFont::p ut_Size

Imposta la dimensione del punto del tipo di carattere.
IFont::p ut_Strikethrough

Imposta la proprietà Strikethrough del tipo di carattere.
IFont::p ut_Underline

Imposta la proprietà Underline del tipo di carattere.
IFont::p ut_Weight

Imposta la proprietà Weight del tipo di carattere.
IFont::QueryTextMetrics

Riempie una struttura allocata dal chiamante con informazioni sul tipo di carattere.
IFont::ReleaseHfont

Notifica all'oggetto carattere che il chiamante che in precedenza ha bloccato questo tipo di carattere nella cache con IFont::AddRefHfont non richiede più il blocco.
IFont::SetHdc

Fornisce un contesto di dispositivo al tipo di carattere che descrive la modalità di mapping logico.
IFont::SetRatio

Converte il fattore di ridimensionamento per questo tipo di carattere tra unità logiche e unità HIMETRIC.

Commenti

Ogni proprietà nell'interfaccia IFont include un metodo get_PropertyName se la proprietà supporta l'accesso in lettura e un metodo put_PropertyName se la proprietà supporta l'accesso in scrittura. La maggior parte di queste proprietà supporta sia l'accesso in lettura che in scrittura.

Proprietà Type Metodo di accesso in lettura Metodo di accesso in scrittura Descrizione
Nome BSTR get_Name put_Name Nome faccia del tipo di carattere, ad esempio Arial.
Dimensione CY get_Size put_Size Dimensione del punto del tipo di carattere, espressa in un tipo CY per consentire le dimensioni dei punti frazionari.
Grassetto BOOL get_Bold put_Bold Indica se il tipo di carattere è grassetto.
Corsivo BOOL get_Italic put_Italic Indica se il tipo di carattere è in corsivo.
Sottolineato BOOL get_Underline put_Underline Indica se il tipo di carattere è sottolineato.
barrato BOOL get_Strikethrough put_Strikethrough Indica se il tipo di carattere è barrato.
Weight short get_Weight put_Weight Grassetto del tipo di carattere.
Charset short get_Charset put_Charset Set di caratteri utilizzato nel tipo di carattere, ad esempio ANSI_CHARSET, DEFAULT_CHARSET o SYMBOL_CHARSET.
hFont HFONT get_hFont Handle del tipo di carattere di Windows che può essere selezionato in un contesto di dispositivo per il rendering.
 

Implementazione OLE

Il sistema fornisce un'implementazione standard di un oggetto carattere con l'interfaccia IFont sopra il supporto del tipo di carattere di sistema sottostante. Un oggetto font viene creato tramite la funzione OleCreateFontIndirect. Un oggetto font supporta una serie di proprietà di lettura/scrittura, nonché un set di metodi tramite l'interfaccia IFont e supporta lo stesso set di proprietà (ma non i metodi) tramite un'interfaccia dispatch IFontDisp derivata da IDispatch per fornire l'accesso alle proprietà del tipo di carattere tramite Automazione. L'implementazione di sistema dell'oggetto carattere fornisce entrambe le interfacce.

Requisiti

   
Client minimo supportato Windows 2000 Professional [app desktop | App UWP]
Server minimo supportato Windows 2000 Server [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione ocidl.h

Vedi anche

IFontDisp