Struttura OLEUIPASTESPECIALA (oledlg.h)

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

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;

Members

cbStruct

Dimensioni della struttura, in byte. Questo membro deve essere compilato in input.

dwFlags

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

hWndOwner

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

lpszCaption

Puntatore a una stringa da utilizzare 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 nella procedura 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 di 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 risorsa per il modello di finestra di dialogo che deve essere sostituito per il modello di finestra di dialogo Incolla speciale della libreria.

hResource

Handle modello personalizzato.

lpSrcDataObj

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

arrPasteEntries

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

cPasteEntries

Numero di voci della matrice OLEUIPASTEENTRY . Questo membro viene compilato in input.

arrLinkTypes

Elenco di tipi di collegamento accettabili. I tipi di collegamento vengono definiti usando OLEUIPASTEFLAG in arrPasteEntries. Questo membro viene compilato in input.

cLinkTypes

Numero di tipi di collegamento. Questo membro viene compilato in input.

cClsidExclude

Numero di CLSID in lpClsidExclude. Questo membro viene compilato in 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 sul collegamento incolla. Un'applicazione può impedire l'incorporamento in se stessa elencando il proprio CLSID in questo elenco. Questo campo viene riempito in 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

Gestire il metafile contenente l'icona e il titolo dell'icona selezionati dall'utente. Questo membro viene compilato nell'output.

sizel

Dimensione dell'oggetto visualizzato nell'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 dall'oggetto ObjectDescriptor se fLink è FALSE e dal LinkSrcDescriptor se fLink è TRUE. Questo membro viene compilato nell'output.

Commenti

Requisiti

Vedi anche

OLEUIPASTEENTRY

OLEUIPASTEFLAG

OleUIPasteSpecial