Steuerelementeigenschaften

  • Artikel

Zusätzlich zu den Eigenschaften, die vom Steuerelement selbst definiert und implementiert werden, umfasst die ActiveX-Steuerungstechnologie auch Folgendes:

Ambient-Eigenschaften

Diese werden vom Container über einen Steuerungsclientstandort verfügbar gemacht, um Umgebungswerte bereitzustellen, die für alle im Container eingebetteten Steuerelemente gelten. Beispielsweise kann ein Container eine Standardhintergrundfarbe oder eine Standardschriftart bereitstellen, die das Steuerelement verwenden kann. Ambient-Eigenschaften werden über IDispatch verfügbar gemacht, die für das Standortobjekt eines Containers implementiert ist. Der Container ruft die IOleControl::OnAmbientPropertyChange-Methode des Steuerelements auf, wenn sich der Wert seiner Ambient-Eigenschaften ändert. Als Reaktion darauf muss ein Steuerelement möglicherweise seinen eigenen internen oder visuellen Zustand aktualisieren. Der Container gibt an, welche Ambient-Eigenschaft sich mit dem DISPID-Parameter geändert hat, oder kann DISPID_UNKNOWN übergeben, um anzugeben, dass sich mehrere Ambient-Eigenschaften geändert haben.

Erweiterte Eigenschaften

Diese werden tatsächlich von einem Container implementiert, um die enthaltenen Steuerelemente zu umschließen, um containerverwaltete Eigenschaften bereitzustellen, die so aussehen, als ob es sich um native Steuerelementeigenschaften handelt. Der Container kann das Steuerelement aggregieren und die erweiterten Eigenschaften hinzufügen, um die Eigenschaften des Steuerelements zu ergänzen oder zu überschreiben. Das aggregierte Objekt wird als erweitertes Steuerelement bezeichnet. Für den Container wird das erweiterte Steuerelement als das Steuerelement selbst angezeigt, und erweiterte Eigenschaften werden vom Steuerelement verfügbar gemacht. Der Container unterstützt ein erweitertes Steuerelement über seine Clientstandortmethode IOleControlSite::GetExtendedControl. Mit der GetExtendedControl-Methode können Steuerelemente durch die Website zu dem vom Container bereitgestellten erweiterten Steuerelementobjekt navigieren, wenn der Container dieses Feature unterstützt. Ein Container kann auch Eigenschaftenseiten für seine erweiterten Steuerelemente zusätzlich zu den Seiten anzeigen, die ein Steuerelement normalerweise über ISpecifyPropertyPages angeben würde. Aus diesem Grund muss ein Steuerelement einen Container bitten, einen Eigenschaftsrahmen anzuzeigen, bevor das Steuerelement versucht, dies selbst zu tun. Dazu ruft das Steuerelement IOleControlSite::ShowPropertyFrame auf. Wenn der Container diese Funktion implementiert, wird der Eigenschaftenrahmen selbst angezeigt. Wenn die Methode einen Fehler zurückgibt, kann das Steuerelement den Eigenschaftenrahmen anzeigen.

Weitere Informationen finden Sie in den folgenden Themen:

Steuerelementmethoden