Freigeben über


IXpsOMObjectFactory::CreateGlyphs-Methode (xpsobjectmodel.h)

Erstellt eine IXpsOMGlyphen-Schnittstelle , die Text angibt, der auf einer Seite angezeigt wird.

Syntax

HRESULT CreateGlyphs(
  [in]          IXpsOMFontResource *fontResource,
  [out, retval] IXpsOMGlyphs       **glyphs
);

Parameter

[in] fontResource

Ein Zeiger auf die IXpsOMFontResource-Schnittstelle der zu verwendenden Schriftartressource.

[out, retval] glyphs

Der neue IXpsOMGlyphen-Schnittstellenzeiger .

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliche Werte sind unter anderem diejenigen in der folgenden Tabelle. Informationen zu Rückgabewerten der XPS-Dokument-API, die in dieser Tabelle nicht aufgeführt sind, finden Sie unter XPS-Dokumentfehler.

Rückgabecode BESCHREIBUNG
S_OK
Die Methode wurde erfolgreich ausgeführt.
E_POINTER
fontResource oder glyphs ist NULL.
XPS_E_NO_CUSTOM_OBJECTS
fontResource verweist nicht auf eine erkannte Schnittstellenimplementierung. Die benutzerdefinierte Implementierung von XPS-Dokument-API-Schnittstellen wird nicht unterstützt.

Hinweise

Im folgenden Codebeispiel wird veranschaulicht, wie diese Methode zum Erstellen einer neuen Schnittstelle verwendet wird.


IXpsOMGlyphs       *newInterface;
// this interface is defined outside of this example
//  IXpsOMFontResource *font; 

// Note the implicit requirement that CoInitializeEx 
//  has previously been called from this thread.

hr = CoCreateInstance(
    __uuidof(XpsOMObjectFactory),
    NULL,
    CLSCTX_INPROC_SERVER,
    _uuidof(IXpsOMObjectFactory),
    reinterpret_cast<LPVOID*>(&xpsFactory)
    );

if (SUCCEEDED(hr))
{
    hr = xpsFactory->CreateGlyphs (font, &newInterface);
    if (SUCCEEDED(hr))
    {
        // use newInterface

        newInterface->Release();
    }
    xpsFactory->Release();
}
else
{
    // evaluate HRESULT error returned in hr
}

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile xpsobjectmodel.h

Weitere Informationen

IXpsOMFontResource

IXpsOMGlyphen

IXpsOMObjectFactory

XML Paper Specification

XPS-Dokumentfehler