mirror of
https://github.com/linuxdeepin/dde-dock.git
synced 2025-06-02 15:45:21 +00:00
chore: 给任务栏添加部分注释
给任务栏MainPanelControl类添加部分注释 Log: Change-Id: I60845aa7db41e1ffb6c34626a3d8b2b09a907124
This commit is contained in:
songwentao
parent
10a774288f
commit
6404ca24c1
@ -129,6 +129,9 @@ AppItem::~AppItem()
|
||||
m_appNameTips->deleteLater();
|
||||
}
|
||||
|
||||
/**将属于同一个应用的窗口合并到同一个应用图标
|
||||
* @brief AppItem::checkEntry
|
||||
*/
|
||||
void AppItem::checkEntry()
|
||||
{
|
||||
m_itemEntryInter->Check();
|
||||
@ -162,6 +165,9 @@ void AppItem::updateWindowIconGeometries()
|
||||
xcb_misc->set_window_icon_geometry(it.key(), r);
|
||||
}
|
||||
|
||||
/**取消驻留在dock上的应用
|
||||
* @brief AppItem::undock
|
||||
*/
|
||||
void AppItem::undock()
|
||||
{
|
||||
m_itemEntryInter->RequestUndock();
|
||||
|
||||
@ -150,6 +150,10 @@ void AppDragWidget::dragMoveEvent(QDragMoveEvent *event)
|
||||
}
|
||||
}
|
||||
|
||||
/**获取应用的左上角坐标
|
||||
* @brief AppDragWidget::topleftPoint
|
||||
* @return 返回应用左上角坐标
|
||||
*/
|
||||
const QPoint AppDragWidget::topleftPoint() const
|
||||
{
|
||||
QPoint p;
|
||||
@ -162,6 +166,11 @@ const QPoint AppDragWidget::topleftPoint() const
|
||||
return p;
|
||||
}
|
||||
|
||||
/**拖动从任务栏移除应用时浮窗坐标
|
||||
* @brief AppDragWidget::popupMarkPoint
|
||||
* @param pos 任务栏所在位置
|
||||
* @return 拖动从任务栏移除应用时浮窗坐标
|
||||
*/
|
||||
const QPoint AppDragWidget::popupMarkPoint(Dock::Position pos)
|
||||
{
|
||||
QPoint p(topleftPoint());
|
||||
@ -269,6 +278,9 @@ void AppDragWidget::initAnimations()
|
||||
connect(m_goBackAnim, &QPropertyAnimation::finished, this, &AppDragWidget::hide);
|
||||
}
|
||||
|
||||
/**显示移除动画
|
||||
* @brief AppDragWidget::showRemoveAnimation
|
||||
*/
|
||||
void AppDragWidget::showRemoveAnimation()
|
||||
{
|
||||
if (m_animGroup->state() == QParallelAnimationGroup::Running) {
|
||||
@ -278,6 +290,9 @@ void AppDragWidget::showRemoveAnimation()
|
||||
m_animGroup->start();
|
||||
}
|
||||
|
||||
/**显示放弃移除后的动画
|
||||
* @brief AppDragWidget::showGoBackAnimation
|
||||
*/
|
||||
void AppDragWidget::showGoBackAnimation()
|
||||
{
|
||||
m_goBackAnim->setDuration(300);
|
||||
@ -289,16 +304,16 @@ void AppDragWidget::showGoBackAnimation()
|
||||
void AppDragWidget::onRemoveAnimationStateChanged(QAbstractAnimation::State newState,
|
||||
QAbstractAnimation::State oldState)
|
||||
{
|
||||
Q_UNUSED(oldState);
|
||||
if (newState == QAbstractAnimation::Stopped) {
|
||||
hide();
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* @brief 判断图标拖到一定高度后是否可以移除
|
||||
/**判断图标拖到一定高度(默认任务栏高度的1.5倍)后是否可以移除
|
||||
* @brief AppDragWidget::isRemoveAble
|
||||
* @param curPos 当前鼠标所在位置
|
||||
* @return true
|
||||
* @return false
|
||||
* @return 返回true可移除，false不可移除
|
||||
*/
|
||||
bool AppDragWidget::isRemoveAble(const QPoint &curPos)
|
||||
{
|
||||
@ -324,17 +339,13 @@ bool AppDragWidget::isRemoveAble(const QPoint &curPos)
|
||||
return true;
|
||||
}
|
||||
break;
|
||||
default:
|
||||
break;
|
||||
}
|
||||
return false;
|
||||
}
|
||||
|
||||
/**
|
||||
* @brief 判断应用区域图标是否拖出任务栏
|
||||
*
|
||||
* @return true
|
||||
* @return false
|
||||
/**判断应用区域图标是否被拖出任务栏
|
||||
* @brief AppDragWidget::isRemoveItem
|
||||
* @return 返回true应用移出任务栏，false应用在任务栏内
|
||||
*/
|
||||
bool AppDragWidget::isRemoveItem()
|
||||
{
|
||||
@ -374,6 +385,9 @@ void AppDragWidget::enterEvent(QEvent *event)
|
||||
}
|
||||
}
|
||||
|
||||
/**显示移除应用提示窗口
|
||||
* @brief AppDragWidget::showRemoveTips
|
||||
*/
|
||||
void AppDragWidget::showRemoveTips()
|
||||
{
|
||||
Dock::Position pos = Dock::Position::Bottom;
|
||||
|
||||
@ -159,6 +159,9 @@ void MainPanelControl::setDisplayMode(DisplayMode dislayMode)
|
||||
updateDisplayMode();
|
||||
}
|
||||
|
||||
/**根据任务栏在屏幕上的位置，更新任务栏各控件布局
|
||||
* @brief MainPanelControl::updateMainPanelLayout
|
||||
*/
|
||||
void MainPanelControl::updateMainPanelLayout()
|
||||
{
|
||||
switch (m_position) {
|
||||
@ -192,10 +195,18 @@ void MainPanelControl::updateMainPanelLayout()
|
||||
break;
|
||||
}
|
||||
|
||||
// 显示桌面的区域
|
||||
resizeDesktopWidget();
|
||||
|
||||
// 设置任务栏各区域图标大小
|
||||
resizeDockIcon();
|
||||
}
|
||||
|
||||
/**往固定区域添加应用
|
||||
* @brief MainPanelControl::addFixedAreaItem
|
||||
* @param index 位置索引，如果为负数则插入到最后，为正则插入到指定位置
|
||||
* @param wdg 应用指针对象
|
||||
*/
|
||||
void MainPanelControl::addFixedAreaItem(int index, QWidget *wdg)
|
||||
{
|
||||
if(m_position == Position::Top || m_position == Position::Bottom){
|
||||
@ -206,6 +217,11 @@ void MainPanelControl::addFixedAreaItem(int index, QWidget *wdg)
|
||||
m_fixedAreaLayout->insertWidget(index, wdg);
|
||||
}
|
||||
|
||||
/**往应用区域添加应用
|
||||
* @brief MainPanelControl::addAppAreaItem
|
||||
* @param index 位置索引，如果为负数则插入到最后，为正则插入到指定位置
|
||||
* @param wdg 应用指针对象
|
||||
*/
|
||||
void MainPanelControl::addAppAreaItem(int index, QWidget *wdg)
|
||||
{
|
||||
if(m_position == Position::Top || m_position == Position::Bottom){
|
||||
@ -216,12 +232,22 @@ void MainPanelControl::addAppAreaItem(int index, QWidget *wdg)
|
||||
m_appAreaSonLayout->insertWidget(index, wdg);
|
||||
}
|
||||
|
||||
/**往托盘插件区域添加应用
|
||||
* @brief MainPanelControl::addTrayAreaItem
|
||||
* @param index 位置索引，如果为负数则插入到最后，为正则插入到指定位置
|
||||
* @param wdg 应用指针对象
|
||||
*/
|
||||
void MainPanelControl::addTrayAreaItem(int index, QWidget *wdg)
|
||||
{
|
||||
m_tray = static_cast<TrayPluginItem *>(wdg);
|
||||
m_trayAreaLayout->insertWidget(index, wdg);
|
||||
}
|
||||
|
||||
/**往插件区域添加应用，保存回收站插件指针对象
|
||||
* @brief MainPanelControl::addPluginAreaItem
|
||||
* @param index 位置索引，如果为负数则插入到最后，为正则插入到指定位置
|
||||
* @param wdg 应用指针对象
|
||||
*/
|
||||
void MainPanelControl::addPluginAreaItem(int index, QWidget *wdg)
|
||||
{
|
||||
//因为日期时间插件和其他插件的大小有异，为了方便设置边距，在插件区域布局再添加一层布局设置边距
|
||||
@ -236,21 +262,37 @@ void MainPanelControl::addPluginAreaItem(int index, QWidget *wdg)
|
||||
m_trashItem = pluginsItem;
|
||||
}
|
||||
|
||||
/**移除固定区域某一应用
|
||||
* @brief MainPanelControl::removeFixedAreaItem
|
||||
* @param wdg 应用指针对象
|
||||
*/
|
||||
void MainPanelControl::removeFixedAreaItem(QWidget *wdg)
|
||||
{
|
||||
m_fixedAreaLayout->removeWidget(wdg);
|
||||
}
|
||||
|
||||
/**移除应用区域某一应用
|
||||
* @brief MainPanelControl::removeAppAreaItem
|
||||
* @param wdg 应用指针对象
|
||||
*/
|
||||
void MainPanelControl::removeAppAreaItem(QWidget *wdg)
|
||||
{
|
||||
m_appAreaSonLayout->removeWidget(wdg);
|
||||
}
|
||||
|
||||
/**移除托盘插件区域某一应用
|
||||
* @brief MainPanelControl::removeTrayAreaItem
|
||||
* @param wdg 应用指针对象
|
||||
*/
|
||||
void MainPanelControl::removeTrayAreaItem(QWidget *wdg)
|
||||
{
|
||||
m_trayAreaLayout->removeWidget(wdg);
|
||||
}
|
||||
|
||||
/**移除插件区域某一应用
|
||||
* @brief MainPanelControl::removePluginAreaItem
|
||||
* @param wdg 应用指针对象
|
||||
*/
|
||||
void MainPanelControl::removePluginAreaItem(QWidget *wdg)
|
||||
{
|
||||
//因为日期时间插件大小和其他插件有异，为了方便设置边距，各插件中增加一层布局
|
||||
@ -277,6 +319,9 @@ void MainPanelControl::resizeEvent(QResizeEvent *event)
|
||||
return QWidget::resizeEvent(event);
|
||||
}
|
||||
|
||||
/**根据任务栏所在位置， 设置应用区域控件的大小
|
||||
* @brief MainPanelControl::updateAppAreaSonWidgetSize
|
||||
*/
|
||||
void MainPanelControl::updateAppAreaSonWidgetSize()
|
||||
{
|
||||
if ((m_position == Position::Top) || (m_position == Position::Bottom)) {
|
||||
@ -307,6 +352,11 @@ void MainPanelControl::setPositonValue(Dock::Position position)
|
||||
});
|
||||
}
|
||||
|
||||
/**向任务栏插入各类应用,并将属于同一个应用的窗口合并到同一个应用图标
|
||||
* @brief MainPanelControl::insertItem
|
||||
* @param index 位置索引
|
||||
* @param item 应用指针对象
|
||||
*/
|
||||
void MainPanelControl::insertItem(int index, DockItem *item)
|
||||
{
|
||||
item->installEventFilter(this);
|
||||
@ -328,8 +378,6 @@ void MainPanelControl::insertItem(int index, DockItem *item)
|
||||
case DockItem::Plugins:
|
||||
addPluginAreaItem(index, item);
|
||||
break;
|
||||
default:
|
||||
break;
|
||||
}
|
||||
|
||||
// 同removeItem处 注意:不能屏蔽此接口，否则会造成插件插入时无法显示
|
||||
@ -342,6 +390,10 @@ void MainPanelControl::insertItem(int index, DockItem *item)
|
||||
item->checkEntry();
|
||||
}
|
||||
|
||||
/**从任务栏移除某一应用，并更新任务栏图标大小
|
||||
* @brief MainPanelControl::removeItem
|
||||
* @param item 应用指针对象
|
||||
*/
|
||||
void MainPanelControl::removeItem(DockItem *item)
|
||||
{
|
||||
switch (item->itemType()) {
|
||||
@ -359,8 +411,6 @@ void MainPanelControl::removeItem(DockItem *item)
|
||||
case DockItem::Plugins:
|
||||
removePluginAreaItem(item);
|
||||
break;
|
||||
default:
|
||||
break;
|
||||
}
|
||||
|
||||
/** 此处重新计算大小的时候icon的个数在原有个数上减少了一个，导致每个icon的大小跟原来大小不一致，需要重新设置setFixedSize
|
||||
@ -371,6 +421,11 @@ void MainPanelControl::removeItem(DockItem *item)
|
||||
resizeDockIcon();
|
||||
}
|
||||
|
||||
/**任务栏移动应用图标
|
||||
* @brief MainPanelControl::moveItem
|
||||
* @param sourceItem 即将插入的应用
|
||||
* @param targetItem 被移动的应用
|
||||
*/
|
||||
void MainPanelControl::moveItem(DockItem *sourceItem, DockItem *targetItem)
|
||||
{
|
||||
// get target index
|
||||
@ -563,6 +618,7 @@ void MainPanelControl::dragMoveEvent(QDragMoveEvent *e)
|
||||
|
||||
bool MainPanelControl::eventFilter(QObject *watched, QEvent *event)
|
||||
{
|
||||
// 更新应用区域大小和任务栏图标大小
|
||||
if (watched == m_appAreaSonWidget) {
|
||||
switch (event->type()) {
|
||||
case QEvent::LayoutRequest:
|
||||
@ -584,9 +640,12 @@ bool MainPanelControl::eventFilter(QObject *watched, QEvent *event)
|
||||
case QEvent::Resize:
|
||||
resizeDockIcon();
|
||||
break;
|
||||
default:
|
||||
break;
|
||||
}
|
||||
}
|
||||
|
||||
// 高效模式下，鼠标移入移出＇显示桌面＇区域的处理
|
||||
if (watched == m_desktopWidget) {
|
||||
if (event->type() == QEvent::Enter) {
|
||||
if (checkNeedShowDesktop()) {
|
||||
@ -605,6 +664,7 @@ bool MainPanelControl::eventFilter(QObject *watched, QEvent *event)
|
||||
}
|
||||
}
|
||||
|
||||
// 更新应用区域子控件大小以及位置
|
||||
if (watched == m_appAreaWidget) {
|
||||
if (event->type() == QEvent::Resize)
|
||||
updateAppAreaSonWidgetSize();
|
||||
@ -841,6 +901,9 @@ void MainPanelControl::updateDisplayMode()
|
||||
resizeDesktopWidget();
|
||||
}
|
||||
|
||||
/**把驻留应用和被打开的应用所在窗口移动到指定位置
|
||||
* @brief MainPanelControl::moveAppSonWidget
|
||||
*/
|
||||
void MainPanelControl::moveAppSonWidget()
|
||||
{
|
||||
QRect rect(QPoint(0, 0), m_appAreaSonWidget->size());
|
||||
@ -883,6 +946,9 @@ void MainPanelControl::moveAppSonWidget()
|
||||
m_appAreaSonWidget->move(rect.x(), rect.y());
|
||||
}
|
||||
|
||||
/**通知布局器，控件已发生变化，需要重新设置几何位置
|
||||
* @brief MainPanelControl::updatePluginsLayout
|
||||
*/
|
||||
void MainPanelControl::updatePluginsLayout()
|
||||
{
|
||||
for (int i = 0; i < m_pluginLayout->count(); ++i) {
|
||||
@ -935,6 +1001,9 @@ void MainPanelControl::paintEvent(QPaintEvent *event)
|
||||
painter.fillRect(m_desktopWidget->geometry(), QColor(255, 255, 255, 25));
|
||||
}
|
||||
|
||||
/**重新计算任务栏上应用图标、插件图标的大小，并设置
|
||||
* @brief MainPanelControl::resizeDockIcon
|
||||
*/
|
||||
void MainPanelControl::resizeDockIcon()
|
||||
{
|
||||
// 插件有点特殊，因为会引入第三方的插件，并不会受dock的缩放影响，我们只能限制我们自己的插件，否则会导致显示错误。
|
||||
@ -1147,6 +1216,9 @@ void MainPanelControl::calcuDockIconSize(int w, int h, PluginsItem *trashPlugin,
|
||||
}
|
||||
}
|
||||
|
||||
/**获取托盘插件的个数并更新任务栏图标大小
|
||||
* @brief MainPanelControl::getTrayVisableItemCount
|
||||
*/
|
||||
void MainPanelControl::getTrayVisableItemCount()
|
||||
{
|
||||
if (m_trayAreaLayout->count() > 0) {
|
||||
@ -1159,6 +1231,9 @@ void MainPanelControl::getTrayVisableItemCount()
|
||||
resizeDockIcon();
|
||||
}
|
||||
|
||||
/**时尚模式没有‘显示桌面’区域
|
||||
* @brief MainPanelControl::resizeDesktopWidget
|
||||
*/
|
||||
void MainPanelControl::resizeDesktopWidget()
|
||||
{
|
||||
if (m_position == Position::Right || m_position == Position::Left)
|
||||
@ -1189,9 +1264,9 @@ bool MainPanelControl::checkNeedShowDesktop()
|
||||
}
|
||||
|
||||
/**
|
||||
* @brief MainWindow::appIsOnDock 判断应用是否驻留在任务栏上
|
||||
* @brief MainWindow::appIsOnDock 判断指定的应用（驻留和运行显示在任务栏的所有应用）是否在任务栏上
|
||||
* @param appDesktop 应用的desktop文件的完整路径
|
||||
* @return true: 驻留；false:未驻留
|
||||
* @return true: 在任务栏；false: 不在任务栏
|
||||
*/
|
||||
bool MainPanelControl::appIsOnDock(const QString &appDesktop)
|
||||
{
|
||||
|
||||
@ -113,7 +113,7 @@ private:
|
||||
QBoxLayout *m_fixedAreaLayout; //
|
||||
QLabel *m_fixedSpliter; // 固定区域与应用区域间的分割线
|
||||
QWidget *m_appAreaWidget; // 应用区域
|
||||
QWidget *m_appAreaSonWidget; // 子应用区域
|
||||
QWidget *m_appAreaSonWidget; // 子应用区域，所在位置根据显示模式手动指定
|
||||
QBoxLayout *m_appAreaSonLayout; //
|
||||
QLabel *m_appSpliter; // 应用区域与托盘区域间的分割线
|
||||
QWidget *m_trayAreaWidget; // 托盘区域
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user