Qt-dokumentasjon.

QTableView-klassen gir en standardmodell / visning implementering av en tabellvisning. Mer.

Egenskaper.

cornerButtonEnabled: bool gridStyle: Qt :: PenStyle showGrid: bool.

sorteringEnabled: bool wordWrap: bool.

16 egenskaper arvet fra QAbstractItemView 3 egenskaper arvet fra QAbstractScrollArea 6 egenskaper arvet fra QFrame 59 egenskaper arvet fra QWidget 1 eiendom arvet fra QObject.

Offentlige funksjoner.

Reimplemented Public Functions.

60 offentlige funksjoner arvet fra QAbstractItemView 20 offentlige funksjoner arvet fra QAbstractScrollArea 14 offentlige funksjoner arvet fra QFrame 214 offentlige funksjoner arvet fra QWidget 32 offentlige funksjoner arvet fra QObject 14 offentlige funksjoner arvet fra QPaintDevice.

Offentlige spor.

9 offentlige slots arvet fra QAbstractItemView 19 offentlige slots arvet fra QWidget 1 offentlige slot arvet fra QObject.

Reimplemented Protected Functions.

37 beskyttede funksjoner arvet fra QAbstractItemView 20 beskyttede funksjoner arvet fra QAbstractScrollArea 4 beskyttede funksjoner arvet fra QFrame 35 beskyttede funksjoner arvet fra QWidget 9 beskyttede funksjoner arvet fra QObject 1 beskyttet funksjon arvet fra QPaintDevice.

Beskyttede spor.

9 beskyttede spor som er arvet fra QAbstractItemView 1 beskyttet spor som er arvet fra QWidget.

Ekstra arvelige medlemmer.

7 signaler arvet fra QAbstractItemView 3-signaler arvet fra QWidget 2-signaler arvet fra QObject 5 statlige offentlige medlemmer arvet fra QWidget 11 statiske offentlige medlemmer arvet fra QObject 37 beskyttede funksjoner arvet fra QAbstractItemView 20 beskyttede funksjoner arvet fra QAbstractScrollArea 4 beskyttede funksjoner arvet fra QFrame 35 beskyttede funksjoner arvet fra QWidget 9 beskyttede funksjoner arvet fra QObject 1 beskyttet funksjon arvet fra QPaintDevice.

Detaljert beskrivelse.

QTableView-klassen gir en standardmodell / visning implementering av en tabellvisning.

En QTableView implementerer en tabellvisning som viser elementer fra en modell. Denne klassen brukes til a gi standard tabeller som tidligere ble oppgitt av QTable-klassen, men ved hjelp av den mer fleksible tiln rmingen som ble gitt av Qts modell / visningsarkitektur.

QTableView implementerer grensesnittene definert av QAbstractItemView-klassen for a tillate det a vise data levert av modeller avledet fra QAbstractItemModel-klassen.

Navigasjon.

Du kan navigere i cellene i tabellen ved a klikke pa en celle med musen, eller ved hjelp av piltastene. Fordi QTableView aktiverer tabKeyNavigation som standard, kan du ogsa trykke pa Tab og Backtab for a flytte fra celle til celle.

Visuell utseende.

Tabellen har en vertikal header som kan oppnas ved hjelp av funksjonen verticalHeader () og en horisontal header som er tilgjengelig gjennom horizontalHeader () -funksjonen. Hoyden pa hver rad i bordet kan bli funnet ved a bruke rowHeight (); Pa samme mate kan bredden pa kolonner bli funnet ved hjelp av columnWidth (). Siden begge disse er enkle widgets, kan du gjemme dem med deres Hide () -funksjoner.

Rader og kolonner kan bli skjult og vist med hideRow (), hideColumn (), showRow () og showColumn (). De kan velges med selectRow () og selectColumn (). Tabellen vil vise et rutenett avhengig av showGrid-egenskapen.

Elementene som vises i en tabellvisning, som de som vises i de andre elementvisningen, blir gjort og redigert ved hjelp av vanlige delegater. Men for enkelte oppgaver er det noen ganger nyttig a kunne sette inn widgets i et bord i stedet. Widgets er angitt for bestemte indekser med setIndexWidget () -funksjonen, og senere hentet med indexWidget ().

Du kan fa cellene til a fylle ledig plass ved a strekke den siste header-delen. Fa tilgang til den aktuelle overskriften ved hjelp av horizontalHeader () eller verticalHeader () og angi topptekstets stretchLastSection-egenskap.

For a distribuere ledig plass i henhold til plassbehovet for hver kolonne eller rad, ring innstillingene til resizeColumnsToContents () eller resizeRowsToContents () -funksjonene.

