Énumération OLEMISC (oleidl.h)

  • Article

Décrit les caractéristiques diverses d’un objet ou d’une classe d’objets. Un conteneur peut appeler la méthode IOleObject ::GetMiscStatus pour déterminer les bits OLEMISC définis pour un objet. Les valeurs spécifiées dans l’entrée CLSID\MiscStatus d’un serveur d’objets dans la base de données d’inscription sont basées sur l’énumération OLEMISC . Ces constantes sont également utilisées dans le membre dwStatus de la structure OBJECTDESCRIPTOR .

Syntax

typedef enum tagOLEMISC {
  OLEMISC_RECOMPOSEONRESIZE = 0x1,
  OLEMISC_ONLYICONIC = 0x2,
  OLEMISC_INSERTNOTREPLACE = 0x4,
  OLEMISC_STATIC = 0x8,
  OLEMISC_CANTLINKINSIDE = 0x10,
  OLEMISC_CANLINKBYOLE1 = 0x20,
  OLEMISC_ISLINKOBJECT = 0x40,
  OLEMISC_INSIDEOUT = 0x80,
  OLEMISC_ACTIVATEWHENVISIBLE = 0x100,
  OLEMISC_RENDERINGISDEVICEINDEPENDENT = 0x200,
  OLEMISC_INVISIBLEATRUNTIME = 0x400,
  OLEMISC_ALWAYSRUN = 0x800,
  OLEMISC_ACTSLIKEBUTTON = 0x1000,
  OLEMISC_ACTSLIKELABEL = 0x2000,
  OLEMISC_NOUIACTIVATE = 0x4000,
  OLEMISC_ALIGNABLE = 0x8000,
  OLEMISC_SIMPLEFRAME = 0x10000,
  OLEMISC_SETCLIENTSITEFIRST = 0x20000,
  OLEMISC_IMEMODE = 0x40000,
  OLEMISC_IGNOREACTIVATEWHENVISIBLE = 0x80000,
  OLEMISC_WANTSTOMENUMERGE = 0x100000,
  OLEMISC_SUPPORTSMULTILEVELUNDO = 0x200000
} OLEMISC;

