Freigeben über

COleChangeIconDialog-Klasse

  • Artikel

Wird für das OLE-Dialogfeld "Symbol ändern" verwendet.

Syntax

class COleChangeIconDialog : public COleDialog

Member

Öffentliche Konstruktoren

Name Beschreibung
COleChangeIconDialog::COleChangeIconDialog Erstellt ein COleChangeIconDialog-Objekt.

Öffentliche Methoden

Name Beschreibung
COleChangeIconDialog::D oChangeIcon Führt die im Dialogfeld angegebene Änderung aus.
COleChangeIconDialog::D oModal Zeigt das Dialogfeld "OLE 2-Symbol ändern" an.
COleChangeIconDialog::GetIconicMetafile Ruft ein Handle für die Metadatei ab, die der ikonischen Form dieses Elements zugeordnet ist.

Öffentliche Datenmember

Name Beschreibung
COleChangeIconDialog::m_ci Eine Struktur, die das Verhalten des Dialogfelds steuert.

Hinweise

Erstellen Sie ein Klassenobjekt COleChangeIconDialog , wenn Sie dieses Dialogfeld aufrufen möchten. Nachdem ein COleChangeIconDialog Objekt erstellt wurde, können Sie die m_ci Struktur verwenden, um die Werte oder Zustände von Steuerelementen im Dialogfeld zu initialisieren. Die m_ci Struktur ist vom Typ OLEUICHANGEICON. Weitere Informationen zur Verwendung dieser Dialogklasse finden Sie in der DoModal-Memberfunktion .

Weitere Informationen finden Sie in der OLEUICHANGEICON-Struktur im Windows SDK.

Weitere Informationen zu OLE-spezifischen Dialogfeldern finden Sie im Artikel Dialogfelder in OLE.

Vererbungshierarchie

CObject

CCmdTarget

CWnd

Cdialog

CCommonDialog

COleDialog

COleChangeIconDialog

Anforderungen

Kopfzeile: afxodlgs.h

COleChangeIconDialog::COleChangeIconDialog

Diese Funktion erstellt nur ein COleChangeIconDialog Objekt.

explicit COleChangeIconDialog(
    COleClientItem* pItem,
    DWORD dwFlags = CIF_SELECTCURRENT,
    CWnd* pParentWnd = NULL);

Parameter

pItem
Verweist auf das zu konvertierende Element.

dwFlags
Creation flag, which contains any number of the following values combined using the bitwise-or operator:

  • CIF_SELECTCURRENT Gibt an, dass das Optionsfeld "Aktuell" anfänglich ausgewählt wird, wenn das Dialogfeld aufgerufen wird. Dies ist die Standardeinstellung.

  • CIF_SELECTDEFAULT Gibt an, dass das Optionsfeld "Standard" anfänglich ausgewählt wird, wenn das Dialogfeld aufgerufen wird.

  • CIF_SELECTFROMFILE Gibt an, dass das Optionsfeld "Aus Datei" anfangs ausgewählt wird, wenn das Dialogfeld aufgerufen wird.

  • CIF_SHOWHELP Gibt an, dass die Schaltfläche "Hilfe" angezeigt wird, wenn das Dialogfeld aufgerufen wird.

  • CIF_USEICONEXE Gibt an, dass das Symbol aus der im szIconExe Feld m_ci angegebenen ausführbaren Datei extrahiert werden soll, anstatt aus dem Typ abzurufen. Dies ist nützlich für das Einbetten oder Verknüpfen mit Nicht-OLE-Dateien.

pParentWnd
Verweist auf das übergeordnete oder Besitzerfensterobjekt (vom Typ CWnd), zu dem das Dialogobjekt gehört. Wenn es NULL ist, wird das übergeordnete Fenster des Dialogfelds auf das Standard Anwendungsfenster festgelegt.

Hinweise

Rufen Sie zum Anzeigen des Dialogfelds die DoModal-Funktion auf.

Weitere Informationen finden Sie in der OLEUICHANGEICON-Struktur im Windows SDK.

COleChangeIconDialog::D oChangeIcon

Rufen Sie diese Funktion auf, um das Symbol zu ändern, das das Element in das im Dialogfeld ausgewählte darstellt, nachdem DoModal IDOK zurückgegeben hat.

BOOL DoChangeIcon(COleClientItem* pItem);

Parameter

pItem
Verweist auf das Element, dessen Symbol geändert wird.

Rückgabewert

Nonzero, wenn die Änderung erfolgreich ist; andernfalls 0.

COleChangeIconDialog::D oModal

Rufen Sie diese Funktion auf, um das Dialogfeld "OLE-Änderungssymbol" anzuzeigen.

virtual INT_PTR DoModal();

Rückgabewert

Abschlussstatus für das Dialogfeld. Einer der folgenden Werte:

  • IDOK, wenn das Dialogfeld erfolgreich angezeigt wurde.

  • IDCANCEL, wenn der Benutzer das Dialogfeld abgebrochen hat.

  • IDABORT, wenn ein Fehler aufgetreten ist. Wenn IDABORT zurückgegeben wird, rufen Sie die COleDialog::GetLastError Memberfunktion auf, um weitere Informationen zum Typ des aufgetretenen Fehlers zu erhalten. Eine Auflistung möglicher Fehler finden Sie in der OleUIChangeIcon-Funktion im Windows SDK.

Hinweise

Wenn Sie die verschiedenen Dialogfeldsteuerelemente initialisieren möchten, indem Sie Elemente der m_ci-Struktur festlegen, sollten Sie dies vor dem Aufrufen DoModalausführen, aber nach dem Erstellen des Dialogobjekts.

Wenn DoModal IDOK zurückgegeben wird, können Sie andere Memberfunktionen aufrufen, um die Einstellungen oder Informationen abzurufen, die vom Benutzer in das Dialogfeld eingegeben wurden.

COleChangeIconDialog::GetIconicMetafile

Rufen Sie diese Funktion auf, um ein Handle für die Metadatei abzurufen, die den ikonischen Aspekt des ausgewählten Elements enthält.

HGLOBAL GetIconicMetafile() const;

Rückgabewert

Das Handle für die Metadatei, die den ikonischen Aspekt des neuen Symbols enthält, wenn das Dialogfeld durch Auswahl von "OK" geschlossen wurde. Andernfalls wird das Symbol wie vor der Anzeige des Dialogfelds angezeigt.

COleChangeIconDialog::m_ci

Struktur des Typs OLEUICHANGEICON zum Steuern des Verhaltens des Dialogfelds "Symbol ändern".

OLEUICHANGEICON m_ci;

Hinweise

Elemente dieser Struktur können entweder direkt oder über Memberfunktionen geändert werden.

Weitere Informationen finden Sie in der OLEUICHANGEICON-Struktur im Windows SDK.

Siehe auch

COleDialog-Klasse
Hierarchiediagramm
COleDialog-Klasse