比例框架 Aspect Frames

比例框架控件(The aspect frame widget)和框架控件(frame widget)差不多，除了它还会使子控件的外观比例（也就是宽和高的比例）保持一定值，如果需要，还会在控件中增加额外的可用空间。这很有用，例如，想预览一个大的图片。当用户改变窗口的尺寸时，预览器的尺寸应该随之改变，但是外观比例要与原来图片的尺寸保持一致。

用下面的函数创建一个新的比例框架：

GtkWidget *gtk_aspect_frame_new( const gchar *label,
                                 gfloat       xalign,
                                 gfloat       yalign,
                                 gfloat       ratio,
                                 gboolean     obey_child);

参数:

• xalign和yalign参数的作用和创建对齐控件(Alignment widgets)时的一样。
• obey_child
  该参数设置为 TRUE，子控件的长宽比例会和它所请求的理想长宽比例相匹配。否则，比例值由ratio参数指定。

用以下函数可以改变已有比例框架控件的选项：

void gtk_aspect_frame_set( GtkAspectFrame *aspect_frame,
                           gfloat          xalign,
                           gfloat          yalign,
                           gfloat          ratio,
                           gboolean        obey_child);

示例

效果

源码

在下面的示例中，程序用一个比例框架控件显示一个绘图区，纵横比例总是 2:1，而不管用户如何改变顶级窗口的尺寸。

#include <gtk/gtk.h>

int main( int argc,
          char *argv[] )
{
    GtkWidget *window;
    GtkWidget *aspect_frame;
    GtkWidget *drawing_area;
    gtk_init (&argc, &argv);

    window = gtk_window_new (GTK_WINDOW_TOPLEVEL);
    gtk_window_set_title (GTK_WINDOW (window), "www.softool.cn - Aspect Frame");
    g_signal_connect (G_OBJECT (window), "destroy",
                            G_CALLBACK (gtk_main_quit), NULL);
    gtk_container_set_border_width (GTK_CONTAINER (window), 10);

    /* 创建一个比例框架，将它添加到顶级窗口中 */
    aspect_frame = gtk_aspect_frame_new ("2x1", /* 标签 */
                                             0.5, /* center x */
                                             0.5, /* center y */
                                             2,        /* xsize/ysize = 2 */
                                             FALSE /* ignore child's aspect */);

    gtk_container_add (GTK_CONTAINER (window), aspect_frame);
    gtk_widget_show (aspect_frame);

    /* 添加一个子构件到比例框架中 */
    drawing_area = gtk_drawing_area_new ();

    /* 要求一个200×200的窗口，但是比例框架会给出一个200×100
     * 的窗口，因为我们已经指定了2×1的比例值 */
    gtk_widget_set_size_request (drawing_area, 200, 200);
    gtk_container_add (GTK_CONTAINER (aspect_frame), drawing_area);
    gtk_widget_show (drawing_area);

    gtk_widget_show (window);
    gtk_main ();
    return 0;
}