Freigeben über


PX_Font

Rufen Sie diese Funktion in DoPropExchange-Memberfunktion des Steuerelements auf, um eine Eigenschaft der Schriftart zu serialisieren und zu initialisieren.

BOOL PX_Font( 
   CPropExchange* pPX, 
   LPCTSTR pszPropName, 
   CFontHolder& font, 
   const FONTDESC FAR* pFontDesc = NULL, 
   LPFONTDISP pFontDispAmbient = NULL  
);

Parameter

  • pPX
    Zeiger zum CPropExchange-Objekt (in der Regel an als Parameter für DoPropExchange).

  • pszPropName
    Der Name der Eigenschaft, die ausgetauscht wird.

  • font
    Ein Verweis auf ein CFontHolder-Objekt, das die Schriftarteigenschaft enthält.

  • pFontDesc
    Ein Zeiger auf eine FONTDESC-Struktur, die die Werte enthält, die zu verwenden ist, wenn der Standardzustand der Schriftarteigenschaft, im Fall initialisiert wird pFontDispAmbient, NULL ist.

  • pFontDispAmbient
    Ein Zeiger auf die IFontDisp-Schnittstelle einer Schriftart, wenn zu verwenden, der Standardzustand der Schriftarteigenschaft initialisiert wird.

Rückgabewert

Wert ungleich 0 (null), wenn der Austausch erfolgreich war; wenn 0 fehlgeschlagen.

Hinweise

Der Eigenschaftswert wird aus gelesen oder geschrieben font, CFontHolder, wenn ein Verweis entspricht. Wenn pFontDesc und pFontDispAmbient angegeben sind, werden sie zum Initialisieren des Standardwerts der Eigenschaft, nach Bedarf verwendet. Diese Werte werden verwendet, wenn für jeden, Grund, der fehlschlägt Serialisierungsprozess des Steuerelements. Normalerweise übergeben Sie NULL für pFontDesc und der Umgebungsfarbe Wert, der von COleControl::AmbientFont für pFontDispAmbient zurückgegeben wird. Beachten Sie, dass das Schriftartobjekt, das von COleControl::AmbientFont zurückgegeben wird, durch einen Aufruf freigegeben werden muss die IFontDisp::Release-Memberfunktion.

Anforderungen

Header: afxctl.h

Siehe auch

Referenz

COleControl::DoPropExchange

COleControl::AmbientFont

Konzepte

MFC-Makros, globale Funktionen und globale Variablen