Main Page   Class Hierarchy   Alphabetical List   Compound List   File List   Compound Members

FXMatrix.h

Go to the documentation of this file.
00001 /********************************************************************************
00002 *                                                                               *
00003 *                   M a t r i x   C o n t a i n e r   W i d g e t               *
00004 *                                                                               *
00005 *********************************************************************************
00006 * Copyright (C) 1997,2006 by Jeroen van der Zijp.   All Rights Reserved.        *
00007 *********************************************************************************
00008 * This library is free software; you can redistribute it and/or                 *
00009 * modify it under the terms of the GNU Lesser General Public                    *
00010 * License as published by the Free Software Foundation; either                  *
00011 * version 2.1 of the License, or (at your option) any later version.            *
00012 *                                                                               *
00013 * This library is distributed in the hope that it will be useful,               *
00014 * but WITHOUT ANY WARRANTY; without even the implied warranty of                *
00015 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU             *
00016 * Lesser General Public License for more details.                               *
00017 *                                                                               *
00018 * You should have received a copy of the GNU Lesser General Public              *
00019 * License along with this library; if not, write to the Free Software           *
00020 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA.    *
00021 *********************************************************************************
00022 * $Id: FXMatrix.h,v 1.19 2006/01/22 17:58:06 fox Exp $                          *
00023 ********************************************************************************/
00024 #ifndef FXMATRIX_H
00025 #define FXMATRIX_H
00026 
00027 #ifndef FXPACKER_H
00028 #include "FXPacker.h"
00029 #endif
00030 
00031 namespace FX {
00032 
00033 
00034 /// Matrix packing options
00035 enum {
00036   MATRIX_BY_ROWS        = 0,              /// Fixed number of rows, add columns as needed
00037   MATRIX_BY_COLUMNS     = 0x00020000      /// Fixed number of columns, adding rows as needed
00038   };
00039 
00040 
00041 
00042 /**
00043 * The Matrix layout manager automatically arranges its child windows
00044 * in rows and columns.  If the matrix style is MATRIX_BY_ROWS, then
00045 * the matrix will have the given number of rows and the number of columns
00046 * grows as more child windows are added; if the matrix style is MATRIX_BY_COLUMNS,
00047 * then the number of columns is fixed and the number of rows grows as more children
00048 * are added.
00049 * If all children in a row (column) have the LAYOUT_FILL_ROW (LAYOUT_FILL_COLUMN)
00050 * hint set, then the row (column) will be stretchable as the matrix layout manager
00051 * itself is resized.  If more than one row (column) is stretchable, the space is
00052 * apportioned to each stretchable row (column) proportionally.
00053 * Within each cell of the matrix, all other layout hints are observed.
00054 * For example, a child having LAYOUT_CENTER_Y and LAYOUT_FILL_X hints will
00055 * be centered in the Y-direction, while being stretched in the X-direction.
00056 * Empty cells can be obtained by simply placing a borderless FXFrame widget
00057 * as a space-holder.
00058 */
00059 class FXAPI FXMatrix : public FXPacker {
00060   FXDECLARE(FXMatrix)
00061 protected:
00062   FXint  num;
00063 protected:
00064   FXMatrix(){}
00065 private:
00066   FXMatrix(const FXMatrix&);
00067   FXMatrix &operator=(const FXMatrix&);
00068 public:
00069   long onFocusUp(FXObject*,FXSelector,void*);
00070   long onFocusDown(FXObject*,FXSelector,void*);
00071   long onFocusLeft(FXObject*,FXSelector,void*);
00072   long onFocusRight(FXObject*,FXSelector,void*);
00073 public:
00074 
00075   /// Construct a matrix layout manager with n rows or columns
00076   FXMatrix(FXComposite *p,FXint n=1,FXuint opts=MATRIX_BY_ROWS,FXint x=0,FXint y=0,FXint w=0,FXint h=0,FXint pl=DEFAULT_SPACING,FXint pr=DEFAULT_SPACING,FXint pt=DEFAULT_SPACING,FXint pb=DEFAULT_SPACING,FXint hs=DEFAULT_SPACING,FXint vs=DEFAULT_SPACING);
00077 
00078   /// Perform layout
00079   virtual void layout();
00080 
00081   /// Return default width
00082   virtual FXint getDefaultWidth();
00083 
00084   /// Return default height
00085   virtual FXint getDefaultHeight();
00086 
00087   /// Obtain the child placed at a certain row and column
00088   FXWindow* childAtRowCol(FXint r,FXint c) const;
00089 
00090   /// Return the row in which the given child is placed
00091   FXint rowOfChild(const FXWindow* child) const;
00092 
00093   /// Return the column in which the given child is placed
00094   FXint colOfChild(const FXWindow* child) const;
00095 
00096   /// Change the matrix style
00097   void setMatrixStyle(FXuint ph);
00098 
00099   /// Return the current matrix style
00100   FXuint getMatrixStyle() const;
00101 
00102   /// Change the number of rows
00103   void setNumRows(FXint nr);
00104 
00105   /// Return the number of rows
00106   FXint getNumRows() const;
00107 
00108   /// Change the number of columns
00109   void setNumColumns(FXint nc);
00110 
00111   /// Return the number of columns
00112   FXint getNumColumns() const;
00113   };
00114 
00115 }
00116 
00117 #endif

Copyright © 1997-2005 Jeroen van der Zijp