Metodo IPropertyPage::Activate (ocidl.h)

  • Articolo

Crea la finestra di dialogo per la pagina delle proprietà.

La finestra di dialogo viene creata senza cornice, didascalia o menu/controlli di sistema. Il testo nella finestra di dialogo deve corrispondere alle impostazioni locali ottenute tramite IPropertyPageSite::GetLocaleID.

Sintassi

HRESULT Activate(
  [in] HWND    hWndParent,
  [in] LPCRECT pRect,
  [in] BOOL    bModal
);

Parametri

[in] hWndParent

Handle di finestra dell'elemento padre della finestra di dialogo da creare.

[in] pRect

Puntatore alla struttura RECT contenente le informazioni di posizionamento per la finestra di dialogo. Questo metodo deve creare la finestra di dialogo con la posizione e le dimensioni descritte da questa struttura.

[in] bModal

Indica se la cornice della finestra di dialogo è modale (TRUE) o modeless (FALSE).

Valore restituito

Questo metodo può restituire i valori restituiti standard E_OUTOFMEMORY e E_UNEXPECTED, nonché i valori seguenti.

Codice restituito Descrizione
S_OK
 Metodo completato correttamente.
E_POINTER
 L'indirizzo in prc non è valido. Ad esempio, può essere NULL.

Commenti

La pagina delle proprietà gestisce l'handle di finestra creato in questo processo, che usa per eliminare definitivamente la finestra di dialogo all'interno di IPropertyPage::D eactivate.

Note per gli implementatori

E_NOTIMPL non è un valore restituito valido.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione ocidl.h

Vedi anche

Ipropertypage