COlePropertiesDialog-Klasse

Artikel
06/10/2015

Kapselt das OLE-Objekt-Eigenschaftdialogfeld Windows allgemeine.

class COlePropertiesDialog : public COleDialog

Mitglieder

Öffentliche Konstruktoren

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

Öffentliche Methoden

Name	Description
COlePropertiesDialog::DoModal	Zeigt das Dialogfeld an und ermöglicht dem Benutzer, um die Auswahl zu machen.
COlePropertiesDialog::OnApplyScale	Aufgerufen vom Framework, wenn die Skalierung des Dokumentelements geändert hat.

Öffentliche Datenmember

Name	Description
COlePropertiesDialog::m_gp	Eine Struktur verwendet, um die "allgemeine" Seite COlePropertiesDialog eines Objekts zu initialisieren.
COlePropertiesDialog::m_lp	Eine Struktur verwendet, um die Seite "Link" COlePropertiesDialog eines Objekts zu initialisieren.
COlePropertiesDialog::m_op	Eine Struktur verwendet, um das COlePropertiesDialog-Objekt initialisieren.
COlePropertiesDialog::m_psh	Eine Struktur verwendet, um zusätzliche benutzerdefinierte Eigenschaftenseiten hinzuzufügen.
COlePropertiesDialog::m_vp	Eine Struktur verwendet, um die Seite "Ansichts" eines Objekts COlePropertiesDialog anzupassen.

Hinweise

Allgemeine OLE-Objekt-Eigenschaftdialogfelder bieten eine einfache Möglichkeit, die Eigenschaften eines OLE-Dokumentelements anzuzeigen und zu ändern, das mit Windows-Standards in ähnlicher Weise konsistent ist. Zu diesen Eigenschaften zählen unter anderem Informationen über die Datei dargestellt durch das Dokumentelement, Optionen zum Anzeigen der Symbol- und Bildskalieren und Informationen über den Link des Elements (wenn das Element verknüpft ist).

Um ein COlePropertiesDialog-Objekt zu verwenden, erstellen Sie zunächst das Objekt mithilfe des COlePropertiesDialog-Konstruktors. Nachdem das Dialogfeld erstellt wurde, rufen Sie die DoModal-Memberfunktion auf, um das Dialogfeld anzuzeigen und dem Benutzer zu ermöglichen, um alle Eigenschaften des Elements ändern. DoModal gibt zurück, ob der Benutzer OK (IDOK) oder die Schaltfläche Löschverhalten (IDCANCEL) ausgewählt hat. Neben OK und zu den Abbrechen gibt es eine übernehmensschaltfläche. Wenn der Benutzer auswählt, wenden Sie zu, werden alle Änderungen, die an den Eigenschaften des Dokumentelements vorgenommen werden, am Element angewendet und das Bild wird automatisch aktualisiert, aber bleibt aktiv.

Der m_psh Datenmember ist ein Zeiger auf eine Struktur PROPSHEETHEADER, und in den meisten Fällen müssen Sie nicht, um explizit auf sie zuzugreifen. Eine Ausnahme ist, wenn Sie zusätzliche Eigenschaftenseiten zum standardmäßigen Allgemein hinaus benötigen, anzeigen und Seiten verknüpfen. In diesem Fall können Sie den m_psh Datenmember ändern, um die benutzerdefinierten Seiten einzuschließen, bevor Sie die DoModal-Memberfunktion aufrufen.

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