COleControl-Klasse

Artikel
02/26/2013

Ein leistungsstarkes Basisklasse zum Entwickeln von OLE-Steuerelemente.

class COleControl : public CWnd

Mitglieder

Öffentliche Konstruktoren

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

Öffentliche Methoden

Name	Description
COleControl::AmbientAppearance	Ruft die aktuelle Darstellung des Steuerelements ab.
COleControl::AmbientBackColor	Gibt den Wert der Ambienten BackColor-Eigenschaft zurück.
COleControl::AmbientDisplayName	Gibt den Namen des Steuerelements zurück, wie vom Container angegeben.
COleControl::AmbientFont	Gibt den Wert der Ambienten Schriftarteigenschaft zurück.
COleControl::AmbientForeColor	Gibt den Wert der Ambienten ForeColor-Eigenschaft zurück.
COleControl::AmbientLocaleID	Gibt eher das Gebietsschema des Containers zurück
COleControl::AmbientScaleUnits	Gibt den Typ von Einheiten zurück, die vom Container verwendet werden.
COleControl::AmbientShowGrabHandles	Bestimmt, ob Ziehpunkte angezeigt werden.
COleControl::AmbientShowHatching	Bestimmt, ob das Schraffieren angezeigt wird.
COleControl::AmbientTextAlign	Gibt den Typ der Textausrichtung angegeben durch den Container zurück.
COleControl::AmbientUIDead	Bestimmt, ob das Steuerelement auf Benutzeroberflächeaktionen reagiert.
COleControl::AmbientUserMode	Bestimmt den Modus des Containers.
COleControl::BoundPropertyChanged	Benachrichtigt den Container, dass eine gebundene Eigenschaft geändert wurde.
COleControl::BoundPropertyRequestEdit	Fordert Berechtigung, den Eigenschaftswert zu bearbeiten.
COleControl::ClientToParent	Übersetzt einen Punkt relativ zum Ursprung des Steuerelements einem Punkt relativ zum Ursprung des Containers.
COleControl::ClipCaretRect	Passt ein Einfügemarkerechteck, wenn es von einem Steuerelement somit wird.
COleControl::ControlInfoChanged	Rufen Sie diese Funktion nach dem mnemonischen auf, die vom Steuerelement behandelt wird, hat sich geändert.
COleControl::DisplayError	Anzeigen vorrätigen Artikel Fehlerereignisse dem Benutzer des Steuerelements.
COleControl::DoClick	Implementierung der vordefinierten DoClick-Methode.
COleControl::DoPropExchange	Serialisiert die Eigenschaften eines Objekts COleControl.
COleControl::DoSuperclassPaint	Aktualisiert ein OLE-Steuerelement neu, das von einem Windows-Steuerelement erstellt wurde).
COleControl::EnableSimpleFrame	Aktiviert einfache Frameunterstützung für ein Steuerelement.
COleControl::ExchangeExtent	Serialisiert die Breite und Höhe des Steuerelements.
COleControl::ExchangeStockProps	Serialisiert die Vorrateigenschaften des Steuerelements.
COleControl::ExchangeVersion	Serialisiert die Versionsnummer des Steuerelements.
COleControl::FireClick	Löst das vordefinierte Click-Ereignis aus.
COleControl::FireDblClick	Löst das vordefinierte DblClick-Ereignis aus.
COleControl::FireError	Löst das vordefinierte Error-Ereignis aus.
COleControl::FireEvent	Löst ein benutzerdefiniertes Ereignis aus.
COleControl::FireKeyDown	Löst das vordefinierte KeyDown-Ereignis aus.
COleControl::FireKeyPress	Löst das vordefinierte KeyPress-Ereignis aus.
COleControl::FireKeyUp	Löst das vordefinierte KeyUp-Ereignis aus.
COleControl::FireMouseDown	Löst das vordefinierte MouseDown-Ereignis aus.
COleControl::FireMouseMove	Löst das vordefinierte MouseMove-Ereignis aus.
COleControl::FireMouseUp	Löst das vordefinierte MouseUp-Ereignis aus.
COleControl::FireReadyStateChange	Löst ein Ereignis wenn die Änderungen des betriebsbereiten Zustand des Steuerelements aus.
COleControl::GetActivationPolicy	Ändert das standardmäßige Aktivierungsverhalten eines Steuerelements, das die IPointerInactive-Schnittstelle unterstützt.
COleControl::GetAmbientProperty	Gibt den Wert der angegebenen Ambient-Eigenschaft zurück.
COleControl::GetAppearance	Gibt den Wert der vordefinierten Darstellungseigenschaft zurück.
COleControl::GetBackColor	Gibt den Wert der vordefinierten BackColor-Eigenschaft zurück.
COleControl::GetBorderStyle	Gibt den Wert der vordefinierten BorderStyle-Eigenschaft zurück.
COleControl::GetCapture	Bestimmt, ob ein fensterloses, aktiviertes Steuerelementobjekt die Mausauswahl verfügt.
COleControl::GetClassID	Ruft die OLE-Klassen-ID des Steuerelements ab.
COleControl::GetClientOffset	Ruft den Unterschied zwischen der linken oberen Ecke des rechteckigen Bereichs des Steuerelements und der linken oberen Ecke des Clientbereichs ab.
COleControl::GetClientRect	Ruft die Größe des Clientbereichs des Steuerelements ab.
COleControl::GetClientSite	Fragt ein Objekt für den Zeiger auf der aktuellen Clientsite innerhalb des Containers ab.
COleControl::GetControlFlags	Ruft die Steuerflagseinstellungen ab.
COleControl::GetControlSize	Gibt die Position und die Größe des OLE-Steuerelements zurück.
COleControl::GetDC	Stellt eine Möglichkeit bereit, damit ein fensterloses Steuerelement einen Gerätekontext vom Container abruft.
COleControl::GetEnabled	Gibt den Wert der vordefinierten aktivierten Eigenschaft zurück.
COleControl::GetExtendedControl	Ruft einen Zeiger auf einen erweiterten Steuerelementobjekt ab, das dem Container gehört.
COleControl::GetFocus	Bestimmt, ob das Steuerelement den Fokus besitzt.
COleControl::GetFont	Gibt den Wert der vordefinierten Schriftarteigenschaft zurück.
COleControl::GetFontTextMetrics	Gibt die Metriken CFontHolder eines Objekts zurück.
COleControl::GetForeColor	Gibt den Wert der vordefinierten ForeColor-Eigenschaft zurück.
COleControl::GetHwnd	Gibt den Wert der vordefinierten hWnd Eigenschaft zurück.
COleControl::GetMessageString	Stellt Statusleistentext für ein Menüelement bereit.
COleControl::GetNotSupported	Verhindert den Zugriff auf den Eigenschaftswert eines Steuerelements durch den Benutzer.
COleControl::GetReadyState	Gibt den Bereitschaftszustand des Steuerelements zurück.
COleControl::GetRectInContainer	Gibt das Rechteck des Steuerelements relativ zu seinem Container zurück.
COleControl::GetStockTextMetrics	Gibt die Metriken der vordefinierten Schriftarteigenschaft zurück.
COleControl::GetText	Gibt den Wert der vordefinierten Text- oder Beschriftungseigenschaft zurück.
COleControl::GetWindowlessDropTarget	Überschreiben Sie, um die fensterlose eines Steuerelements zu ermöglichen, ein Ziel von Drag & Drop-Vorgängen zu sein.
COleControl::InitializeIIDs	Das informiert die Basisklasse über die IID, das das Steuerelement verwendet.
COleControl::InternalGetFont	Gibt ein Objekt CFontHolder für die vordefinierte Schriftarteigenschaft zurück.
COleControl::InternalGetText	Ruft die vordefinierte Beschriftungs- oder Texteigenschaft ab.
COleControl::InternalSetReadyState	Legt den Bereitschaftszustand des Steuerelements fest Betriebsbereit-Zustandänderung und löst das Ereignis aus.
COleControl::InvalidateControl	Macht einen Bereich des angezeigten Steuerelements ungültig und wird Neuzeichnen zu werden.
COleControl::InvalidateRgn	Löscht den Clientbereich des Containerfensters innerhalb des angegebenen Bereichs ungültig.Kann verwendet werden, um fensterlose Steuerelemente im Bereich neu zu zeichnen.
COleControl::IsConvertingVBX	Ermöglicht es spezialisierte Laden eines OLE-Steuerelements.
COleControl::IsModified	Bestimmt, ob der Steuerelementzustand geändert hat.
COleControl::IsOptimizedDraw	Gibt an, ob der Container optimierte Zeichnen für den aktuellen Zeichenvorgang unterstützt.
COleControl::IsSubclassedControl	Aufgerufen, um zu ermitteln, ob das Steuerelement ein Windows-Steuerelement als Unterklasse verwendet.
COleControl::Load	Setzt alle vorherigen asynchronen Daten zurück und initiiert eine neue Auslastung der asynchronen Eigenschaft.
COleControl::LockInPlaceActive	Bestimmt, ob das Steuerelement vom Container deaktiviert werden kann.
COleControl::OnAmbientPropertyChange	Aufgerufen, wenn eine Ambient-Eigenschaft geändert wird.
COleControl::OnAppearanceChanged	Aufgerufen, wenn die vordefinierte Darstellungseigenschaft geändert wird.
COleControl::OnBackColorChanged	Aufgerufen, wenn die Bestand BackColor-Eigenschaft geändert wird.
COleControl::OnBorderStyleChanged	Aufgerufen, wenn die Bestand BorderStyle-Eigenschaft geändert wird.
COleControl::OnClick	Aufgerufen, um das Klickereignis vordefinierte auszulösen.
COleControl::OnClose	Benachrichtigt das Steuerelement, dass IOleControl::Close aufgerufen wurde.
COleControl::OnDoVerb	Aufgerufen, nachdem ein Steuerverb ausgeführt wurde.
COleControl::OnDraw	Aufgerufen, wenn ein Steuerelement angefordert wird, sich selbst neu zu entwerfen.
COleControl::OnDrawMetafile	Aufgerufen vom Container, wenn ein Steuerelement angefordert wird, die mit einem Metadateigerätekontexts neu zu zeichnen.
COleControl::OnEdit	Aufgerufen vom Container zu Benutzeroberfläche können Sie ein OLE-Steuerelement.
COleControl::OnEnabledChanged	Aufgerufen, wenn die vordefinierte aktivierte Eigenschaft geändert wird.
COleControl::OnEnumVerbs	Aufgerufen vom Container, um die Verben eines Steuerelements aufzulisten.
COleControl::OnEventAdvise	Aufgerufen, wenn Ereignishandler von einem Steuerelement verbunden oder getrennt werden.
COleControl::OnFontChanged	Aufgerufen, wenn die vordefinierte Schriftarteigenschaft geändert wird.
COleControl::OnForeColorChanged	Aufgerufen, wenn die Bestand ForeColor-Eigenschaft geändert wird.
COleControl::OnFreezeEvents	Aufgerufen, wenn die Ereignisse eines Steuerelements fixiert und seine Fixierung nicht aufgehoben werden.
COleControl::OnGetColorSet	Benachrichtigt das Steuerelement, dass IOleObject::GetColorSet aufgerufen wurde.
COleControl::OnGetControlInfo	Stellt mnemonische Informationen an den Container bereit.
COleControl::OnGetDisplayString	Aufgerufen, erhält eine Zeichenfolge, um eines Eigenschaftswerts darzustellen.
COleControl::OnGetInPlaceMenu	Zeigt das Handle des Steuerelements an, das dem Containermenü zusammengeführt wird.
COleControl::OnGetNaturalExtent	Überschreiben Sie, um die Anzeigengröße des Steuerelements abzurufen am ehesten dem vorgeschlagenen Größen- und Wertebereichsmodus.
COleControl::OnGetPredefinedStrings	EINGABETASTE reiht die Darstellung von möglichen Werten für eine Eigenschaft auf.
COleControl::OnGetPredefinedValue	Gibt den Wert entsprechend einer vordefinierten Zeichenfolge zurück.
COleControl::OnGetViewExtent	Überschreiben Sie, um die Größe der Anzeigebereiche des Steuerelements abzurufen (kann verwendet werden, um in zwei Durchläufenzeichnung) zu aktivieren.
COleControl::OnGetViewRect	Überschreiben Sie, um die Größe des Steuerelements in ein Rechteck zu konvertieren, die an einer bestimmten Position beginnt.
COleControl::OnGetViewStatus	Überschreiben Sie, um das Anzeigen des Steuerelements abzurufen.
COleControl::OnHideToolBars	Aufgerufen vom Container, wenn das Steuerelement deaktiviertes Benutzeroberfläche ist.
COleControl::OnInactiveMouseMove	Überschreibung für das den Container für das inaktive Steuerelement unter den WM_MOUSEMOVE-Mauszeigerdispatch-Meldungen an das Steuerelement.
COleControl::OnInactiveSetCursor	Überschreibung für das den Container für das inaktive Steuerelement unter den WM_SETCURSOR-Mauszeigerdispatch-Meldungen an das Steuerelement.
COleControl::OnKeyDownEvent	Aufgerufen, nachdem das vordefinierte KeyDown-Ereignis ausgelöst wurde.
COleControl::OnKeyPressEvent	Aufgerufen, nachdem das Bestand KeyPress-Ereignis ausgelöst wurde.
COleControl::OnKeyUpEvent	Aufgerufen, nachdem das Bestand KeyUp-Ereignis ausgelöst wurde.
COleControl::OnMapPropertyToPage	Gibt an, das für Bearbeitung verwendeten Eigenschaftenseite, einer Eigenschaft.
COleControl::OnMnemonic	Aufgerufen, wenn eine mnemonische Taste des Steuerelements gedrückt wurde.
COleControl::OnProperties	Aufgerufen, wenn das "Eigenschaft" Verb des Steuerelements aufgerufen wurde.
COleControl::OnQueryHitPoint	Abzufragen Überschreibung ob Anzeigenüberschneidungen eines Steuerelements ein angegebenen Punkt.
COleControl::OnQueryHitRect	Abzufragen Überschreibung, ob die Anzeige eines Steuerelements entweder sich Punkt in einem angegebenen Rechteck schneidet.
COleControl::OnRenderData	Aufgerufen durch das Framework, um Daten im angegebenen Format abzurufen.
COleControl::OnRenderFileData	Aufgerufen durch das Framework, um Daten aus einer Datei im angegebenen Format abzurufen.
COleControl::OnRenderGlobalData	Aufgerufen durch das Framework, um Daten aus dem globalen Arbeitsspeicher im angegebenen Format abzurufen.
COleControl::OnResetState	Setzt die Eigenschaften eines Steuerelements auf die Standardwerte zurück.
COleControl::OnSetClientSite	Benachrichtigt das Steuerelement, dass IOleControl::SetClientSite aufgerufen wurde.
COleControl::OnSetData	Ersetzt die Daten des Steuerelements durch einen anderen Wert.
COleControl::OnSetExtent	Aufgerufen nach dem Wertebereich des Steuerelements hat sich geändert.
COleControl::OnSetObjectRects	Aufgerufen, nachdem die Dimensionen des Steuerelements geändert wurden.
COleControl::OnShowToolBars	Aufgerufen, wenn das Steuerelement Benutzeroberfläche aktiviert war.
COleControl::OnTextChanged	Aufgerufen, wenn die vordefinierte Text- oder Beschriftungseigenschaft geändert wird.
COleControl::OnWindowlessMessage	Prozessfenstermeldungen (außer Maus- und Tastaturmeldungen) für fensterlose Steuerelemente.
COleControl::ParentToClient	Übersetzt einen Punkt relativ zum Ursprung des Containers zu einem Punkt im Verhältnis zu dem Ursprung des Steuerelements.
COleControl::PostModalDialog	Benachrichtigt den Container, dass ein modales Dialogfeld geschlossen wurde.
COleControl::PreModalDialog	Benachrichtigt den Container, dass ein modales Dialogfeld im Begriff ist angezeigt werden.
COleControl::RecreateControlWindow	Zerstört und erstellt das Fenster des Steuerelements neu.
COleControl::Refresh	Erzwingt ein Neu streichung der Darstellung eines Steuerelements.
COleControl::ReleaseCapture	Befreit Mausauswahl.
COleControl::ReleaseDC	Gibt den Anzeigegerätenkontext eines Containers fensterlose eines Steuerelements frei.
COleControl::ReparentControlWindow	Setzt das übergeordnete Element des Steuerfensters zurück.
COleControl::ResetStockProps	Initialisiert COleControl Vorrateigenschaften mit ihren Standardwerten.
COleControl::ResetVersion	Initialisiert die Versionsnummer zu einem angegebenen Wert.
COleControl::ScrollWindow	Ermöglicht einem fensterlose Steuerelement, um einen Bereich innerhalb des direkt aktiven Bilder auf der Anzeige liegen.
COleControl::SelectFontObject	Wählt eine benutzerdefinierte Schriftarteigenschaft in einen Gerätekontext aus.
COleControl::SelectStockFont	Wählt die vordefinierte Schriftarteigenschaft in einen Gerätekontext aus.
COleControl::SerializeExtent	Serialisiert oder initialisiert den Bildbereich für das Steuerelement.
COleControl::SerializeStockProps	Serialisiert oder initialisiert die COleControl Vorrateigenschaften.
COleControl::SerializeVersion	Serialisiert oder initialisiert die Versionsinformationen des Steuerelements.
COleControl::SetAppearance	Legt den Wert der vordefinierten Darstellungseigenschaft fest.
COleControl::SetBackColor	Legt den Wert der vordefinierten BackColor-Eigenschaft fest.
OnStop-Methode	Legt den Wert der vordefinierten BorderStyle-Eigenschaft fest.
COleControl::SetCapture	Veranlasst das Containerfenster des Steuerelements, die Mausauswahl im Namen des Steuerelements in Besitz zu akzeptieren.
COleControl::SetControlSize	Legt die Position und die Größe des OLE-Steuerelements fest.
COleControl::SetEnabled	Legt den Wert der vordefinierten aktivierten Eigenschaft fest.
COleControl::SetFocus	Veranlasst das Containerfenster des Steuerelements, den Eingabefokus im Namen des Steuerelements in Besitz zu akzeptieren.
COleControl::SetFont	Legt den Wert der vordefinierten Schriftarteigenschaft fest.
COleControl::SetForeColor	Legt den Wert der vordefinierten ForeColor-Eigenschaft fest.
COleControl::SetInitialSize	Legt die Größe eines OLE-Steuerelements fest, wenn Sie zuerst in einem Container angezeigt werden.
COleControl::SetModifiedFlag	Ändert den geänderten Zustand eines Steuerelements.
COleControl::SetNotPermitted	Gibt an, dass eine Bearbeitungsanforderung fehlgeschlagen ist.
COleControl::SetNotSupported	Verhindert Änderung auf den Eigenschaftswert eines Steuerelements durch den Benutzer.
COleControl::SetRectInContainer	Legt das Rechteck des Steuerelements relativ zu seinem Container fest.
COleControl::SetText	Legt den Wert der vordefinierten Text- oder Beschriftungseigenschaft fest.
COleControl::ThrowError	signalisiert, dass ein Fehler in einem OLE-Steuerelement aufgetreten ist.
COleControl::TransformCoords	Transformiert Koordinatenwerte zwischen einem Container und dem Steuerelement.
COleControl::TranslateColor	Konvertiert einen Wert OLE_COLOR zu einem COLORREF-Wert.
COleControl::WillAmbientsBeValidDuringLoad	Bestimmt, ob Ambient-Eigenschaften nächsten das Steuerelement wird geladen verfügbar sind.
COleControl::WindowProc	Enthält eine Windows-Prozedur für ein Objekt COleControl vor.

