From 5a3442bf9c470736c8846534607be5825c22410b Mon Sep 17 00:00:00 2001
From: Matthias Clasen <mclasen@redhat.com>
Date: Mon, 6 Aug 2012 22:26:13 -0400
Subject: [PATCH] Improve GtkMenuButton menu positioning

Take the menu halign/valign into consideration when positioning
the menu. Also, document the various combinations.

https://bugzilla.gnome.org/show_bug.cgi?id=680988
---
 docs/reference/gtk/Makefile.am             |  14 +-
 docs/reference/gtk/images/down-center.png  | Bin 0 -> 2194 bytes
 docs/reference/gtk/images/down-end.png     | Bin 0 -> 2170 bytes
 docs/reference/gtk/images/down-start.png   | Bin 0 -> 2177 bytes
 docs/reference/gtk/images/left-center.png  | Bin 0 -> 2234 bytes
 docs/reference/gtk/images/left-end.png     | Bin 0 -> 2196 bytes
 docs/reference/gtk/images/left-start.png   | Bin 0 -> 2099 bytes
 docs/reference/gtk/images/right-center.png | Bin 0 -> 2250 bytes
 docs/reference/gtk/images/right-end.png    | Bin 0 -> 2241 bytes
 docs/reference/gtk/images/right-start.png  | Bin 0 -> 2110 bytes
 docs/reference/gtk/images/up-center.png    | Bin 0 -> 2171 bytes
 docs/reference/gtk/images/up-end.png       | Bin 0 -> 2123 bytes
 docs/reference/gtk/images/up-start.png     | Bin 0 -> 2148 bytes
 gtk/gtkmenubutton.c                        | 248 ++++++++++++++-------
 14 files changed, 178 insertions(+), 84 deletions(-)
 create mode 100644 docs/reference/gtk/images/down-center.png
 create mode 100644 docs/reference/gtk/images/down-end.png
 create mode 100644 docs/reference/gtk/images/down-start.png
 create mode 100644 docs/reference/gtk/images/left-center.png
 create mode 100644 docs/reference/gtk/images/left-end.png
 create mode 100644 docs/reference/gtk/images/left-start.png
 create mode 100644 docs/reference/gtk/images/right-center.png
 create mode 100644 docs/reference/gtk/images/right-end.png
 create mode 100644 docs/reference/gtk/images/right-start.png
 create mode 100644 docs/reference/gtk/images/up-center.png
 create mode 100644 docs/reference/gtk/images/up-end.png
 create mode 100644 docs/reference/gtk/images/up-start.png

diff --git a/docs/reference/gtk/Makefile.am b/docs/reference/gtk/Makefile.am
index 0d86b6a2fd..34bcf02d1a 100644
--- a/docs/reference/gtk/Makefile.am
+++ b/docs/reference/gtk/Makefile.am
@@ -382,7 +382,19 @@ HTML_IMAGES = \
 	$(srcdir)/images/numerableicon2.png				\
 	$(srcdir)/images/bloatpad-osx.png				\
 	$(srcdir)/images/bloatpad-gnome.png				\
-	$(srcdir)/images/bloatpad-xfce.png
+	$(srcdir)/images/bloatpad-xfce.png				\
+	$(srcdir)/images/down-center.png				\
+	$(srcdir)/images/down-end.png					\
+	$(srcdir)/images/down-start.png					\
+	$(srcdir)/images/left-center.png				\
+	$(srcdir)/images/left-end.png					\
+	$(srcdir)/images/left-start.png					\
+	$(srcdir)/images/right-center.png				\
+	$(srcdir)/images/right-end.png					\
+	$(srcdir)/images/right-start.png				\
+	$(srcdir)/images/up-center.png					\
+	$(srcdir)/images/up-end.png					\
+	$(srcdir)/images/up-start.png
 
 # Extra options to supply to gtkdoc-fixref
 FIXXREF_OPTIONS=--extra-dir=../gdk/html \
diff --git a/docs/reference/gtk/images/down-center.png b/docs/reference/gtk/images/down-center.png
new file mode 100644
index 0000000000000000000000000000000000000000..c42ccbe01fe4c0f6ecbcd92f73577b1edc9927ed
GIT binary patch
literal 2194
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

literal 0
HcmV?d00001

diff --git a/docs/reference/gtk/images/down-end.png b/docs/reference/gtk/images/down-end.png
new file mode 100644
index 0000000000000000000000000000000000000000..f2a2f6f6532ad6072664b4b21f5d5884054eb688
GIT binary patch
literal 2170
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

