COlePropertiesDialog-Klasse

Kapselt das allgemeine Windows-OLE-Dialogfeld "Objekteigenschaften".

Syntax

class COlePropertiesDialog : public COleDialog

Member

Öffentliche Konstruktoren

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

Öffentliche Methoden

Name	Beschreibung
COlePropertiesDialog::D oModal	Zeigt das Dialogfeld an und ermöglicht es dem Benutzer, eine Auswahl vorzunehmen.
COlePropertiesDialog::OnApplyScale	Wird vom Framework aufgerufen, wenn sich die Skalierung des Dokumentelements geändert hat.

Öffentliche Datenmember

Name	Beschreibung
COlePropertiesDialog::m_gp	Eine Struktur, die zum Initialisieren der Seite "Allgemein" eines COlePropertiesDialog Objekts verwendet wird.
COlePropertiesDialog::m_lp	Eine Struktur, die zum Initialisieren der Seite "Link" eines COlePropertiesDialog Objekts verwendet wird.
COlePropertiesDialog::m_op	Eine Struktur, die zum Initialisieren des COlePropertiesDialog Objekts verwendet wird.
COlePropertiesDialog::m_psh	Eine Struktur, die zum Hinzufügen zusätzlicher benutzerdefinierter Eigenschaftenseiten verwendet wird.
COlePropertiesDialog::m_vp	Eine Struktur, die zum Anpassen der Seite "Ansicht" eines COlePropertiesDialog Objekts verwendet wird.

Hinweise

Allgemeine Dialogfelder für OLE-Objekteigenschaften bieten eine einfache Möglichkeit zum Anzeigen und Ändern der Eigenschaften eines OLE-Dokumentelements in einer Weise, die den Windows-Standards entspricht. Zu diesen Eigenschaften gehören u. a. Informationen zur Datei, die durch das Dokumentelement dargestellt wird, Optionen zum Anzeigen des Symbols und der Bildskalierung sowie Informationen zum Link des Elements (wenn das Element verknüpft ist).

Um ein COlePropertiesDialog Objekt zu verwenden, erstellen Sie zuerst das Objekt mit dem COlePropertiesDialog Konstruktor. Rufen Sie nach dem Erstellen des Dialogfelds die DoModal Memberfunktion auf, um das Dialogfeld anzuzeigen, und ermöglichen Sie dem Benutzer, alle Eigenschaften des Elements zu ändern. DoModal gibt zurück, ob der Benutzer die SCHALTFLÄCHE OK (IDOK) oder die Schaltfläche "Abbrechen" (IDCANCEL) ausgewählt hat. Zusätzlich zu den Schaltflächen "OK" und "Abbrechen" gibt es eine Schaltfläche "Übernehmen". Wenn der Benutzer "Übernehmen" auswählt, werden alle Änderungen, die an den Eigenschaften des Dokumentelements vorgenommen wurden, auf das Element angewendet, und das Bild wird automatisch aktualisiert, bleibt aber aktiv.

Das m_psh Datenmememm ist ein Zeiger auf eine PROPSHEETHEADER Struktur, und in den meisten Fällen müssen Sie nicht explizit darauf zugreifen. Eine Ausnahme besteht darin, dass Sie zusätzliche Eigenschaftenseiten benötigen, die über die Standardseiten "Allgemein", "Ansicht" und "Link" hinausgehen. In diesem Fall können Sie das m_psh Datenelement so ändern, dass sie Ihre benutzerdefinierten Seiten enthält, bevor Sie die DoModal Memberfunktion aufrufen.

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

Vererbungshierarchie

CObject

CCmdTarget

CWnd

CDialog

CCommonDialog

COleDialog

COlePropertiesDialog

Anforderungen

Kopfzeile: afxodlgs.h

COlePropertiesDialog::COlePropertiesDialog

Erstellt ein COlePropertiesDialog-Objekt.

COlePropertiesDialog(
    COleClientItem* pItem,
    UINT nScaleMin = 10,
    UINT nScaleMax = 500,
    CWnd* pParentWnd = NULL);

Parameter

pItem
Zeigen Sie auf das Dokumentelement, auf dessen Eigenschaften zugegriffen wird.

nScaleMin
Minimaler Skalierungsprozentsatz für das Dokumentelementbild.

nScaleMax
Maximaler Skalierungsprozentsatz für das Dokumentelementbild.

pParentWnd
Zeigen Sie auf das übergeordnete Element oder den Besitzer des Dialogfelds.

Hinweise

Leiten Sie ihre allgemeine OLE-Objekteigenschaften-Dialogklasse ab, COlePropertiesDialog um die Skalierung für Ihre Dokumentelemente zu implementieren. Alle von einer Instanz dieser Klasse implementierten Dialogfelder unterstützen die Skalierung des Dokumentelements nicht.

Standardmäßig verfügt das allgemeine Dialogfeld "OLE-Objekteigenschaften" über drei Standardseiten:

• Allgemein

  Diese Seite enthält Systeminformationen für die Datei, die durch das ausgewählte Dokumentelement dargestellt wird. Auf dieser Seite kann der Benutzer das ausgewählte Element in einen anderen Typ konvertieren.

• Ansicht

  Diese Seite enthält Optionen zum Anzeigen des Elements, Ändern des Symbols und Ändern der Skalierung des Bilds.

• Verknüpfung

  Diese Seite enthält Optionen zum Ändern des Speicherorts des verknüpften Elements und zum Aktualisieren des verknüpften Elements. Auf dieser Seite kann der Benutzer den Link des ausgewählten Elements unterbrechen.