Geschützte Methoden

Name	Description
COleControl::DrawContent	Aufgerufen vom Framework, wenn die Darstellung des Steuerelements aktualisiert werden muss.
COleControl::DrawMetafile	Aufgerufen vom Framework, wenn der Metadateigerätekontext verwendet wird.
COleControl::IsInvokeAllowed	Ermöglicht Automatisierungsmethodenaufruf.
COleControl::SetInitialDataFormats	Aufgerufen vom Framework, um die Liste der Datenformaten zu initialisieren vom Steuerelement unterstützt wird.

Hinweise

Ist von CWnd, erbt diese Klasse die gesamte Funktionalität eines Windows-Fensterobjekts sowie Einzelheiten der zusätzlichen Funktionen zu OLE, wie Auslösen von Ereignissen und der Möglichkeit, Methoden und Eigenschaften zu unterstützen.

OLE-Steuerelemente können sich in OLE-Containeranwendungen eingefügt werden und mit dem Container kommunizieren, indem sie eine bidirektionale System von Auslösen von Ereignissen verwenden und Methoden und Eigenschaften zum Container verfügbar machen.Beachten Sie, dass Standard-OLE-Container nur die grundlegende Funktionalität eines OLE-Steuerelements unterstützen.Sie ist nicht möglich, erweiterte Funktionen eines OLE-Steuerelements zu unterstützen.Auslösen von Ereignissen treten auf, wenn Ereignisse an den Container aufgrund bestimmter Aktionen gesendet werden, die im - Steuerelement stattfinden.Dagegen ist der Container das Steuerelement kommunizieren, indem er einen Satz verfügbar gemachten Methoden abgerufen werden und Eigenschaften, die Memberfunktionen und Datenmember von eine C++-Datei analog sind, Klasse.Dieser Ansatz ermöglicht es dem Entwickler, die Darstellung des Steuerelements zu steuern und den Container zu benachrichtigen, wenn bestimmte Aktionen auftreten.

