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 0을 지정하고 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 헤더는 UNICODE 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 HELPWININFO를 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입대한 규칙을 참조하세요.

요구 사항

요구	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows 2000 Server [데스크톱 앱만 해당]
헤더	winuser.h