Funzione DrawTextExPrivWrap

Articolo
06/13/2023

[DrawTextExPrivWrap è disponibile tramite Windows XP con Service Pack 2 (SP2). Potrebbe essere modificata 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 per il 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 con terminazione 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 sufficientemente grande per contenere questi caratteri aggiuntivi.

cchText [in]

Tipo: int

Lunghezza della stringa a cui punta 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, in coordinate logiche, in cui il testo deve essere formattato.

dwDTFormat [in]

Tipo: UINT

Opzioni di formattazione. Per un elenco completo delle opzioni, vedere la documentazione di 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 corrisponde all'altezza del testo in unità logiche. Se viene specificato DT_VCENTER o DT_BOTTOM , il valore restituito corrisponde all'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 il numero ordinale 416 da ComCtl32.dll per ottenere un puntatore a 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)