WIA_DPS_PAGE_SIZE
La proprietà WIA_DPS_PAGE_SIZE contiene le dimensioni della pagina attualmente selezionata per l'analisi.
Tipo di proprietà: VT_I4
Valori validi: WIA_PROP_LIST
Diritti di accesso: lettura/scrittura
Commenti
Per selezionare le dimensioni della pagina da analizzare, un'applicazione imposta WIA_DPS_PAGE_SIZE. Il minidriver WIA crea e gestisce questa proprietà.
Nella tabella seguente vengono descritte le costanti valide con WIA_IPS_PAGE_SIZE.
| valore | Definizione |
|---|---|
| WIA_PAGE_A4 | Le dimensioni della pagina sono 8267 × 11692 (orientamento VERTICALE). |
| WIA_PAGE_CUSTOM | Le dimensioni della pagina sono definite dai valori delle proprietà WIA_DPS_PAGE_HEIGHT e WIA_DPS_PAGE_WIDTH . |
| WIA_PAGE_LETTER | Le dimensioni della pagina sono pari a 8500 × 11000 (orientamento VERTICALE). |
Il valore della proprietà WIA_IPS_ORIENTATION determina l'orientamento della pagina attualmente selezionata. Le proprietà WIA_DPS_PAGE_WIDTH e WIA_DPS_PAGE_HEIGHT segnalano le dimensioni della pagina, in migliaia di pollici (001). Queste proprietà devono avere valori equivalenti alle proprietà WIA_IPS_XEXTENT e WIA_IPS_YEXTENT , che contengono le dimensioni della pagina, in pixel.
WIA_PROP_LIST valori tipizzati devono dipendere dalle impostazioni valide della proprietà WIA_IPS_ORIENTATION. Se un dispositivo non è in grado di analizzare documenti orientati all'orizzontale con un'impostazione di WIA_PAGE_A4, WIA_PAGE_A4 non deve essere visualizzato nell'elenco di valori validi per la proprietà WIA_DPS_PAGE_SIZE quando WIA_IPS_ORIENTATION è impostato su LANDSCAPE.
Se un'applicazione imposta WIA_DPS_PAGE_SIZE su qualsiasi valore diverso da WIA_PAGE_CUSTOM, il minidriver deve modificare i valori di WIA_DPS_PAGE_WIDTH e WIA_DPS_PAGE_HEIGHT alle dimensioni della pagina, in millesimi di pollice (.001). Il minidriver deve anche modificare i valori di WIA_IPS_XEXTENT e WIA_IPS_YEXTENT alle dimensioni della pagina, in pixel.
Se un'impostazione dell'extent (WIA_IPS_XEXTENT o WIA_IPS_YEXTENT) viene modificata in un valore che non corrisponde all'impostazione delle dimensioni della pagina corrente, il minidriver deve modificare il valore della proprietà WIA_DPS_PAGE_SIZE in WIA_PAGE_CUSTOM. Il minidriver deve anche modificare WIA_DPS_PAGE_WIDTH o WIA_DPS_PAGE_HEIGHT in base all'impostazione del nuovo extent.
Se WIA_IPS_ORIENTATION è impostato su LANDSCAPE, le impostazioni dell'extent verranno "capovolte". Ad esempio, se un'applicazione imposta WIA_DPS_PAGE_SIZE su WIA_PAGE_A4, il minidriver deve impostare WIA_DPS_PAGE_WIDTH su 11692 e WIA_DPS_PAGE_HEIGHT su 8267. Il minidriver deve anche impostare WIA_IPS_XEXTENT e WIA_IPS_YEXTENT di conseguenza. Si noti che se WIA_DPS_PAGE_SIZE è impostato su WIA_PAGE_CUSTOM, l'impostazione dell'orientamento non viene utilizzata per determinare le dimensioni extent della pagina da analizzare.
Il minidriver deve garantire che la proprietà WIA_IPS_ORIENTATION sia d'accordo con l'area di selezione corrente. Se un'applicazione modifica il valore di WIA_IPS_ORIENTATION a uno non valido per le dimensioni della pagina attualmente selezionate, il minidriver deve modificare il valore di WIA_DPS_PAGE_SIZE in una dimensione di pagina supportata dal nuovo valore di orientamento.
Se un'applicazione imposta la proprietà WIA_DPS_PAGE_SIZE su WIA_PAGE_CUSTOM, l'area di selezione corrente non è interessata. Il minidriver WIA deve ottenere il layout dell'immagine corrente, a partire dalle impostazioni correnti delle proprietà WIA_IPS_XPOS e WIA_IPS_YPOS . Se l'impostazione delle dimensioni della pagina determina un'area di selezione esterna al letto dello scanner, il minidriver deve modificare automaticamente i valori della WIA_IPS_XPOS e WIA_IPS_YPOS proprietà in impostazioni valide. Se le proprietà WIA_DPS_PAGE_SIZE e WIA_IPS_ORIENTATION vengono impostate contemporaneamente e non sono valide quando vengono applicate in combinazione, il minidriver deve non riuscire le impostazioni dell'applicazione restituendo un errore nel metodo IWiaMiniDrv::d rvValidateItemProperties .
I quattro esempi di codice seguenti illustrano gli scenari di WIA_DPS_PAGE_SIZE seguenti:
Il driver segnala le impostazioni.
Un'applicazione imposta la proprietà WIA_DPS_PAGE_SIZE su WIA_PAGE_LETTER.
Un'applicazione imposta la proprietà WIA_IPS_ORIENTATION su LANDSCAPE.
Un'applicazione modifica la proprietà WIA_IPS_XEXTENT impostando un valore inferiore.
Esempio 1: il minidriver segnala le impostazioni
Nell'esempio di codice seguente, il minidriver imposta un'area di selezione personalizzata prima che un'applicazione imposti le proprietà WIA. In questo caso, l'area di selezione rappresenta l'intero piano.
WIA_DPS_PAGE_SIZE = WIA_PAGE_CUSTOM WIA_DPS_PAGE_WIDTH = 11500 WIA_DPS_PAGE_HEIGHT = 14000 WIA_IPS_ORIENTATION = PORTRAIT WIA_IPS_XPOS = 0 WIA_IPS_YPOS = 0 WIA_IPS_XEXTENT = 1150 WIA_IPS_YEXTENT = 1400 WIA_IPS_XRES = 100 WIA_IPS_YRES = 100
Esempio 2: un'applicazione imposta la proprietà WIA_DPS_PAGE_SIZE su WIA_PAGE_LETTER
WIA_DPS_PAGE_SIZE = WIA_PAGE_LETTER WIA_DPS_PAGE_WIDTH = 8500 WIA_DPS_PAGE_HEIGHT = 11000 WIA_IPS_ORIENTATION = PORTRAIT WIA_IPS_XPOS = 0 WIA_IPS_YPOS = 0 WIA_IPS_XEXTENT = 850 WIA_IPS_YEXTENT = 1100 WIA_IPS_XRES = 100 WIA_IPS_YRES = 100
Esempio 3: un'applicazione imposta la proprietà WIA_IPS_ORIENTATION su LANDSCAPE
Il letto fisico deve essere in grado di acquisire una pagina originariamente in orientamento orizzontale.
WIA_DPS_PAGE_SIZE = WIA_PAGE_LETTER WIA_DPS_PAGE_HEIGHT = 11000 WIA_DPS_PAGE_WIDTH = 8500 WIA_IPS_ORIENTATION = LANDSCAPE WIA_IPS_XPOS = 0 WIA_IPS_YPOS = 0 WIA_IPS_XEXTENT = 1100 WIA_IPS_YEXTENT = 850 WIA_IPS_XRES = 100 WIA_IPS_YRES = 100
Esempio 4: un'applicazione modifica la proprietà WIA_IPS_XEXTENT in un valore più piccolo
Nell'esempio di codice seguente un'applicazione modifica la proprietà WIA_IPS_XEXTENT su 1000. Il minidriver deve presupporre che il nuovo valore per WIA_IPS_XEXTENT non sia più valido per la proprietà WIA_DPS_PAGE_SIZE e debba quindi modificare WIA_DPS_PAGE_SIZE in WIA_PAGE_CUSTOM. Il minidriver deve anche regolare WIA_DPS_PAGE_WIDTH.
WIA_DPS_PAGE_SIZE = WIA_PAGE_CUSTOM WIA_DPS_PAGE_HEIGHT = 10000 WIA_DPS_PAGE_WIDTH = 8500 WIA_IPS_ORIENTATION = LANDSCAPE WIA_IPS_XPOS = 0 WIA_IPS_YPOS = 0 WIA_IPS_XEXTENT = 1000 WIA_IPS_YEXTENT = 850 WIA_IPS_XRES = 100 WIA_IPS_YRES = 100
Requisiti
Versione: Obsoleto, usare invece la proprietà WIA_IPS_PAGE_SIZE.
Intestazione: wiadef.h (include Wiadef.h)
Vedi anche
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per