Funzione DrawTextWrap

Articolo
06/03/2023

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

Disegna testo formattato nel rettangolo specificato. Formatta il testo in base al metodo specificato (espandendo le schede, giustificando i caratteri, le righe di interruzione e così via). Questa funzione esegue il wrapping di una chiamata a DrawText.

Sintassi

int WINAPI DrawTextWrap(
  _In_    HDC              hdc,
  _Inout_ LPCTSTR          lpString,
  _In_    int              nCount,
  _Inout_ LPRECT           lpRect,
  _In_    UINT             uFormat,
  _In_    LPDRAWTEXTPARAMS lpDTParams
);

Parametri

hdc [in]

Tipo: HDC

Handle nel contesto del dispositivo.

lpString [in, out]

Tipo: LPCTSTR

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

Se uFormat 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.

nCount [in]

Tipo: int

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

lpRect [in, out]

Tipo: LPRECT

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

uFormat [in]

Tipo: UINT

Opzioni di formattazione. Per un elenco completo delle opzioni, vedere la documentazione di DrawText .

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.

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

Per informazioni dettagliate sull'errore, chiamare GetLastError.

Osservazioni

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

Per altre osservazioni, vedere DrawText.

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)

Condividi tramite