OLEMISC-Enumeration (oleidl.h)

  • Artikel

Beschreibt verschiedene Merkmale eines Objekts oder einer Objektklasse. Ein Container kann die IOleObject::GetMiscStatus-Methode aufrufen, um die für ein Objekt festgelegten OLEMISC-Bits zu bestimmen. Die werte, die im CLSID\MiscStatus-Eintrag eines Objektservers in der Registrierungsdatenbank angegeben sind, basieren auf der OLEMISC-Enumeration . Diese Konstanten werden auch im dwStatus-Member der OBJECTDESCRIPTOR-Struktur verwendet.

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;

Konstanten

 
OLEMISC_RECOMPOSEONRESIZE
Wert: 0x1
Wenn der Container die Größe des Platzes ändert, der für die Anzeige eines Objekts zugeordnet ist, versucht das Objekt, die Präsentation neu anzuordnen. Dies bedeutet, dass das Objekt bei der Größenänderung nicht nur sein Bild skalieren möchte. Wenn dieses Bit festgelegt ist, sollte der Container das Objekt in den Ausführungszustand zwingen und IOleObject::SetExtent mit der neuen Größe aufrufen.
OLEMISC_ONLYICONIC
Wert: 0x2
Das Objekt besitzt keine andere nützliche Inhaltsansicht als sein Symbol. Aus Benutzersicht sollte das Kontrollkästchen Als Symbol anzeigen (im Dialogfeld Spezial einfügen ) für dieses Objekt immer aktiviert sein und sollte nicht deaktiviert sein. Beachten Sie, dass ein solches Objekt noch einen zeichnungsfähigen Inhaltsaspekt haben sollte; dies wird genauso aussehen wie seine Symbolansicht.
OLEMISC_INSERTNOTREPLACE
Wert: 0x4
Das Objekt hat sich selbst mit den Daten in der aktuellen Auswahl des Containers initialisiert. Container sollten dieses Bit untersuchen, nachdem sie IOleObject::InitFromData aufgerufen haben, um ein Objekt aus der aktuellen Auswahl zu initialisieren. Wenn er festgelegt ist, sollte der Container das Objekt neben der aktuellen Auswahl einfügen, anstatt die aktuelle Auswahl zu ersetzen. Wenn dieses Bit nicht festgelegt wird, verwendet das Objekt, das eingefügt wird, die aktuelle Auswahl.
OLEMISC_STATIC
Wert: 0x8
Dieses Objekt ist ein statisches Objekt, also ein Objekt, das nur eine Darstellung enthält; es enthält keine systemeigenen Daten. Weitere Informationen finden Sie unter OleCreateStaticFromData.
OLEMISC_CANTLINKINSIDE
Wert: 0x10
Dieses Objekt kann nicht die Linkquelle sein, die das Objekt bei Anbindung aktiviert (ausführt). Wenn das Objekt ausgewählt und in die Zwischenablage kopiert wird, kann der Container des Objekts einen Link in einer Zwischenablagedatenübertragung bereitstellen, die, wenn sie gebunden wird, eine Verbindung außerhalb des Objekts herstellen muss. Der Benutzer Objekt würde das Objekt ausgewählt in seinem Container finden, nicht zum Bearbeiten geöffnet. Anstelle dessen kann der Container es einfach ablehnen, eine Linkquelle anzugeben, wenn Objekte mit diesem Bitsatz übertragen werden. Beispiele von Objekten mit diesem Bit-Satz sind OLE1-Objekte, statische Objekte und Links.
OLEMISC_CANLINKBYOLE1
Wert: 0x20
Auf dieses Objekt kann durch OLE 1-Container verknüpft werden. Dieses Bit wird im dwStatus-Member der OBJECTDESCRIPTOR-Struktur verwendet, die mit den Formaten Object und Link Source Descriptor übertragen wurde. Auf ein Objekt kann durch OLE 1Container verknüpft werden, wenn es ein unbenanntes Dokument, eine Datei oder eine Auswahl von Daten innerhalb einer Datei ist. Eingebettete Objekte oder Pseudoobjekte, die in einem eingebetteten Objekt enthalten sind, können nicht mit OLE 1-Containern verknüpft werden (d. h. OLE 1-Container können keine Verknüpfung mit Linkquellen herstellen, für die bei Bindung mehrere Objektserver ausgeführt werden müssen.
OLEMISC_ISLINKOBJECT
Wert: 0x40
Dieses Objekt ist ein Linkobjekt. Dieses Bit ist signifikant für OLE 1 und wird durch das OLE 2-Linkobjekt festgelegt; Objektanwendungen haben keine Veranlassung, dieses Bit festzulegen.
OLEMISC_INSIDEOUT
Wert: 0x80
Dieses Objekt kann direkt aktivieren und kann ohne Installation von Menüs und Symbolleisten ausgeführt werden. Einige diese Objekte können gleichzeitig aktiv sein. Einige Container, wie Formulare, können diese Objekte automatisch aktivieren.
OLEMISC_ACTIVATEWHENVISIBLE
Wert: 0x100
Dieses Bit wird nur festgelegt, wenn OLEMISC_INSIDEOUT festgelegt ist, und gibt an, dass das Objekt aktiviert werden soll, wenn es sichtbar ist. Einige Container ignorieren möglicherweise immer diesen Hinweis.
OLEMISC_RENDERINGISDEVICEINDEPENDENT
Wert: 0x200
Dieses Objekt reagiert nicht auf Zielgeräte. Die Präsentationsdaten sind in allen Fällen identisch.
OLEMISC_INVISIBLEATRUNTIME
Wert: 0x400
Dieser Wert wird mit Steuerelementen verwendet. Zeigt an, dass das Steuerelement, keine Laufzeit-Benutzeroberfläche hat, aber dass es zur Entwurfszeit sichtbar ist. Beispiel: Ein Zeitgeber-Steuerelement, das ein bestimmtes Ereignis periodisch auslöst, wird nicht selbst zur Laufzeit angezeigt. Es benötigt eine Entwurfszeit-Benutzeroberfläche, damit Ereignispunkt und andere Eigenschaften vom Form-Designer festlegt werden können.
OLEMISC_ALWAYSRUN
Wert: 0x800
Dieser Wert wird mit Steuerelementen verwendet. Es teilt dem Container mit, dass dieses Steuerelement immer ausgeführt werden möchte. Daher sollte der Container oleRun aufrufen, wenn das Objekt geladen oder erstellt wird.
OLEMISC_ACTSLIKEBUTTON
Wert: 0x1000
Dieser Wert wird mit Steuerelementen verwendet. Zeigt an, dass sich das Steuerelement wie eine Schaltfläche verhält, und die Umgebungseigenschaft DisplayAsDefault des Containers versteht.
OLEMISC_ACTSLIKELABEL
Wert: 0x2000
Dieser Wert wird mit Steuerelementen verwendet. Markiert das Steuerelement als eine Bezeichnung für das nachfolgende Steuerelement. Das Drücken einer mnemonischen Taste für ein Bezeichnungssteuerelement aktiviert das nachfolgende Steuerelement.
OLEMISC_NOUIACTIVATE
Wert: 0x4000
Dieser Wert wird mit Steuerelementen verwendet. Es gibt an, dass das Steuerelement über keinen aktiven Benutzeroberflächen-Zustand verfügt, was bedeutet, dass es keine direkten Tools, kein freigegebenes Menü und keine Zugriffstasten erfordert. Dies bedeutet auch, dass das Steuerelement nie den Fokus erfordert.
OLEMISC_ALIGNABLE
Wert: 0x8000
Dieser Wert wird mit Steuerelementen verwendet. Es gibt an, dass das Steuerelement erkennt, wie es sich innerhalb seines Anzeigenrechtecks ausrichtet, entsprechend der Ausrichtungseigenschaften wie links, zentriert und rechts.
OLEMISC_SIMPLEFRAME
Wert: 0x10000
Dieser Wert wird mit Steuerelementen verwendet. Es gibt an, dass das Steuerelement eine einfache Gruppierung weiterer Steuerelemente ist und sich letztlich darauf beschränkt, Windows-Meldungen an den Steuerelementcontainer zu übergeben, der das Formular verwaltet. Steuerelemente dieser Art erfordern die Implementierung von ISimpleFrameSite auf der Website des Containers.
OLEMISC_SETCLIENTSITEFIRST
Wert: 0x20000
Dieser Wert wird mit Steuerelementen verwendet. Es gibt an, dass das Steuerelement IOleObject::SetClientSite als Initialisierungsfunktion verwenden möchte, noch vor einem Aufruf wie IPersistStreamInit::InitNew oder IPersistStorage::InitNew. Dies ermöglicht es dem Steuerelement, auf die AmbientProperties eines Containers zugreifen, bevor Informationen aus dem permanenten Speicher geladen werden. Beachten Sie, dass die aktuellen Implementierungen von OleCreate, OleCreateFromData, OleCreateFromFile, OleLoad und dem Standardhandler diesen Wert nicht verstehen. Steuerelementcontainer, die diesen Wert ehren möchten, müssen ihre eigenen Versionen dieser Funktionen aktuell implementieren, um die richtige Initialisierungssequenz für das Steuerelement festzulegen.
OLEMISC_IMEMODE
Wert: 0x40000
Veraltet. Ein Steuerelement, das mit einer Systemkomponente der Eingabemethode Editor (IME) arbeitet, kann den Zustand des IME über die IMEMode-Eigenschaft steuern, anstatt diesen Wert in der OLEMISC-Enumeration zu verwenden. Sie können eine IME-Komponente verwenden, um Informationen in asiatischen Zeichensätzen mit einer regulären Tastatur einzugeben. Eine japanische IME ermöglicht es Ihnen beispielsweise, auf einer regulären Tastatur ein Wort wie "Sushi" einzugeben, und bei Drücken der Leertaste, konvertiert die IME-Komponente das Wort in die entsprechenden Kanji, oder schlägt eine mögliche Auswahl vor. Der OLEMISC_IMEMODE-Wert wurde zuvor verwendet, um ein Steuerelement zu kennzeichnen, das in der Lage ist, eine IME-Modussystemkomponente zu steuern.
OLEMISC_IGNOREACTIVATEWHENVISIBLE
Wert: 0x80000
Damit neue ActiveX-Steuerelemente in einem älteren Container arbeiten, muss für das Steuerelement der Wert OLEMISC_ACTIVATEWHENVISIBLE festgelegt sein. In einem späteren Container, der IPointerInactive versteht und verwendet, möchte das Steuerelement allerdings nicht direkt aktiviert werden, wenn es sichtbar wird. Um dem Steuerelement die Arbeit in beiden Arten Containern zu ermöglichen, kann das Steuerelement diesen Wert festlegen. Anschließend ignoriert der Container OLEMISC_ACTIVATEWHENVISIBLE und aktiviert das Steuerelement nicht direkt, wenn er angezeigt wird.
OLEMISC_WANTSTOMENUMERGE
Wert: 0x100000
Ein Steuerelement, das das Menü mit seinem Container zusammenführen kann, legt diesen Wert fest.
OLEMISC_SUPPORTSMULTILEVELUNDO
Wert: 0x200000
Ein Steuerelement, das auf Rückgängigmachen auf mehreren Ebenen unterstützt, legt diesen Wert fest.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Kopfzeile oleidl.h

Weitere Informationen

IOleObject::GetMiscStatus

OBJECTDESCRIPTOR