Koordinatsystemer.

For noen spesialiserte tabeller er det nyttig a kunne konvertere mellom rad og kolonne indekser og widget koordinater. Funksjonen rowAt () gir y-koordinaten innenfor visningen av den angitte raden; radindeksen kan brukes til a oppna en tilsvarende y-koordinat med rowViewportPosition (). Funksjonene columnAt () og columnViewportPosition () gir tilsvarende konverteringsoperasjoner mellom x-koordinater og kolonneindekser.

Eiendomsdokumentasjon.

cornerButtonEnabled: bool.

Denne egenskapen innehar om knappen overst til venstre er aktivert.

Hvis denne egenskapen er sant, er knappen i overste venstre hjorne av tabellvisningen aktivert. Ved a klikke pa denne knappen velges alle cellene i tabellvisningen.

Denne egenskapen er sant som standard.

Denne eiendommen ble introdusert i Qt 4.3.

gridStyle: Qt :: PenStyle.

Denne egenskapen inneholder pennestilen som brukes til a tegne rutenettet.

Denne egenskapen har stilen som brukes nar du tegner rutenettet (se showGrid).

showGrid: bool.

Denne egenskapen gjelder om rutenettet er vist.

Hvis denne egenskapen er sant, trekkes et rutenett for bordet; Hvis eiendommen er feil, blir det ikke tegnet noe. Standardverdien er sann.

sorteringEnabled: bool.

Denne egenskapen inneb rer om sortering er aktivert.

Hvis denne egenskapen er sant, er sortering aktivert for tabellen. Hvis denne egenskapen er feil, er sorteringen ikke aktivert. Standardverdien er feil.

Merk: . Innstilling av egenskapen til sann med setSortingEnabled () utloser umiddelbart et anrop for a sortereByColumn () med gjeldende sorteringsseksjon og rekkefolge.

Denne eiendommen ble introdusert i Qt 4.2.

wordwrap: bool.

Denne egenskapen inneholder ordliste for ordtekst for teksttekst.

Hvis denne egenskapen er sant, blir elementet tekst pakket inn nar det er nodvendig ved ordbrudd; ellers er det ikke pakket inn i det hele tatt. Denne egenskapen er sant som standard.

Legg merke til at selv om innpakning er aktivert, vil cellen ikke bli utvidet for a passe til all tekst. Ellipsis blir satt inn i henhold til gjeldende textElideMode.

Denne eiendommen ble introdusert i Qt 4.3.

Medlemsfunksjon Dokumentasjon.

QTableView :: QTableView (QWidget * foreldre = Q_NULLPTR)

Konstruerer en tabellvisning med en forelder for a representere dataene.

QTableView ::

Odelegger tabellvisningen.

void QTableView :: clearSpans ()

Fjerner alle rader og kolonne spenner i tabellvisningen.

Denne funksjonen ble introdusert i Qt 4.4.

int QTableView :: columnAt (int x) const.

Returnerer kolonnen der den gitte x-koordinaten, x, i innholdskoordinatene er plassert.

Merk: Denne funksjonen returnerer -1 hvis den oppgitte koordinaten ikke er gyldig (har ingen kolonne).

[beskyttet spor] ugyldig QTableView :: columnCountChanged (int oldCount, int newCount)

Dette sporet heter nar kolonner blir lagt til eller slettet. Det forrige antall kolonner er spesifisert av oldCount, og det nye antallet kolonner er spesifisert av newCount.

[beskyttet spor] ugyldig QTableView :: columnMoved (int kolonne, int oldIndex, int newIndex)

Dette sporet kalles for a endre indeksen for den oppgitte kolonnen i tabellvisningen. Den gamle indeksen er spesifisert av oldIndex, og den nye indeksen av newIndex.

[beskyttet spor] ugyldig QTableView :: columnResized (int kolonne, int oldWidth, int newWidth)

Dette sporet kalles for a endre bredden pa den oppgitte kolonnen. Den gamle bredden er spesifisert av oldWidth, og den nye bredden av newWidth.

int QTableView :: columnSpan (int rad, int kolonne) const.

Returnerer kolonnestrekningen til tabellelementet pa (rad, kolonne). Standard er 1.

Denne funksjonen ble introdusert i Qt 4.2.

int QTableView :: columnViewportPosition (int kolonne) const.

Returnerer x-koordinaten i innholdskoordinatene til den oppgitte kolonnen.

int QTableView :: columnWidth (int kolonne) const.

Returnerer bredden pa den oppgitte kolonnen.

[virtuell beskyttet] ugyldig QTableView :: currentChanged (const QModelIndex & current, const QModelIndex & previous)

