Struktur HELPWININFOA (winuser.h)

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

Sintaksis

typedef struct tagHELPWININFOA {
  int  wStructSize;
  int  x;
  int  y;
  int  dx;
  int  dy;
  int  wMax;
  CHAR rgchMember[2];
} HELPWININFOA, *PHELPWININFOA, *LPHELPWININFOA;

Anggota

wStructSize

Jenis: int

Ukuran struktur ini, dalam byte.

x

Jenis: int

Koordinat X dari 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.

Komentar

Bantuan Windows membagi tampilan menjadi 1024 unit dalam 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 dx dan anggota 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 diperhitungkan 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;
}

Persyaratan