Bagikan melalui

Struktur TTTOOLINFOW (commctrl.h)

  • Artikel

Struktur TOOLINFO berisi informasi tentang alat dalam kontrol tipsalat.

Sintaksis

typedef struct tagTOOLINFOW {
  UINT      cbSize;
  UINT      uFlags;
  HWND      hwnd;
  UINT_PTR  uId;
  RECT      rect;
  HINSTANCE hinst;
  LPWSTR    lpszText;
  LPARAM    lParam;
  void      *lpReserved;
} TTTOOLINFOW, *PTOOLINFOW, *LPTTTOOLINFOW;

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 Arti
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 uId anggota.
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 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

Penunjuk 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 mengirimkan 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*

Dipesan. Harus diatur keNULL .

Komentar

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 dalam arah yang sama dengan teks di jendela induknya. Jika TTF_RTLREADING diatur, teks tipsalat akan membaca ke arah yang berlawanan dari teks di jendela induk.

Nota

Header commctrl.h mendefinisikan TTTOOLINFO 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

Syarat Nilai
klien minimum yang didukung Windows Vista [hanya aplikasi desktop]
server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Header commctrl.h