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