OLEUIPASTEENTRYA-Struktur (oledlg.h)

  • Artikel

Ein Array von Einträgen, die in der OLEUIPASTESPECIAL-Struktur für das Dialogfeld Spezial 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 der OLEUIPASTEFLAG-Enumeration . Die Flags geben an, ob der Eintrag nur für das Einfügen, nur für die Verknüpfung oder für das Einfügen und Verknüpfen gültig ist. Wenn der Eintrag für die Verknüpfung gültig ist, geben die Flags an, welche Linktypen akzeptabel sind, indem OR die entsprechenden OLEUIPASTE_LINKTYPEn-Werte zusammengibt.

Syntax

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

Member

fmtetc

Format, das akzeptabel ist. Im Dialogfeld Spezial einfügen wird überprüft, ob dieses Format vom Objekt in der Zwischenablage angeboten wird, und bietet es dem Benutzer zur Auswahl an.

lpstrFormatName

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

lpstrResultText

Zeiger auf die Zeichenfolge, die zum Anpassen des resultierenden Texts des Dialogfelds verwendet wird, wenn der Benutzer das diesem Eintrag entsprechende Format auswählt. Alle %s in dieser Zeichenfolge werden durch den Anwendungsnamen oder FullUserTypeName des Objekts in der Zwischenablage ersetzt. Nur ein %s ist zulässig.

dwFlags

Werte aus der OLEUIPASTEFLAG-Enumeration .

dwScratchSpace

Für Routinen, die eine IEnumFORMATETC-Schleife durchlaufen, um zu markieren, ob das PasteEntry-Format verfügbar ist, verfügbarer Scratch-Speicherplatz. Dieses Feld kann nicht initialisiert werden.

Hinweise

Hinweis

Der oledlg.h-Header definiert OLEUIPASTEENTRY als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code 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
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Kopfzeile oledlg.h

Weitere Informationen

OLEUIPASTEFLAG

OLEUIPASTESPECIAL

OleUIPasteSpecial