CWnd::GetNextDlgGroupItem

Articolo
02/19/2013

Ricerca del controllo precedente o successivo nell'interno di un gruppo di controlli in una finestra di dialogo.

CWnd* GetNextDlgGroupItem(
   CWnd* pWndCtl,
   BOOL bPrevious = FALSE 
) const;
COleControlSiteOrWnd* GetNextDlgGroupItem(
   COleControlSiteOrWnd *pCurSiteOrWnd = NULL
) const;

Parametri

pWndCtl
Identifica il controllo da utilizzare come punto iniziale per la ricerca.
bPrevious
Specifica della funzione è di trovare il gruppo di controlli nella finestra di dialogo.Se TRUE, la funzione trova il controllo precedente nel gruppo, se FALSE, cerca il controllo successivo nel gruppo.
pCurSiteOrWnd
Identifica il controllo COleControlSiteOrWnd .Per ulteriori informazioni su COleControlSiteOrWnd, vedere Note.

Valore restituito

Puntatore al controllo precedente o successivo nel gruppo se la funzione membro ha esito positivo.

Il puntatore restituito può essere temporanei e non deve essere archiviata per un utilizzo successivo.

Note

Un gruppo di controlli inizia con un controllo creato con lo stile WS_GROUP e termina con l'ultimo controllo che non è stato creato con lo stile WS_GROUP.

Per impostazione predefinita, la funzione membro GetNextDlgGroupItem restituisce un puntatore al controllo successivo nel gruppo.Se pWndCtl identifica il primo controllo nel gruppo e bPrevious è TRUE, GetNextDlgGroupItem restituisce un puntatore all'ultimo controllo nel gruppo.

[!NOTA]

Poiché i controlli ActiveX senza finestra di MFC supporta, controlli ActiveX standard e finestre, facendo riferimento a un controllo solo da un HWND) non basta.L'oggetto COleControlSiteOrWnd include informazioni che identificano l'oggetto come un controllo ActiveX con finestre, un controllo ActiveX senza finestra, o finestra, come segue:

Tipo di finestra o del controllo	Informazioni di identificazione
Controllo ActiveX di Compilazione	Contiene un HWND e associa un oggetto COleControlSite con.Il membro m_hWndCOleControlSiteOrWnd è impostato su HWND del controllo e ai punti del membro m_pSite a COleControlSitedel controllo.
Controllo ActiveX senza finestra	Non contiene HWND.Il membro m_pSite punti COleControlSiteOrWnd a COleControlSitedel controllo e il membro m_hWnd è NULL.
Finestra standard	Contiene solo HWND.Il membro m_hWndCOleControlSiteOrWnd è impostato su HWND della finestra e il membro m_pSite è NULL.