Fensterlose Steuerelemente

OLE-Steuerelemente können ohne ein Fenster verwendete direkt aktiviertes sein.Fensterlose Steuerelemente weisen erhebliche Vorteile:

Fensterlose Steuerelemente können transparent und nicht-rechteckig sein
Fensterlose Steuerelemente verringern außerdem Erstellungszeit des Objekts

Steuerelemente erfordern kein Fenster.Dienste, die ein Fenster bietet, können über ein einzelnes freigegebenes Fenster (normalerweise den Container) und ein Bit des Weiterleitens des Codes leicht bereitgestellt werden.Ein Fenster zu ändern ist meistens eine unnötige Schwierigkeit auf dem Objekt.

Wenn fensterlose Aktivierung verwendet wird, ist der Container (der ein Fenster hat), zum Bereitstellen von Diensten verantwortlich, die andernfalls vom eigenen Fenster des Steuerelements bereitgestellt worden wären.Wenn das Steuerelement, den Tastaturfokus abfragen, die Mausauswahl abzufragen oder zum Abrufen eines Gerätekontext, diese Vorgänge vom Container verwaltet werden.Der Aufruf COleControlFensterlosVorgang Memberfunktionen diese Vorgänge auf den Container.

Wenn fensterlose Aktivierung aktiviert ist, stellen die Containerdelegat-Eingabemeldungen zu IOleInPlaceObjectWindowless des Steuerelements auf (eine Erweiterung von IOleInPlaceObject für fensterlose Unterstützung).Die COleControl-Implementierung dieser Schnittstelle leitet diese Meldungen durch die Meldungszuordnung des Steuerelements weiter nach, die Mauskoordinaten entsprechend anpassen.Sie können diese Meldungen wie gewöhnliche Fenstermeldungen verarbeiten, indem Sie die entsprechenden Einträgen zur Meldungszuordnung hinzufügen.

