Condividi tramite


CDC::GetOutputTabbedTextExtent

Chiamare la funzione membro per calcolare la larghezza e l'altezza di una stringa di caratteri utilizzando m_hDC, il contesto del dispositivo di output.

CSize GetOutputTabbedTextExtent( 
   LPCTSTR lpszString, 
   int nCount, 
   int nTabPositions, 
   LPINT lpnTabStopPositions  
) const; 
CSize GetOutputTabbedTextExtent( 
   const CString& str, 
   int nTabPositions, 
   LPINT lpnTabStopPositions  
) const;

Parametri

  • lpszString
    Punta a una stringa di caratteri da eseguire. È anche possibile passare un oggetto CString per questo parametro.

  • nCount
    Specifica il numero di caratteri della stringa. Se nCount è a 1, la lunghezza viene calcolato.

  • nTabPositions
    Specifica il numero di posizioni tabstop la matrice è indicata da lpnTabStopPositions.

  • lpnTabStopPositions
    Punta a una matrice di valori interi che contengono le posizioni tabstop in unità logiche. Le tabulazioni devono essere ordinate in ordine crescente, il valore x più piccolo deve essere il primo elemento della matrice. Le schede finale non sono consentite.

  • str
    Un oggetto CString che contiene i caratteri specificati da eseguire.

Valore restituito

Le dimensioni della stringa (in unità logiche) in un oggetto CSize.

Note

Se la stringa contiene uno o più caratteri di tabulazione, la larghezza della stringa è basata sulle tabulazioni specificate da lpnTabStopPositions. La funzione utilizza il tipo attualmente selezionata per il calcolo delle dimensioni della stringa.

L'area di visualizzazione corrente non esegue l'offset la larghezza e l'altezza restituite dalla funzione GetOutputTabbedTextExtent.

Poiché alcuni dispositivi non posizionano i caratteri nelle matrici standard della cella (ovvero che kern i caratteri), la somma degli ambiti di caratteri in una stringa non può essere uguale nella misura della stringa.

Se nTabPositions è 0 e lpnTabStopPositions è NULL, schede sono espanse a otto larghezza media del carattere. Se nTabPositions è 1, tabulazioni saranno separate dalla distanza specificata dal primo valore nella matrice che indica lpnTabStopPositions. Se i punti lpnTabStopPositions a più di un singolo valore, una tabulazione è impostato per ogni valore nella matrice, fino al numero specificato da nTabPositions.

Requisiti

Header: afxwin.h

Vedere anche

Riferimenti

Classe CDC

Grafico delle gerarchie

CDC::GetTextExtent

CDC::m_hAttribDC

CDC::m_hDC

CDC::GetTabbedTextExtent

CDC::GetOutputTextExtent

CDC::TabbedTextOut

GetTabbedTextExtent

CSize Class