Struktur NMTTDISPINFOA (commctrl.h)

Artikel
08/22/2023

Berisi informasi yang digunakan dalam menangani kode pemberitahuan TTN_GETDISPINFO . Struktur ini menggantikan struktur TOOLTIPTEXT .

Sintaks

typedef struct tagNMTTDISPINFOA {
  NMHDR     hdr;
  LPSTR     lpszText;
  char      szText[80];
  HINSTANCE hinst;
  UINT      uFlags;
  LPARAM    lParam;
} NMTTDISPINFOA, *LPNMTTDISPINFOA;

Anggota

hdr

Jenis: NMHDR

Struktur NMHDR yang berisi informasi tambahan tentang pemberitahuan.

lpszText

Jenis: LPTSTR

Penunjuk ke string yang dihentikan null yang akan ditampilkan sebagai teks tipsalat. Jika hinst menentukan handel instans, anggota ini harus menjadi pengidentifikasi sumber daya string.

szText[80]

Jenis: TCHAR

Buffer yang menerima teks tipsalat. Aplikasi dapat menyalin teks ke buffer ini alih-alih menentukan alamat string atau sumber daya string. Untuk teks tipsalat yang melebihi 80 TCHAR, lihat komentar di bagian keterangan dokumen ini.

hinst

Jenis: HINSTANCE

Tangani ke instans yang berisi sumber daya string yang akan digunakan sebagai teks tipsalat. Jika lpszText adalah alamat string teks tipsalat, anggota ini harus NULL.

uFlags

Jenis: UINT

Bendera yang menunjukkan cara menginterpretasikan idDari anggota struktur NMHDR yang disertakan.

Nilai	Makna
TTF_IDISHWND	Jika bendera ini diatur, idFrom adalah handel alat. Jika tidak, itu adalah pengidentifikasi alat.
TTF_RTLREADING	Windows dapat dicerminkan untuk menampilkan bahasa seperti Ibrani atau Arab yang membaca kanan-ke-kiri (RTL). Biasanya, teks tipsalat dibaca dengan arah yang sama dengan teks di jendela induknya. Agar tipsalat dibaca ke arah yang berlawanan dari jendela induknya, tambahkan bendera TTF_RTLREADING ke anggota uFlags saat memproses pemberitahuan.
TTF_DI_SETITEM	Versi 4.70. Jika Anda menambahkan bendera ini ke uFlags saat memproses pemberitahuan, kontrol tipsalat akan menyimpan informasi yang disediakan dan tidak memintanya lagi.

lParam

Jenis: LPARAM

Versi 4.70. Data yang ditentukan aplikasi yang terkait dengan alat.

Keterangan

Anda perlu mengarahkan array lpszText ke buffer privat Anda sendiri ketika teks yang digunakan dalam tipsalat melebihi panjang 80 TCHAR. Sistem secara otomatis menghapus akselerator ampersand (&) TCHARdari semua string yang diteruskan ke kontrol tipsalat, kecuali kontrol memiliki gaya TTS_NOPREFIX .

Catatan

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


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