Struttura HELPWININFOW (winuser.h)

Contiene le dimensioni e la posizione di una finestra della Guida primaria o secondaria. Un'applicazione può impostare queste informazioni chiamando la funzione WinHelp con il valore HELP_SETWINPOS.

Sintassi

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

Members

wStructSize

Tipo: int

Dimensioni di questa struttura, in byte.

x

Tipo: int

Coordinata X dell'angolo superiore sinistro della finestra, nelle coordinate dello schermo.

y

Tipo: int

Coordinata Y dell'angolo superiore sinistro della finestra, nelle coordinate dello schermo.

dx

Tipo: int

Larghezza della finestra in pixel.

dy

Tipo: int

Altezza della finestra, in pixel.

wMax

Tipo: int

Opzioni per la visualizzazione della finestra. Può essere uno qualsiasi dei valori che è possibile specificare nel parametro nCmdShow per la funzione ShowWindow .

rgchMember[2]

Tipo: TCHAR[2]

Nome della finestra.

Commenti

La Guida di Windows divide lo schermo in 1024 unità nelle direzioni X e Y. Per creare una finestra secondaria che riempie il quadrante superiore sinistro dello schermo, ad esempio, un'applicazione specifica zero per i membri x e y e 512 per i membri dx e dy .

Per calcolare correttamente wStructSize , è necessario conoscere le dimensioni effettive della stringa da archiviare in rgchMember . Poiché sizeof(HELPWININFO) include due TCHAR per definizione, devono essere presi in considerazione nel totale finale. Nell'esempio seguente viene illustrato il calcolo corretto di un'istanza di 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;
}

Nota

L'intestazione winuser.h definisce HELPWININFO come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	Winuser