Funzione TabbedTextOutA (winuser.h)

Articolo
03/04/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 di 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 nel 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 zero, poiché nCount specifica la lunghezza della stringa.

[in] chCount

Lunghezza della stringa puntata da lpString.

[in] nTabPositions

Numero di valori nella matrice di posizioni tabulazioni.

[in] lpnTabStopPositions

Puntatore a una matrice contenente le posizioni tabulazioni, 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 è le dimensioni, in unità logiche, della stringa. L'altezza è nella parola ad ordine elevato e la larghezza è nella parola a basso ordine.

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

Commenti

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

Se nTabPositions è 1, le tabulazioni vengono 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ù di una volta con il valore 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 usata 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 preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll
Set di API	ext-ms-win-ntuser-misc-l1-5-1 (introdotta in Windows 10, versione 10.0.14393)