HELPWININFOA 結構 (winuser.h)

包含主要或次要說明視窗的大小和位置。 應用程式可以使用 HELP_SETWINPOS 值呼叫 WinHelp 函式來設定這項資訊。

語法

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

成員

wStructSize

類型： int

這個結構的大小，以位元組為單位。

x

類型： int

視窗左上角的 X 座標，以螢幕座標表示。

y

類型： int

視窗左上角的 Y 座標，以螢幕座標表示。

dx

類型： int

視窗的寬度，以像素為單位。

dy

類型： int

視窗的高度，以像素為單位。

wMax

類型： int

窗口顯示的選項。 它可以是可在 ShowWindow 函式的 nCmdShow 參數中指定的任何值。

rgchMember[2]

類型： TCHAR[2]

視窗的名稱。

備註

Windows 說明會將顯示器分成 X 和 Y 方向的 1024 單位。 若要建立填滿顯示器左上角象限的次要視窗，例如，應用程式會為 x 和 y 成員指定零，而 dx 和 dy 成員則指定 512。

若要正確計算 wStructSize ，必須知道要儲存在 rgchMember 之字串的實際大小。 由於 sizeof (HELPWININFO) 依定義包含兩個 TCHAR ，因此必須在最終總計中納入考慮。 下列範例顯示 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;
}

注意

winuser.h 標頭會將 HELPWININFO 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。

規格需求

需求	值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
標頭	winuser.h