Vcl.OleCtnrs.TOleContainer

De RAD Studio API Documentation
Aller à : navigation, rechercher

Vcl.Controls.TCustomControlVcl.Controls.TWinControlVcl.Controls.TControlSystem.Classes.TComponentSystem.Classes.TPersistentSystem.TObjectTOleContainer

Delphi

TOleContainer = class(TCustomControl, IUnknown, IOleClientSite,
IOleInPlaceSite, IAdviseSink, IOleDocumentSite, IOleUIObjInfo)

C++

class PASCALIMPLEMENTATION TOleContainer : public Vcl::Controls::TCustomControl

Propriétés

Type Visibilité  Source Unité  Parent
class public
Vcl.OleCtnrs.pas
Vcl.OleCtnrs.hpp
Vcl.OleCtnrs Vcl.OleCtnrs

Description

TOleContainer incorpore ou lie des objets OLE.

Utilisez TOleContainer pour gérer la complexité inhérente à OLE 2.0. Avec TOleContainer, il suffit d'un simple appel de la méthode InsertObjectDialog pour donner à l'utilisateur la possibilité de choisir et d'insérer un objet OLE. TOleContainer peut créer un objet OLE incorporé ou lié.

TOleContainer gère automatiquement la fusion de menus combinant le menu de la fiche conteneur à celui de l'application serveur d'un objet OLE activé en mode in-situ. Le paramétrage de la propriété GroupIndex des éléments de menu détermine la fusion. Les éléments de menu principaux qui ont des valeurs pour GroupIndex égales à 0, 2 ou 4 restent inchangés ; TOleContainer fusionne les menus de l'application serveur en remplaçant les éléments de menu principaux qui ont une valeur pour GroupIndex de 1, 3 ou 5 (s'ils ont été définis).

Les objets OLE activés en mode in-situ ajoutent la barre d'outils de leur serveur directement dans la fenêtre de l'application conteneur. Normalement, tous les volets utilisés par les barres d'outils sont remplacés par les barres d'outils de l'objet OLE. Vous pouvez empêcher cela en affectant la valeur true à la propriété Locked d'un volet.

Si vous utilisez un composant TOleContainer dans une application SDI (la propriété FormStyle de la fiche principale a la valeur fsNormal et pas fsMDIForm), vous devez placer le composant TOleContainer à l'intérieur d'un volet dont la propriété Align a la valeur alClient. TOleContainer remplace la barre d'outils d'une fiche SDI de la manière décrite ci-dessus et l'utilisation du volet permet d'ajuster l'espace disponible pour le conteneur OLE.

Voir aussi