Struktur TTTOOLINFOA (commctrl.h)

Struktur TOOLINFO berisi informasi tentang alat dalam kontrol tipsalat.

Sintaks

typedef struct tagTOOLINFOA {
  UINT      cbSize;
  UINT      uFlags;
  HWND      hwnd;
  UINT_PTR  uId;
  RECT      rect;
  HINSTANCE hinst;
  LPSTR     lpszText;
  LPARAM    lParam;
  void      *lpReserved;
} TTTOOLINFOA, *PTOOLINFOA, *LPTTTOOLINFOA;

Anggota

cbSize

Jenis: UINT

Ukuran struktur ini, dalam byte. Anggota ini harus ditentukan.

uFlags

Jenis: UINT

Bendera yang mengontrol tampilan tipsalat. Anggota ini bisa menjadi kombinasi dari nilai berikut:

Nilai	Makna
TTF_ABSOLUTE	Memposisikan jendela tipsalat pada koordinat yang sama yang disediakan oleh TTM_TRACKPOSITION. Bendera ini harus digunakan dengan bendera TTF_TRACK.
TTF_CENTERTIP	Tengahkan jendela tipsalat di bawah alat yang ditentukan oleh anggota uId .
TTF_IDISHWND	Menunjukkan bahwa anggota uId adalah handel jendela ke alat. Jika bendera ini tidak diatur, uId adalah pengidentifikasi alat.
TTF_PARSELINKS	Versi 6.0 dan yang lebih baru. Menunjukkan bahwa tautan dalam teks tipsalat harus diurai. Perhatikan bahwa Comctl32.dll versi 6 tidak dapat didistribusikan ulang tetapi disertakan dalam Windows atau yang lebih baru. Untuk menggunakan Comctl32.dll versi 6, tentukan dalam manifes. Untuk informasi selengkapnya tentang manifes, lihat Mengaktifkan Gaya Visual.
TTF_RTLREADING	Menunjukkan bahwa teks tipsalat akan ditampilkan dalam arah yang berlawanan dengan teks di jendela induk.
TTF_SUBCLASS	Menunjukkan bahwa kontrol tipsalat harus mensubkelas jendela alat untuk mencegat pesan, seperti WM_MOUSEMOVE. Jika bendera ini tidak diatur, Anda harus menggunakan pesan TTM_RELAYEVENT untuk meneruskan pesan ke kontrol tipsalat. Untuk daftar pesan yang diproses kontrol tipsalat, lihat TTM_RELAYEVENT.
TTF_TRACK	Memposisikan jendela tipsalat di samping alat yang sesuai dan memindahkan jendela sesuai dengan koordinat yang disediakan oleh pesan TTM_TRACKPOSITION . Anda harus mengaktifkan jenis alat ini menggunakan pesan TTM_TRACKACTIVATE .
TTF_TRANSPARENT	Menyebabkan kontrol tipsalat meneruskan pesan peristiwa mouse ke jendela induk. Ini terbatas pada peristiwa mouse yang terjadi di dalam batas jendela tipsalat.

hwnd

Jenis: HWND

Tangani ke jendela yang berisi alat. Jika lpszText menyertakan nilai LPSTR_TEXTCALLBACK, anggota ini mengidentifikasi jendela yang menerima kode pemberitahuan TTN_GETDISPINFO .

uId

Jenis: UINT_PTR

Pengidentifikasi alat yang ditentukan aplikasi. Jika uFlags menyertakan bendera TTF_IDISHWND, uId harus menentukan handel jendela ke alat.

rect

Jenis: RECT

Koordinat persegi panjang pembatas alat. Koordinat relatif terhadap sudut kiri atas area klien jendela yang diidentifikasi oleh hwnd. Jika uFlags menyertakan bendera TTF_IDISHWND, anggota ini diabaikan.

hinst

Jenis: HINSTANCE

Tangani ke instans yang berisi sumber daya string untuk alat tersebut. Jika lpszText menentukan pengidentifikasi sumber daya string, anggota ini digunakan.

lpszText

Jenis: LPTSTR

Arahkan ke buffer yang berisi teks untuk alat, atau pengidentifikasi sumber daya string yang berisi teks. Anggota ini terkadang digunakan untuk mengembalikan nilai. Jika Anda perlu memeriksa nilai yang dikembalikan, harus menunjuk ke buffer yang valid dengan ukuran yang memadai. Jika tidak, ini dapat diatur ke NULL. Jika lpszText diatur ke LPSTR_TEXTCALLBACK, kontrol akan mengirim kode pemberitahuan TTN_GETDISPINFO ke jendela pemilik untuk mengambil teks.

lParam

Jenis: LPARAM

Versi 4.70 dan yang lebih baru. Nilai yang ditentukan aplikasi 32-bit yang terkait dengan alat ini.

lpReserved

Jenis: batal*

Dicadangkan. Harus diatur ke NULL.

Keterangan

Jendela normal menampilkan teks kiri-ke-kanan (LTR). Windows dapat dicerminkan untuk menampilkan bahasa seperti Ibrani atau Arab yang membaca kanan-ke-kiri (RTL). Biasanya, teks tipsalat ditampilkan ke arah yang sama dengan teks di jendela induknya. Jika TTF_RTLREADING diatur, teks tipsalat akan dibaca ke arah yang berlawanan dari teks di jendela induk.

Catatan

Header commctrl.h mendefinisikan TTTOOLINFO sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor 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

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Header	commctrl.h