Freigeben über


OLEUIPASTEENTRYA-Struktur (oledlg.h)

Ein Array von Einträgen, die im OLEUIPASTESPECIAL- Struktur für das Dialogfeld Inhalte einfügen angegeben werden sollen. Jeder Eintrag enthält eine FORMATTC- Struktur, die die zulässigen Formate angibt, eine Zeichenfolge, die das Format im Listenfeld des Dialogfelds darstellt, eine Zeichenfolge zum Anpassen des Ergebnistexts des Dialogfelds und eine Reihe von Flags aus dem OLEUIPASTEFLAG Enumeration. Die Kennzeichnungen geben an, ob der Eintrag nur für das Einfügen gültig ist, nur verknüpfungen oder sowohl Einfügen als auch Verknüpfen. Wenn der Eintrag für die Verknüpfung gültig ist, geben die Flags an, welche Verknüpfungstypen zulässig sind, indem sie die entsprechenden OLEUIPASTE_LINKTYPEn Werte zusammenfügen.

Syntax

typedef struct tagOLEUIPASTEENTRYA {
  FORMATETC fmtetc;
  LPCSTR    lpstrFormatName;
  LPCSTR    lpstrResultText;
  DWORD     dwFlags;
  DWORD     dwScratchSpace;
} OLEUIPASTEENTRYA, *POLEUIPASTEENTRYA, *LPOLEUIPASTEENTRYA;

Angehörige

fmtetc

Format, das akzeptabel ist. Das Dialogfeld "Inhalte einfügen" überprüft, ob dieses Format vom Objekt in der Zwischenablage angeboten wird und wenn ja, wird es dem Benutzer zur Auswahl angeboten.

lpstrFormatName

Zeigen Sie auf die Zeichenfolge, die das Format für den Benutzer darstellt. Jede %s in dieser Zeichenfolge wird durch den FullUserTypeName des Objekts in der Zwischenablage ersetzt, und die resultierende Zeichenfolge wird im Listenfeld des Dialogfelds platziert. Es ist nur ein %s zulässig. Das Vorhandensein oder Fehlen von %s gibt an, ob der Ergebnistext angibt, dass Daten eingefügt werden oder ob ein Objekt, das von einer Anwendung aktiviert werden kann, eingefügt wird. Wenn %s vorhanden ist, gibt der resultierende Text an, dass ein Objekt eingefügt wird. Andernfalls wird angegeben, dass Daten eingefügt werden.

lpstrResultText

Zeigen Sie auf die Zeichenfolge, die zum Anpassen des resultierenden Texts des Dialogfelds verwendet wird, wenn der Benutzer das format auswählt, das diesem Eintrag entspricht. Jede %s in dieser Zeichenfolge wird durch den Anwendungsnamen oder Den FullUserTypeName des Objekts in der Zwischenablage ersetzt. Es ist nur ein %s zulässig.

dwFlags

Werte aus OLEUIPASTEFLAG Enumeration.

dwScratchSpace

Scratch space available to routines that loop through an IEnumFORMATETC to mark if the PasteEntry format is available. Dieses Feld kann nicht initialisiert werden.

Bemerkungen

Anmerkung

Der oledlg.h-Header definiert OLEUIPASTEENTRY als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server- Windows 2000 Server [nur Desktop-Apps]
Header- oledlg.h

Siehe auch

OLEUIPASTEFLAG-

OLEUIPASTESPECIAL

OleUIPasteSpecial-