[slot] void QTableView :: hideColumn (int kolonne)

Skjul den oppgitte kolonnen.

[slot] void QTableView :: hideRow (int rad)

Skjul den oppgitte raden.

QHeaderView * QTableView :: horizontalHeader () const.

Returnerer tabellvisningens horisontale overskrift.

[virtuelt beskyttet] int QTableView :: horizontalOffset () const.

Returnerer den horisontale forskyvningen av elementene i tabellvisningen.

Legg merke til at tabellvisningen bruker posisjonene for den horisontale overskriften for a bestemme posisjonene til kolonnene i visningen.

[virtuell] QModelIndex QTableView :: indexAt (const QPoint og pos) const.

Returnerer indeksposisjonen til modellelementet som svarer til tabellelementet pa posisjon pos i innholdskoordinater.

bool QTableView :: isColumnHidden (int kolonne) const.

Returnerer sant hvis den oppgitte kolonnen er skjult; ellers returnerer false.

[virtuell beskyttet] bool QTableView :: isIndexHidden (const QModelIndex og indeks) const.

bool QTableView :: isRowHidden (int rad) const.

Returnerer sant hvis den gitte rad er skjult; ellers returnerer false.

[virtuelt beskyttet] QModelIndex QTableView :: moveCursor (CursorAction cursorAction, Qt :: KeyboardModifiers modifiers)

Flytter markoren i samsvar med den oppgitte markoren, ved hjelp av informasjonen som er oppgitt av modifikatorene.

[virtuell beskyttet] ugyldig QTableView :: paintEvent (QPaintEvent * -hendelse)

Maler bordet ved mottak av det aktuelle maleventilhendelsen.

[slot] void QTableView :: resizeColumnToContents (int kolonne)

Endrer storrelsen pa den oppgitte kolonnen basert pa storrelsestipsene til delegaten som brukes til a gjengi hvert element i kolonnen.

Merk: Bare synlige kolonner blir endret. Reimplement sizeHintForColumn () for a endre storrelsen pa skjulte kolonner ogsa.

[slot] void QTableView :: resizeColumnsToContents ()

Endrer storrelsen pa alle kolonnene basert pa storrelseshintene til delegaten som brukes til a gjengi hvert element i kolonnene.

[slot] void QTableView :: resizeRowToContents (int rad)

Endrer storrelsen pa den oppgitte raden basert pa storrelsestippene til delegaten som brukes til a gjengi hvert element i raden.

[slot] void QTableView :: resizeRowsToContents ()

Endrer storrelsen pa alle rader basert pa storrelseshintene til delegaten som brukes til a gjengi hvert element i radene.

int QTableView :: rowAt (int y) const.

Returnerer raden der den gitte y-koordinaten, y, i innholdskoordinatene er plassert.

Merk: Denne funksjonen returnerer -1 hvis den oppgitte koordinaten ikke er gyldig (har ingen rad).

[beskyttet spor] ugyldig QTableView :: rowCountChanged (int oldCount, int newCount)

Dette sporet heter nar rader legges til eller slettes. Det forrige antall rader er angitt av oldCount, og det nye antallet rader er spesifisert av newCount.

int QTableView :: rowHeight (int rad) const.

Returnerer hoyden pa den oppgitte raden.

[beskyttet spor] ugyldig QTableView :: rowMoved (int rad, int oldIndex, int newIndex)

Dette sporet kalles for a endre indeksen for den oppgitte raden i tabellvisningen. Den gamle indeksen er spesifisert av oldIndex, og den nye indeksen av newIndex.

[beskyttet spor] ugyldig QTableView :: rowResized (int rad, int oldHeight, int newHeight)

Denne sporet kalles for a endre hoyden pa den oppgitte raden. Den gamle hoyden er spesifisert av oldHeight, og den nye hoyden ved newHeight.

int QTableView :: rowSpan (int rad, int kolonne) const.

Returnerer radspenningen til tabellelementet pa (rad, kolonne). Standard er 1.

Denne funksjonen ble introdusert i Qt 4.2.

int QTableView :: rowViewportPosition (int rad) const.

Returnerer y-koordinaten i innholdskoordinatene til den oppgitte raden.

[slot] void QTableView :: selectColumn (int kolonne)

Velger den oppgitte kolonnen i tabellvisningen hvis den gjeldende SelectionMode og SelectionBehavior tillater at kolonner velges.

[slot] void QTableView :: selectRow (int rad)

Velger den angitte raden i tabellvisningen hvis gjeldende SelectionMode og SelectionBehavior tillater at rader velges.

[virtuelt beskyttet] QModelIndexList QTableView :: selectedIndexes () const.

