Condividi tramite


Metodo IXpsOMGlyphs::SetFontFaceIndex (xpsobjectmodel.h)

Imposta l'indice del viso del tipo di carattere da usare.

Questo valore viene usato solo quando GetFontResource restituisce un'interfaccia IXpsOMFontResource che rappresenta una raccolta di caratteri TrueType .

Sintassi

HRESULT SetFontFaceIndex(
  [in] SHORT fontFaceIndex
);

Parametri

[in] fontFaceIndex

Valore dell'indice del viso del tipo di carattere da usare.

Valore restituito

Il metodo restituisce un HRESULT. I valori possibili includono, ma non sono limitati a quelli della tabella che segue. Per informazioni sui valori restituiti dall'API documento XPS non elencati in questa tabella, vedere Errori del documento XPS.

Codice restituito Descrizione
S_OK
Il metodo è riuscito.
E_INVALIDARG
Il valore di fontFaceIndex non è valido; deve essere un intero maggiore o uguale a -1.

Commenti

Il valore predefinito della proprietà indice del viso del carattere è -1, il che significa che un indice di carattere non è stato impostato o la risorsa del tipo di carattere non è una raccolta di caratteri TrueType .

Se questo valore viene specificato e non è –1, "#<Index>" viene aggiunto all'URI carattere durante la serializzazione. In questo caso, <Index> è il valore impostato da SetFontFaceIndex.

Il markup seguente di un oggetto FixedPage mostra il risultato dell'impostazione del carattereFaceIndex su 1. Si noti che l'attributo FontUri dell'elemento Glyphs ha un valore di ../Resources/Fonts/Font.TTF#1, che include l'indice del viso del carattere.

    <FixedPage Height="1056" Width="816" xml:lang="en-US"
    xmlns="http://schemas.microsoft.com/xps/2005/06">
      <Glyphs
      OriginX="96"
      OriginY="96"
      UnicodeString="This is Page 1!"
      FontUri="../Resources/Fonts/Font.TTF#1"
      FontRenderingEmSize="16" />
    </FixedPage>

Requisiti

Requisito Valore
Client minimo supportato Windows 7, Windows Vista con SP2 e Aggiornamento della piattaforma per Windows Vista [app desktop | App UWP]
Server minimo supportato Windows Server 2008 R2, Windows Server 2008 con SP2 e Platform Update per Windows Server 2008 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione xpsobjectmodel.h

Vedi anche

IXpsOMGlyphs

XML Paper Specification

Errori del documento XPS