Funzione TabbedTextOutA (winuser.h)

Articolo
11/20/2024

La funzione TabbedTextOut scrive una stringa di caratteri in una posizione specificata, espandendo le schede ai valori specificati in una matrice di posizioni tabulazioni. Il testo viene scritto nel tipo di carattere, nel colore di sfondo e nel colore del testo attualmente selezionato.

Sintassi

LONG TabbedTextOutA(
  [in] HDC       hdc,
  [in] int       x,
  [in] int       y,
  [in] LPCSTR    lpString,
  [in] int       chCount,
  [in] int       nTabPositions,
  [in] const INT *lpnTabStopPositions,
  [in] int       nTabOrigin
);

Parametri

[in] hdc

Handle per il contesto del dispositivo.

[in] x

Coordinata x del punto iniziale della stringa, in unità logiche.

[in] y

Coordinata y del punto iniziale della stringa, in unità logiche.

[in] lpString

Puntatore alla stringa di caratteri da disegnare. La stringa non deve essere terminata con zero, perché nCount specifica la lunghezza della stringa.

[in] chCount

Lunghezza della stringa a cui punta lpString.

[in] nTabPositions

Numero di valori nella matrice di posizioni tabulazioni.

[in] lpnTabStopPositions

Puntatore a una matrice contenente le posizioni di tabulazione, in unità logiche. Le tabulazioni devono essere ordinate in ordine crescente; il valore x più piccolo deve essere il primo elemento della matrice.

[in] nTabOrigin

Coordinata x della posizione iniziale da cui vengono espanse le schede, in unità logiche.

Valore restituito

Se la funzione ha esito positivo, il valore restituito corrisponde alle dimensioni, in unità logiche, della stringa. L'altezza è nella parola in ordine elevato e la larghezza è nella parola in ordine basso.

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

Osservazioni

Se il parametro nTabPositions è zero e il parametro lpnTabStopPositions è NULL, le schede vengono espanse fino a otto volte la larghezza media del carattere.

Se nTabPositions è 1, le tabulazioni sono separate dalla distanza specificata dal primo valore nella matrice lpnTabStopPositions.

Se la matrice lpnTabStopPositions contiene più valori, viene impostata una tabulazione per ogni valore della matrice, fino al numero specificato da nTabPositions.

Il parametro nTabOrigin consente a un'applicazione di chiamare la funzione TabbedTextOut più volte per una singola riga. Se l'applicazione chiama TabbedTextOut più volte con il nTabOrigin impostato sullo stesso valore ogni volta, la funzione espande tutte le schede relative alla posizione specificata da nTabOrigin.

Per impostazione predefinita, la posizione corrente non viene utilizzata o aggiornata dalla funzione tabbedTextOut . Se un'applicazione deve aggiornare la posizione corrente quando chiama TabbedTextOut, l'applicazione può chiamare la funzione SetTextAlign con il parametro wFlags impostato su TA_UPDATECP. Quando questo flag è impostato, il sistema ignora i parametri X e Y nelle chiamate successive alla funzione TabbedTextOut, usando invece la posizione corrente.

Nota per Windows Vista e versioni successive, TabbedTextOut ignora l'allineamento del testo quando disegna testo.

Nota

L'intestazione winuser.h definisce TabbedTextOut come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	winuser.h (include Windows.h)
libreria	User32.lib
dll	User32.dll
set di API	ext-ms-win-ntuser-misc-l1-5-1 (introdotto in Windows 10, versione 10.0.14393)