layout/tables/BasicTableLayoutStrategy.h

   1 /* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
   2 // vim:cindent:ts=4:et:sw=4:
   3 /* ***** BEGIN LICENSE BLOCK *****
   4  * Version: MPL 1.1/GPL 2.0/LGPL 2.1
   5  *
   6  * The contents of this file are subject to the Mozilla Public License Version
   7  * 1.1 (the "License"); you may not use this file except in compliance with
   8  * the License. You may obtain a copy of the License at
   9  * http://www.mozilla.org/MPL/
  10  *
  11  * Software distributed under the License is distributed on an "AS IS" basis,
  12  * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
  13  * for the specific language governing rights and limitations under the
  14  * License.
  15  *
  16  * The Original Code is Mozilla's table layout code.
  17  *
  18  * The Initial Developer of the Original Code is the Mozilla Foundation.
  19  * Portions created by the Initial Developer are Copyright (C) 2006
  20  * the Initial Developer. All Rights Reserved.
  21  *
  22  * Contributor(s):
  23  *   L. David Baron <dbaron@dbaron.org> (original author)
  24  *
  25  * Alternatively, the contents of this file may be used under the terms of
  26  * either the GNU General Public License Version 2 or later (the "GPL"), or
  27  * the GNU Lesser General Public License Version 2.1 or later (the "LGPL"),
  28  * in which case the provisions of the GPL or the LGPL are applicable instead
  29  * of those above. If you wish to allow use of your version of this file only
  30  * under the terms of either the GPL or the LGPL, and not to allow others to
  31  * use your version of this file under the terms of the MPL, indicate your
  32  * decision by deleting the provisions above and replace them with the notice
  33  * and other provisions required by the GPL or the LGPL. If you do not delete
  34  * the provisions above, a recipient may use your version of this file under
  35  * the terms of any one of the MPL, the GPL or the LGPL.
  36  *
  37  * ***** END LICENSE BLOCK ***** */
  38
  39 /*
  40  * Web-compatible algorithms that determine column and table widths,
  41  * used for CSS2's 'table-layout: auto'.
  42  */
  43
  44 #ifndef BasicTableLayoutStrategy_h_
  45 #define BasicTableLayoutStrategy_h_
  46
  47 #include "nsITableLayoutStrategy.h"
  48
  49 class nsTableFrame;
  50
  51 class BasicTableLayoutStrategy : public nsITableLayoutStrategy
  52 {
  53 public:
  54     BasicTableLayoutStrategy(nsTableFrame *aTableFrame);
  55     virtual ~BasicTableLayoutStrategy();
  56
  57     // nsITableLayoutStrategy implementation
  58     virtual nscoord GetMinWidth(nsIRenderingContext* aRenderingContext);
  59     virtual nscoord GetPrefWidth(nsIRenderingContext* aRenderingContext,
  60                                  PRBool aComputingSize);
  61     virtual void MarkIntrinsicWidthsDirty();
  62     virtual void ComputeColumnWidths(const nsHTMLReflowState& aReflowState);
  63
  64 private:
  65     // NOTE: Using prefix "BTLS" to avoid overlapping names with
  66     // the values of nsLayoutUtils::IntrinsicWidthType
  67     enum BtlsWidthType { BTLS_MIN_WIDTH,
  68                          BTLS_PREF_WIDTH,
  69                          BTLS_FINAL_WIDTH };
  70
  71     // Compute intrinsic width member variables on the columns.
  72     void ComputeColumnIntrinsicWidths(nsIRenderingContext* aRenderingContext);
  73
  74     // Distribute a colspanning cell's percent width (if any) to its columns.
  75     void DistributePctWidthToColumns(float aSpanPrefPct,
  76                                      PRInt32 aFirstCol,
  77                                      PRInt32 aColCount);
  78
  79     // Distribute a width of some BltsWidthType type to a set of columns.
  80     //  aWidth: The amount of width to be distributed
  81     //  aFirstCol: The index (in the table) of the first column to be
  82     //             considered for receiving width
  83     //  aColCount: The number of consecutive columns (starting with aFirstCol)
  84     //             to be considered for receiving width
  85     //  aWidthType: The type of width being distributed.  (BTLS_MIN_WIDTH and
  86     //              BTLS_PREF_WIDTH are intended to be used for dividing up
  87     //              colspan's min & pref width.  BTLS_FINAL_WIDTH is intended
  88     //              to be used for distributing the table's final width across
  89     //              all its columns)
  90     //  aSpanHasSpecifiedWidth: Should be PR_TRUE iff:
  91     //                           - We're distributing a colspanning cell's
  92     //                             pref or min width to its columns
  93     //                           - The colspanning cell has a specified width.
  94     void DistributeWidthToColumns(nscoord aWidth,
  95                                   PRInt32 aFirstCol,
  96                                   PRInt32 aColCount,
  97                                   BtlsWidthType aWidthType,
  98                                   PRBool aSpanHasSpecifiedWidth);
  99
 100
 101     // Compute the min and pref widths of the table from the width
 102     // variables on the columns.
 103     void ComputeIntrinsicWidths(nsIRenderingContext* aRenderingContext);
 104
 105     nsTableFrame *mTableFrame;
 106     nscoord mMinWidth;
 107     nscoord mPrefWidth;
 108     nscoord mPrefWidthPctExpand;
 109     nscoord mLastCalcWidth;
 110 };
 111
 112 #endif /* !defined(BasicTableLayoutStrategy_h_) */