[virtuelt beskyttet] ugyldig QTableView :: selectionChanged (const QItemSelection & selected, const QItemSelection & deelected)

void QTableView :: setColumnHidden (int kolonne, bool hide)

Hvis skjul er sant, vil den gjeldende kolonnen bli skjult; ellers vil det bli vist.

void QTableView :: setColumnWidth (int kolonne, int bredde)

Angir bredden pa den oppgitte kolonnen for a v re bredde.

Denne funksjonen ble introdusert i Qt 4.1.

void QTableView :: setHorizontalHeader (QHeaderView * header)

Angir widgeten som skal brukes for den horisontale overskriften til topptekst.

[virtuell] ugyldig QTableView :: setModel (QAbstractItemModel * modell)

[virtual] void QTableView :: setRootIndex (const QModelIndex og indeks)

void QTableView :: setRowHeight (int rad, int hoyde)

Setter hoyden pa den oppgitte raden til hoyde.

Denne funksjonen ble introdusert i Qt 4.1.

void QTableView :: setRowHidden (int rad, bool hide)

Hvis skjul er sant rad vil bli skjult, ellers vil det bli vist.

[virtuell beskyttet] ugyldig QTableView :: setSelection (const QRect & rect, QItemSelectionModel :: SelectionFlags flagg)

Velger elementene innenfor den oppgitte rektangul re og i samsvar med de angitte valgflaggene.

[virtuell] ugyldig QTableView :: setSelectionModel (QItemSelectionModel * selectionModel)

void QTableView :: setSortingEnabled (bool enable)

Hvis aktivering er sant, gjor det mulig a sortere for bordet og umiddelbart utlose et anrop for a sortereByColumn () med gjeldende sorteringsseksjon og rekkefolge.

Merk: Setter-funksjon for egenskaps sorteringEnaktivert.

void QTableView :: setSpan (int rad, int kolonne, int rowSpanCount, int columnSpanCount)

Angir spenningen pa tabellelementet ved (rad, kolonne) til antall rader og kolonner som er spesifisert av (radSpanCount, columnSpanCount).

Denne funksjonen ble introdusert i Qt 4.2.

void QTableView :: setVerticalHeader (QHeaderView * header)

Angir widgeten som skal brukes til den vertikale toppteksten.

[slot] void QTableView :: showColumn (int kolonne)

Vis den oppgitte kolonnen.

[slot] void QTableView :: showRow (int rad)

Vis den oppgitte raden.

[virtuell beskyttet] int QTableView :: sizeHintForColumn (int kolonne) const.

Returnerer storrelseshinten for den valgte kolonnens bredde eller -1 hvis det ikke er noen modell.

Hvis du trenger a angi bredden pa en gitt kolonne til en fast verdi, ring QHeaderView :: resizeSection () pa bordets horisontale overskrift.

Hvis du reimplementerer denne funksjonen i en underklasse, merk at verdien du returnerer vil bli brukt nar resizeColumnToContents () eller QHeaderView :: resizeSections () kalles. Hvis en storre kolonnebredde kreves av enten den horisontale overskriften eller elementdelegatet, vil den storre bredden bli brukt i stedet.

[virtuelt beskyttet] int QTableView :: sizeHintForRow (int rad) const.

Returnerer storrelsestipset for den oppgitte radens hoyde eller -1 hvis det ikke er noen modell.

Hvis du ma sette hoyden pa en gitt rad til en fast verdi, ring QHeaderView :: resizeSection () pa bordets vertikale topptekst.

Hvis du reimplementerer denne funksjonen i en underklasse, merk at verdien du returnerer bare brukes nar resizeRowToContents () kalles. I sa fall, hvis en storre radhoyde kreves av enten den vertikale toppteksten eller elementdelegatet, vil denne bredden bli brukt i stedet.

void QTableView :: sortByColumn (int kolonne, Qt :: SortOrder rekkefolge)

Sorterer modellen ved verdiene i den oppgitte kolonnen i den oppgitte rekkefolgen.

Denne funksjonen ble introdusert i Qt 4.2.

[virtuelt beskyttet] ugyldig QTableView :: timerEvent (QTimerEvent * -hendelse)

[virtuelt beskyttet] ugyldig QTableView :: updateGeometries ()

QHeaderView * QTableView :: verticalHeader () const.

Returnerer tabellvisningens vertikale overskrift.

[virtuelt beskyttet] int QTableView :: verticalOffset () const.

Returnerer den vertikale forskyvningen av elementene i tabellvisningen.

Legg merke til at tabellvisningen bruker posisjonene for vertikal topptekst for a bestemme plasseringene av radene i visningen.