Classe CRectTracker
Consente di visualizzare, spostare e ridimensionare un elemento in modi diversi.
Sintassi
class CRectTracker
Membri
Costruttori pubblici
| Nome | Descrizione |
|---|---|
| CRectTracker::CRectTracker | Costruisce un oggetto CRectTracker. |
Metodi pubblici
| Nome | Descrizione |
|---|---|
| CRectTracker::AdjustRect | Chiamato quando il rettangolo viene ridimensionato. |
| CRectTracker::D raw | Esegue il rendering del rettangolo. |
| CRectTracker::D rawTrackerRect | Chiamato quando si disegna il bordo di un CRectTracker oggetto . |
| CRectTracker::GetHandleMask | Chiamato per ottenere la maschera degli handle di ridimensionamento di un CRectTracker elemento. |
| CRectTracker::GetTrueRect | Restituisce la larghezza e l'altezza del rettangolo, inclusi i quadratini di ridimensionamento. |
| CRectTracker::HitTest | Restituisce la posizione corrente del cursore correlato all'oggetto CRectTracker . |
| CRectTracker::NormalizeHit | Normalizza un codice di hit test. |
| CRectTracker::OnChangedRectRect | Chiamato quando il rettangolo è stato ridimensionato o spostato. |
| CRectTracker::SetCursor | Imposta il cursore, a seconda della posizione sul rettangolo. |
| CRectTracker::Track | Consente all'utente di modificare il rettangolo. |
| CRectTracker::TrackRubberBand | Consente all'utente di "banda di gomma" la selezione. |
Membri dati pubblici
| Nome | Descrizione |
|---|---|
| CRectTracker::m_nHandleSize | Determina le dimensioni degli handle di ridimensionamento. |
| CRectTracker::m_nStyle | Stili correnti del tracciatore. |
| CRectTracker::m_rect | Posizione corrente (in pixel) del rettangolo. |
| CRectTracker::m_sizeMin | Determina la larghezza e l'altezza minime del rettangolo. |
Osservazioni:
CRectTracker non dispone di una classe di base.
Anche se la CRectTracker classe è progettata per consentire all'utente di interagire con gli elementi OLE tramite un'interfaccia grafica, il relativo utilizzo non è limitato alle applicazioni abilitate per OLE. Può essere usato ovunque sia necessaria un'interfaccia utente di questo tipo.
CRectTracker i bordi possono essere linee a tinta unita o tratteggiata. All'elemento può essere assegnato un bordo tratteggio o sovrapposto con un motivo tratteggio per indicare stati diversi dell'elemento. È possibile posizionare otto quadratini di ridimensionamento sull'esterno o sul bordo interno dell'elemento. Per una spiegazione degli handle di ridimensionamento, vedere GetHandleMask. Infine, un oggetto CRectTracker consente di modificare l'orientamento di un elemento durante il ridimensionamento.
Per usare CRectTracker, costruire un CRectTracker oggetto e specificare gli stati di visualizzazione inizializzati. È quindi possibile usare questa interfaccia per fornire all'utente un feedback visivo sullo stato corrente dell'elemento OLE associato all'oggetto CRectTracker .
Per altre informazioni sull'uso CRectTrackerdi , vedere l'articolo Tracker.
Gerarchia di ereditarietà
CRectTracker
Requisiti
Intestazione: afxext.h
CRectTracker::AdjustRect
Chiamato dal framework quando il rettangolo di rilevamento viene ridimensionato usando un handle di ridimensionamento.
virtual void AdjustRect(
int nHandle,
LPRECT lpRect);
Parametri
nHandle
Indice dell'handle utilizzato.
Lprect
Puntatore alla dimensione corrente del rettangolo. Le dimensioni di un rettangolo sono date in base all'altezza e alla larghezza.
Osservazioni:
Il comportamento predefinito di questa funzione consente di modificare l'orientamento del rettangolo solo quando Track e TrackRubberBand vengono chiamati con l'inversione consentita.
Eseguire l'override di questa funzione per controllare la regolazione del rettangolo di rilevamento durante un'operazione di trascinamento. Un metodo consiste nel regolare le coordinate specificate da lpRect prima della restituzione.
È possibile implementare funzionalità speciali non supportate direttamente da CRectTracker, ad esempio snap-to-grid o keep-aspect-ratio, eseguendo l'override di questa funzione.
CRectTracker::CRectTracker
Crea e inizializza un CRectTracker oggetto .
CRectTracker();
CRectTracker(
LPCRECT lpSrcRect,
UINT nStyle);
Parametri
lpSrcRect
Coordinate dell'oggetto rettangolo.
nStyle
Specifica lo stile dell'oggetto CRectTracker . Sono supportati gli stili seguenti:
CRectTracker::solidLineUsare una linea continua per il bordo del rettangolo.CRectTracker::dottedLineUtilizzare una linea tratteggiata per il bordo del rettangolo.CRectTracker::hatchedBorderUtilizzare un motivo tratteggio per il bordo rettangolo.CRectTracker::resizeInsideRidimensiona gli handle che si trovano all'interno del rettangolo.CRectTracker::resizeOutsideRidimensiona gli handle che si trovano all'esterno del rettangolo.CRectTracker::hatchInsideMotivo tratteggio copre l'intero rettangolo.
Osservazioni:
Il costruttore predefinito inizializza l'oggetto CRectTracker con i valori di lpSrcRect e inizializza le altre dimensioni alle impostazioni predefinite di sistema. Se l'oggetto viene creato senza parametri, i m_rect membri dati e m_nStyle non vengono inizializzati.
CRectTracker::D raw
Chiamare questa funzione per disegnare le linee esterne del rettangolo e l'area interna.
void Draw(CDC* pDC) const;
Parametri
pDC
Puntatore al contesto del dispositivo in cui disegnare.
Osservazioni:
Lo stile del tracciatore determina come viene eseguito il disegno. Per altre informazioni sugli stili disponibili, vedere il costruttore CRectTracker .
CRectTracker::D rawTrackerRect
Chiamato dal framework ogni volta che la posizione del tracker è cambiata all'interno della Track funzione membro o TrackRubberBand .
virtual void DrawTrackerRect(
LPCRECT lpRect,
CWnd* pWndClipTo,
CDC* pDC,
CWnd* pWnd);
Parametri
Lprect
Puntatore all'oggetto RECT contenente il rettangolo da disegnare.
pWndClipTo
Puntatore alla finestra da usare per ritagliare il rettangolo.
pDC
Puntatore al contesto del dispositivo in cui disegnare.
pWnd
Puntatore alla finestra in cui verrà eseguito il disegno.
Osservazioni:
L'implementazione predefinita esegue una chiamata a CDC::DrawFocusRect, che disegna un rettangolo punteggiato.
Eseguire l'override di questa funzione per fornire commenti e suggerimenti diversi durante l'operazione di rilevamento.
CRectTracker::GetHandleMask
Il framework chiama questa funzione membro per recuperare la maschera per gli handle di ridimensionamento di un rettangolo.
virtual UINT GetHandleMask() const;
Valore restituito
Maschera degli handle di ridimensionamento di un CRectTracker elemento.
Osservazioni:
I quadratini di ridimensionamento vengono visualizzati sui lati e sugli angoli del rettangolo e consentono all'utente di controllare la forma e le dimensioni del rettangolo.
Un rettangolo ha 8 handle di ridimensionamento numerati da 0 a 7. Ogni handle di ridimensionamento è rappresentato da un po' nella maschera; il valore di tale bit è 2^ n, dove n è il numero di handle di ridimensionamento. I bit 0-3 corrispondono ai quadratini di ridimensionamento dell'angolo, a partire dall'angolo superiore sinistro in senso orario. I bit da 4 a 7 corrispondono ai quadratini di ridimensionamento laterale a partire dalla parte superiore in senso orario. La figura seguente mostra i quadratini di ridimensionamento di un rettangolo e i relativi valori e numeri di handle di ridimensionamento corrispondenti:
L'implementazione predefinita di GetHandleMask restituisce la maschera dei bit in modo che vengano visualizzati gli handle di ridimensionamento. Se il singolo bit è attivo, verrà disegnato l'handle di ridimensionamento corrispondente.
Eseguire l'override di questa funzione membro per nascondere o visualizzare gli handle di ridimensionamento indicati.
CRectTracker::GetTrueRect
Chiamare questa funzione per recuperare le coordinate del rettangolo.
void GetTrueRect(LPRECT lpTrueRect) const;
Parametri
lpTrueRect
Puntatore alla RECT struttura che conterrà le coordinate del dispositivo dell'oggetto CRectTracker .
Osservazioni:
Le dimensioni del rettangolo includono l'altezza e la larghezza di eventuali quadratini di ridimensionamento posizionati sul bordo esterno. Al momento della restituzione, lpTrueRect è sempre un rettangolo normalizzato nelle coordinate del dispositivo.
CRectTracker::HitTest
Chiamare questa funzione per scoprire se l'utente ha afferrato un handle di ridimensionamento.
int HitTest(CPoint point) const;
Parametri
point
Punto, nelle coordinate del dispositivo, da testare.
Valore restituito
Il valore restituito è basato sul tipo CRectTracker::TrackerHit enumerato e può avere uno dei valori seguenti:
CRectTracker::hitNothing-1CRectTracker::hitTopLeft0CRectTracker::hitTopRight1CRectTracker::hitBottomRight2CRectTracker::hitBottomLeft3CRectTracker::hitTop4CRectTracker::hitRight5CRectTracker::hitBottom6CRectTracker::hitLeft7CRectTracker::hitMiddle8
CRectTracker::m_nHandleSize
Dimensioni, in pixel, degli handle di CRectTracker ridimensionamento.
int m_nHandleSize;
Osservazioni:
Inizializzato con il valore di sistema predefinito.
CRectTracker::m_rect
Posizione corrente del rettangolo nelle coordinate client (pixel).
CRect m_rect;
CRectTracker::m_sizeMin
Dimensione minima del rettangolo.
CSize m_sizeMin;
Osservazioni:
Entrambi i valori predefiniti e cxcy, vengono calcolati dal valore di sistema predefinito per la larghezza del bordo. Questo membro dati viene utilizzato solo dalla AdjustRect funzione membro.
CRectTracker::m_nStyle
Stile corrente del rettangolo.
UINT m_nStyle;
Osservazioni:
Per un elenco di possibili stili, vedere CRectTracker::CRectTracker .
CRectTracker::NormalizeHit
Chiamare questa funzione per convertire un handle potenzialmente invertito.
int NormalizeHit(int nHandle) const;
Parametri
nHandle
Handle selezionato dall'utente.
Valore restituito
Indice dell'handle normalizzato.
Osservazioni:
Quando CRectTracker::Track o CRectTracker::TrackRubberBand viene chiamato con inversione consentita, è possibile che il rettangolo venga invertito sull'asse x, sull'asse y o su entrambi. In questo caso, HitTest restituirà handle che vengono invertiti anche rispetto al rettangolo. Ciò non è appropriato per il feedback del cursore di disegno perché il feedback dipende dalla posizione dello schermo del rettangolo, non dalla parte della struttura di dati del rettangolo che verrà modificata.
CRectTracker::OnChangedRectRect
Chiamato dal framework ogni volta che il rettangolo di rilevamento è cambiato durante una chiamata a Track.
virtual void OnChangedRect(const CRect& rectOld);
Parametri
rectOld
Contiene le coordinate del dispositivo precedenti dell'oggetto CRectTracker .
Osservazioni:
Al momento della chiamata di questa funzione, tutti i feedback estratti con DrawTrackerRect sono stati rimossi. L'implementazione predefinita di questa funzione non esegue alcuna operazione.
Eseguire l'override di questa funzione quando si desidera eseguire qualsiasi azione dopo il ridimensionamento del rettangolo.
CRectTracker::SetCursor
Chiamare questa funzione per modificare la forma del cursore mentre si trova sull'area CRectTracker dell'oggetto.
BOOL SetCursor(
CWnd* pWnd,
UINT nHitTest) const;
Parametri
pWnd
Punta alla finestra che contiene attualmente il cursore.
nHitTest
Risultati dell'hit test precedente, dal messaggio WM_edizione Standard TCURSOR.
Valore restituito
Diverso da zero se l'hit precedente è stato superato il rettangolo di rilevamento; in caso contrario, 0.
Osservazioni:
Chiamare questa funzione dall'interno della funzione della finestra che gestisce il messaggio WM_edizione Standard TCURSOR (in OnSetCursorgenere ).
CRectTracker::Track
Chiamare questa funzione per visualizzare l'interfaccia utente per ridimensionare il rettangolo.
BOOL Track(
CWnd* pWnd,
CPoint point,
BOOL bAllowInvert = FALSE,
CWnd* pWndClipTo = NULL);
Parametri
pWnd
Oggetto finestra contenente il rettangolo.
point
Coordinate del dispositivo della posizione corrente del mouse rispetto all'area client.
bAllowInvert
Se TRUE, il rettangolo può essere invertito lungo l'asse x o l'asse y; altrimenti FAL edizione Standard.
pWndClipTo
Finestra in cui verranno ritagliate le operazioni di disegno. Se NULL, pWnd viene usato come rettangolo di ritaglio.
Valore restituito
Se il tasto ESC viene premuto, il processo di rilevamento viene interrotto, il rettangolo archiviato nel tracciatore non viene modificato e viene restituito 0. Se viene eseguito il commit della modifica, spostando il mouse e rilasciando il pulsante sinistro del mouse, la nuova posizione e/o dimensione viene registrata nel rettangolo del tracker e viene restituito un valore diverso da zero.
Osservazioni:
Questo viene in genere chiamato dall'interno della funzione dell'applicazione che gestisce il WM_LBUTTONDOWN messaggio (in OnLButtonDowngenere ).
Questa funzione acquisisce il mouse finché l'utente non rilascia il pulsante sinistro del mouse, preme ESC o preme il pulsante destro del mouse. Quando l'utente sposta il cursore del mouse, il feedback viene aggiornato chiamando DrawTrackerRect e OnChangedRect.
Se bAllowInvert è TRUE, il rettangolo di rilevamento può essere invertito sull'asse x o sull'asse y.
CRectTracker::TrackRubberBand
Chiamare questa funzione per eseguire la selezione della banda di gomma.
BOOL TrackRubberBand(
CWnd* pWnd,
CPoint point,
BOOL bAllowInvert = TRUE);
Parametri
pWnd
Oggetto finestra contenente il rettangolo.
point
Coordinate del dispositivo della posizione corrente del mouse rispetto all'area client.
bAllowInvert
Se TRUE, il rettangolo può essere invertito lungo l'asse x o l'asse y; altrimenti FAL edizione Standard.
Valore restituito
Diverso da zero se il mouse è stato spostato e il rettangolo non è vuoto; in caso contrario, 0.
Osservazioni:
Viene in genere chiamato dall'interno della funzione dell'applicazione che gestisce il messaggio WM_LBUTTONDOWN (in OnLButtonDowngenere ).
Questa funzione acquisisce il mouse finché l'utente non rilascia il pulsante sinistro del mouse, preme ESC o preme il pulsante destro del mouse. Quando l'utente sposta il cursore del mouse, il feedback viene aggiornato chiamando DrawTrackerRect e OnChangedRect.
Il tracciamento viene eseguito con una selezione di tipo elastico dal quadratino inferiore destro. Se l'inversione è consentita, il rettangolo può essere ridimensionato trascinando verso l'alto e verso sinistra o verso il basso e verso destra.
Vedi anche
MFC Sample TRACKER
MFC Sample DRAWCLI
Grafico della gerarchia
Classe COleResizeBar
Classe CRect
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