Funzione ExtTextOutWrap

Articolo
06/13/2023

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

Disegna testo utilizzando il tipo di carattere, il colore di sfondo e il colore del testo attualmente selezionati. Facoltativamente, è possibile specificare le dimensioni da utilizzare per ritagliare, opacità o entrambe. Questa funzione esegue il wrapping di una chiamata a ExtTextOut.

Sintassi

BOOL ExtTextOutWrap(
  _In_       HDC     hdc,
  _In_       int     X,
  _In_       int     Y,
  _In_       UINT    uOptions,
  _In_ const RECT    *lprc,
  _In_       LPCTSTR lpString,
  _In_       UINT    cbCount,
  _In_ const INT     *lpDx
);

Parametri

hdc [in]

Tipo: HDC

Handle per il contesto del dispositivo.

X [in]

Tipo: int

Coordinata x, in coordinate logiche, del punto di riferimento utilizzato per posizionare la stringa.

Y [in]

Tipo: int

Coordinata y, in coordinate logiche, del punto di riferimento utilizzato per posizionare la stringa.

uOptions [in]

Tipo: UINT

Valori che specificano come usare il rettangolo definito dall'applicazione. Per un elenco completo delle opzioni, vedere ExtTextOut .

lprc [in]

Tipo: const RECT*

Puntatore a una struttura RECT facoltativa che specifica le dimensioni, in coordinate logiche, di un rettangolo utilizzato per ritagliare, opacità o entrambi.

lpString [in]

Tipo: LPCTSTR

Puntatore a un buffer contenente il testo da disegnare. La stringa non deve essere terminata da zero, poiché cbCount specifica la lunghezza della stringa.

cbCount [in]

Tipo: UINT

Lunghezza della stringa, in byte, a cui punta lpString.

lpDx [in]

Tipo: const INT*

Puntatore a una matrice facoltativa di valori che indica la distanza tra le origini delle celle di caratteri adiacenti. Ad esempio, le unità logiche lpDx[x] separano le origini della cella di caratteri x e della cella carattere (x + 1).

Valore restituito

Tipo: BOOL

Restituisce un valore diverso da zero se la stringa viene disegnata correttamente. Tuttavia, se la versione ANSI di ExtTextOut viene chiamata con ETO_GLYPH_INDEX, la funzione restituisce TRUE anche se la funzione non esegue alcuna operazione.

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

Per informazioni dettagliate sull'errore, chiamare GetLastError.

Osservazioni

ExtTextOutWrap non viene esportato per nome o dichiarato in un file di intestazione pubblica. Per usarlo, è necessario usare GetProcAddress e richiedere il numero ordinale 417 da ComCtl32.dll per ottenere un puntatore a funzione.

Per altre osservazioni, vedere ExtTextOut.

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