Constantes

 
OLEMISC_RECOMPOSEONRESIZE
Valeur : 0x1
Lorsque le conteneur redimensionne l'espace alloué pour afficher une des présentations de l'objet, l'objet souhaite recomposer la présentation. Cela signifie qu'au moment du redimensionnement, l'objet souhaite effectuer plus que de mettre l'image à l'échelle. Si ce bit est défini, le conteneur doit forcer l’objet à l’état en cours d’exécution et appeler IOleObject ::SetExtent avec la nouvelle taille.
OLEMISC_ONLYICONIC
Valeur : 0x2
L'objet n'a pas d'affichage du contenu utile autre que son icône. Du point de vue de l’utilisateur, la zone Afficher l’icône case activée (dans la boîte de dialogue Coller spécial) pour cet objet doit toujours être cochée et ne doit pas être décochée. Notez qu'un tel objet doit toujours avoir un aspect de contenu qui peut être dessiné ; il doit avoir le même aspect qu'en mode Icône.
OLEMISC_INSERTNOTREPLACE
Valeur : 0x4
L'objet s'est initialisé à partir des données dans la sélection actuelle du conteneur. Les conteneurs doivent examiner ce bit après avoir appelé IOleObject ::InitFromData pour initialiser un objet à partir de la sélection actuelle. Si ce paramètre est défini, le conteneur doit insérer l'objet à côté de la sélection actuelle au lieu de remplacer cette dernière. Si ce bit n'est pas défini, l'objet qui est inséré remplace la sélection actuelle.
OLEMISC_STATIC
Valeur : 0x8
Cet objet est un objet statique, c'est-à-dire un objet qui contient uniquement une présentation. Il ne contient aucune donnée native. Consultez OleCreateStaticFromData.
OLEMISC_CANTLINKINSIDE
Valeur : 0x10
Cet objet ne peut pas être la source de liaison qui, lorsqu'elle est liée, active (exécute) l'objet. Si l'objet est sélectionné et copié dans le Presse-papiers, le conteneur de l'objet peut proposer un lien dans un transfert de données du Presse-papiers qui, une fois lié, doit se connecter à l'extérieur de l'objet. L'utilisateur verrait l'objet sélectionné dans son conteneur, non ouvert pour la modification. Plutôt que de procéder de la sorte, le conteneur peut simplement refuser d'offrir une source de liaison en transférant des objets avec cet ensemble de bits. Exemples d'objets qui ont ce bit défini, y compris les objets OLE1, les objets statiques, et les liens.
OLEMISC_CANLINKBYOLE1
Valeur : 0x20
Cet objet peut être lié par des conteneurs OLE 1. Ce bit est utilisé dans le membre dwStatus de la structure OBJECTDESCRIPTOR transféré avec les formats Descriptor Object et Link Source Descriptor. Les conteneurs OLE 1 peuvent établir une liaison avec un objet s'il s'agit d'un document sans titre, d'un fichier ou d'une sélection de données dans un fichier. Les objets incorporés ou pseudo-objets contenus dans un objet incorporé ne peuvent pas être liés par des conteneurs OLE 1 (c’est-à-dire, les conteneurs OLE 1 ne peuvent pas lier à des sources de liaison qui, lorsqu’ils sont liés, nécessitent l’exécution de plusieurs serveurs d’objets.
OLEMISC_ISLINKOBJECT
Valeur : 0x40
Cet objet est un objet de liaison. Ce bit est propre à OLE 1 et est défini par l'objet de lien OLE 2 ; les applications d'objets n'ont pas besoin de le définir.
OLEMISC_INSIDEOUT
Valeur : 0x80
Cet objet est capable d'effectuer une activation sur place, sans nécessiter l'installation et l'exécution de menus et de barres d'outils. Plusieurs de ces objets peuvent être actifs simultanément. Certains conteneurs, tels que les formulaires, peuvent choisir d'activer ces objets automatiquement.
OLEMISC_ACTIVATEWHENVISIBLE
Valeur : 0x100
Ce bit est défini uniquement lorsque OLEMISC_INSIDEOUT est défini, et indique que cet objet préfère être activé chaque fois qu'il est visible. Certains conteneurs peuvent toujours ignorer cet indicateur.
OLEMISC_RENDERINGISDEVICEINDEPENDENT
Valeur : 0x200
Cet objet ne prête pas attention aux appareils cibles. Ses données de présentation seront les mêmes dans tous les cas.
OLEMISC_INVISIBLEATRUNTIME
Valeur : 0x400
Cette valeur est utilisée avec les contrôles. Il indique que le contrôle n'a pas d'interface utilisateur au moment de l'exécution, mais qu'il doit être visible au moment du design. Par exemple, un contrôle Timer qui génère régulièrement un événement spécifique ne se déclenche pas au moment de l'exécution. Une interface utilisateur au moment du design lui est nécessaire pour permettre à un Concepteur de formulaires de définir la période d'événements et d'autres propriétés.
OLEMISC_ALWAYSRUN
Valeur : 0x800
Cette valeur est utilisée avec les contrôles. Elle indique au conteneur que ce contrôle souhaite toujours s'exécuter. Par conséquent, le conteneur doit appeler OleRun lors du chargement ou de la création de l’objet.
OLEMISC_ACTSLIKEBUTTON
Valeur : 0x1000
Cette valeur est utilisée avec les contrôles. Il indique que le contrôle est de type bouton, car il comprend et obéit à la propriété ambiante DisplayAsDefault du conteneur.
OLEMISC_ACTSLIKELABEL
Valeur : 0x2000
Cette valeur est utilisée avec les contrôles. Marque le contrôle comme une étiquette pour le contrôle qui vient après lui dans l'ordre des contrôles de la feuille. Si vous appuyez sur une touche mnémonique pour un contrôle label, le contrôle situé après lui est activé.
OLEMISC_NOUIACTIVATE
Valeur : 0x4000
Cette valeur est utilisée avec les contrôles. Elle indique que le contrôle n'a aucun état actif d'interface utilisateur, ce qui signifie qu'il ne requiert aucun outil sur place, aucun menu partagé et aucun accélérateur. Cela signifie également que le contrôle n'a jamais besoin du focus.
OLEMISC_ALIGNABLE
Valeur : 0x8000
Cette valeur est utilisée avec les contrôles. Elle indique que le contrôle comprend comment s'aligner dans son rectangle d'affichage, selon les propriétés d'alignement telles que la gauche, le centre et la droite.
OLEMISC_SIMPLEFRAME
Valeur : 0x10000
Cette valeur est utilisée avec les contrôles. Elle indique que le contrôle est un regroupement simple d'autres contrôles et ne fait rien de plus que de passer les messages Windows au conteneur de contrôles gérant le formulaire. Les contrôles de ce type nécessitent l’implémentation d’ISimpleFrameSite sur le site du conteneur.
OLEMISC_SETCLIENTSITEFIRST
Valeur : 0x20000
Cette valeur est utilisée avec les contrôles. Cela indique que le contrôle souhaite utiliser IOleObject ::SetClientSite comme fonction d’initialisation, même avant un appel tel que IPersistStreamInit ::InitNew ou IPersistStorage ::InitNew. Cela permet au contrôle d'accéder aux propriétés ambiantes d'un conteneur avant de charger des informations à partir d'un stockage persistant. Notez que les implémentations actuelles d’OleCreate, OleCreateFromData, OleCreateFromFile, OleLoad et le gestionnaire par défaut ne comprennent pas cette valeur. Les conteneurs de contrôle qui souhaitent honorer cette valeur doivent implémenter actuellement leurs propres versions de ces fonctions pour générer la séquence correcte d'initialisation pour le contrôle.
OLEMISC_IMEMODE
Valeur : 0x40000
Obsolète. Un contrôle qui fonctionne avec un composant système IME (Input Method Rédacteur) peut contrôler l’état de l’IME via la propriété IMEMode plutôt que d’utiliser cette valeur dans l’énumération OLEMISC. Vous pouvez utiliser un composant IME pour entrer des informations dans les jeux de caractères asiatiques avec un clavier normal. Un éditeur IME japonais, par exemple, vous permet de taper un mot tel que « sushi » sur un clavier normal, et lorsque vous appuyez sur la barre d'espace, le composant IME convertit ce mot en caractère kanji approprié ou propose des options possibles. Valeur OLEMISC_IMEMODE précédemment utilisée pour indiquer qu'un contrôle peut vérifier un composant système de mode IME.
OLEMISC_IGNOREACTIVATEWHENVISIBLE
Valeur : 0x80000
Pour que les nouveaux contrôles ActiveX s'exécutent dans un conteneur antérieur, il faut attribuer à la valeur OLEMISC_ACTIVATEWHENVISIBLE au contrôle. Toutefois, dans un conteneur plus récent qui comprend et utilise IPointerInactive, le contrôle ne souhaite pas être activé sur place lorsqu'il devient visible. Pour permettre au contrôle de travailler dans les deux types de conteneurs, le contrôle peut définir cette valeur. Ensuite, le conteneur ignore OLEMISC_ACTIVATEWHENVISIBLE et n'active pas sur place le contrôle lorsqu'il devient visible.
OLEMISC_WANTSTOMENUMERGE
Valeur : 0x100000
Un contrôle qui peut fusionner son menu avec son conteneur définit cette valeur.
OLEMISC_SUPPORTSMULTILEVELUNDO
Valeur : 0x200000
Un contrôle qui prend en charge l'annulation sur plusieurs niveaux définit cette valeur.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
En-tête oleidl.h

Voir aussi

IOleObject ::GetMiscStatus

OBJECTDESCRIPTOR