Bagikan melalui

Struktur HELPWININFOW (winuser.h)

  • Artikel

Berisi ukuran dan posisi jendela Bantuan primer atau sekunder. Aplikasi dapat mengatur informasi ini dengan memanggil fungsi WinHelp dengan nilai HELP_SETWINPOS.

Sintaks

typedef struct tagHELPWININFOW {
  int   wStructSize;
  int   x;
  int   y;
  int   dx;
  int   dy;
  int   wMax;
  WCHAR rgchMember[2];
} HELPWININFOW, *PHELPWININFOW, *LPHELPWININFOW;

Anggota

wStructSize

Jenis: int

Ukuran struktur ini, dalam byte.

x

Jenis: int

Koordinat X sudut kiri atas jendela, dalam koordinat layar.

y

Jenis: int

Koordinat Y dari sudut kiri atas jendela, dalam koordinat layar.

dx

Jenis: int

Lebar jendela, dalam piksel.

dy

Jenis: int

Tinggi jendela, dalam piksel.

wMax

Jenis: int

Opsi untuk tampilan jendela. Ini bisa menjadi salah satu nilai yang dapat ditentukan dalam parameter nCmdShow untuk fungsi ShowWindow .

rgchMember[2]

Jenis: TCHAR[2]

Nama jendela.

Keterangan

Bantuan Windows membagi tampilan menjadi 1024 unit di arah X dan Y. Untuk membuat jendela sekunder yang mengisi kuadrian kiri atas layar, misalnya, aplikasi akan menentukan nol untuk anggota x dan y dan 512 untuk anggota dx dan dy .

Untuk menghitung wStructSize dengan benar, ukuran aktual string yang akan disimpan di rgchMember harus diketahui. Karena sizeof (HELPWININFO) mencakup dua TCHAR menurut definisi, mereka harus dipertahankan dalam total akhir. Contoh berikut menunjukkan perhitungan yang tepat dari instans wStructSize.

WORD wSize;
TCHAR *szWndName = TEXT("wnd_menu"); 
size_t NameLength;  
HRESULT hr;
HELPWININFO hwi;

// StringCbLength returns the length of the string without 
// the terminating null character.
hr = StringCbLength(szWndName, STRSAFE_MAX_CCH * sizeof(TCHAR), &NameLength);
    
if (SUCCEEDED(hr))
{
    // Add bytes to account for the name string's terminating null character.
    NameLength + sizeof(TCHAR);
    
    // Determine the size of HELPWININFO without the TCHAR array.
    wSize = sizeof(HELPWININFO) - (2 * sizeof(TCHAR));
    
    // Determine the total size of the final HELPWININFO structure.
    hwi.wStructSize = wSize + NameLength;
}

Catatan

Header winuser.h mendefinisikan HELPWININFO 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 XP [hanya aplikasi desktop]
Server minimum yang didukung Windows 2000 Server [hanya aplikasi desktop]
Header winuser.h