literal 0
HcmV?d00001

diff --git a/docs/reference/gtk/images/down-start.png b/docs/reference/gtk/images/down-start.png
new file mode 100644
index 0000000000000000000000000000000000000000..9d68db057933d6a11a0f1f400a0f6b8c8ac44737
GIT binary patch
literal 2177
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

literal 0
HcmV?d00001

diff --git a/docs/reference/gtk/images/left-center.png b/docs/reference/gtk/images/left-center.png
new file mode 100644
index 0000000000000000000000000000000000000000..0473d6523873aceb0fff806369e99ad2be06ad6b
GIT binary patch
literal 2234
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
IM6N<$f={+Io&W#<

literal 0
HcmV?d00001

diff --git a/docs/reference/gtk/images/left-end.png b/docs/reference/gtk/images/left-end.png
new file mode 100644
index 0000000000000000000000000000000000000000..d5101be3e5d9ab6639f804a099de70b586a05faa
GIT binary patch
literal 2196
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
Rs_@6_0vu*;Sgr3I`(Jr%EeQYs

literal 0
HcmV?d00001

diff --git a/docs/reference/gtk/images/left-start.png b/docs/reference/gtk/images/left-start.png
new file mode 100644
index 0000000000000000000000000000000000000000..618f3dc9cde6a3ecfa9f33f80be0882130f7f278
GIT binary patch
literal 2099
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
btti~_;PIzJ2bUUKx82;%%F(jU+~?YVh3W1Q

literal 0
HcmV?d00001

diff --git a/docs/reference/gtk/images/right-center.png b/docs/reference/gtk/images/right-center.png
new file mode 100644
index 0000000000000000000000000000000000000000..401b4d3c0202fe24d9a2794e1370f81320712786
GIT binary patch
literal 2250
zcmX|DdpOhY8~#wD66#A1DUqm#Nh*Yih%}}zmh&mhVUBZ_MWU#rNKP$QOT>IhVrn@b
zI!vpa%_(OyYuL;Vzq#uA{c*p~^*-1AUe|rS&-32Tdk1E7anCM=T>t>=v9i2yMG$iZ
zh!7JNtUr^ts|do*FiWRM0FY?gf>16<;(#D2in4;5i;jqi3d!t#aRR0;NF5BYzlt&o
zMIwDeP=YN0m__({p?t3$jtM{^4qvo_!mergiUNR`iPeSk_OV0MVkGL{>4P8n%m)1*
zx=@B`fu%z5jpQPgT*(Nwcb)K5PHm*xfyebBrAteShN~ih>f%}Lb?+MfgW3gWnj1v<
zi`hTdBb||OUJKq9I8t5gndzNr6%auFW%}7V^kL!kE+?upB4p})1C+rpPVBP67}m!n
zG2;j%E+kJuK|xs6OZn>dImz>AF}B$jdX-XmTaa2!AK90m+9{FVs@N%V^ZflOZ`Se;
zuxm!Cnj1zeyZc(I)YGwCvQlUGp{&l}Gd`ykprN67(~@Ta@#XcHX3t(~G`9NWyU}G&
z?I!?NKr_Zj-n!R3%b?R>&sSyV`LF@j_X0HS{*-MI<nWe&KO!=V33)T?tLqu@V(G2n
z)f<u(ABYALotGBa{bLYV<GfvSt<mUu5~2Ny(_5KE%sW;(SJrs*@=Ea8*P3xJ{+mds
z$avWjngfN$y&MbL93;h<JKF;Td=8BU))3z=3~sVVFRT(YKJBNtRAbrU4)O7}p|rjp
zYK+zse)hCagX@PG(F)>vEbn(e(JnO@G|X=ODS5wJKg~hpHTsd?bjEb0=0%}rtz?Q<
z0FhWN1-J(zIIENG*NMZM3m|ATVXEOe_`*I9DvjjUxVo~4uL8xD&BG#($pr?!9<y(x
z556a^ZF2RJ8jjLkJEruirdckw_DGVh!s)=ZEbFrzF2>)2*BH(<h;-~@*Bu3_!?{D}
zW=UYDTE8d0_&pLf(>nQYsk5;=sL>b_oZU6ElU(Ldp3R(}@43D9ii5=wiLhhRPP-jm
zyxjKjocevznfx$b9)QqQ01%twW?7w6jE!Fr8^1*}qK!A~3GF&z)S)~hBfegwT3WEv
zV_&&6FFD}dMD!`~BVJ1S#oSj8<zEU9QQY9n-Zb(u2_kx9sGy*zJ;un5`T1thrSh2N
z_=+{ETn%z_ytOp9-5iuD<oVq;$@xtUYb6_dg==xCg$2d;2h}+<7z`o#_Q6_zf6~+9
zf`WpjHL$$N-?IO|_a1I@@5k%kuU&VdnypVvc$G*LJ$zVt*&)KK3GJSU?lT5O7Sq{H
ztx3%s5n&;G|AAepy~%UD9n_l|pLPrY$|-gAC9p0UqgEqR;sR4vTx44^07ZCZ9aOox
zF*zv-h-q>x(@T#_OG%=o&3C$Q05@=mjAtz@7S?>_B0>x+Oy};+0FuMrwDf)X5w19k
z(%*QC5gc{oiz(aDf?S#q^t<w>v|O8dA-$wp?&aG^6WlF`K_e0TfuoY(wO+bpE?u&t
zYLBH(QbR&ONYJNm`rgY{5mRZK_k21j$e`LGHknM$SO&c=KW1xf{isa|Z+BEg8ah`7
zCX7;|UhM{IWc?2K%VW{zsm4*dD((1G(`LNUQ>x5X<DnfkGtn6Sb6j-Rjg8%CzLt4x
z9R~2MAKq!c|FcJRShK0v%~7u`a%IL~Vum!a^c$kQ-ob)07NTuf7vw+qwtTxB`nMri
z(M+Q55>i_ZWiZ<2BX75eiKT;l=H})&Uz-}PY#d4C(h-m&;G2|Z{fn&=+O67l|70>-
zC;uUm*|RYey}m2;1iwq0N2HZgr3~2C_<mC1IY}TsKEd@aD3GnK8pi2S;-gsOB{R6R
zyqT~0j{rt`S@#>~O8rmb0KCdIyusD30$wyrYw5u264%*x9;thrL&45Q`gwomm#Ure
zEda(ri*T)uc6Fl?OT`(qcN-qXoBfV6`_h@E_}KAKDEi|fJHL{&e{kPJ8YTVBy9)jh
zI!Gk0A@xBvD;Fu_>l8CGu@;YCXUguEZhOGsb#zS9s$kD?7Nu7KlS)ThD*NKz+h>N?
zV-10i=zFk_KigbRr)9Hb92yt;i6gbD>M!5oa1+ycn5u-1d6b`@-`A6cJ}aHBL|*pv
zRM+@)p<USvw|(fQNqA!;;YVQIc=(t*zP`3Ll7TIx>kJ^&WQZ*ZJe$4E6`5s>bk$@g
zTXQc3GeA{mZ$jcyJhYT`1qM22f<g!84t48AIgdhR?tc~vF_0H{UN)(dlUsUBc8VNW
zw?(N9!N^FYBjLy?=1&~2bIvwoO<zPBHnxO*gtH_dJCIu>f#2o?==kS{8f-82lrW~R
zj!>gLJ|xN?Z1dr?)Vv;N22Os#2;Wt%7W?b%TmJqGvYlHZfbyKAl>$0ER;_2l)}W{2
zkcVT_3F2I`rmxIso>mFOPU?8lEfxD^Bjyj<a7=XxB_|;9b*YZ@LyZS$128&MnpmT%
z?r&vd^XvWj&{)QW#RuPCk-ALKrYg~#j4@jM5PLyV@g0qlB3>*pY@59IT#~PKoNspr
z8C?t^VjG=X)E890vHl%k<<2sBGaq@fr%>_^wo4DRcezfkpL*(FRZRyuSE@n4%t52N
z#iZ5h(Fv()exZH-I0ODcM!r!TfUOYV3d5vsWikVvXspz#t(8|%LD=jbCBQXYaIj-x
zyu*fqhg77uv7Y_-?55}r-N3bs=}$dM!z#X_s#FF%_>7CY`=P^Fy_n^q?rSZxcvX=(
z$*p_&GnFiBSW^v^m&wPKQ~5_>`EU4Tu3C_&g`Cz2Ib!M;eyK4jXDlN3hJXHVFq?in
zprCIaWr5A+2WY;4<X^_wpSWj%wZKknJc;sx2dZ^J2X5_s+F)*jcyXm0?E>6c#F&;?
zT3JmTw>8Y3jFLK;bLX;}^<B2?priegTWmNdWvfmCEr0a<9n;>kL`u|}(p!*Y^VTQB
N%G~Bcm8oaS{{a8bh!6k(

literal 0
HcmV?d00001

diff --git a/docs/reference/gtk/images/right-end.png b/docs/reference/gtk/images/right-end.png
new file mode 100644
index 0000000000000000000000000000000000000000..8af0ac15cb71e15bc97d3f216e6e5e57f1e9a064
GIT binary patch
literal 2241
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

literal 0
HcmV?d00001

diff --git a/docs/reference/gtk/images/right-start.png b/docs/reference/gtk/images/right-start.png
new file mode 100644
index 0000000000000000000000000000000000000000..e08f3146210db2435788e6f9d6cd662d7cbe68fe
GIT binary patch
literal 2110
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

literal 0
HcmV?d00001

diff --git a/docs/reference/gtk/images/up-center.png b/docs/reference/gtk/images/up-center.png
new file mode 100644
index 0000000000000000000000000000000000000000..1d122241452e56bd0a36152b4eb513215cf69e38
GIT binary patch
literal 2171
zcmZ9OcQhM%8^<ZV_J}<@aE+=Jwd%GA2~r_;71bh9D~cqlYOiw98VO=n)vJQms1>7D
zG-6bXqT$wVqonDu=}q7Jp7Wmf{p0yP=lP!V`~C4fpYL;iX>eOh0bUtiHa0c^Yby%}
zR*zuSeeM&i)1hn`z-m0Vt=z)d*aQcD6+2E{P?jZfp{-$HE*du%yD*Qw<De}|lJ|GI
ziZ%}k4o0BRtdWh)JPdIYjqp7a;g7y`#?l%F_tivjv92<$EzF$m%x#wV-*$8s8)9@Z
z#0e?LM{dx$jAYHPX6mPJ+-h);C<JDtd(YN<0FHflF7}+a58ez0hnhdv5WCh2=xr3k
zIQ<5e6R$RFSW1aQSK(S__k%<nnmX50C+C!5gvtEQhs8htHR6uC8_W1k3uheIY3di+
zaEl=UrfhlfKyFnIL^=P7VN+?&yp!VcyBCH+&r>@*H1P=YV8U|SM}`U6aOI^^Qk6f*
z>dTIxSs}u$XcV8F&CZ<h($LWGZYZcwjRB@mR~xUMkDIz8@#o-b7!#lGhJW#XlQm;W
zmny}e2^4DFl))}Y22)Osg9@r9#sT5K4VOzjx<{>~xL&)~w=WKP9BOwY+r%iAjc0TS
zdbf9VJ@);S*l7@TI3NkT==mvq^`VY1sCu1IS{8eR+d)c>YAv`sUh>1*=fSH^9&Rm{
zmEAd{2$aet2+!@&sg8WS#kT8#&s^n=j|=-3RogJb9gRbkA`~1RzxpH)H9|RdiEvR8
z86`#4PazL>bM17_5?#;t_-%P!*AVh~qJi{@oF0+R6yOpDjdoNaJ>O0yoJe||MJJTS
z>>&=WykDTX2Wm@s%^nlhmx!C2xhk-^o$VsNbVgkrF@i*Uq33+%ibTl#wzr+#IL2fj
z99CF>m`yQHExSrmhCR-v`tIbP-=`NjM*B%>c{~j57vNi$R7{f4DvtHRVws(hvBq*G
zccYV@CJ!fN)%evLNPWgeQ8<K7wn3C}+tGNdoJ-@%!#+mmR7vxw@$@z)1vBnw^vXm1
zOY(HYf>J&e08+7y@o$>_j3rqq5p?QqACX}!A1(dXPrKINi>6O%6EKEy{QcVeiNf@j
zt5PWd{RloAH)Y)AW;A7OcsNQD=h1ctaMsEGdTG=*n4R<G@OPa{jXz`s4Pvx2kaop~
zjkjIw7i$%gUcX5_tyb*Z9P*Q$os`C59Qe$WG(9&*C@T|cS~<QLz2EFYgh8PR82(q(
zUzGhXbMY(^*jWVTnVCwfCRSvJamppk&*SH#HrDcK`39J|&G4<6#vhTyDVeFfe)?UW
zT-k|DtXpu49??Z#U+zx*(kI6F5&U{X^3e7(-FH_CX!pa~JA*J!*TZYBb@})2ixc1R
z&Wz5W74JT6-y5nO2@Sot4<={M>@Hd|y8eQ<x61`&TxV`U?yb*9N73nlM6c5Z*q~x0
zzZY`@QX9Lmsc8A2+qu;;J4Yd?$9p<+cX_WYV1q8S`Im~Jw-^y+k@R|uK&W`{m!6wb
z5G&r(KwF38K`X~iNC*%L1&)mTu{F<f&qu%L?VC4bq_3Dwp-4c}h*xYh(Rf38|Co3I
z4Fh3BY4`g9ZGfBd9RGylzn1(vDrf#<5C;P8<d_vF%cKd7s=vFe-*pQcv)GJKck$dk
z+G)#L)ousq^yaGA*3NZD+hLsV64oZ1pP*XZU!urWvY{Z<Ruau)-0uZ6`is?LN|1{h
zj%j5?Lk*OcmQJ^r5V4ybo6~C0WCdGYNZb5<staC1OLK3F){a3S`i_+m=Scvs`R%^?
z65~AH)j5@E9una7YiY$C`<KsTL%-jOj9FNzb3Z3RYaO_8;cG#@IYQ*1C$ri~6#!Z)
zk2cjQ(CJ%&G{4{E??+=WN7%(a@@SEtZJDOTpUbT|e7UmBR}(_p2691+j}NK7x_&lZ
zdmn)}Nk+}G4Rv)IT3SL#$`NL5r11N9^liny0Kh-our`;`mYPonPrS;axkg?vA+_`X
z0J2b+Xz&@zfIMbwq<oO<IP|16)>4A#Em-4{v3LXiY3?O$nc5JJ2fr&RSwXBF92~fn
zk3lLkMn&T|F|e8#Zze?4;fsJ-Vb!OV72iyVVm>vICZSZRM<&X<^1ws}(*#rdPt)MY
z#;({VReL3zwcb;LFiJqMOXYJ;ZmvIJO&34t&3u)u*x%er>h+bv{gHmE_gffmuf-qG
z+NprOgpI+0rdH#SJRPza_+(F7WOapz>XNdxLTUc*I^?vpH0y+VY>KIoh$4@8%7k7=
zi-jlwNG?#gxo6qS$+5~Vt+u9a60as|BWxze+fTF;R23@z@#SYip?P0-bJpcyCwSh}
zxfjr<Z)Crh?Ayi!ZX1?oXoIWIKB}IgGmVyY$k61Rit4ekv9spVszTMADI-z=xQi;r
zTxTa2CQ55;<;!$SZ-^LH7-c19EPDEIo~dxCX#_S2gYq@KSZ}%z_0)CMRg6=GD-1qz
zz_INfrje#ypC2?@C@{}-9}XdMDHecXU*OFQ-5~@Lfix-^+uB0)<N@GYt`q?1@QHnT
zMX{z|pgXahN;3doh$sx@o308}OaE#RvSO%N;}GuT6m~pzt#10;`nY0J=US?bWItM`
zdx&dN3a-Uv9l5&-%!paQc}O8=;93U*K;=%YN9?O+YcZYfmGO<^wVa|0j=Jz|wKZ;d
z7Pt2Tmnq&y^do0EO})?wi5y9vNH;UvNnR;$n02j>EE$w4l5T=NIWgQNlY22`xvhm5
z+)WkS_4;A5#4v<NE&jZ2MXdymN@cbVnZI0Ac`j*kLPp1%6ZSR{FU|fY@WaRkmJ}s$
uN|<`eNG_{dK?J|Z75^)>|CizNpU-01OqTdrviYyC1)DY4)}kJCBjIlX_zJrK

literal 0
HcmV?d00001

diff --git a/docs/reference/gtk/images/up-end.png b/docs/reference/gtk/images/up-end.png
new file mode 100644
index 0000000000000000000000000000000000000000..e3882af13d20c1a41f1bf3e8027d95263bad7714
GIT binary patch
literal 2123
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

literal 0
HcmV?d00001

diff --git a/docs/reference/gtk/images/up-start.png b/docs/reference/gtk/images/up-start.png
new file mode 100644
index 0000000000000000000000000000000000000000..73157804fe4eb11c61697729b1714868d07f0823
GIT binary patch
literal 2148
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
Mh%4~t=AQ9?0g0&Mc>n+a

literal 0
HcmV?d00001

diff --git a/gtk/gtkmenubutton.c b/gtk/gtkmenubutton.c
index 8a76361f21..a1aaa8c372 100644
--- a/gtk/gtkmenubutton.c
+++ b/gtk/gtkmenubutton.c
@@ -26,9 +26,118 @@
  * The #GtkMenuButton widget is used to display a menu when clicked on.
  * This menu can be provided either as a #GtkMenu, or an abstract #GMenuModel.
  *
- * The #GtkMenuButton widget can hold any valid child widget.  That is, it can hold
- * almost any other standard #GtkWidget. The most commonly used child is the
- * provided #GtkArrow.
+ * The #GtkMenuButton widget can hold any valid child widget. That is, it
+ * can hold almost any other standard #GtkWidget. The most commonly used
+ * child is the provided #GtkArrow.
+ *
+ * The positioning of the menu is determined by the #GtkMenuButton:direction
+ * property of the menu button and the #GtkWidget:halign or #GtkWidget:valign
+ * properties of the menu. For example, when the direction is %GTK_ARROW_DOWN
+ * and the horizontal alignment is %GTK_ALIGN_START, the menu will be
+ * positioned below the button, with the starting edge (depending on the
+ * text direction) of the menu aligned with the starting edge of the button.
+ * If there is not enough space below the button, the menu is popped up above
+ * the button instead. If the alignment would move part of the menu offscreen,
+ * it is 'pushed in'.
+ *
+ * <informaltable>
+ *   <tgroup cols="4">
+ *     <tbody>
+ *       <row>
+ *         <entry></entry>
+ *         <entry>halign = start</entry>
+ *         <entry>halign = center</entry>
+ *         <entry>halign = end</entry>
+ *       </row>
+ *     <row>
+ *       <entry>direction = down</entry>
+ *       <entry>
+ *         <inlinemediaobject>
+ *           <imageobject><imagedata fileref="down-start.png" format="PNG"/></imageobject>
+ *         </inlinemediaobject>
+ *       </entry>
+ *       <entry>
+ *         <inlinemediaobject>
+ *           <imageobject><imagedata fileref="down-center.png" format="PNG"/></imageobject>
+ *         </inlinemediaobject>
+ *       </entry>
+ *       <entry>
+ *         <inlinemediaobject>
+ *           <imageobject><imagedata fileref="down-end.png" format="PNG"/></imageobject>
+ *         </inlinemediaobject>
+ *       </entry>
+ *     </row>
+ *     <row>
+ *       <entry>direction = up</entry>
+ *       <entry>
+ *         <inlinemediaobject>
+ *           <imageobject><imagedata fileref="up-start.png" format="PNG"/></imageobject>
+ *         </inlinemediaobject>
+ *       </entry>
+ *       <entry>
+ *         <inlinemediaobject>
+ *           <imageobject><imagedata fileref="up-center.png" format="PNG"/></imageobject>
+ *         </inlinemediaobject>
+ *       </entry>
+ *       <entry>
+ *         <inlinemediaobject>
+ *           <imageobject><imagedata fileref="up-end.png" format="PNG"/></imageobject>
+ *         </inlinemediaobject>
+ *       </entry>
+ *      </row>
+ *     </tbody>
+ *   </tgroup>
+ * </informaltable>
+ * <informaltable>
+ *   <tgroup cols="3">
+ *     <tbody>
+ *       <row>
+ *         <entry></entry>
+ *         <entry>direction = left</entry>
+ *         <entry>direction = right</entry>
+ *       </row>
+ *     <row>
+ *       <entry>valign = start</entry>
+ *       <entry>
+ *         <inlinemediaobject>
+ *           <imageobject><imagedata fileref="left-start.png" format="PNG"/></imageobject>
+ *         </inlinemediaobject>
+ *       </entry>
+ *       <entry>
+ *         <inlinemediaobject>
+ *           <imageobject><imagedata fileref="right-start.png" format="PNG"/></imageobject>
+ *         </inlinemediaobject>
+ *       </entry>
+ *     </row>
+ *     <row>
+ *       <entry>valign = center</entry>
+ *       <entry>
+ *         <inlinemediaobject>
+ *           <imageobject><imagedata fileref="left-center.png" format="PNG"/></imageobject>
+ *         </inlinemediaobject>
+ *       </entry>
+ *       <entry>
+ *         <inlinemediaobject>
+ *           <imageobject><imagedata fileref="right-center.png" format="PNG"/></imageobject>
+ *         </inlinemediaobject>
+ *       </entry>
+ *     </row>
+ *     <row>
+ *       <entry>valign = end</entry>
+ *       <entry>
+ *         <inlinemediaobject>
+ *           <imageobject><imagedata fileref="left-end.png" format="PNG"/></imageobject>
+ *         </inlinemediaobject>
+ *       </entry>
+ *       <entry>
+ *         <inlinemediaobject>
+ *           <imageobject><imagedata fileref="right-end.png" format="PNG"/></imageobject>
+ *         </inlinemediaobject>
+ *       </entry>
+ *      </row>
+ *     </tbody>
+ *   </tgroup>
+ * </informaltable>
  */
 
 #include "config.h"
@@ -132,11 +241,11 @@ gtk_menu_button_state_flags_changed (GtkWidget    *widget,
 }
 
 static void
-menu_position_down_func (GtkMenu       *menu,
-                         gint          *x,
-                         gint          *y,
-                         gboolean      *push_in,
-                         GtkMenuButton *menu_button)
+menu_position_up_down_func (GtkMenu       *menu,
+                            gint          *x,
+                            gint          *y,
+                            gboolean      *push_in,
+                            GtkMenuButton *menu_button)
 {
   GtkMenuButtonPrivate *priv = menu_button->priv;
   GtkWidget *widget = GTK_WIDGET (menu_button);
@@ -147,14 +256,12 @@ menu_position_down_func (GtkMenu       *menu,
   GdkScreen *screen;
   GdkWindow *window;
   GtkAllocation allocation, arrow_allocation;
-  GtkWidget *toplevel;
-
-  toplevel = gtk_widget_get_toplevel (GTK_WIDGET (priv->menu));
-  gtk_window_set_type_hint (GTK_WINDOW (toplevel), GDK_WINDOW_TYPE_HINT_DROPDOWN_MENU);
+  GtkAlign align;
 
   gtk_widget_get_preferred_size (GTK_WIDGET (priv->menu),
                                  &menu_req, NULL);
 
+  align = gtk_widget_get_halign (GTK_WIDGET (priv->menu));
   direction = gtk_widget_get_direction (widget);
   window = gtk_widget_get_window (priv->align_widget ? priv->align_widget : widget);
 
@@ -171,71 +278,32 @@ menu_position_down_func (GtkMenu       *menu,
   *x += allocation.x;
   *y += allocation.y;
 
-  if (direction == GTK_TEXT_DIR_LTR)
+  /* treat the default align value like START */
+  if (align == GTK_ALIGN_FILL)
+    align = GTK_ALIGN_START;
+
+  if (align == GTK_ALIGN_CENTER)
+    *x -= (menu_req.width - allocation.width) / 2;
+  else if ((align == GTK_ALIGN_START && direction == GTK_TEXT_DIR_LTR) ||
+           (align == GTK_ALIGN_END && direction == GTK_TEXT_DIR_RTL))
     *x += MAX (allocation.width - menu_req.width, 0);
   else if (menu_req.width > allocation.width)
     *x -= menu_req.width - allocation.width;
 
-  if ((*y + arrow_allocation.height + menu_req.height) <= monitor.y + monitor.height)
-    *y += arrow_allocation.height;
-  else if ((*y - menu_req.height) >= monitor.y)
-    *y -= menu_req.height;
-  else if (monitor.y + monitor.height - (*y + arrow_allocation.height) > *y)
-    *y += arrow_allocation.height;
-  else
-    *y -= menu_req.height;
-
-  *push_in = FALSE;
-}
-
-static void
-menu_position_up_func (GtkMenu       *menu,
-                       gint          *x,
-                       gint          *y,
-                       gboolean      *push_in,
-                       GtkMenuButton *menu_button)
-{
-  GtkMenuButtonPrivate *priv = menu_button->priv;
-  GtkWidget *widget = GTK_WIDGET (menu_button);
-  GtkRequisition menu_req;
-  GtkTextDirection direction;
-  GdkRectangle monitor;
-  gint monitor_num;
-  GdkScreen *screen;
-  GdkWindow *window;
-  GtkAllocation allocation, arrow_allocation;
-
-  gtk_widget_get_preferred_size (GTK_WIDGET (priv->menu),
-                                 &menu_req, NULL);
-
-  direction = gtk_widget_get_direction (widget);
-  window = gtk_widget_get_window (priv->align_widget ? priv->align_widget : widget);
-
-  screen = gtk_widget_get_screen (GTK_WIDGET (menu));
-  monitor_num = gdk_screen_get_monitor_at_window (screen, window);
-  if (monitor_num < 0)
-    monitor_num = 0;
-  gdk_screen_get_monitor_workarea (screen, monitor_num, &monitor);
-
-  gtk_widget_get_allocation (priv->align_widget ? priv->align_widget : widget, &allocation);
-  gtk_widget_get_allocation (widget, &arrow_allocation);
-
-  gdk_window_get_origin (window, x, y);
-  *x += allocation.x;
-  *y += allocation.y;
-
-  if (direction == GTK_TEXT_DIR_LTR)
-    *x += MAX (allocation.width - menu_req.width, 0);
-  else if (menu_req.width > allocation.width)
-    *x -= menu_req.width - allocation.width;
-
-  *y -= menu_req.height;
-
-  /* If we're going to clip the top, pop down instead */
-  if (*y < monitor.y)
+  if (priv->arrow_type == GTK_ARROW_UP && *y - menu_req.height >= monitor.y)
     {
-      menu_position_down_func (menu, x, y, push_in, menu_button);
-      return;
+      *y -= menu_req.height;
+    }
+  else
+    {
+      if ((*y + arrow_allocation.height + menu_req.height) <= monitor.y + monitor.height)
+        *y += arrow_allocation.height;
+      else if ((*y - menu_req.height) >= monitor.y)
+        *y -= menu_req.height;
+      else if (monitor.y + monitor.height - (*y + arrow_allocation.height) > *y)
+        *y += arrow_allocation.height;
+      else
+        *y -= menu_req.height;
     }
 
   *push_in = FALSE;
@@ -249,19 +317,21 @@ menu_position_side_func (GtkMenu       *menu,
                          GtkMenuButton *menu_button)
 {
   GtkMenuButtonPrivate *priv = menu_button->priv;
-  GtkAllocation toggle_allocation;
+  GtkAllocation allocation;
   GtkWidget *widget = GTK_WIDGET (menu_button);
   GtkRequisition menu_req;
   GdkRectangle monitor;
   gint monitor_num;
   GdkScreen *screen;
   GdkWindow *window;
+  GtkAlign align;
 
   gtk_widget_get_preferred_size (GTK_WIDGET (priv->menu),
                                  &menu_req, NULL);
 
   window = gtk_widget_get_window (widget);
 
+  align = gtk_widget_get_valign (GTK_WIDGET (menu));
   screen = gtk_widget_get_screen (GTK_WIDGET (menu));
   monitor_num = gdk_screen_get_monitor_at_window (screen, window);
   if (monitor_num < 0)
@@ -270,16 +340,31 @@ menu_position_side_func (GtkMenu       *menu,
 
   gdk_window_get_origin (gtk_button_get_event_window (GTK_BUTTON (menu_button)), x, y);
 
-  gtk_widget_get_allocation (widget, &toggle_allocation);
+  gtk_widget_get_allocation (widget, &allocation);
 
   if (priv->arrow_type == GTK_ARROW_RIGHT)
-    *x += toggle_allocation.width;
+    {
+      if (*x + allocation.width + menu_req.width <= monitor.x + monitor.width)
+        *x += allocation.width;
+      else
+        *x -= menu_req.width;
+    }
   else
-    *x -= menu_req.width;
+    {
+      if (*x - menu_req.width >= monitor.x)
+        *x -= menu_req.width;
+      else
+        *x += allocation.width;
+    }
 
-  if (*y + menu_req.height > monitor.y + monitor.height &&
-      *y + toggle_allocation.height - monitor.y > monitor.y + monitor.height - *y)
-    *y += toggle_allocation.height - menu_req.height;
+  /* treat the default align value like START */
+  if (align == GTK_ALIGN_FILL)
+    align = GTK_ALIGN_START;
+
+  if (align == GTK_ALIGN_CENTER)
+    *y -= (menu_req.height - allocation.height) / 2;
+  else if (align == GTK_ALIGN_END)
+    *y -= menu_req.height - allocation.height;
 
   *push_in = FALSE;
 }
@@ -299,15 +384,12 @@ popup_menu (GtkMenuButton  *menu_button,
 
   switch (priv->arrow_type)
     {
-      case GTK_ARROW_UP:
-        func = (GtkMenuPositionFunc) menu_position_up_func;
-        break;
       case GTK_ARROW_LEFT:
       case GTK_ARROW_RIGHT:
         func = (GtkMenuPositionFunc) menu_position_side_func;
         break;
       default:
-        func = (GtkMenuPositionFunc) menu_position_down_func;
+        func = (GtkMenuPositionFunc) menu_position_up_down_func;
         break;
   }