Fungsi GetTabbedTextExtentA (winuser.h)

Fungsi GetTabbedTextExtent menghitung lebar dan tinggi string karakter. Jika string berisi satu atau beberapa karakter tab, lebar string didasarkan pada perhentian tab yang ditentukan. Fungsi GetTabbedTextExtent menggunakan font yang saat ini dipilih untuk menghitung dimensi string.

Sintaks

DWORD GetTabbedTextExtentA(
  [in] HDC       hdc,
  [in] LPCSTR    lpString,
  [in] int       chCount,
  [in] int       nTabPositions,
  [in] const INT *lpnTabStopPositions
);

Parameter

[in] hdc

Handel ke konteks perangkat.

[in] lpString

Penunjuk ke string karakter.

[in] chCount

Panjang string teks. Untuk fungsi ANSI itu adalah jumlah BYTE dan untuk fungsi Unicode itu adalah hitungan WORD. Perhatikan bahwa untuk fungsi ANSI, karakter di halaman kode SBCS masing-masing mengambil satu byte, sementara sebagian besar karakter di halaman kode DBCS mengambil dua byte; untuk fungsi Unicode, karakter Unicode yang saat ini ditentukan (yang ada di Basic Multilingual Plane (BMP)) adalah satu WORD sedangkan pengganti Unicode adalah dua WORD.

[in] nTabPositions

Jumlah posisi tab-stop dalam array yang ditujukkan oleh parameter lpnTabStopPositions .

[in] lpnTabStopPositions

Penunjuk ke array yang berisi posisi tab-stop, di unit perangkat. Perhentian tab harus diurutkan dalam urutan yang meningkat; nilai x terkecil harus menjadi item pertama dalam array.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah dimensi string dalam unit logis. Tingginya dalam kata berurutan tinggi dan lebarnya dalam kata berurutan rendah.

Jika fungsi gagal, nilai yang dikembalikan adalah 0. GetTabbedTextExtent akan gagal jika hDC tidak valid dan jika nTabPositions kurang dari 0.

Keterangan

Wilayah kliping saat ini tidak memengaruhi lebar dan tinggi yang dikembalikan oleh fungsi GetTabbedTextExtent .

Karena beberapa perangkat tidak menempatkan karakter dalam array sel reguler (yaitu, mereka membuat karakter), jumlah sejauh mana karakter dalam string mungkin tidak sama dengan tingkat string.

Jika parameter nTabPositions adalah nol dan parameter lpnTabStopPositions adalah NULL, tab diperluas hingga delapan kali lebar karakter rata-rata.

Jika nTabPositions adalah 1, perhentian tab dipisahkan oleh jarak yang ditentukan oleh nilai pertama dalam array tempat lpnTabStopPositions menunjuk .

Catatan

Header winuser.h mendefinisikan GetTabbedTextExtent sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosem UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	winuser.h (termasuk Windows.h)
Pustaka	User32.lib
DLL	User32.dll

Lihat juga

Fungsi Font dan Teks

Gambaran Umum Font dan Teks

GetTextExtentPoint32

TabbedTextOut