Klasa CFontHolder
Implementuje właściwość czcionki akcji i hermetyzuje funkcjonalność obiektu czcionki systemu Windows i interfejsu IFont .
Składnia
class CFontHolder
Elementy członkowskie
Konstruktory publiczne
| Nazwa/nazwisko | opis |
|---|---|
| CFontHolder::CFontHolder | CFontHolder Tworzy obiekt. |
Metody publiczne
| Nazwa/nazwisko | opis |
|---|---|
| CFontHolder::GetDisplayString | Pobiera ciąg wyświetlany w przeglądarce właściwości kontenera. |
| CFontHolder::GetFontDispatch | Zwraca interfejs czcionki IDispatch . |
| CFontHolder::GetFontHandle | Zwraca uchwyt do czcionki systemu Windows. |
| CFontHolder::InitializeFont | Inicjuje CFontHolder obiekt. |
| CFontHolder::QueryTextMetrics | Pobiera informacje dotyczące powiązanej czcionki. |
| CFontHolder::ReleaseFont | Odłącza CFontHolder obiekt od IFont interfejsów i IFontNotification . |
| CFontHolder::Select | Wybiera zasób czcionki w kontekście urządzenia. |
| CFontHolder::SetFont | CFontHolder Łączy obiekt z interfejsemIFont. |
Publiczne elementy członkowskie danych
| Nazwa/nazwisko | opis |
|---|---|
| CFontHolder::m_pFont | Wskaźnik do interfejsu CFontHolder IFont obiektu. |
Uwagi
CFontHolder nie ma klasy bazowej.
Ta klasa służy do implementowania niestandardowych właściwości czcionki dla kontrolki. Aby uzyskać informacje na temat tworzenia takich właściwości, zobacz artykuł Kontrolki ActiveX: Używanie czcionek.
Hierarchia dziedziczenia
CFontHolder
Wymagania
Nagłówek: afxctl.h
CFontHolder::CFontHolder
CFontHolder Tworzy obiekt.
explicit CFontHolder(LPPROPERTYNOTIFYSINK pNotify);
Parametry
pNotify
Wskaźnik do interfejsu czcionki IPropertyNotifySink .
Uwagi
Przed użyciem obiektu wynikowego należy wywołać InitializeFont metodę inicjowania obiektu.
CFontHolder::GetDisplayString
Pobiera ciąg, który można wyświetlić w przeglądarce właściwości kontenera.
BOOL GetDisplayString(CString& strValue);
Parametry
strValue
Odwołanie do CString, który ma zawierać ciąg wyświetlania.
Wartość zwracana
Nonzero, jeśli ciąg został pomyślnie pobrany; w przeciwnym razie 0.
CFontHolder::GetFontDispatch
Wywołaj tę funkcję, aby pobrać wskaźnik do interfejsu wysyłania czcionki.
LPFONTDISP GetFontDispatch();
Wartość zwracana
Wskaźnik do interfejsu CFontHolder IFontDisp obiektu. Należy pamiętać, że funkcja, która wywołuje GetFontDispatch , musi wywołać IUnknown::Release ten wskaźnik interfejsu po zakończeniu z nim.
Uwagi
Przed wywołaniem metody wywołaj metodę InitializeFont GetFontDispatch.
CFontHolder::GetFontHandle
Wywołaj tę funkcję, aby uzyskać uchwyt czcionki systemu Windows.
HFONT GetFontHandle();
HFONT GetFontHandle(
long cyLogical,
long cyHimetric);
Parametry
cyLogical
Wysokość w jednostkach logicznych prostokąta, w którym jest rysowana kontrolka.
cyHimetric
Wysokość w jednostkach MM_HIMETRIC kontrolki.
Wartość zwracana
Uchwyt do obiektu Font; w przeciwnym razie wartość NULL.
Uwagi
Współczynnik cyLogical i cyHimetric służy do obliczania odpowiedniego rozmiaru wyświetlania w jednostkach logicznych dla rozmiaru punktu czcionki wyrażonego w jednostkach MM_HIMETRIC:
Rozmiar wyświetlania = ( cyLogical / cyHimetric) X rozmiar czcionki
Wersja bez parametrów zwraca uchwyt do czcionki o prawidłowym rozmiarze dla ekranu.
CFontHolder::InitializeFont
Inicjuje CFontHolder obiekt.
void InitializeFont(
const FONTDESC* pFontDesc = NULL,
LPDISPATCH pFontDispAmbient = NULL);
Parametry
pFontDesc
Wskaźnik do struktury opisu czcionki ( FONTDESC), która określa cechy czcionki.
pFontDispAmbient
Wskaźnik do właściwości czcionki otoczenia kontenera.
Uwagi
Jeśli parametr pFontDispAmbient nie ma wartości NULL, CFontHolder obiekt jest połączony z klonem interfejsu IFont używanego przez właściwość czcionki otoczenia kontenera.
Jeśli parametr pFontDispAmbient ma wartość NULL, zostanie utworzony nowy obiekt czcionki na podstawie opisu czcionki wskazywanego przez wartość pFontDesc lub, jeśli wartość pFontDesc ma wartość NULL, z domyślnego opisu.
Wywołaj tę funkcję po utworzeniu CFontHolder obiektu.
CFontHolder::m_pFont
Wskaźnik do interfejsu CFontHolder IFont obiektu.
LPFONT m_pFont;
CFontHolder::QueryTextMetrics
Pobiera informacje o czcionki fizycznej reprezentowanej CFontHolder przez obiekt.
void QueryTextMetrics(LPTEXTMETRIC lptm);
Parametry
lptm
Wskaźnik do struktury TEXTMETRIC , która będzie otrzymywać informacje.
CFontHolder::ReleaseFont
Ta funkcja odłącza obiekt od interfejsu CFontHolder IFont .
void ReleaseFont();
CFontHolder::Select
Wywołaj tę funkcję, aby wybrać czcionkę kontrolki w określonym kontekście urządzenia.
CFont* Select(
CDC* pDC,
long cyLogical,
long cyHimetric);
Parametry
PDC
Kontekst urządzenia, w którym jest zaznaczona czcionka.
cyLogical
Wysokość w jednostkach logicznych prostokąta, w którym jest rysowana kontrolka.
cyHimetric
Wysokość w jednostkach MM_HIMETRIC kontrolki.
Wartość zwracana
Wskaźnik do czcionki, która jest zastępowana.
Uwagi
Zobacz GetFontHandle , aby zapoznać się z omówieniem parametrów cyLogical i cyHimetric .
CFontHolder::SetFont
Zwalnia dowolną istniejącą czcionkę i łączy obiekt z CFontHolder interfejsem IFont .
void SetFont(LPFONT pNewFont);
Parametry
pNewFont
Wskaźnik do nowego IFont interfejsu.