diff options
author | Tor Lillqvist <tml@collabora.com> | 2017-01-03 09:35:53 +0200 |
---|---|---|
committer | Tor Lillqvist <tml@collabora.com> | 2017-01-03 10:24:47 +0200 |
commit | 0621795c54956c89dbb2df585df8336b1f86f7ef (patch) | |
tree | f8b38bb3fa88bf758a7069a311c35366d7616651 /sfx2/source/doc/objmisc.cxx | |
parent | 53fd124d2488977af8536f439874a15de375dc40 (diff) |
Move documentation for parameter of SfxObjectShell::GetTitle() to include file
A re-design of this API would be a good idea.
Is this function ever called with some specific max length that would
not be one of the magic values? Probably the sanest would be to turn
the magic value constants into a normal (scoped) enum, and have two
separate functions: One that takes no parameter and returns the whole
title (and then let the caller take care of truncating as necessary),
and one that takes such an enum and returns a correspondingly mangled
title. The less magic and defaulted parameters the better.
Change-Id: I9e3aa95fae981c5ed48300b753556fa9074c1166
Diffstat (limited to 'sfx2/source/doc/objmisc.cxx')
-rw-r--r-- | sfx2/source/doc/objmisc.cxx | 42 |
1 files changed, 1 insertions, 41 deletions
diff --git a/sfx2/source/doc/objmisc.cxx b/sfx2/source/doc/objmisc.cxx index 4cc03cc6d228..dfed530ee3a1 100644 --- a/sfx2/source/doc/objmisc.cxx +++ b/sfx2/source/doc/objmisc.cxx @@ -707,47 +707,7 @@ void SfxObjectShell::SetTitle -OUString SfxObjectShell::GetTitle -( - sal_uInt16 nMaxLength /* 0 (default) - the title itself, as it is - - 1 (==SFX_TITLE_FILENAME) - provides the logical file name without path - (under WNT depending on the system settings - without extension) - - 2 (==SFX_TITLE_FULLNAME) - provides the logical file names with full path - (remote =>:: com:: sun:: star:: util:: URL) - - 3 (==SFX_TITLE_APINAME) - provides the logical filename without path - and extension - - 4 (==SFX_TITLE_DETECT) - provides the complete title, if not set yet - it will be created from DocInfo or the name of - the medium. - - 5 (==SFX_TITLE_CAPTION) - provides the Title just like MB now in the - CaptionBar view - - 6 (==SFX_TITLE_PICKLIST) - returns the Title, just like MB now would - display it in the PickList - - 7 (==SFX_TITLE_HISTORY) - returns the Title just like MB now would - display it in the History - - 10 bis USHRT_MAX - provides the 'nMaxLength' of the logical - file name including the path - (remote => css::util::URL) - */ -) const +OUString SfxObjectShell::GetTitle( sal_uInt16 nMaxLength ) const /* [Description] |