Struttura OLEUIPASTESPECIALA (oledlg.h)

Contiene informazioni utilizzate dalla libreria dell'interfaccia utente OLE per inizializzare la finestra di dialogo Incolla speciale , nonché spazio per la raccolta per restituire informazioni quando la finestra di dialogo viene chiusa.

Sintassi

typedef struct tagOLEUIPASTESPECIALA {
  DWORD              cbStruct;
  DWORD              dwFlags;
  HWND               hWndOwner;
  LPCSTR             lpszCaption;
  LPFNOLEUIHOOK      lpfnHook;
  LPARAM             lCustData;
  HINSTANCE          hInstance;
  LPCSTR             lpszTemplate;
  HRSRC              hResource;
  LPDATAOBJECT       lpSrcDataObj;
  LPOLEUIPASTEENTRYA arrPasteEntries;
  int                cPasteEntries;
  UINT               *arrLinkTypes;
  int                cLinkTypes;
  UINT               cClsidExclude;
  LPCLSID            lpClsidExclude;
  int                nSelectedIndex;
  BOOL               fLink;
  HGLOBAL            hMetaPict;
  SIZEL              sizel;
} OLEUIPASTESPECIALA, *POLEUIPASTESPECIALA, *LPOLEUIPASTESPECIALA;

Membri

cbStruct

Dimensione della struttura, in byte. Questo membro deve essere compilato nell'input.

dwFlags

In caso di input, dwFlags specifica i flag di inizializzazione e creazione. All'uscita, specifica le scelte dell'utente. Può trattarsi di una combinazione dei flag seguenti.

hWndOwner

Finestra proprietaria della finestra di dialogo. Questo membro non deve essere NULL.

lpszCaption

Puntatore a una stringa da usare come titolo della finestra di dialogo. Se NULL , la libreria usa Incolla speciale.

lpfnHook

Puntatore a una funzione hook che elabora i messaggi destinati alla finestra di dialogo. La funzione hook deve restituire zero per passare un messaggio che non è stato elaborato di nuovo alla routine della finestra di dialogo nella libreria. La funzione hook deve restituire un valore diverso da zero per impedire alla routine della finestra di dialogo della libreria di elaborare un messaggio già elaborato.

lCustData

Dati definiti dall'applicazione che la libreria passa alla funzione hook a cui punta il membro lpfnHook. La libreria passa un puntatore alla struttura OLEUIPASTESPECIAL nel parametro lParam del messaggio WM_INITDIALOG; questo puntatore può essere usato per recuperare il membro lCustData.

hInstance

Istanza che contiene un modello di finestra di dialogo specificato dal membro lpTemplateName.

lpszTemplate

Puntatore a una stringa con terminazione Null che specifica il nome del file di risorse per il modello della finestra di dialogo da sostituire con il modello di finestra di dialogo Incolla speciale della libreria.

hResource

Handle di modello personalizzato.

lpSrcDataObj

Puntatore all'interfaccia IDataObject dell'oggetto dati da incollare (dagli Appunti). Questo membro viene compilato in base all'input. Se lpSrcDataObj è NULL quando viene chiamato OleUIPasteSpecial, OleUIPasteSpecial tenterà di recuperare un puntatore a un IDataObject dagli Appunti. Se oleUIPasteSpecial ha esito positivo, è responsabilità del chiamante liberare il IDataObject restituito in lpSrcDataObj.

arrPasteEntries

Matrice OLEUIPASTEENTRY che specifica formati accettabili. Questo membro viene compilato in base all'input.

cPasteEntries

Numero di voci di matrice OLEUIPASTEENTRY. Questo membro viene compilato in base all'input.

arrLinkTypes

Elenco di tipi di collegamento accettabili. I tipi di collegamento vengono indicati usando OLEUIPASTEFLAG in arrPasteEntries. Questo membro viene compilato in base all'input.

cLinkTypes

Numero di tipi di collegamento. Questo membro viene compilato in base all'input.

cClsidExclude

Numero di CLSID in lpClsidExclude. Questo membro viene compilato in base all'input.

lpClsidExclude

Puntatore a una matrice di CLSID da escludere dall'elenco di oggetti server disponibili per un'operazione Incolla. Si noti che questo non influisce Incolla collegamento. Un'applicazione può impedire l'incorporamento in se stesso elencando il proprio CLSID in questo elenco. Questo campo viene compilato in base all'input.

nSelectedIndex

Indice di arrPasteEntries selezionato dall'utente. Questo membro viene compilato nell'output.

fLink

Se Incolla o Incolla collegamento è stato selezionato dall'utente. Questo membro viene compilato nell'output.

hMetaPict

Handle nel Metafile contenente l'icona e il titolo dell'icona selezionati dall'utente. Questo membro viene compilato nell'output.

sizel

Dimensione dell'oggetto visualizzato nella relativa origine, se l'aspetto visualizzato scelto dall'utente corrisponde all'aspetto visualizzato nell'origine. Se l'utente sceglie un aspetto diverso, sizel.cx e sizel.cy sono entrambi impostati su zero. Le dimensioni dell'oggetto visualizzato nell'origine vengono recuperate dal ObjectDescriptor se fLink è false e dal LinkSrcDescriptor se fLink è TRUE. Questo membro viene compilato nell'output.

Osservazioni

Fabbisogno

Vedere anche

OLEUIPASTEENTRY

OLEUIPASTEFLAG

OleUIPasteSpecial