IPropertyPage::Activate-Methode (ocidl.h)

Artikel
03/06/2024

Erstellt das Dialogfeldfenster für die Eigenschaftenseite.

Das Dialogfeld wird ohne Frame, Untertitel oder Systemmenü/Steuerelemente erstellt. Der Text im Dialogfeld sollte mit dem Gebietsschema übereinstimmen, das über IPropertyPageSite::GetLocaleID abgerufen wurde.

Syntax

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

Parameter

[in] hWndParent

Das Fensterhandle des übergeordneten Dialogfelds, das erstellt wird.

[in] pRect

Ein Zeiger auf die RECT-Struktur , die die Positionierungsinformationen für das Dialogfeld enthält. Diese Methode muss ihr Dialogfeld mit der Platzierung und den dimensionen erstellen, die von dieser Struktur beschrieben werden.

[in] bModal

Gibt an, ob der Dialogfeldrahmen modal (TRUE) oder moduslos (FALSE) ist.

Rückgabewert

Diese Methode kann die standardmäßigen Rückgabewerte E_OUTOFMEMORY und E_UNEXPECTED sowie die folgenden Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich abgeschlossen.
E_POINTER	Die Adresse in prc ist ungültig. Es kann z. B. NULL sein.

Hinweise

Die Eigenschaftenseite verwaltet das in diesem Prozess erstellte Fensterhandle, das verwendet wird, um das Dialogfeld in IPropertyPage::D eactivate zu zerstören.

Hinweise für Implementierer

E_NOTIMPL ist kein gültiger Rückgabewert.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	ocidl.h

Weitere Informationen

IPropertyPage

Freigeben über