Funzione DrawTextExPrivWrap

[DrawTextExPrivWrap è disponibile tramite Windows XP con Service Pack 2 (SP2). Potrebbe essere modificato o non disponibile nelle versioni successive. È consigliabile usare DrawTextEx direttamente.

Disegna testo formattato nel rettangolo specificato. Questa funzione esegue il wrapping di una chiamata a DrawTextEx.

Sintassi

int WINAPI DrawTextExPrivWrap(
  _In_    HDC              hdc,
  _Inout_ LPTSTR           lpchText,
  _In_    int              cchText,
  _Inout_ LPRECT           lprc,
  _In_    UINT             dwDTFormat,
  _In_    LPDRAWTEXTPARAMS lpDTParams
);

Parametri

hdc [in]

Tipo: HDC

Handle al contesto del dispositivo in cui disegnare.

lpchText [in, out]

Tipo: LPTSTR

Puntatore a un buffer contenente il testo da disegnare. Se il parametro cchText è -1, la stringa deve essere terminata con null.

Se dwDTFormat include DT_MODIFYSTRING, la funzione potrebbe aggiungere fino a quattro caratteri aggiuntivi a questa stringa. Il buffer contenente la stringa deve essere abbastanza grande per supportare questi caratteri aggiuntivi.

cchText [in]

Tipo: int

Lunghezza della stringa puntata da lpchText. Se cchText è -1, si presuppone che il parametro lpchText sia un puntatore a una stringa con terminazione null e DrawTextEx calcola automaticamente il conteggio dei caratteri.

lprc [in, out]

Tipo: LPRECT

Puntatore a una struttura RECT che contiene il rettangolo, nelle coordinate logiche, in cui il testo deve essere formattato.

dwDTFormat [in]

Tipo: UINT

Opzioni di formattazione. Per un elenco completo di opzioni, vedere la documentazione per DrawTextEx .

lpDTParams [in]

Tipo: LPDRAWTEXTPARAMS

Puntatore a una struttura DRAWTEXTPARAMS che specifica opzioni di formattazione aggiuntive. Questo parametro può essere NULL.

Valore restituito

Tipo: int

Se la funzione ha esito positivo, il valore restituito è l'altezza del testo nelle unità logiche. Se viene specificato DT_VCENTER o DT_BOTTOM , il valore restituito è l'offset dal membro superiore di lprc alla parte inferiore del testo disegnato.

Se la funzione ha esito negativo, il valore restituito è zero.

Per informazioni dettagliate sull'errore, chiamare GetLastError.

Osservazioni

DrawTextExPrivWrap non viene esportato per nome o dichiarato in un file di intestazione pubblica. Per usarlo, è necessario usare GetProcAddress e richiedere ordinale 416 da ComCtl32.dll per ottenere un puntatore alla funzione.

Per altre osservazioni, vedere DrawTextEx.

Requisiti

Requisito Valore
Client minimo supportato
Windows Vista [solo app desktop]
Server minimo supportato
Windows Server 2003 [solo app desktop]
DLL
Comctl32.dll (versione 6.0 o successiva)