Klasa CFontHolder

Implementuje właściwość czcionki akcji i hermetyzuje funkcjonalność obiektu czcionki systemu Windows i interfejsu IFont .

Składnia

class CFontHolder

Członkowie

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 Połączenie obiekt do interfejsuIFont.

Publiczne elementy członkowskie danych

Nazwa/nazwisko	opis
CFontHolder::m_pFont	Wskaźnik do interfejsu CFontHolderIFont 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 CFontHolderIFontDisp 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ę InitializeFontGetFontDispatch.

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 CFontHolderIFont 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 CFontHolderIFont .

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.

Zobacz też

Wykres hierarchii
Klasa CPropExchange