Wenn Sie Seiten über die standardmäßig bereitgestellten Seiten hinaus hinzufügen möchten, ändern Sie die m_psh Membervariable, bevor Sie den Konstruktor Ihrer COlePropertiesDialogabgeleiteten Klasse beenden. Dies ist eine erweiterte Implementierung des COlePropertiesDialog Konstruktors.

COlePropertiesDialog::D oModal

Rufen Sie diese Memberfunktion auf, um das Windows-Dialogfeld für allgemeine OLE-Objekteigenschaften anzuzeigen und/oder dem Benutzer das Anzeigen und/oder Ändern der verschiedenen Eigenschaften des Dokumentelements zu ermöglichen.

virtual INT_PTR DoModal();

Rückgabewert

IDOK oder IDCANCEL bei erfolgreicher Ausführung; andernfalls 0. IDOK und IDCANCEL sind Konstanten, die angeben, ob der Benutzer die Schaltfläche "OK" oder "Abbrechen" ausgewählt hat.

Wenn IDCANCEL zurückgegeben wird, können Sie die Windows CommDlgExtendedError-Funktion aufrufen, um zu ermitteln, ob ein Fehler aufgetreten ist.

COlePropertiesDialog::m_gp

Eine Struktur vom Typ OLEUIGNRLPROPS, die zum Initialisieren der Seite "Allgemein" des Dialogfelds "OLE-Objekteigenschaften" verwendet wird.

OLEUIGNRLPROPS m_gp;

Hinweise

Diese Seite zeigt den Typ und die Größe einer Einbettung an und ermöglicht dem Benutzer den Zugriff auf das Dialogfeld "Konvertieren". Auf dieser Seite wird auch das Linkziel angezeigt, wenn es sich bei dem Objekt um einen Link handelt.

Weitere Informationen zur OLEUIGNRLPROPS Struktur finden Sie im Windows SDK.

COlePropertiesDialog::m_lp

Eine Struktur vom Typ OLEUILINKPROPS, die zum Initialisieren der Seite "Verknüpfung" des Dialogfelds "OLE-Objekteigenschaften" verwendet wird.

OLEUILINKPROPS m_lp;

Hinweise

Diese Seite zeigt den Speicherort des verknüpften Elements an und ermöglicht es dem Benutzer, den Link zum Element zu aktualisieren oder zu unterbrechen.

Weitere Informationen zur OLEUILINKPROPS Struktur finden Sie im Windows SDK.

COlePropertiesDialog::m_op

Eine Struktur vom Typ OLEUIOBJECTPROPS, die zum Initialisieren des allgemeinen Dialogfelds für OLE-Objekteigenschaften verwendet wird.

OLEUIOBJECTPROPS m_op;

Hinweise

Diese Struktur enthält Elemente, die zum Initialisieren der Seiten "Allgemein", "Link" und "Ansicht" verwendet werden.

Weitere Informationen finden Sie unter den OLEUIOBJECTPROPS- und OLEUILINKPROPS-Strukturen im Windows SDK.

COlePropertiesDialog::m_psh

Eine Struktur vom Typ PROPSHEETHEADER, deren Member die Merkmale des Dialogobjekts speichern.

PROPSHEETHEADER m_psh;

Hinweise

Nach dem Erstellen eines COlePropertiesDialog Objekts können m_psh Sie verschiedene Aspekte des Dialogfelds festlegen, bevor Sie die DoModal Memberfunktion aufrufen.

Wenn Sie das m_psh Datenelement direkt ändern, überschreiben Sie alle Standardverhaltensweisen.

Weitere Informationen zur PROPSHEETHEADER Struktur finden Sie im Windows SDK.

COlePropertiesDialog::m_vp

Eine Struktur vom Typ OLEUIVIEWPROPS, die zum Initialisieren der Ansichtsseite des Dialogfelds "OLE-Objekteigenschaften" verwendet wird.

OLEUIVIEWPROPS m_vp;

Hinweise

Auf dieser Seite kann der Benutzer zwischen "Content"- und "iconic"-Ansichten des Objekts umschalten und seine Skalierung innerhalb des Containers ändern. Er ermöglicht dem Benutzer auch den Zugriff auf das Dialogfeld "Symbol ändern", wenn das Objekt als Symbol angezeigt wird.

Weitere Informationen zur OLEUIVIEWPROPS Struktur finden Sie im Windows SDK.

COlePropertiesDialog::OnApplyScale

Wird vom Framework aufgerufen, wenn sich der Skalierungswert geändert hat und entweder OK oder Übernehmen ausgewählt wurde.

virtual BOOL OnApplyScale(
    COleClientItem* pItem,
    int nCurrentScale,
    BOOL bRelativeToOrig);

Parameter

pItem
Zeigen Sie auf das Dokumentelement, auf dessen Eigenschaften zugegriffen wird.

nCurrentScale
Numerischer Wert der Dialogskala.

bRelativeToOrig
Gibt an, ob die Skalierung auf die Originalgröße des Dokumentelements angewendet wird.

Rückgabewert

Nonzero, wenn behandelt; andernfalls 0.

Hinweise

Bei der Standardimplementierung wird keine Aktion ausgeführt. Sie müssen diese Funktion außer Kraft setzen, um die Skalierungssteuerelemente zu aktivieren.

Hinweis

Bevor das allgemeine Dialogfeld "OLE-Objekteigenschaften" angezeigt wird, ruft das Framework diese Funktion mit einem NULL-Wert für pItem und a - 1 für nCurrentScale auf. Dies geschieht, um zu ermitteln, ob die Skalierungssteuerelemente aktiviert werden sollen.

Siehe auch

MFC-Beispiel-CIRC
COleDialog-Klasse
Hierarchiediagramm
COleDialog-Klasse
CPropertyPage-Klasse