CFontHolder osztály

Megjegyzés:

A Microsoft Foundation Classes (MFC) könyvtár továbbra is támogatott. A továbbiakban azonban nem adunk hozzá funkciókat, és nem frissítjük a dokumentációt.

Implementálja a stock Font tulajdonságot, és belefoglalja egy Windows-betűtípus-objektum és a felület funkcióit IFont .

Szemantika

class CFontHolder

Tagok

Nyilvános konstruktorok

Név	Description
CFontHolder::CFontHolder	Egy CFontHolder objektumot hoz létre.

Nyilvános metódusok

Név	Description
CFontHolder::GetDisplayString	Lekéri a tároló tulajdonságböngészőjében megjelenő sztringet.
CFontHolder::GetFontDispatch	A betűtípus felületét IDispatch adja vissza.
CFontHolder::GetFontHandle	Egy fogópontot ad vissza Egy Windows-betűtípushoz.
CFontHolder::InitializeFont	Inicializál egy objektumot CFontHolder .
CFontHolder::QueryTextMetrics	Lekéri a kapcsolódó betűtípussal kapcsolatos információkat.
CFontHolder::ReleaseFont	Leválasztja az CFontHolder objektumot az és az IFontIFontNotification interfészekről.
CFontHolder::Select	Kiválaszt egy betűtípus-erőforrást egy eszközkörnyezetbe.
CFontHolder::SetFont	Csatolja az CFontHolder objektumot egy IFont interfészhez.

Nyilvános adatok tagjai

Név	Description
CFontHolder::m_pFont	Az objektum felületére IFont mutató mutatóCFontHolder.

Megjegyzések

CFontHolder nem rendelkezik alaposztálysal.

Ebben az osztályban egyéni betűtípus-tulajdonságokat implementálhat a vezérlőelemhez. Az ilyen tulajdonságok létrehozásáról az ActiveX-vezérlők: Betűtípusok használata című cikkben olvashat.

Öröklési hierarchia

CFontHolder

Requirements

Fejléc: afxctl.h

CFontHolder::CFontHolder

Egy CFontHolder objektumot hoz létre.

explicit CFontHolder(LPPROPERTYNOTIFYSINK pNotify);

Paraméterek

pNotify
Mutasson a betűtípus felületére IPropertyNotifySink .

Megjegyzések

A használat előtt meg kell hívnia InitializeFont az eredményként kapott objektum inicializálását.

CFontHolder::GetDisplayString

Lekéri a tároló tulajdonságböngészőjében megjeleníthető sztringet.

BOOL GetDisplayString(CString& strValue);

Paraméterek

strValue
A megjelenítendő sztringet tartalmazó CStringre mutató hivatkozás.

Visszaadott érték

Nonzero, ha a sztring lekérése sikeresen megtörtént; egyéb esetben 0.

CFontHolder::GetFontDispatch

Hívja meg ezt a függvényt, hogy lekérjen egy mutatót a betűtípus küldőfelületére.

LPFONTDISP GetFontDispatch();

Visszaadott érték

Az objektum felületére IFontDisp mutató mutatóCFontHolder. Vegye figyelembe, hogy a hívásokat kezdeményező GetFontDispatch függvénynek ezen az interfészmutatón kell hívnia IUnknown::Release , ha végzett vele.

Megjegyzések

Hívás InitializeFont a hívás GetFontDispatchelőtt.

CFontHolder::GetFontHandle

Hívja meg ezt a függvényt, hogy lekérjen egy leírót egy Windows-betűtípushoz.

HFONT GetFontHandle();

HFONT GetFontHandle(
    long cyLogical,
    long cyHimetric);

Paraméterek

cyLogical
Annak a téglalapnak a magassága logikai egységekben, amelyben a vezérlő meg van rajzolva.

cyHimetric
A vezérlő magassága MM_HIMETRIC egységben.

Visszaadott érték

Fogópont a Betűtípus objektumhoz; ellenkező esetben NULL.

Megjegyzések

A cyLogical és a cyHimetric aránya a betűméret MM_HIMETRIC mértékegységben kifejezett helyes megjelenítési méretének logikai egységekben történő kiszámítására szolgál:

Megjelenítési méret = ( cyLogical / cyHimetric) X betűméret

A paraméterek nélküli verzió egy fogópontot ad vissza a megfelelő méretű betűtípushoz a képernyőn.

CFontHolder::InitializeFont

Inicializál egy objektumot CFontHolder .

void InitializeFont(
    const FONTDESC* pFontDesc = NULL,
    LPDISPATCH pFontDispAmbient = NULL);

Paraméterek

pFontDesc
Mutasson egy betűtípus leírási struktúrájára ( FONTDESC), amely meghatározza a betűtípus jellemzőit.

pFontDispAmbient
Mutasson a tároló környezeti Betűtípus tulajdonságára.

Megjegyzések

Ha a pFontDispAmbient értéke nem NULL, az CFontHolder objektum a tároló környezeti Betűtípus tulajdonsága IFont által használt felület klónjához csatlakozik.

Ha a pFontDispAmbient null értékű, a program egy új betűtípus-objektumot hoz létre a pFontDesc által mutatott betűtípus-leírásból, vagy ha a pFontDesc null értékű, egy alapértelmezett leírásból.

Az objektum létrehozása után hívja meg ezt a függvényt CFontHolder .

CFontHolder::m_pFont

Az objektum felületére IFont mutató mutatóCFontHolder.

LPFONT m_pFont;

CFontHolder::QueryTextMetrics

Az objektum által CFontHolder képviselt fizikai betűtípussal kapcsolatos információkat kéri le.

void QueryTextMetrics(LPTEXTMETRIC lptm);

Paraméterek

lptm
Az információt fogadó TEXTMETRIC-struktúra mutatója.

CFontHolder::ReleaseFont

Ez a függvény leválasztja az objektumot a CFontHolder felületéről IFont .

void ReleaseFont();

CFontHolder::Select

A függvény meghívásával válassza ki a vezérlő betűtípusát a megadott eszközkörnyezetben.

CFont* Select(
    CDC* pDC,
    long cyLogical,
    long cyHimetric);

Paraméterek

Pdc
Eszközkörnyezet, amelyben a betűtípus ki van jelölve.

cyLogical
Annak a téglalapnak a magassága logikai egységekben, amelyben a vezérlő meg van rajzolva.

cyHimetric
A vezérlő magassága MM_HIMETRIC egységben.

Visszaadott érték

Mutató a lecserélt betűtípusra.

Megjegyzések

A cyLogical és a cyHimetric paraméterekről a GetFontHandle című témakörben olvashat.

CFontHolder::SetFont

Felszabadítja a meglévő betűtípusokat, és összekapcsolja az CFontHolder objektumot egy felülettel IFont .

void SetFont(LPFONT pNewFont);

Paraméterek

pNewFont
Mutasson az új IFont felületre.

Lásd még

hierarchiadiagram
CPropExchange osztály