In einem fensterlose Steuerelement sollten Sie die COleControl-Memberfunktionen anstelle entsprechender CWnd-Memberfunktionen oder ihrer verwandten Windows-API-Funktionen immer verwenden.

OLE-Steuerelement-Objekte können das Fenster auch erstellen, wenn sie aktiv sind, aber der Arbeitsaufwand, der für den INACTIVEACTIVE-Übergang benötigt wird, wechselt und die Geschwindigkeit des Übergangs wird unten.Es gibt Fälle, wenn dies ein Problem ist: Betrachten Sie als Beispiel ein Raster von Textfeldern.Wenn Cursoring auf ab und über die Spalte, jedes Steuerelement direkt aktiviert werden muss und anschließend deaktiviert.Die Geschwindigkeit des inaktiven/aktiven Übergangs beeinflusst direkt die Bildlaufgeschwindigkeit.

Weitere Informationen über das Entwickeln eines OLE-Steuerelement-Frameworks, finden Sie in Artikel MFC-ActiveX-Steuerelemente und Übersicht: Erstellen eines MFC-ActiveX-Steuerelement-Programms.Informationen zum Optimieren von OLE-Steuerelementen, einschließlich der fensterlose Steuerelemente und flimmerfreien, finden Sie unter MFC-ActiveX-Steuerelemente: Optimierung.