Struttura HELPWININFOA (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 tagHELPWININFOA {
  int  wStructSize;
  int  x;
  int  y;
  int  dx;
  int  dy;
  int  wMax;
  CHAR rgchMember[2];
} HELPWININFOA, *PHELPWININFOA, *LPHELPWININFOA;

Membri

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.

Osservazioni

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 il dx e membri.

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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows XP [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
intestazione	winuser.h